登录 注册

读书笔记 --Java 核心技术 -- 高级特征

本贴最后更新于 2539 天前，其中的信息可能已经时移世异

第一章--流与文件----------------------------------------------

流

读写字节

java.io.InputStream 1.0

  1. abstract int read() //从数据中读入一个字节，并返回该字节，在碰到流的结尾时返回-1
  2. int read(byte[] b) //读入一个字节数组，并返回实际读入的字节数，或者在碰到流的结尾时返回-1
  3. int read(byte[] b, int off, int len) //读入一个字节数组。这个read方法返回实际读入的字节数，或者在碰到流的结尾时返回-1
  4. long skip(long n) //在输入流中跳过n个字节，返回实际跳过的字节数（如果碰到流的结尾，则可能小于n）
  5. int available() //返回在不阻塞的情况下可用的字节数
  6. void close() //关闭这个输入流
  7. void mark(int readLimit) //在输入流的当前位置打一个标记，如果输入流中已经读入的字节多于readLimit个，则这个流允许忽略这个标记
  8. void reset() //返回到最后的标记，随后对read的调用将重新读入这些字节
  9. boolean markSupported() //如果这个流支持打标记，则返回true

java.io.OutputStream 1.0

  1. abstract void write(int n) //写出一个字节的数据
  2. void write(byte[] b)
  3. void write(byte[] b, int off, int len) //写出所有字节或者某个范围的字节到数组b中
  4. void close() //清空并关闭输出流
  5. void flush() //清空输出流，也就是将所有缓冲的数据发送到目的地

流家族

InputStream 和 OutputStream 为基础

DataInputStream 和 DataOutputStream 可以以二进制格式读写所有的基本 Java 类型

ZipInputStream 和 ZipOutputStream 可以以常见的 ZIP 压缩格式读写文件

4 个附加接口：Closeable、Flushable、Readable 和 Appendable

java.io.Closeable 5.0

  1. void close() //关闭这个Closeable，可能会抛出IOException

java.io.Flushable 5.0

  1. void flush() //清空这个Flushable

java.lang.Readable 5.0

  1. int read(CharBuffer cb) //尝试读入cb可以持有的数量的char值。返回读入的char值的数量

java.lang.Appendable 5.0

  1. Appendable append(char c)
  2. Appendable append(CharSequence cs) //向这个Appendable中追加给定的码元或者给定的序列中的所有码元，返回this

java.lang.CharSequence 1.4

  1. char charAt(int index) //返回给定索引处的码元
  2. int length() //返回这个序列中的码元的数量
  3. CharSequence subSequence(int startIndex, int endIndex) //返回由存储在startIndex到endIndex - 1处的所有码元构成的CharSequence
  4. String toString() //返回这个序列中所有码元构成的字符串

组合流过滤器

  1. FileInputStream fin = new FileInputStream("employee.dat");
  2. DataInputStream din = new DataInputStream(fin);
  3. double s = din.readDouble();

使用缓冲机制

  1. DataInputStream din = new DataInputStream(
  2. new BufferedInputStream(
  3. new FileInputStream("employee.dat")));

从一个 ZIP 压缩文件中读入数字

  1. ZipInputStream zin = new ZipInputStream(new FileInputStream("employee.zip"));
  2. DataInputStream din = new DataInputStream(zin);

java.io.FileInputStream 1.0

  1. FileInputStream(String name)
  2. FileInputStream(File file) //使用由name字符串或file对象指定路径名的文件创建一个新的文件输入流

java.io.FileOutputStream 1.0

  1. FileOutputStream(String name)
  2. FileOutputStream(String name, boolean append)
  3. FileOutputStream(File file)
  4. FileOutputStream(File file, boolean append) // 使用由 name 字符串或 file 对象指定路径名的文件创建一个新的文件输出流

java.io.BufferedInputStream 1.0

  1. BufferedInputStream(InputStream in) //创建一个带缓冲区的流

java.io.BufferdOutputStream 1.0

  1. BufferedOutputStream(OutputStream out) //创建一个带缓冲区的流

java.io.PushbackInputStream 1.0

  1. PushbackInputStream(InputStream in)
  2. PushbackInputStream(InputStream in, int size) //构建一个可以预览一个字节或者具有指定尺寸的回推缓冲区的流
  3. void unread(int b) //回推一个字节，它可以在下次调用 read 时被再次获取，b:要再次读入的字节

文本输入与输出

  1. InputStreamReader in = new InputStreamReader(new FileInputStream("input.txt"), "ISO8859_5");
  2. 等价于
  3. FileReader in = new FileReader("input.txt"):

以文本格式打印字符串和数字

  1. PrintWriter out = new PrintWriter("employee.txt"):
  2. 等同于
  3. PrintWriter out = new PrintWriter(new FileWriter("employee.txt"));

System.out 是 PrintStream 类，在内部采用与 PrintWriter 相同的方式将 Unicode 字符转换成了默认的主机编码方式。与 PrintWriter 不同的是，它们允许我们用 write(int)和 write(byte[])方法输出原生字节

java.io.PrintWriter 1.1

  1. PrintWriter(Writer out)
  2. PrintWriter(Writer out, boolean autoFlush) //创建一个新的PrintWriter
  3. PrintWriter(OutputStream out)
  4. PrintWriter(OutputStream out, boolean autoflush) //通过创建必需的中介OutputStreamWriter，从已有的OutputStream中创建一个新的PrintWriter
  5. PrintWriter(String filename)
  6. PrintWriter(File file) //通过创建必需的中介FileWriter，创建一个想给定的文件写出的新的PrintWriter
  7. void print(Object obj) //通过打印从toString产生的字符串来打印一个对象
  8. void print(String s) //打印一个Unicode字符串
  9. void println(String s) //打印一个字符串，后面紧跟一个行终止符
  10. void print(char[] s) //打印给定的字符串中的所有Unicode字符
  11. void print(char c) //打印一个Unicode字符
  12. void print(int i)
  13. void print(long l)
  14. void print(float f)
  15. void print(double d)
  16. void print(boolean b) //以文本格式打印给定的值
  17. void printf(String format, Object... args) //按照格式化字符串指定的方式打印给定的值
  18. boolean checkError() //如果产生格式化或输出错误，返回true

使用 Scanner 读入文本输入

Java SE 5.0 之前，处理文本的唯一方式就是 BufferedReader 类，它拥有一个 readLine 方法，可以读入一行文本

  1. BufferedReader in = new BufferedReader(new FileReader("employee.txt"));

字符集

  1. //编码Unicode字符串
  2. Charset cset = Charset.forName("ISO-8859-1"):
  3. String str = ...;
  4. ByteBuffer buffer = cset.encode(str);
  5. byte[] bytes = buffer.array();
  6. //解码字节序列
  7. byte[] bytes = ...;
  8. ByteBuffer bbuf = ByteBuffer.wrap(bytes, offset, length);
  9. CharBuffer cbuf = cset.decode(bbuf);
  10. String str = cbuf.toString();

java.nio.charset.Charset 1.4

  1. static SortedMap availableCharsets() //获取这个虚拟机可用的所有字符集。返回一个映射表，它的键是字符集的名字，值是字符集
  2. static Charset forName(String name) //获取给定名字的字符集
  3. Set aliases() //返回这个字符集的别名集
  4. ByteBuffer encode(String str) //将给定的字符串编码为字节序列
  5. CharBuffer decode(ByteBuffer buffer) //解码给定的字节序列，无法识别的输入将被转换成Unicode的“替代字符”（’\uFFFD')

java.nio.ByteBuffer 1.4

  1. byte[] array() //返回这个缓冲区所管理的字节数组
  2. static ByteBuffer wrap(byte[] bytes)
  3. static ByteBuffer wrap(byte[] bytes, int offset, int length) //返回管理给定的字节数组或给定字节数组的某个范围的字节缓冲区

java.nio.CharBuffer

  1. char[] array() //返回这个缓冲区所管理的码元数组
  2. char charAt(int index) //返回给定索引处的码元
  3. String toString() //返回由这个缓冲区所管理的码元构成的字符串

读写二进制数据

DataInputStream 类实现了 DataInput 接口

java.io.DataInput 1.0

  1. boolean readBoolean()
  2. byte readByte()
  3. char readChar()
  4. double readDouble()
  5. float readFloat()
  6. int readInt()
  7. long readLong()
  8. short readShort() //读入一个给定类型的值
  9. void readFully(byte[] b) //将字节读入到数组b中，其间阻塞直至所有字节都读入
  10. void readFully(byte[] b, int off, int len) //将字节读入到数组b中，其间阻塞直至所有字节都读入
  11. String readUTF() //读入由“修订过的UTF-8”格式的字符构成的字符串
  12. int skipBytes(int n) //跳过n个字节，其间阻塞直至所有字节都被跳过

java.io.DataOutput 1.0

  1. void writeBoolean(boolean b)
  2. void writeByte(int b)
  3. void writeChar(int c)
  4. void writeDouble(double d)
  5. void writeFloat(float f)
  6. void writeInt(int i)
  7. void writeLong(long l)
  8. void writeShort(int s) //写出一个给定类型的值
  9. void writeChars(String s) //写出字符串中的所有字符
  10. void writeUTF(String s) //写出由“修订过的UTF-8”格式的字符构成的字符串

随机访问文件

RandomAccessFile 类可以在文件中的任何位置查找或写入数据，通过“r"或"rw"来指定。同时实现了 DataInput 和 DataOutput 接口

java.io.RandomAccessFile 1.0

  1. RandomAccessFile(String file, String mode)
  2. RandomAccessFile(File file, String mode) //file:要打开的文件，mode:"r"表示只读模式，"rw"表示读/写模式
  3. long getFilePointer() //返回文件指针的当前位置
  4. void seek(long pos) //将文件指针从文件的开始设置到pos个字节处
  5. long length() //返回文件按照字节来度量的长度

ZIP 文档

通读 ZIP 文件代码：

  1. ZipInputStream zin = new ZipInputStream(new FileInputStream(zipname));
  2. ZipEntry entry;
  3. while ((entry = zin.getNextEntry()) != null)
  4. {
  5. analyze entry;
  6. read the contents of zin;
  7. zin.closeEntry();
  8. }
  9. zin.close();

写出 ZIP 文件代码：

  1. FileOutputStream fout = new FileOutputStream("test.zip");
  2. ZipOutputStream zout = new ZipOutputStream(fout);
  3. for all files
  4. {
  5. ZipEntry ze = new ZipEntry(filename);
  6. zout.putNextEntry(ze);
  7. send data to zout;
  8. zout.closeEntry();
  9. }
  10. zout.close();

java.util.zip.ZipInputStream 1.1

  1. ZipInputStream(InputStream in) //创建一个ZipInputStream
  2. ZipEntry getNextEntry() //为下一项返回ZipEntry对象，否则没有更多的项时返回null
  3. void closeEntry() //关闭这个ZIP文件中当前打开的项

java.util.zip.ZipOutputStream 1.1

  1. ZipOutputStream(OutputStream out) //创建一个将压缩数据写出到指定的OutputStream的ZipOutputStream
  2. void putNextEntry(ZipEntry ze) //将给定的ZipEntry中的信息写出到流中，并定为用于写出数据的流，然后这些数据可以通过write()写出到这个流中
  3. void closeEntry() //关闭这个ZIP文件中当前打开的项
  4. void setLevel(int level) //设置后续的各个DEFAULTED项的默认压缩级别。
  5. void setMethod(int method) //设置用于这个ZipOutputStream的默认压缩方法，压缩方法：DEFLATED或STORED

java.util.zip.ZipEntry 1.1

  1. ZipEntry(String name) //这一项的名字
  2. long getCrc() //返回用于这个ZipEntry的CRC32校验和的值
  3. String getName() //返回这一项的名字
  4. long getSize() //返回这一项不被压缩的大小
  5. boolean isDirectory() //当这一项是目录时返回true
  6. void setSize(long size) //设置这一项的大小，当压缩方法是STORED时才必需
  7. void setCrc(long crc) //给这一项设置CRC32校验和，这个校验和是使用CRC32类计算的，STORED时必需

java.util.zip.ZipFile 1.1

  1. ZipFile(String name)
  2. ZipFile(File file) //创建一个ZipFile，用于从给定的字符串或File对象中读入数据
  3. Enumeration entries() //返回一个Enumeration对象，它枚举了描述这个ZipFile中各个项的ZipEntry对象
  4. ZipEntry getEntry(String name) //返回给定名字所对应的项，或者在没有对应项的时候返回null
  5. InputStream getInputStream(ZipEntry ze) //返回用于给定项的InputStream
  6. String getName() //返回这个ZIP文件的路径

对象流与序列化

对象序列化（object serialization)

ObjectInputStream 和 ObjectOutputStream 类，readObject 和 writeObject 方法

在对象流中存储或恢复的所有类都需要实现 Serializable 接口

java.io.ObjectOutputStream 1.1

  1. ObjectOutputStream(OutputStream out) //创建一个ObjectOutputStream使得你可以将对象写出到指定的OutputStream
  2. void writeObject(Object obj) //写出指定的对象到ObjectOutputStream，这个方法将存储指定对象的类、类的签名以及这个类及其超类中所有非静态和非瞬时的域的值

java.io.ObjectInputStream 1.1

  1. ObjectInputStream(InputStream in) //创建一个ObjectInputStream用于从指定的InputSream中读回对象信息
  2. Object readObject() //从ObjectInputStream中读入一个对象

对象流输出中包含所有对象的类型和数据域

每个对象都被赋予一个序列号

相同对象的重复出现将被存储为对这个对象的序列号的引用

修改默认的序列化机制

防止不应该被序列化的域被序列化，标记成 transient

可序列化的类可以定义下列方法：

  1. private void readObject(ObjectInputStream in) throws IOException, ClassNotFoundException;
  2. private void writeObject(ObjectOutputStream out) throws IOException;

之后，数据域就不再自动序列化，而是调用这些方法

类还可以定义它自己的机制，必须实现 Externalizable 接口，定义两个方法：

  1. public void readExternal(ObjectInputStream in) throws IOException, ClassNotFoundException;
  2. public void writeExternal(ObjectOutputStream out) throws IOException;

序列化单例和类型安全的枚举

请记住向遗留代码中所有类型安全的枚举以及向所有支持单例设计模式的类中添加 readResolve 方法

版本管理

运行 JDK 中的单机程序 serialver

serialver Employee

这个类的所有版本都需要定义

public static final long serialVersionUID = -184528436328947893L;

文件管理

File 类

可以用 FileNameFilter 对象作为 list 方法的参数来减小列表长度，一个实现 FileNameFilter 接口的类需要定义 accept 方法

使用 File 类中存储在名为 separator 的静态实例域中的有关当前目录分隔符的信息可以得到系统恰当的分隔符

java.io.File 1.0

  1. boolean canRead()
  2. boolean canWrite()
  3. boolean canExecute() //表明文件是否可读、可写或可执行
  4. boolean setReadable(boolean state, boolean ownerOnly)
  5. boolean setWritable(boolean state, boolean ownerOnly)
  6. boolean setExecutable(boolean state, boolean ownerOnly) //设置这个文件的可读、可写或可执行状态。如果ownerOnly为true，状态设置只对文件拥有者有效，否则，对所有人有效。这些方法在设置状态成功后返回true
  7. static boolean createTempFile(String prefix, String suffix)
  8. static boolean createTempFile(String prefix, String suffix, File directory) //在系统的默认临时目录或给定目录中创建一个临时文件，并使用给定的前缀或后缀来生成文件名
  9. boolean delete() //尝试删除这个文件
  10. void deleteOnExit() //请求在虚拟机关闭时将文件删除
  11. boolean exists() //如果目录存在则返回true
  12. String getAbsolutePath() //返回包含绝对路径名的字符串，应该用getCanonicalPath代替它
  13. File getCanonicalFile() //返回包含这个文件的规范路径名的File对象
  14. String getCanonicalPath() //返回包含这个文件的规范路径名的字符串
  15. String getName() //返回包含这个File对象的文件名的字符串（不包含路径）
  16. String getParent() //返回这个File对象的父亲名字的字符串
  17. File getParentFile() //返回这个File目录的父目录的File对象
  18. String getPath() //返回包含这个文件的路径名的字符串
  19. boolean isDirectory() //如果这个File对象表示一个文件而不是一个目录或一个设备，则返回true
  20. boolean isFile() //如果这个File对象表示一个文件而不是一个目录或一个设备，则返回true
  21. boolean isHidden() //如果这个File对象表示的是一个隐藏文件或目录，则返回true
  22. long lastModified() //返回这个文件最后被修改的时间（毫秒数）
  23. String[] list()
  24. String[] list(FilenameFilter filter) //返回由这个File对象包含的满足过滤器条件的文件名和目录名构成的字符串数组
  25. File[] listFiles()
  26. File[] listFiles(FilenameFilter filter) //返回由这个File对象包含的文件和目录所对应的File对象构成的数组
  27. static File[] listRoots() //返回由所有可获得的文件根对应的File对象构成的数组
  28. boolean createNewFile() //自动创建一个由File对象给定名字的新文件
  29. boolean mkdir() //创建一个由这个File对象给定名字的子目录
  30. boolean mkdirs() //与mkdir不同，这个方法在必要时将创建父目录
  31. boolean renameTo(File newName) //如果文件名被修改，则返回true
  32. boolean setLastModified(long time) //设置这个文件的最后修改时间
  33. boolean setReadOnly() //将这个文件设置成只读
  34. URL toURL() //将这个File对象转换成一个文件的URL
  35. long getTotalSpace()
  36. long getFreeSpace()
  37. long getUsableSpace() //获得由File对象所描述的分区的总大小、未分配字节的数量和可用字节的数量

java.io.FilenameFilter 1.0

  1. boolean accept(File dir, String name) //应该定义为在文件能够匹配过滤器标准时返回true

新 IO

内存映射文件

java.io.FileInputStream 1.0

  1. FileChannel getChannel() //返回用于访问这个流的通道

java.io.FileOutputStream 1.0

  1. FileChannel getChannel() //返回用于访问这个流的通道

java.io.RandomAccessFile 1.0

  1. FileChannel getChannel() //返回用于访问这个流的通道

java.nio.channels.FileChannel 1.4

  1. MappedByteBuffer map(FileChannel.MapMode mode, long position, long size) //将文件的一个区域映射到内存中

java.nio.Buffer 1.4

  1. boolean hasRemaining() //如果当前的缓冲区位置没有达到这个缓冲区的界限位置则返回true
  2. int limit() //返回这个缓冲区的界限位置

java.nio.ByteBuffer 1.4

  1. byte get() //从当前位置获得一个字节，并将当前位置推到下一个字节
  2. byte get(int index) //从指定索引处获得一个字节
  3. ByteBuffer put(byte b) //向当前位置推入一个字节，并将当前位置推到下一个字节，返回对这个缓冲区的引用
  4. ByteBuffer put(int index, byte b) //向指定索引处推入一个字节，返回对这个缓冲区的引用
  5. ByteBuffer get(byte[] destination)
  6. ByteBuffer get(byte[] destination, int offset, int length) //用缓冲区的字节来填充字节数组，或者字节数组的某个区域，并将当前位置向前推读入的字节数个位置，如果缓冲区不够，不会读入任何字节，并抛出BufferUnderflowException
  7. ByteBuffer put(byte[] source)
  8. ByteBuffer put(byte[] source, int offset, int length) //将字节数组中的所有字节或者给定区域的字节都推入缓冲区，并将当前位置向前推写出的字节数个位置
  9. Xxx getXxx()
  10. Xxx getXxx(int index)
  11. ByteBuffer putXxx(xxx value)
  12. ByteBuffer putXxx(int index, xxx value) //获得或放置一个二进制数
  13. ByteBuffer order(ByteOrder order)
  14. ByteOrder order() //设置或获得字节顺序，order的值是ByteOrder类的常量BIG_ENDIAN或LITTLE_ENDIAN中的一个

缓冲区数据结构

java.nio.Buffer 1.4

  1. Buffer clear() //通过将位置复位到0，并将界限复位到容量，使这个缓冲区为写出做好准备。返回this
  2. Buffer flip() //通过将界限设置为位置，并将位置复位到0，使这个缓冲区为读入做好准备，返回this
  3. Buffer rewind() //通过将读写位置复位到0，并保持极限不变，使这个缓冲区为重新读入相同的值做好准备，返回this
  4. Buffer mark() //将这个缓冲区的标记设置到读写位置，返回this
  5. Buffer reset() //将这个缓冲区的位置设置到标记，从而允许被标记的部分可以再次被读入或写出，返回this
  6. int remaining() //返回剩余可读入或可写出的值的数量，即界限与位置之间的差异
  7. int position() //返回这个缓冲区的位置
  8. int capacity() //返回这个缓冲区的容量

java.nio.CharBuffer 1.4

  1. char get()
  2. CharBuffer get(char[] destination)
  3. CharBuffer get(char[] destination, int offset, int length) //从这个缓冲区的位置处开始，获得一个char值，或者某个范围的char值，然后将位置向前推过所读入的字符，最后两个方法返回this
  4. CharBuffer put(char c)
  5. CharBuffer put(char[] source)
  6. CharBuffer put(char[] source, int offset, int length)
  7. CharBuffer put(String source)
  8. CharBuffer put(CharBuffer source) //从这个缓冲区的位置处开始，推入一个char值，或者某个范围的char值，然后将位置向前推过所写出的字符
  9. CharBuffer read(CharBuffer destination) //从这个缓冲区中获得char值，然后将它们推入目标缓冲区，直至达到目标缓冲区的界限

文件加锁机制

文件加锁机制是依赖于操作系统的

文件锁是由整个 Java 虚拟机持有的。如果有两个程序是由同一个虚拟机启动的，那么它们不可能每一个都获得一个在同一个文件上的锁，当调用 lock 和 tryLock 方法时，如果虚拟机已经在同一个文件上持有了另一个重叠的锁，那么这两个方法将抛出 OverlappingFileLockException

java.nio.channels.FileChannel 1.4

  1. FileLock lock() //在整个文件上获得一个独占的锁，这个方法将阻塞直至获得锁
  2. FileLock tryLock() //在整个文件上获得一个独占的锁，或者在无法获得锁的情况下返回null
  3. FileLock lock(long position, long size, boolean shared)
  4. FileLock tryLock(long position, long size, boolean shared) //在文件的一个区域上获得锁

java.nio.channels.FileLock 1.4

  1. void release() //释放这个锁

正则表达式

语法

  1. String patternString = "]*)\\s*>"

用法

  1. Pattern pattern = Pattern.compile(patternString);
  2. Matcher matcher = pattern.matcher(input);
  3. if (matcher.matches()) ...

java.util.regex.Pattern 1.4

  1. static Pattern compile(String expression)
  2. static Pattern compile(String expression, int flags) //把正则表达式字符串编译到一个用于快速处理匹配的模式对象中
  3. Matcher matcher(CharSequence input) //返回一个matcher对象，可以用它在输入定位模式的匹配
  4. String[] split(CharSequence input)
  5. String[] split(CharSequence input, int limit) //将输入分割成标号，其中模式指定了分隔符的形式

java.util.regex.Matcher 1.4

  1. boolean matches() //如果输入匹配模式，则返回true
  2. boolean lookingAt() //如果输入的开头匹配模式，则返回true
  3. boolean find()
  4. boolean find(int start) //尝试查找下一个匹配，找到返回true
  5. int start()
  6. int end() //返回当前匹配的开始索引和结尾之后的索引
  7. String group() //返回当前的匹配
  8. int groupCount() //返回输入模式中的群组数量
  9. int start(int groupIndex)
  10. int end(int groupIndex) //返回当前匹配中给定群组的开始和结尾之后的位置
  11. String group(int groupIndex) //返回匹配给定群组的字符串
  12. String replaceAll(String replacement)
  13. String replaceFirst(String replacement) //返回从匹配器输入获得的通过将所有匹配或第一个匹配用替换字符串替换之后的字符串
  14. Matcher reset()
  15. Matcher reset(CharSequence input) //复位匹配器的状态。第二个方法将使匹配器作用于另一个不同的输入，两个方法都返回this

第二章--XML----------------------------------------------

XML 文档

文档头

<?xml version="1.0" encoding="UTF-8"?>

文档类型定义（DTD，Document Type Definition）

<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN" "http:java.sun.com/j2ee/dtds/web-app_2_2.dtd">

通常属性只应该在修改值的解释时使用，而不是在指定值时使用

字符引用：&#233 （十进制）; &#xD9（十六进制）

实体引用：

	&lt; 小于
	&gt; 大于
	&amp; &
	&quot; 引号
	&apos; 省略号

CDATA 部分: 用和来限定其界限，可用来包含含有 <、>、&之类字符的字符串
处理指令：用限定界限
注释：用 <!-和--> 限定界限

解析 XML 文档

DOM（Document Object Model，文档对象模型）解析器：树型解析器

用于 XML 的简单 API（Simple API for XML, SAX)解析器：流机制解析器

读入一个 XML 文档

  1. DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
  2. DocumentBuilder builder = factory.newDocumentBuilder();
  3. File f = ...
  4. Document doc = builder.parse(f);

javax.xml.parsers.DocumentBuilderFactory 1.4

  1. static DocumentBuilderFactory newInstance() //返回DocumentBuilderFactory类的一个实例
  2. DocumentBuilder newDocumentBuilder() //返回DocumentBuilder类的一个实例

javax.xml.parsers.DocumentBuilder 1.4

  1. Document parse(File f)
  2. Document parse(String url)
  3. Document parse(InputStream in) //解析来自给定文件、URL或输入流的XML文档，返回解析后的文档

org.w3c.dom.Document 1.4

  1. Element getDocumentElement() //返回文档的根元素

org.w3c.dom.Element 1.4

  1. String getTagName() //返回元素的名字
  2. String getAttribute(String name) //返回给定名字的属性值，没有该属性时返回空字符串

org.w3c.dom.Node 1.4

  1. NodeList getChildNodes() //返回包含所有子元素节点的节点列表
  2. Node getFirstChild()
  3. Node getLastChild() //获取该节点的第一个或最后一个子节点，在该节点没有子节点时返回null
  4. Node getNextSibling()
  5. Node getPreviousSibling() //获取该节点的下一个或上一个兄弟节点，在该节点没有兄弟节点时返回null
  6. Node getParentNode() //获取该节点的父结点，在该节点是文档节点时返回null
  7. NamedNodeMap getAttributes() //返回含有描述该节点所有属性的Attr节点的映射表
  8. String getNodeName() //返回该节点的名字，当该结点是Attr节点时，该名字就是属性名
  9. String getNodeValue() //返回该节点的值，当该节点是Attr节点时，该值就是属性值

org.w3c.dom.CharacterData 1.4

  1. String getData() //返回存储在节点中的文本

org.w3c.dom.NodeList 1.4

  1. int getLength() //返回列表中的节点数
  2. Node item(int index) //返回给定索引号的节点

org.w3c.dom.NamedNodeMap 1.4

  1. int getLength() //返回该节点映射表中的节点数
  2. Node item(int index) //返回给定索引号的节点

验证 XML 文档

DTD

<!ELEMENT font (name,size)>

XML Schema （xsd 文件）

<xsd:element name="font">
	<xsd:sequence>
		<xsd:element name="name" type="xsd:string" />
		<xsd:element name="size" type="xsd:int" />
	</xsd:sequence>
</xsd:element>

文档类型定义：
将 DTD 纳入 XML 文档中

<?xml version="1.0"?>
<!DOCTYPE configuration [
	<!ELEMENT configuration ...>
	more rules
	...
]>
<configuration>
...
</configuration>

将 DTD 存储在外面

<!DOCTYPE configuration SYSTEM "config.dtd">

或者

<!DOCTYPE configuration SYSTEM "http://myserver.com/config.dtd">

如果使用 DTD 的相对 URL（比如"config.dtd"），需要给解析器一个文件或 URL 对象，而不是 InputStream，如果必须从一个输入流来解析，请提供一个实体渲染器
来源于 SGML 的用于识别“众所周知的”DTD 的机制，如

<!DOCTYPE web-app
  PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN" "http://java.sun.com/j2ee/dtds/web-app_2_2.dtd" >

如果使用的是 DOM 解析器，想要支持公共标识符，需要调用 DocumentBuilder 类的 setEntityResolver 方法来安装 EntityResolver 接口的某个实现类的一个对象，该接口只有一个方法：resolveEntity

ELEMENT 规则

E* 0 或多个 E
E+ 1 或多个 E
E？ 0 或 1 个 E
E1|E2|...|En E1, E2, ..., En 中的一个
E1, E2, ..., En E1 随后是 E2，...，En
#PCDATA 文本
(#PCDATA|E1|E2|...|En)* 0 或多个任意顺序的文本和 E1，E2，...，En（混合式内容）
ANY 允许任意子元素
EMPTY 不允许有子元素

元素的规范可以包含嵌套的和复杂的正则表达式，如

<!ELEMENT chapter (intro, (heading, (para | image | table | note)+)+)

描述合法元素属性的语法规则：

<!ATTLIST element attribute type default>

两个属性规范范例：

<!ATTLIST font style (plain|bold|italic|bold-italic) "plain">
<!ATTLIST size unit CDATA #IMPLIED>

使用 DTD 验证输入

  1. factory.setValidating(true);
  2. factory.setIgnoringElementContentWhitespace(true);

在验证时，应该安装一个错误处理器，即一个实现了 ErrorHandler 接口的对象

javax.xml.parsers.DocumentBuilder 1.4

  1. void setEntityResolver(EntityResolver resolver) //设置解析器，来定位要分析的XML文档中引用的实体
  2. void setErrorHandler(ErrorHandler handler) //设置报告解析过程中出现的错误和警告的处理器

org.xml.sax.EntityResolver 1.4

  1. public InputSource resolveEntity(String publicID, String systemID) //返回包含被指定ID引用数据的一个输入源，或者，当解析器不知道如何解析某个特定名字时，返回null。如果没有提供公共ID，那么参数publicID可以为null

org.xml.sax.InputSource 1.4

  1. InputSource(InputStream in)
  2. InputSource(Reader in)
  3. InputSource(String systemID) //根据流、读入器、或系统ID（通常是相对或绝对URL）构建输入源

org.xml.sax.ErrorHandler 1.4

  1. void fatalError(SAXParseException exception)
  2. void error(SAXParseException exception)
  3. void warning(SAXParseException exception) //覆盖这些方法以提供处理器，对致命错误、非致命错误和警告进行处理

org.xml.sax.SAXParseException 1.4

  1. int getLineNumber()
  2. int getColumnNumber() //返回引起异常的已处理的输入信息末尾的行号和列号

javax.xml.parsers.DocumentBuilderFactory 1.4

  1. boolean isValidating()
  2. void setValidating(boolean value) //获取和设置工厂的validating属性，当设为true时，工厂生成的解析器会验证它们的输入信息
  3. boolean isIgnoringElementContentWhiteSpace(boolean value) //获取和设置工厂的ignoringElementContentWhiteSpace属性，当设为true时，工厂生成的解析器会忽略没有混合内容（即元素与#PCDATA混合）的元素节点之间的空白

XML Schema

如果要在文档中引用 Schema 文件，需要在根元素中加上属性

<?xml version="1.0"?>
<configuration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:noNamespaceSchemaLocation="config.xsd">
...
</configuration>

解析带有 Schema 的 XML 文件和解析带有 DTD 的文件相似，但有 3 点差别：
//必须打开对命名空间的支持

factory.setNamespaceAware(true);

//必须执行如下步骤

final String JAXP_SCHEMA_LANGUAGE = "http://java.sun.com/xml/jaxp/properties/schemaLanguage";
final String W3C_XML_SCHEMA = "http://www.w3.org/2001/XMLSchema";
factory.setAttribute(JAXP_SCHEMA_LANGUAGE, W3C_XML_SCHEMA);

使用 XPath 来定位信息

XPath 表达式/configuration/database/username

使用 @ 操作符可以得到属性值，如

/gridbag/row[1]/cell[1]/@anchor

javax.xml.xpath.XPathFactory 5.0

  1. static XPathFactory newInstance() //返回XPathFactory实例来创建XPath对象
  2. XPath newXpath() //构建XPath对象来计算XPath表达式

javax.xml.xpath.XPath 5.0

  1. String evaluate(String expression, Object startingPoint) /从给定的起点计算表达式，起点可以是一个节点或节点列表，如果结果是一个节点或节点集，则返回的字符串包含所有文本节点子元素的数据
  2. Object evaluate(String expression, Object startingPoint, QName resultType) //从给定的起点计算表达式，起点可以是一个节点或节点列表。ResultType是XPathConstants类的常量STRING, NODE, NODESET, NUMBER或BOOLEAN之一

使用命名空间（URI）

HTTP URL 格式最常用

xmlns:alias="namespaceURI" 用于定义命名空间和别名

打开命名空间处理特性

  1. factory.setNamespaceAware(true);

由 getNodeName 和 getTagName 等方法返回带有别名前缀的限定名

org.w3c.dom.Node 1.4

  1. String getLocalName() //返回本地名（不带别名前缀），或者在解析器不支持命名空间时返回null
  2. String getNamespaceURI() //返回命名空间URI，或者在解析器不支持命名空间时返回null

javax.xml.parsers.DocumentBuilderFactory 1.4

  1. boolean isNamespaceAware()
  2. void setNamespaceAware(boolean value) //获取或设置工厂的namespaceAware属性

流机制解析器

使用 SAX 解析器（事件回调）

在使用 SAX 解析器时，需要一个处理器来定义不同的解析器事件的事件动作，ContentHandler 接口定义了若干个回调方法，如 startElement, endElement, characters, startDocument 和 endDocument

  1. SAXParserFactory factory = SAXParserFactory.newInstance();
  2. SAXParser parser = factory.newSAXParser();
  3. parser.parse(source, handler);

处理器属于 DefaultHandler 的一个子类，DefaultHandler 类为 4 个接口定义了空的方法：ContentHandler, DTDHandler, EntityResolver, ErrorHandler

javax.xml.parsers.SAXParserFactory 1.4

  1. static SAXParserFactory newInstance() //返回SAXParserFactory类的一个实例
  2. SAXParser newSAXParser() //返回SAXParser类的一个实例
  3. boolean isNamespaceAware()
  4. void setNamespaceAware(boolean value) //获取和设置工厂的namespaceAware属性
  5. boolean isValidating()
  6. void setValidating(boolean value) //获取和设置工厂的validating属性

javax.xml.parsers.SAXParser 1.4

  1. void parse(File f, DefaultHandler handler)
  2. void parse(String url, DefaultHandler handler)
  3. void parse(InputStream in, DefaultHandler handler) //解析来自给定文件、URL或输入流的XML文档，并把解析事件报告给指定的处理器

org.xml.sax.ContentHandler 1.4

  1. void startDocument()
  2. void endDocument()
  3. void startElement(String uri, String lname, String qname, Attributes attr)
  4. void endElement(String uri, String lname, String qname) //在元素的起始或结束时被调用
  5. void characters(char[] data, int start, int length) //解析器报告字符数据时被调用

org.xml.sax.Attributes 1.4

  1. int getLength() //返回存储在该属性集合中属性数量
  2. String getLocalName(int index) //返回给定索引的属性的本地名（无别名前缀），或当不支持命名空间特性时返回空字符串
  3. String getURI(int index) //返回给定索引的属性的命名空间URI
  4. String getQName(int index) //返回给定索引的属性的限定名
  5. String getValue(int index)
  6. String getValue(String qname)
  7. String getValue(String uri, String lname) //根据给定索引、限定名或命名空间URI+本地名，返回属性值，该值不存在时返回null

使用 StAX 解析器（提供解析事件的迭代器）

  1. InputStream in = url.openStream();
  2. XMLInputFactory factory = XMLInputFactory.newInstance();
  3. XMLStreamReader parser = factory.createXMLStreamReader(in);
  4. while (parser.hasNext()) {
  5. int event = parser.next();
  6. Call parser methods to obtain event details
  7. }

javax.xml.stream.XMLInputFactory 6

  1. static XMLInputFactory newInstance() //返回XMLInputFactory类的一个实例
  2. void setProperty(String name, Object value) //设置这个工厂的属性，或者在要设置的属性不支持设置成给定值时，抛出IllegalArgumentException
  3. XMLStreamReader createXMLStreamReader(InputStream in)
  4. XMLStreamReader createXMLStreamReader(InputStream in, String characterEncoding)
  5. XMLStreamReader createXMLStreamReader(Reader in)
  6. XMLStreamReader createXMLStreamReader(Source in) //创建一个从给定的流、阅读器或JAXP源读入的解析器

javax.xml.stream.XMLStreamReader 6

  1. boolean hasNext() //如果有另一个解析事件则返回true
  2. int next() //将解析器的状态设置为下一个解析事件，并返回下列常量之一：START_ELEMENT、CHARACTERS、START_DOCUMENT、END_DOCUMENT、CDATA、COMMENT、SPACE（可忽略的空白字符）、PROCESSING_INSTRUCTION、ENTITY_REFERENCE、DTD
  3. boolean isStartElement()
  4. boolean isEndElement()
  5. boolean isCharacters()
  6. boolean isWhiteSpace() //如果当前事件是一个开始元素、结束元素、字符数据或空白字符，返回true
  7. QName getName()
  8. String getLocalName() //获取在START_ELEMENT或END_ELEMENT事件中的元素的名字
  9. String getText() //返回一个CHARACTERS、COMMENT或CDATA事件，或一个ENTITY_REFERENCE的替换值，或者一个DTD的内部子集所对应的字符
  10. int getAttributeCount()
  11. QName getAttributeName(int index)
  12. String getAttributeLocalName(int index)
  13. String getAttributeValue(int index)
  14. String getAttributeValue(String namespaceURI, String name) //只要当前事件是START_ELEMENT，则获取给定属性的值，如果namespaceURI为null，则不检查名字空间

生成 XML 文档

用文档的内容构建一棵 DOM 树

  1. Document doc = builder.newDocument();
  2. Element rootElement = doc.createElement(rootName);
  3. Element childElement = doc.createElement(childName);
  4. Text textNode = doc.createTextNode(textContents);
  5. doc.appendChild(rootElement);
  6. rootElement.appendChild(childElement);
  7. childElement.appendChild(textNode);
  8. rootElement.setAttribute(name, value);

但是 DOM API 目前还不支持 DOM 树写到输出流，需要使用可扩展的格式页转换（XSLT) API

  1. //construct the "do nothing" transformation
  2. Transformer t = TransformerFactory.newInstance().newTransformer();
  3. //set output properties to get a DOCTYPE node
  4. t.setOutputProperty(OutputKeys.DOCTYPE_SYSTEM, systemIdentifier);
  5. t.setOutputProperty(OutputKeys.DOCTYPE_PUBLIC, publicIdentifier);
  6. //set indentation
  7. t.setOutputProperty(OutputKeys.INDENT, "yes");
  8. t.setOutputProperty(OutputKeys.METHOD, "xml");
  9. //apply the "do nothing" transformation and send the output to a file
  10. t.transform(new DOMSource(doc), new StreamResult(new FileOutputStream(file)));

javax.xml.parsers.DocumentBuilder 1.4

  1. Document newDocument() //返回一个空文档

org.w3c.dom.Document 1.4

  1. Element createElement(String name) //返回具有给定名字的元素
  2. Text createTextNode(String data) //返回具有给定数据的文本节点

org.w3c.dom.Node 1.4

  1. Node appendChild(Node child) //将一个节点附加到该节点的子节点列表，返回该节点

org.w3c.dom.Element 1.4

  1. void setAttribute(String name, String value) //将有给定名字的属性设置为指定的值
  2. void setAttributeNS(String uri, String qname, String value) //将带有给定命名空间URI和限定名的属性设置为指定的值

javax.xml.transform.TransformerFactory 1.4

  1. static TransformerFactory newInstance() //返回TransformerFactory类的一个实例
  2. transformer newTransformer() //返回Transformer类的一个实例，带有标识符或“无操作”的转换

javax.xml.transform.Transformer 1.4

  1. void setOutputProperty(String name, String value) //设置输出属性
  2. void transform(Source from, Result to) //转换一个XML文档

javax.xml.transform.dom.DOMSource 1.4

  1. DOMSource(Node n) //根据指定的节点构建一个源。通常，n是文档节点

javax.xml.transform.stream.StreamResult 1.4

  1. StreamResult(File f)
  2. StreamResult(OutputStream out)
  3. StreamResult(Writer out)
  4. StreamResult(String systemID)根据文件、流、写入程序或系统ID（通常是相对或绝对URL）来构建数据流结果

使用 StAX 写 XML 文档

  1. XMLOutputFactory factory = XMLOutputFactory.newInstance();
  2. XMLStreamWriter writer = factory.createXMLStreamWriter(out);
  3. writer.writeStartDocument();
  4. writer.writeStartElement(name);
  5. writer.writeAttribute(name, value);
  6. writer.writeCharacters(text);
  7. writer.writeEndElement();
  8. writer.writeEmptyElement(name);
  9. writer.writeEndDocument();

javax.xml.stream.XMLOutputFactory 6.

  1. static XMLOutputFactory newInstance() //返回这个XMLOutputFactory类的一个实例
  2. XMLStreamWriter createXMLStreamWriter(OutputStream in)
  3. XMLStreamWriter createXMLStreamWriter(OutputStream in, String characterEncoding)
  4. XMLStreamWriter createXMLStreamWriter(Writer in)
  5. XMLStreamWriter createXMLStreamWriter(Result in) //创建写入给定流、写出器和JAXP结果的写出器

javax.xml.stream.XMLStreamWriter 6

  1. void writeStartDocument()
  2. void writeStartDocument(String xmlVersion)
  3. void writeStartDocument(String encoding, String xmlVersion) //在文档的顶部写入XML处理指令
  4. void setDefaultNamespace(String namespaceURI)
  5. void setPrefix(String prefix, String namespaceURI)
  6. 设置默认的命名空间，或具有前缀的命名空间，作用域仅为当前元素
  7. void writeStartElement(String localName)
  8. void writeStartElement(String namespaceURI, String localName) //写出一个开始标签，其中namespaceURI将用相关联的前缀来代替
  9. void writeEndElement() //关闭当前元素
  10. void writeEndDocument() //关闭所有打开的元素
  11. void writeEmptyElement(String localName)
  12. void writeEmptyElement(String namespaceURI, String localName) //写出一个自闭合的标签
  13. void writeAttribute(String localName, String value)
  14. void writeAttribute(String namespaceURI, String localName, String value) //写出一个用于当前元素的属性
  15. void writeCharacters(String text) //写出字符数据
  16. void writeCData(String text) //写出CDATA块
  17. void writeDTD(String dtd) //写出dtd字符串，该字串需要包含一个DOCTYPE声明
  18. void writeComment(String comment) //写出一个注释
  19. void close() //关闭这个写出器

XSL 转换（XSLT）

典型模板：

<xsl:template match="/staff/employee">
  <tr><xsl:apply-templates/></tr>
</xsl:template>

处理属性值：

<xsl:template match="/staff/employee/hiredate">
  <td><xsl:value-of select="@year"/>-<xsl:value-of select="@month"/>-<xsl:value-of select="@day"/></td>
</xsl:template>

实现 XML 转换

  1. File styleSheet = new File(filename);
  2. StreamSource styleSource = new StreamSource(styleSheet);
  3. Transformer t = TransformerFactory.newInstance().newTransformer(styleSource);
  4. t.transform(source, result);

Source 接口有 3 个实现类：DOMSource, SAXSource, StreamSource

Result 接口有 3 个实现类：DOMResult，SAXResult，StreamResult

javax.xml.transform.TransformerFactory 1.4

  1. transformer newTransformer(Source stylesheet) //返回一个transformer类的实例，用来从指定的源中读取样式表

javax.xml.transform.stream.StreamSource 1.4

  1. StreamSource(File f)
  2. StreamSource(InputStream in)
  3. StreamSource(Reader in)
  4. StreamSource(String stystemID) //根据一个文件、流、阅读器或系统ID（通常是相对或绝对URL）来构建一个数据流源

javax.xml.transform.sax.SAXSource 1.4

  1. SAXSource(XMLReader reader, InputSource source) //构建一个SAX数据源，以便从给定输入源获取数据，并使用给定的阅读器来解析输入数据

org.xml.sax.XMLReader 1.4

  1. void setContentHandler(ContentHandler handler) //设置在输入被解析时会被告知解析事件的处理器
  2. void parse(InputSource source) //根据给定输入源解析输入数据，并将解析事件发送到内容处理器

javax.xml.transform.dom.DOMResult 1.4

  1. DOMResult(Node n) //根据给定结点构建一个数据源，通常n是一个新文档节点

org.xml.sax.helpers.AttributesImpl 1.4

  1. void addAtrribute(String uri, String lname, String qname, String type, String value) //将一个属性添加到该属性集合
  2. void clear() //删除属性集合中的所有属性

第三章--网络----------------------------------------------

套接字 Socket

套接字超时设置

java.net.Socket 1.0

  1. Socket(String host, int port) //构建一个套接字，用来连接给定的主机和端口
  2. InputStream getInputStream()
  3. OutputStream getOutputStream() //获取可以从套接字中读取数据的流，以及可以向套接字写出数据的流
  4. Socket() //创建一个还未被连接的套接字
  5. void connect(SocketAddress address) //将该套接字连接到给定的地址
  6. void connect(SocketAddress address, int timeoutInMilliSeconds) //将套接字连接到给定的地址，如果在给定的时间内没有响应，则返回
  7. void setSoTimeout(int timeoutInMilliseconds) //设置该套接字上读请求的阻塞时间，如果超出时间，则抛出一个InterruptedIOException异常
  8. boolean isConnected() //如果该套接字已被连接，则返回true
  9. boolean isClosed() //如果该套接字已被关闭，返回true

因特网地址

  1. InetAddress address = InetAddress.getByName("time-A.timefreq.bldrdoc.gov");
  2. byte[] addressBytes = address.getAddress();

java.net.InetAddress 1.0

  1. static InetAddress getByName(String host)
  2. static InetAddress[] getAllByName(String host) //为给定的主机名，创建一个InetAddress对象，或者一个包含了该主机名所对应的所有因特网地址的数组
  3. static InetAddress getLocalHost() //为本地主机创建一个InetAddress对象
  4. byte[] getAddress() //返回一个包含数字型地址的字节数组
  5. String getHostAddress() //返回一个由十进制数组成的字符串，各数字间用圆点符号隔开
  6. String getHostName() //返回主机名

实现服务器

  1. ServerSocket s = new ServerSocket(8189);
  2. Socket incoming = s.accept();
  3. InputStream inStream = incoming.getInputStream();
  4. OutputStream outStream = incoming.getOutputStream();
  5. Scanner in = new Scanner(inStream);
  6. PrintWriter out = new PrintWriter(outStream, true /* autoFlush */);
  7. out.println("Hello!Enter BYE to exit.“);
  8. String line = in.nextLine();
  9. out.println("Echo:" + line);
  10. if (line.trim().equals("BYE")) done = true;
  11. incoming.close();

java.net.ServerSocket 1.0

  1. ServerSocket(int port) //创建一个监控端口的服务器套接字
  2. Socket accept() //等待连接，阻塞当前线程直到建立连接为止
  3. void close() //关闭服务器套接字

为多个客户端服务

  1. while (true) {
  2. Socket incoming = s.accept();
  3. Runnable r = new ThreadedEchoHandler(incoming);
  4. Thread t = new Thread(r);
  5. t.start();
  6. }

半关闭

java.net.Socket 1.0

  1. void shutdownOutput() //将输出流设为“流结束”
  2. void shutdownInput() //将输入流设为“流结束”
  3. boolean isOutputShutdown() //如果输出已被关闭返回true
  4. boolean isInputShutdown() //如果输入已被关闭，返回true

可中断套接字

java.nio 包的特性：SocketChannel 类，通道（channel)没有相关联的流，需要调用 Buffer 对象来实现 ReadableByteChannel 和 WritableByteChannel 接口声明的 read 和 write 方法

  1. SocketChannel channel = SocketChannel.open(new InetSocketAddress(host, port));
  2. Scanner in = new Scanner(channel);
  3. OutputStream outStream = Channels.newOutputStream(channel);

如果线程发生中断，不会阻塞，而是会抛出异常

java.net.InetSocketAddress 1.4

  1. InetSocketAddress(String hostname, int port) //通过主机和端口参数创建一个地址对象，并在创建过程中解析主机名，如果主机名不能被解析，那么该地址对象的unresolved属性被设为true
  2. boolean isUnresolved() //如果不能解析该地址对象，返回true

java.nio.channels.SocketChannel 1.4

  1. static SocketChannel open(SocketAddress address) //打开一个套接字通道，并将其连接到远程地址

java.nio.channels.Channels 1.4

  1. static InputStream newInputStream(ReadableByteChannel channel) //创建一个输入流，用以从指定的通道读取数据
  2. static OutputStream newOutputStream(WritableByteChannel channel) //创建一个输出流，用以向指定的通道写入数据

发送 E-mail

  1. Socket s = new Socket("mail.yourserver.com", 25);
  2. PrintWriter out = new PrintWriter(s.getOutputStream));

信息规范：

HELO sending host
MAIL FROM: <sender e-mail address>
RCPT TO: <recipient e-mail address>
DATA
mail message
(any number of lines)
.
QUIT

SMTP 规范规定，每一行都要以\r 再紧跟一个\n 来结尾

建议 URL 连接

URL 和 URI

  1. URL url = new URL(urlString);
  2. InputStream inStream = url.openStream();
  3. Scanner in = new Scanner(inStream);

URI 句法：

[scheme:]schemeSpecificPart[#fragment]

一个分层 URI 的 schemeSpecificPart 具有以下结构：

[//authority][path][?query]

对基于服务器的 URI，authority 部分采用以下形式：

[user-info@]host[:port]

  1. relative = base.relativize(combined);
  2. combined = base.resolve(relative);

使用 URLConnection 获取信息

1. 调用 URL 类中的 openConnection 方法获得 URLConnection 对象

  1. URLConnection connection = url.openConnection()

2. 使用以下方法来设置任意的请求属性

  1. setDoInput
  2. setDoOutput
  3. setIfModifiedSince
  4. setUseCaches
  5. setAllowUserInteraction
  6. setRequestProperty
  7. setConnectTimeout
  8. setReadTimeout

3. 调用 connect 方法连接远程资源

  1. connection.connect();

4. 建立连接后，可以查询头信息

  1. getContentType
  2. getContentLength
  3. getContentEncoding
  4. getDate
  5. getExpiration
  6. getLastModified

5. 访问资源数据

  1. getInputStream

setRequestProperty 方法，设置“名-值”对

  1. String input = username + ":" + password;
  2. String encoding = base64Encode(input);
  3. connection.setRequestProperty("Authorization", "Basic " + encoding);

java.net.URL 1.0

  1. InputStream openStream() //打开一个用于读取资源数据的输入流
  2. URLConnection openConnection() //返回一个URLConnection对象，该对象负责管理与资源之间的连接

java.net.URLConnection 1.0

  1. void setDoInput() //如果doInput为true，那么用户可以接收来自该URLConnection的输入
  2. void setDoOutput(boolean doOutput)
  3. boolean getDoOutput(boolean doOutput) //如果doOutput为true，那么用户可以将输出发送到该URLConnection
  4. void setIfModifiedSince(long time)
  5. long getIfModifiedSince() //属性ifModifiedSince用于配置URLConnection对象，使它只获取那些自从某个给定时间以来被修改过的数据
  6. void setUseCaches(boolean useCaches)
  7. boolean getUseCaches() //如果useCaches为true，那么数据可以从本地缓存中得到，URLConnection本身并不维护这个缓存，缓存必须由浏览器之类的外部程序提供
  8. void setAllowUserInteraction(boolean allowUserInteraction)
  9. boolean getAllowUserInteraction() //如果为true，那么可以查询用户的口令
  10. void setConnectTimeout(int timeout)
  11. int getConnectionTimeout() //设置或得到连接超时时限
  12. void setRequestProperty(String key, String value) //设置请求头的一个字段
  13. Map<String, List<String>> getRequestProperties() //返回请求头属性的一个映射表，相同的键对应的所有值被放置在同一个映射表中
  14. void connect() //连接远程资源并获取响应头信息
  15. Map<String, List<String>> Map getHeaderFields() //返回响应的一个映射表，相同的键对应的所有值被放置在同一个映射表中
  16. String getHeaderFieldKey(int n) //得到响应头第n个字段的键，如果n等于0或大于响应头字段的总数返回null值
  17. String getHeaderField(int n) //得到响应头第n个字段的值
  18. int getContentLength() //如果知道内容长度，则返回该长度值，否则返回-1
  19. String getContentType() //获取内容的类型，比如text/plain或image/gif
  20. String getContentEncoding() //获取内容的编码，比如gzip
  21. long getDate()
  22. long getExpiration()
  23. long getLastModified() //获取创建日期、过期日以及最后一次被修改的日期
  24. InputStream getInputStream()
  25. OutputStream getOutputStream() //返回从资源读取信息或向资源写入信息的流
  26. Object getContent() //选择适当的内容处理器，以便读取资源数据并将它转换成对象。该方法不能用于读取诸如text/plain或image/gif之类的标准内容类型，除非安装了自己的内容处理器

提交表单数据

GET 和 POST 命令，向 Web 服务器发送信息

URL 编码模式编码，参数规则：

保留字符 A-Z、a-z、0-9 以及 . - * _

用 + 字符替换所有的空格

将其他所有字符编码为 UTF-8，并将每个字节都编码为 % 后面紧跟一个两位的十六进制数字

使用 POST 命令的方法：

  1. URL url = new URL("http://host/script");
  2. URLConnection connection = url.openConnection();
  3. connection.setDoOutput(true);
  4. PrintWriter out = new PrintWriter(connection.getOutputStream());
  5. out.print(name1 + "=" + URLEncoder.encode(value1, "UTF-8") + "&");
  6. out.print(name2 + "=" + URLEncoder.encode(value2, "UTF-8"));
  7. out.close();

java.net.HttpURLConnection 1.0

  1. InputStream getErrorStream() //返回一个流，通过这个流可以读取Web服务器的错误信息

java.net.URLEncoder 1.0

  1. static String encode(String s, String encoding) //采用指定的字符编码模式对字符串s进行编码，并返回它的URL编码形式

java.net.URLDecoder 1.2

  1. static String decode(String s, String encoding) //采用指定编码模式对已编码字符串s进行解码，并返回结果

第三章--数据库编程----------------------------------------------

JDBC 的典型用法

客户端（可视化表示） ---HTTP、RMI---> 中间层（业务逻辑） ---JDBC-数据库协议-> 数据库服务器

JDBC URL 一般语法：

jdbc:subprotocol:other stuff

注册驱动器类

Class.forName("org.postgresql.Driver");

或者

java -Djdbc.drivers=org.postgresql.Driver ProgramName

或者

System.setProperty("jdbc.drivers", "org.postgresql.Driver");

连接到数据库

  1. String url = "jdbc:postgresql:COREJAVA";
  2. String username = "dbuser";
  3. String password = "scret";
  4. Connection conn = DriverManager.getConnection(url, username, password);

java.sql.DriverManager 1.1

  1. static Connection getConnection(String url, String user, String password) //建立一个到指定数据库的连接，并返回一个Connection对象

执行 SQL 语句

java.sql.Connection 1.1

  1. Statement createStatement() //创建一个Statement对象，用以执行不带参数的SQL查询和更新
  2. void close() //用于立即关闭当前的连接以及释放由它所创建的JDBC资源

java.sql.Statement 1.1

  1. ResultSet executeQuery(String sqlQuery) //执行给定字符串中的SQL语句，并返回一个用于查看查询结果的ResultSet对象
  2. int executeUpdate(String sqlStatement) //执行字符串中指定的INSERT、UPDATE或DELETE等SQL语句，也可以执行CREATE TABLE等语句，返回受影响的记录总数
  3. boolean execute(String sqlStatement) //执行字符串中指定的SQL语句，可能会产生多个结果集和更新数。如果第一个执行结果是结果集，则返回true，反之返回false。调用getResultSet或getUpdateCount方法可以得到第一个执行结果
  4. ResultSet getResultSet() //返回前一条查询语句的结果集，如果前一条语句未产生结果集则返回null值，对于每一条执行过的语句，该方法只能被调用一次
  5. void close() //关闭Statement对象以及它所对应的结果集
  6. boolean isClosed() //如果语句被关闭返回true

java.sql.ResultSet 1.1

  1. boolean next() //将结果集中的当前行向前移动一行。如果已经到达最后一行的后面，返回false，注意初始情况必须调用该方法才能转到第一行
  2. Xxx getXxx(int columnNumber)
  3. Xxx getXxx(String columnName) //用给定的列序号或列标签返回该列的值，并将之转换成指定类型
  4. int findColumn(String columnName) //根据给定的列名，返回该列的序号
  5. void close() //立即关闭当前的结果集
  6. boolean isClosed() //如果语句被关闭，则返回true

管理连接、语句和结果集

分析 SQL 异常

每个 SQLException 都有一个由多个 SQLException 对象构成的链，这些对象可以通过 getNextException 方法获取

java.sql.SQLException 1.1

  1. SQLException getNextException() //返回链接到该SQL异常的下一个SQL异常，或者在到达链尾时返回null
  2. Iterator<Throwable> iterator() //获取迭代器，可以迭代链接的SQL异常和它们的成因
  3. String getSQLState() //获取“SQL状态”，即标准化的错误代码
  4. int getErrorCode() //获取提供商相关的错误代码

java.sql.Warning 1.1

  1. SQLWarning getNextWarning() //返回链接到该警告的下一个警告，或者在到达链尾时返回null

java.sql.Connection 1.1

java.sql.Statement 1.1

java.sql.ResultSet 1.1

  1. QLWarning getWarnings()
  2. SQLWarning getWarnings() //返回未处理警告中的第一个，或者在没有未处理警告时返回null

java.sql.DataTruncation 1.1

  1. boolean getParameter() //如果在参数上进行了数据截断，则返回true，如果在列上进行了数据截断返回false
  2. int getIndex() //返回被截断的参数和列的索引
  3. int getDataSize() //返回应该被传输的字节数量，或者在该值未知的情况下返回-1
  4. int getTransferSize() //返回实际被传输的字节数量，或者在该值未知的情况下返回-1

元数据

  1. ResultSet result = stat.getResultSet();
  2. ResultSetMetaData metaData = result.getMetaData();
  3. int columnCount = metaData.getColumnCount();
  4. metaData.getColumnLabel(i);

预备语句

占位符?

  1. PreparedStatement PublisherQueryStat = conn.prepareStatement(publisherQuery);
  2. publisherQueryStat.setString(1, publisher);
  3. ResultSet rs = publisherQueryStat.executeQuery();

java.sql.Connection 1.1

  1. PreparedStatement prepareStatement(String sql) //返回一个含预编译语句的PreparedStatement对象

java.sql.PreparedStatement 1.1

  1. void setXxx(int n, Xxx x) //设置第n个参数值为x
  2. void clearParameters() //清除预备语句中的所有当前参数
  3. ResultSet executeQuery() //执行预备SQL查询，并返回一个ResultSet对象
  4. int executeUpdate() //执行预备SQL语句INSERT UPDATE或DELETE，返回受影响的记录数，如果执行CREATE TABLE,返回0

读写 LOB

二进制大对象称为 BLOB，字符型大对象称为 CLOB

获取一张图像：

  1. PreparedStatement stat = conn.preapareStatement("SELECT Cover FROM BookCovers WHERE ISBN=?");

  2. stat.set(1, isbn);

  3. ResultSet result = stat.executeQuery();

  4. if (result.next()) {

  5. Blob coverBlob = result.getBlob(1);

  6. Image coverImage = ImageIO.read(coverBlob.getInputstream());

  7. }

存储一张图像：

  1. Blob coverBlob = connection.createBlob();
  2. int offset = 0;
  3. OutputStream out = coverBlob.setBinaryStream(offset);
  4. ImageIO.write(coverImage, "PNG", out);
  5. PreparedStatement stat = conn.prepareStatement("INSET INTO Cover VALUES (?, ?)");
  6. stat.set(1, isbn);
  7. stat.set(2, coverBlob);
  8. stat.executeUpdate();

java.sql.ResultSet 1.1

  1. Blob getBlob(int columnIndex)
  2. Blob getBlob(String columnLabel)
  3. Clob getClob(int columnIndex)
  4. Clob getClob(String columnLabel) //获取给定列的BLOB或CLOB

java.sql.Blob 1.2

  1. long length() //获取该BLOB的长度
  2. byte[] getBytes(long startPosition, long length) //获取该BLOB中给定范围的数据
  3. InputStream getBinaryStream()
  4. InputStream getBinaryStream(long startPosition, long length) //返回一个输入流，用于读取该BLOB中全部或给定范围的数据
  5. OutputStream setBinaryStream(long startPosition) //返回一个输出流，用于从给定位置开始写入该BLOB

java.sql.Clob 1.4

  1. long length() //获取该CLOB中的字符总数
  2. String getSubString(long startPosition, long length) //获取该CLOB中给定范围的字符
  3. Reader getCharacterStream()
  4. Reader getCharacterStream(long startPosition, long length) //返回一个读入器（而不是流），用于读取CLOB中全部或给定范围的数据
  5. Writer setCharacterStream(long startPosition) //返回一个写出器（而不是流），用于从给定位置开始写入该CLOB

java.sql.Connection 1.1

  1. Blob createBlob()
  2. Clob createClob() //创建一个空的BLOB或CLOB

SQL 转义

转义主要用于下列特性：

日期和时间字面常量

调用标量函数

调用存储过程

外连接

在 LIKE 子句中的转义字符

多结果集

遍历 execute 所有结果：

  1. boolean done = false;
  2. boolean isResult = stmt.execute(command);
  3. while (!done) {
  4. if (isResult) {
  5. ResultSet result = stmt.getResultSet();
  6. do something with result
  7. } else {
  8. int updateCount = stmt.getUpdateCount();
  9. if (updateCount >= 0)
  10. do something with updateCount
  11. else
  12. done = true;
  13. }
  14. isResult = stmt.getMoreResults();
  15. }

java.sql.Statement 1.1

  1. boolean getMoreResults() //获取该语句的下一个结果集，如果存在返回true

获取自动生成键

  1. stmt.executeUpdate(insertStatement, Statement.RETURN_GENERATED_KEYS);
  2. ResultSet rs = stmt.getGeneratedKeys();
  3. if (rs.next()) {
  4. int key = rs.getInt(1);
  5. ...
  6. }

java.sql.Statement 1.1

  1. boolean execute(String statement, int autogenerated)
  2. int executeUpdate(String statement, int autogenerated) //如果autogenerated被设置为Statement.RETURN_GENERATED_KEYS，并且该语句是一条INSERT语句，那么第一列中就是自动生成的键

可滚动和可更新的结果集

  1. Statement stat = conn.createStatement(type, concurrency);
  2. PreparedStatement stat = conn.prepareStatement(command, type, concurrency);

ResultSet 类的 type 值

| TYPE_FORWARD_ONLY | 结果集不能滚动 |
| TYPE_SCROLL_INSENSITIVE | 结果集可以滚动，但对数据库变化不敏感 |
| TYPE_SCROLL_SENSITIVE | 结果集可以滚动，且对数据库变化敏感 |

ResultSet 类的 Concurrency 值

| CONCUR_READ_ONLY | 结果集不能用于更新数据库 |
| CONCUR_UPDATE | 结果集可以用于更新数据库 |

需要用 getType 和 getConcurrency 方法先检查结果集的功能再使用，否则可能抛出 SQLException 异常

在结果集上的滚动

  1. if (rs.previous()) ...

将游标向后或向前移动多行

  1. rs.relative(n);

将游标设置到指定的行号上

  1. rs.absolute(n);
  2. int currentRow = rs.getRow();

获得可更新的结果集

  1. Statement stat = conn.createStatement(ResultSet.TYPE_SCROLL_INSENSITIVE, ResultSet.CONCUR_UPDATABLE);

迭代遍历所有结果并更新相关内容

  1. String query = "SELECT * FROM Books";
  2. ResultSet rs = stat.executeQuery(query);
  3. while (rs.next()) {
  4. if (...) {
  5. double increase = ...
  6. double price = rs.getDouble("Price");
  7. rs.updateDouble("Price", price + increase);
  8. rs.updateRow();
  9. }
  10. }

添加新行

  1. rs.moveToInsertRow();
  2. rs.updateString("Title", title);
  3. rs.updateString("ISBN", isbn);
  4. rs.updateString("Publisher_Id", pubid);
  5. rs.updateDouble("Price", price);
  6. rs.insertRow();
  7. rs.moveToCurrentRow();

删除行

  1. rs.deleteRow();

java.sql.Connection 1.1

  1. Statement createStatement(int type, int concurrency)
  2. PreparedStatement prepareStatement(String command, int type, int concurrency) //创建一个语句或预备语句，且该语句可以产生指定类型和并发模式的结果集

java.sql.ResultSet 1.1

  1. int getType() //返回结果集的类型
  2. int getConcurrency() //返回结果集的并发设置
  3. boolean previous() //把光标移动到前一行
  4. int getRow() //得到当前行的序号
  5. boolean absolute(int r) //移动光标到第r行
  6. boolean relative(int d) //将光标移动d行，如果d为负数，则光标向后移动，如果光标位于某一行上，返回true
  7. boolean first()
  8. boolean last() //移动光标到第一行或最后一行
  9. void beforeFirst()
  10. void afterLast() //移动光标到第一行之前或最后一行之后的位置
  11. boolean isFirst()
  12. boolean isLast() //测试光标是否在第一行或最后一行
  13. boolean isBeforeFirst()
  14. boolean isAfterLast() //测试光标是否在第一行之前或最后一行之后的位置
  15. void moveToInsertRow() //移动光标到插入行
  16. void moveToCurrentRow() //将光标从插入行移回到调用moveToInsertRow之前所在那一行
  17. void insertRow() //将插入行上的内容插入到数据库和结果集中
  18. void deleteRow() //从数据库和结果集中删除当前行
  19. void updateXxx(int column, Xxx data)
  20. void updateXxx(String columnName, Xxx data) //更新结果中当前行上的某个字段值
  21. void updateRow() //将当前行的更新信息发送到数据库
  22. void cancelRowUpdates() //撤销对当前行的更新

java.sql.DatabaseMetaData 1.1

  1. boolean supportsResultSetType(int type) //如果数据库支持给定类型的结果集，则返回true
  2. boolean supportsResultSetConcurrency(int type, int concurrency) //如果数据库支持给定类型和并发模式的结果集，则返回true

行集

CachedRowSet

WebRowSet

FilteredRowSet

JoinRowSet

JdbcRowSet

被缓存的行集

使用一个结果集来填充 CachedRowSet 对象

  1. ResultSet result = ...;
  2. CachedRowSet crs = new com.sun.rowset.CachedRowSetImpl();
  3. crs.populate(result);
  4. conn.close();

或者可以让 CachedRowSet 对象自动创建一个数据库连接并将查询结果填充到行集，最后断开连接

  1. crs.setURL("jdbc:derby://localhost:1527/COREJAVA");
  2. crs.setUsername("dbuser");
  3. crs.setPassword("secret");
  4. crs.setCommand("SELECT * FROM Books WHERE PUBLISHER = ?");
  5. crs.setString(1, publisherName);
  6. crs.execute();

指定每一页尺寸

  1. CachedRowSet crs = ...;
  2. crs.setCommand(command);
  3. crs.setPageSize(20);
  4. ...
  5. crs.execute();
  6. crs.nextPage();

将修改写回到数据库中

  1. crs.acceptChanges(conn);
  2. 或
  3. crs.acceptChanges(); //这个方法只有设置连接数据库所需信息才有效

javax.sql.RowSet 1.4

  1. String getURL()
  2. void setURL(String url) //获取或设置数据库的URL
  3. String getUsername()
  4. void setUsername(String username) //获取或设置连接数据库所需的用户名
  5. String getPassword()
  6. void setPassword(String password) //获取或设置连接数据库所需的密码
  7. String getCommand()
  8. void setCommand(String command) //获取或设置向行集中填充数据时需要执行的命令
  9. void execute() //通过执行使用setCommand方法设置的命令集来填充行集。为了使驱动管理器可以获得连接，必须事先设定URL、用户名和密码

javax.sql.rowset.CachedRowSet 5.0

  1. void execute(Connection conn) //通过执行使用setCommand方法设置的命令集来填充行集，该方法使用给定的连接，并负责关闭它
  2. void populate(ResultSet result) //将指定的结果集中的数据填充到被缓存的行集中
  3. String getTableName()
  4. void setTableName(String tableName) //获取或设置数据库表名称，填充被缓存的行集时所需的数据来自于该表
  5. int getPageSize()
  6. void setPageSize(int size) //获取和设置页的尺寸
  7. boolean nextPage()
  8. boolean previousPage() //加载下一页或上一页，如果要加载的页存在，返回true
  9. void acceptChanges()
  10. void acceptChanges(Connection conn) //重新连接数据库，并写回行集中修改过的数据，如果因为数据库中的数据已经被修改而导致无法写回行集中的数据，该方法可能会抛出SyncProviderException异常

元数据

描述数据库或其组成部分的数据称为元数据

获取数据库所有表名（第三列是表名）

  1. DatabaseMetaData meta = conn.getMetaData();
  2. ResultSet mrs = meta.getTables(null, null, null, new String[] {"TABLE"});
  3. while (mrs.next())
  4. tableNames.addItem(mrs.getString(3));

通过 ResultSetMetaData 提供结果集的相关信息，如每一列的名称、类型和字段宽度：

  1. ResultSet mrs = stat.executeQuery("SELECT * FROM " + tableName);
  2. ResultSetMetaData meta = mrs.getMetaData();
  3. for (int i = 1; i <= meta.getColumnCount(); i++) {
  4. String columnName = meta.getColumnLabel(i);
  5. int columnWidth = meta.getColumnDisplaySize(i);
  6. ...
  7. }

java.sql.Connection 1.1

  1. DatabaseMetaData getMetaData() //返回一个DatabaseMetaData对象，该对象封装了有关数据库连接的元数据

java.sql.DatabaseMetaData 1.1

  1. ResultSet getTables(String catalog, String schemaPattern, String tableNamePattern, String types[]) //返回某个目录中的所有表的描述，该目录必须符合给定的模式（schema）、表名字模式以及类型标准
  2. int getJDBCMajorVersion()
  3. int getJDBCMinorVersion() //返回建立数据库连接的JDBC驱动程序的主版本号和次版本号
  4. int getMaxConnections() //返回可同时连接到数据库的最大连接数
  5. int getMaxStatements() //返回单个数据库连接允许同时打开的最大语句数

java.sql.ResultSet 1.1

  1. ResultSetMetaData getMetaData() //返回与当前ResultSet对象中的列相关的元数据

java.sql.ResultSetMetaData 1.1

  1. int getColumnCount() //返回当前ResultSet对象中的列数
  2. int getColumnDisplaySize(int column) //返回给定列序号的列的最大宽度
  3. String getColumnLabel(int column) //返回该列所建议的名称
  4. String getColumnName(int column) //返回指定的列序号所对应的列名

事务

回滚（rollback）

默认为自动提交模式（autocommit mode）

  1. conn.setAutoCommit(false);
  2. Statement stat = conn.createStatement();
  3. stat.executeUpdate(command1);
  4. stat.executeUpdate(command2);
  5. ...
  6. conn.commit();
  7. 如果出现错误，请调用：
  8. conn.rollback();

保存点

  1. Statement stat = conn.createStatement(); //start transaction; rollback() goes here
  2. stat.executeUpdate(command1);
  3. Savepoint svpt = conn.setSavepoint(); //set savepoint; rollback(svpt) goes here
  4. stat.executeUpdate(command2);
  5. if (...) conn.rollback(svpt); //undo effect of command2
  6. ...
  7. conn.commit();
  8. conn.releaseSavepoint(svpt);

批量更新

使用 DatabaseMetaData 类中的 supportsBatchUpdates 方法可以获知数据库是否支持这种特性

可以是 INSERT、UPDATE、DELETE 等操作，也可以是 CREATE TABLE 和 DROP TABLE，但不可以是 SELECT 命令，会抛异常

  1. Statement stat = conn.createStatement();
  2. String command = "CREATE TABLE ...";
  3. stat.addBatch(command);
  4. while (...) {
  5. command = "INSERT INTO ... VALUES (" + ... + ")";
  6. stat.addBatch(command);
  7. }
  8. int[] counts = stat.executeBatch();

java.sql.Connection 1.1

  1. boolean getAutoCommit()
  2. void setAutoCommit(boolean b) //获取该连接中的自动提交模式，或将其设置为b
  3. void commit() //提交自上次提交以来所有执行过的语句
  4. void rollback() //撤销自上次提交以来所有执行过的语句所产生的影响
  5. Savepoint setSavepoint()
  6. Savepoint setSavepoint(String name) //设置一个匿名或具名的保存点
  7. void rollback(Savepoint svpt) //回滚到给定保存点
  8. void releaseSavepoint(Savepoint svpt) //释放给定的保存点

java.sql.Savepoint 1.4

  1. int getSavepointId() //获取该匿名保存点的ID号，如果有名字则抛出SQLException异常
  2. String getSavepointName() //获取该保存点的名称，如果为匿名保存点则抛出SQLException异常

java.sql.Statement 1.1

  1. void addBatch(String command) //添加命令到当前批量命令中
  2. int[] executeBatch() //执行当前批量更新中的所有命令，返回一个记录数的数组

java.sql.DatabaseMetaData 1.1

  1. boolean supportsBatchUpdates() //如果驱动程序支持批量更新，返回true

Web 与企业应用中的连接管理

通过目录接口（JNDI）查找

  1. Context jndiContext = new InitialContext();
  2. DataSource source = (DataSource) jndiContext.lookup("java:comp/env/jdbc/corejava");
  3. Connection conn = source.getConnection();

LDAP 介绍

轻量级目录访问协议（Lightweight Directory Access Protocol, LDAP）

通用的 LDAP 属性

| 属性 ID | 意义 |
| dc | 域构件 |
| cn | 通用名 |
| sn | 姓 |
| dn | 专有名称 |
| o | 组织 |
| ou | 组织单元 |
| uid | 唯一标识符 |

访问 LDAP 目录信息

  1. Hashtable env = new Hashtable();
  2. env.put(Context.SECURITY_PRINCIPAL, username);
  3. env.put(Context.SECURITY_CREDENTIALS, password);
  4. DirContext initial = new InitialDirContext(env);
  5. DirContext context = (DirContext) initial.lookup("ldap://localhost:389");

javax.naming.directory.InitialDirContext 1.3

  1. InitialDirContext(Hashtable env) //使用给定的环境设置创建一个目录上下文，散列表包含了Context.SECURITY_PRINCIPAL、Context.SECURITY_CREDENTIALS以及其他键的相关信息

javax.naming.Context 1.3

  1. Object lookup(String name) //使用给定的名称查找对象，返回通常为一棵子树或一个叶对象
  2. Context createSubcontext(String name) //使用给定的名字创建一个子上下文
  3. void destroySubcontext(String name) //根据给定的名称删除其对应的子上下文
  4. void close() //关闭该上下文

javax.naming.directory.DirContext 1.3

  1. Attributes getAttributes(String name) //根据给定的名称，得到其对应条目的属性
  2. void modifyAttributes(String name, int flag, Attributes modes) //根据给定的名称，修改其对应条目的属性，flag为以下常量之一：DirContext.ADD_ATTRIBUTE、DirContext.REMOVE_ATTRIBUTE或DirContext.REPLACE_ATTRIBUTE

javax.naming.directory.Attributes 1.3

  1. Attribute get(String id) //根据给定的ID，得到其对应的属性
  2. NamingEnumeration extends Attribute> getAll() //返回一个枚举对象，用于迭代遍历该属性的所有值
  3. Attribute put(Attribute attr)
  4. Attribute put(String id, Object value) //将一个属性添加到属性集合中

javax.naming.directory.BasicAttributes 1.3

  1. BasicAttributes(String id, Object value) //使用给定的ID和值，构造一个属性集合，该集合只包含了单个属性

javax.naming.directory.Attribute 1.3

  1. String getId() //获取该属性的ID
  2. Object get() //如果值已排好序，则获取该属性的第一个值，未排序则返回其中任意一个值
  3. NamingEnumeration getAll() //返回一个枚举对象，用于迭代遍历该属性的所有值

javax.naming.NamingEnumeration 1.3

  1. boolean hasMore() //如果该对象还包含其他元素，返回true
    T next() //返回下一个元素
  • Java

    Java 是一种可以撰写跨平台应用软件的面向对象的程序设计语言，是由 Sun Microsystems 公司于 1995 年 5 月推出的。Java 技术具有卓越的通用性、高效性、平台移植性和安全性。

    3168 引用 • 8207 回帖
1 回帖
741 13 128 143 48 64 63 257

相关帖子

1 回帖
读书笔记 --Java 核心技术 -- 高级特征

欢迎来到这里！

我们正在构建一个小众社区，大家在这里相互信任，以平等 • 自由 • 奔放的价值观进行分享交流。最终，希望大家能够找到与自己志同道合的伙伴，共同成长。

注册 关于
请输入回帖内容 ...
KioLuo
回帖
0
 帖子
12
 积分
505

近期热议

推荐标签 标签

  • 笔记

    好记性不如烂笔头。

    304 引用 • 777 回帖
  • 倾城之链
    23 引用 • 66 回帖 • 102 关注
  • 程序员

    程序员是从事程序开发、程序维护的专业人员。

    534 引用 • 3528 回帖 • 1 关注
  • Git

    Git 是 Linux Torvalds 为了帮助管理 Linux 内核开发而开发的一个开放源码的版本控制软件。

    205 引用 • 357 回帖
  • Spring

    Spring 是一个开源框架，是于 2003 年兴起的一个轻量级的 Java 开发框架，由 Rod Johnson 在其著作《Expert One-On-One J2EE Development and Design》中阐述的部分理念和原型衍生而来。它是为了解决企业应用开发的复杂性而创建的。框架的主要优势之一就是其分层架构，分层架构允许使用者选择使用哪一个组件，同时为 JavaEE 应用程序开发提供集成的框架。

    941 引用 • 1458 回帖 • 153 关注
  • InfluxDB

    InfluxDB 是一个开源的没有外部依赖的时间序列数据库。适用于记录度量，事件及实时分析。

    2 引用 • 55 关注
  • WebClipper

    Web Clipper 是一款浏览器剪藏扩展，它可以帮助你把网页内容剪藏到本地。

    3 引用 • 9 回帖 • 5 关注
  • Sublime

    Sublime Text 是一款可以用来写代码、写文章的文本编辑器。支持代码高亮、自动完成，还支持通过插件进行扩展。

    10 引用 • 5 回帖
  • 互联网

    互联网（Internet），又称网际网络，或音译因特网、英特网。互联网始于 1969 年美国的阿帕网，是网络与网络之间所串连成的庞大网络，这些网络以一组通用的协议相连，形成逻辑上的单一巨大国际网络。

    96 引用 • 330 回帖
  • OAuth

    OAuth 协议为用户资源的授权提供了一个安全的、开放而又简易的标准。与以往的授权方式不同之处是 oAuth 的授权不会使第三方触及到用户的帐号信息（如用户名与密码），即第三方无需使用用户的用户名与密码就可以申请获得该用户资源的授权，因此 oAuth 是安全的。oAuth 是 Open Authorization 的简写。

    36 引用 • 103 回帖 • 8 关注
  • 开源中国

    开源中国是目前中国最大的开源技术社区。传播开源的理念，推广开源项目，为 IT 开发者提供了一个发现、使用、并交流开源技术的平台。目前开源中国社区已收录超过两万款开源软件。

    7 引用 • 86 回帖 • 1 关注
  • LaTeX

    LaTeX（音译“拉泰赫”）是一种基于 ΤΕΧ 的排版系统，由美国计算机学家莱斯利·兰伯特（Leslie Lamport）在 20 世纪 80 年代初期开发，利用这种格式，即使使用者没有排版和程序设计的知识也可以充分发挥由 TeX 所提供的强大功能，能在几天，甚至几小时内生成很多具有书籍质量的印刷品。对于生成复杂表格和数学公式，这一点表现得尤为突出。因此它非常适用于生成高印刷质量的科技和数学类文档。

    9 引用 • 32 回帖 • 165 关注
  • 爬虫

    网络爬虫（Spider、Crawler），是一种按照一定的规则，自动地抓取万维网信息的程序。

    106 引用 • 275 回帖
  • gRpc
    10 引用 • 8 回帖 • 56 关注
  • 宕机

    宕机，多指一些网站、游戏、网络应用等服务器一种区别于正常运行的状态，也叫“Down 机”、“当机”或“死机”。宕机状态不仅仅是指服务器“挂掉了”、“死机了”状态，也包括服务器假死、停用、关闭等一些原因而导致出现的不能够正常运行的状态。

    13 引用 • 82 回帖 • 38 关注
  • 链书

    链书（Chainbook）是 B3log 开源社区提供的区块链纸质书交易平台，通过 B3T 实现共享激励与价值链。可将你的闲置书籍上架到链书，我们共同构建这个全新的交易平台，让闲置书籍继续发挥它的价值。

    链书社

    链书目前已经下线，也许以后还有计划重制上线。

    14 引用 • 257 回帖 • 5 关注
  • 持续集成

    持续集成（Continuous Integration）是一种软件开发实践，即团队开发成员经常集成他们的工作，通过每个成员每天至少集成一次，也就意味着每天可能会发生多次集成。每次集成都通过自动化的构建（包括编译，发布，自动化测试）来验证，从而尽早地发现集成错误。

    14 引用 • 7 回帖 • 2 关注
  • SVN

    SVN 是 Subversion 的简称，是一个开放源代码的版本控制系统，相较于 RCS、CVS，它采用了分支管理系统，它的设计目标就是取代 CVS。

    29 引用 • 98 回帖 • 692 关注
  • Postman

    Postman 是一款简单好用的 HTTP API 调试工具。

    4 引用 • 3 回帖 • 1 关注
  • IDEA

    IDEA 全称 IntelliJ IDEA，是一款 Java 语言开发的集成环境，在业界被公认为最好的 Java 开发工具之一。IDEA 是 JetBrains 公司的产品，这家公司总部位于捷克共和国的首都布拉格，开发人员以严谨著称的东欧程序员为主。

    180 引用 • 400 回帖
  • 百度

    百度（Nasdaq：BIDU）是全球最大的中文搜索引擎、最大的中文网站。2000 年 1 月由李彦宏创立于北京中关村，致力于向人们提供“简单，可依赖”的信息获取方式。“百度”二字源于中国宋朝词人辛弃疾的《青玉案·元夕》词句“众里寻他千百度”，象征着百度对中文信息检索技术的执著追求。

    63 引用 • 785 回帖 • 251 关注
  • sts
    2 引用 • 2 回帖 • 149 关注
  • Logseq

    Logseq 是一个隐私优先、开源的知识库工具。

    Logseq is a joyful, open-source outliner that works on top of local plain-text Markdown and Org-mode files. Use it to write, organize and share your thoughts, keep your to-do list, and build your own digital garden.

    4 引用 • 55 回帖 • 8 关注
  • NetBeans

    NetBeans 是一个始于 1997 年的 Xelfi 计划，本身是捷克布拉格查理大学的数学及物理学院的学生计划。此计划延伸而成立了一家公司进而发展这个商用版本的 NetBeans IDE，直到 1999 年 Sun 买下此公司。Sun 于次年（2000 年）六月将 NetBeans IDE 开源，直到现在 NetBeans 的社群依然持续增长。

    78 引用 • 102 回帖 • 643 关注
  • JSON

    JSON （JavaScript Object Notation）是一种轻量级的数据交换格式。易于人类阅读和编写。同时也易于机器解析和生成。

    51 引用 • 190 回帖
  • HTML

    HTML5 是 HTML 下一个的主要修订版本，现在仍处于发展阶段。广义论及 HTML5 时，实际指的是包括 HTML、CSS 和 JavaScript 在内的一套技术组合。

    103 引用 • 294 回帖
  • Solo

    Solo 是一款小而美的开源博客系统，专为程序员设计。Solo 有着非常活跃的社区，可将文章作为帖子推送到社区，来自社区的回帖将作为博客评论进行联动（具体细节请浏览 B3log 构思 - 分布式社区网络）。

    这是一种全新的网络社区体验，让热爱记录和分享的你不再感到孤单！

    1425 引用 • 10043 回帖 • 470 关注

最新标签