Guava（八）

目录

【原生类型】
    Java原生类型就是指8中基本类型：byte、short、int、long、float、double、char和boolean。
    原生类型不能当作对象或泛型的类型参数使用，就意味着许多通用方法都不能应用于它们。Guava提供了若干通用工具，包括原生类型数组与集合API的交互，原生类型和字节数组的相互转换，以及对某些原生类型的无符号形式的支持。

原生类型	Guava工具类
byte	Bytes, SignedBytes, UnsignedBytes
short	Shorts
int	Ints, UnsignedInteger, UnsignedInts
long	Longs, UnsignedLong, UnsignedLongs
float	Floats
double	Doubles
char	Chars
boolean	Booleans

注：
● Bytes工具类没有定义任何区分有符号和无符号字节的方法，而是把它们都放到了 SignedBytes和 UnsignedBytes类中，因为字节类型的符号性比其他类型要略微含糊一些。
● int和long的无符号类型在 UnsignedInts和 UnsignedLongs类中，但由于这两个类型的大多数用法都是有符号的，因此将 Ints和 Longs按照有符号形式处理方法的输入参数，以外还提供了int和long的无符号形式的包装类，UnsignedInteger和 UnsignedLong，以极小的性能消耗对有符号和无符号值进行强制转换。
● 建议在从Guava查找原生类型方法之前，先查找 Arrays类或 原生类型对应的包装类。

在本章下面描述的方法签名中，我们用Wrapper表示JDK包装类，Prims表示原生类型。

一、原生类型数组工具

方法名	说明	是否与符号相关
List asList(prim…)	将数组转为对应包装类的List	否
prim[] toArray(Collection)	将集合拷贝为数组	否
prim[] concat(prim[]…)	串联多个数组	否
boolean contains(prim[], prim)	数组中是否包含给定值	否
int indexOf(prim[], prim)	给定值在数组中首次出现的索引，若不存在返回-1	否
int lastIndexOf(prim[], prim)	给定值在数组中最后出现的索引，若不存在返回-1	否
prim min(prim…)	查找最小值	是
prim man(prim…)	查找最大值	是
String join(String, prim…)	数组按给定分隔符拼接为字符串	是
Comparator<prim[]> lexicographicalComparator()	按字典顺序比较数组	是

注：与符号无关方法存在于Bytes, Shorts, Ints, Longs, Floats, Doubles, Chars, Booleans中；与符号相关方法除 Bytes外都存在。

二、通用工具方法

原生类型	Guava工具类	可用性
int compare(prim, prim)	传统的compare，JDK7已有	符号相关
prim checkedCast(long)	将给定long转为某一原生类型，若不符合抛出IllegalArgumentException	仅用于符号相关的整型
prim saturatedCast(long)	将给定long转为某一原生类型，若不符合则使用最接近的值	仅用于符号相关的整型

三、字节转换方法

方法	说明
int BYTES	常量：表示该原生类型需要的字节数
prim fromByteArray(byte[])	使用字节数组的前Prims.BYTES个字节，按大字节序返回原生类型值；如果bytes.length <= Prims.BYTES，抛出IAE
prim fromBytes(byte…, byte)	接受Prims.BYTES个字节参数，按大字节序返回原生类型值
byte[] toByteArray(prim)	按大字节序返回value的字节数组

四、无符号通用工具方法
    以下方法存在于 UnsignedInts和 UnsignedLongs中

方法	说明
int/long parseUnsignedInt(String)/parseUnsignedLong(String)	按无符号十进制解析字符串
int/long parseUnsignedInt(String, int)/parseUnsignedLong(String, int)	按无符号的特定进制解析字符串
String toString(int)/toString(long)	数字按无符号十进制转为字符串
String toString(int, int)/toString(long, int)	数字按无符号特定进制转为字符串

五、无符号包装类
    以下方法存在于 UnsignedInteger和 UnsignedLong中，返回类型 UnsignedPrim指无符号包装类。

方法	说明
UnsignedPrim plus(UnsignedPrim)、minus、times、dividedBy、mod	算数运算（加减乘除余）
UnsignedPrim valueOf(BigInteger)	按给定BigInteger返回无符号对象，若BigInteger为负或不匹配，抛出IllegalArgumentException
UnsignedPrim valueOf(long)	按给定long返回无符号对象，若long为负或不匹配，抛出IllegalArgumentException
BigInteger bigIntegerValue()	用BigInteger返回该无符号对象的值
toString(), toString(int radix)	返回无符号值的字符串表示