通用API

Posted 2020-06-14

第十五章 通用API

15.1　日志

15.1.1　日志API简介

1、java.util.logging包提供了日志功能相关类与接口，不必额外配置日志组件，就可在标准Java平台使用是其好处。使用日志的起点是Logger类，Logger类的构造函数标示为protected，不是java.util.logging同包的类不能直接以new创建，要取得Logger实例，必修使用Logger的静态方法getLogger()。

2、调用getLogger()时，必须指定Logger实例所属名称空间，名称空间以“.”作为层级区分，名称空间层级相同的Logger，其父Logger组态相同。
通常在哪个类中取得的Logger，名称空间就会命名为哪个类全名。 
取得Logger实例后，可以使用Lever的静态成员指定信息层级。

3、Logger是记录信息的起点，要输出的信息，必须先通过Logger的Lever与Filter过滤，在通过Handler的Lever与Filter过滤，格式化信息的动作交给Formatter，输出信息的动作实际上是Handler负责。

4、Logger有层级关系，名称空间层级相同的Logger，父Logger组态会相同，每个Logger处理完自己的日志动作后，会向父Logger传播，让父Logger也可以处理日志。

15.1.2　指定日志层级

1、Logger实例之父Logger组态，就是Logger.GLOBALLOGGERNAME名称空间Logger实例，可通过getLever()取得设定的Lever实例。

2、Logger的信息处理会往父Logger传播，在没有做任何组态设定的情况下，默认取得的Logger实例，层级必须大于或等于Logger.GLOBALLOGGERNAME名称空间Logger实例设定的Lever.INFO，才有可能输出信息。

3、通过setLever()设定Lever实例，若log()时指定的Lever实例内含的int值小于Logger设定的Lever实例内含的int值，Lever就不会记录信息。

4、在经过Logger过滤之后，还得再经过Handler的过滤，一个Logger可以拥有多个Handler，可通过Logger的addHandler()新增Handler实例。实际上进行信息输出时，目前Logger的Handler处理完，还会传播给父Logger的所有Handler处理，可通过getHandlers()方法取得目前已有的Handler实例数组。

5、在没有做任何组态设定的情况下，取得的Logger实例，只会使用Logger.GLOBALLOGGERNAME名词空间Logger实例拥有的Handler，默认是使用ConsoleHandler，为Handler的子类，作用是在控制台下输出日志信息，，默认地层级是Lever.INFO。

15.1.3　使用Handler与Formatter

1、负责日志输出的是Handler实例。

MemoryHandler不会格式化日志信息，信息会暂存于内存缓冲区，直到超过缓冲区大小，才将信息输出至指定的目标Handler。 
StreamHandler可自行指定信息输出时使用的OutputStream实例，它与子类都会使用指定Formatter格式化信息。 
ConsoleHandler创建时，会自动指定OutputStream为System.err，所以日志信息会显示在控制台。 
FileHandler创建时会建立日志输出时使用的FileOutputStream，文档位置与名称可以使用模式Pattern字符串指定。
SocketHandler创建时可以指定主机位置与端口，内部将自动建立网络联机，将日志信息传送至指定的主机。

2、Logger可以使用addHandler()新增Handler实例，使用removeHandler()移除Handler。

3、在创建FileHandler指定模式字符串：

使用“%h”来表示用户的根目录
使用“%t”取得系统暂存目录 
使用“%g”自动为文档编号
使用“%h/config%g.log”表示将configN.log文件存储在用户根目录下，N表示每个信息的文档编号，会自动递增。

4、FileHandler默认的Formatter是XMLFormatter； 
ConsoleHandler默认使用SimpleFormatter；这两个类是Formatter的子类，可以通过Handler的setFormatter()方法设定Formatter。

5、如果要以特定编码输出信息或存储文档，Handler有个setEncoding()方法，可以指定文字编码。

15.1.4　自定义Handler、Formatter与Filter

1、如果java.util.logging包中提供的Handler成果都不符合需求，可以继承Handler类，操作抽象方法publish()、flush()、close()方法来自定义Handler。

2、在职责分配上，Handler是负责输出，格式化是交由Formatter,而信息过滤是交给Filter。Handler有默认的isLoggable()操作，会先依据Level过滤信息，再使用指定的Filter过滤信息。 
format()方法会传入LogRecord，存储所有日志信息。

3、除了依据层级过滤之外，还可以加入额外过滤条件，，就可以操作Filter接口。

15.1.5　使用logging.properties

改变Logger对象的组态的方法：

(1)使用程序撰写方式 
(2)通过logging.properties来设定Logger组态。

15.2　国际化基础

15.2.1　使用ResourceBundle

1、本地化与国际化

本地化：应用程序根据不同地区用户、呈现不同语言、日期格式。 
国际化：应用程序设计时，可在不修改应用程序情况下，根据不同用户直接采用不同语言、日期格式等的设计考虑。

2、对于日后可能变动的文字信息，可以考虑将信息移至程序之外，方法是使用ResourceBundle来做信息绑定。ResourceBundle的静态getBundle()方法会取得一个ResourceBundle实例，所给定的自变量名称是信息文档的主文件名。

15.2.2　使用Locale

1、国际化的三个重要概念是地区信息、资源包、基础名称。

地区信息：代表了特定的地理、政治或文化区，可由一个语言编码与可选的地区编码来指定。其中语言编码是ISO-639定义，由两个小写字母代表。地区编码是由两个大写字母表示，定义在ISO-3166。 
地区信息：对应类是Locale。 
资源包：包括了特定地区的相关信息，ResourceBundle对象，就是JVM中资源包的代表对象。代表同一组信息单不同地区的各个资源包会共享相同的基础名称。 
基础名称：使用ResourceBundle的getBundle()时指定的名称，就是在指定基础名称。

2、建立一个message.zh_TW.properties，必须使用Unicode编码表示，则可以通过JDK工具程序native2ascii来协助转换。 
如果想将Unicode编码表示的.properties转回中文，则可以使用—reserve自变量。

3、使用ResourceBundle时，如何根据基础名称取得对应的信息文档：

（1）使用指定的Locale对象取得信息文档
（2）使用Locale.getDefault()取得的对象取得信息文档 
（3）使用基础名称取得信息文档。

15.3　规则表示式

15.3.1　规则表示式简介

规则表达式基本上包括两种字符：字面意义字符和元字符。

字面意义字符是指按照字面意义比较的字符； 
元字符时不按照字面比较，在不同情境有不同意义的字符。

1、字面意义字符

字母和数字在规则表达式中，都是按照字面意义比较，有些字符之前加上了\之后，会被当做元字符。

元字符在规则表达式中有特殊意义，如! $ ^ ( ) + = { } [ ] | \ : 。 ？等。如果不确定哪些标点符号字符要加上忽略字符，可以在每个标点符号前加上\。

可使用split()方法依\切割。 
例：规则表达式\|\|撰写为java字符串是“\|\|”。

2、字符类

规则表达式中，多个字符可以分归在一起，成为一个字符类。字符类会比较文字中是否有“任一个”字符符合字符类中某个字符。 
归类字符的方式之一是将字符放在[]中。

[]中的字符时“或”的意思，|在字符类中只是个字面意义字符，不会被当做“或”来表示。连字符-作为字符类元字符，表示一段文字范围。字符类中可以使用^作为字符类元字符，[^]则作为反字符类。

预定义字符类

. ：任一字符
\d：比较任一数字字符
\D：比较任一非数字字符
\s：比较任一空格符
\S：比较任一非空格符
\w：比较任一ASCII字符
\W：比较任一非ASCII字符

3、贪婪、逐步、独吐量词

贪婪量词：尽可能找出长度最长的符合文字 
逐步量词（在贪婪量词后加？）：尽可能找出长度最短的符合文字（懒惰量词、非贪婪量词） 
独吐量词（在贪婪量词后加+）：比较器看到独吐量词是，会先将剩余文字吃掉，然后看看独吐量词部分是否符合吃下的文字。

4、边界比较

边界比较用来表示文字必须符合指定的边界条件，也就是定位点，因此这类表示式也常称为锚点。

5、分组与参考

可以使用（）来将规则表达式分组，除了作为子规则表示式之外，还可以搭配量词使用。 
分组回头参考时，是在\后加上分组计数，表示参考第几个分组的比较结果。

15.3.2　Pattern与Matcher

1、java.util.regex.Pattern实例是规则表达式在JVM中的代表对象，Pattern的构造函数被标示为private，创建Pattern实例的方法是:

(1)通过Pattern的静态方法compile()来取得 
(2)指定旗标（Flag）——嵌入旗标表示法。

2、在取得Pattern实例后，可以使用的方法有：

split()方法:将指定字符串依规则表达式切割 
matcher()方法：指定要比较的字符串
find()方法：看看是不是有下一个符合字符串
lookingAt()：看看字符串开头是否符合规则表达式 
group()：可以返回符合的字符串。

3、在取得Matcher实例后，可以使用的方法有 ：

replaceAll()可以将符合规则表达式的部分以指定的字符串取代 
replaceFirst()取代首个组合规则表达式的部分
replaceEnd()取代最后符合规则表达式的部分 
start()方法可以取得符合字符串的初始索引 
end()方法可以取得符合字符串最后一个字符后的索引

15.4　JDK8 API增强功能

15.4.1　StringJoiner、Arrays新增API

1、String.join()、StringJoiner

JDK8中，String新增了join()静态方法可以直接使用，join()接受CharSequence操作对象，String是其中之一。

2、Arrays

在JDK8中，Arrays新增了parallelPrefix()、parallelSetAll()、parallelSort()方法。

parallelPrefix()方法科医院指定XXXBinaryOperator实例，执行类似Stream的reduce()方法。 
parallelSetAll()方法用来对数组进行初始化或全面重新设置每个索引元素。 
parallelSort()方法，可以将指定的数组分为子数组并以平行化当时分别排序。

15.4.2　Stream相关API

1、对数组进行管线化操作的方法:

(1)使用Arrays的asList()方法返回List，而后调用stream()方法取得Stream实例 (2)使用Arrays的stream()方法，可以指定数组后返回Stream实例。

2、CharSequence上新增了chars()和codePoints()犯法，都是返回intStream，前者代表一串字符的整数值，后者代表一串字符的的码点。

3、Math在JDK8中也新增了不少数学运行相关API，例如，multiPlluExact()、floorMod()、floorDiv()等。