概述

Java的原生类型是其基础数据类型：
byte short int long
float double char boolean

在查找一个Guava的方法前，应该先在Arrays或相关JDK的包装类型中查找，例如，Integer。

这些类型不能用作对象或泛型的类型参数，这意味着很多通用的工具与它们不兼容。Guava在原生类型和集合API之间提供了一些通用的工具类、方法和接口，把特定类型转换为byte数组，并且支持特定类型的无符号操作。

Bytes中有符号和无符号的字节的方法的不同之处在于字节被忽略，目前仅适用于SignedBytes和UnsignedBytes，因为有符号的字节比其他有符号的类型更加xxxx。

int和long的无符号类型的变体是UnsignedInts和UnsignedLongs，因为它们的大多数使用场景是有符号的，Ints和Longs默认将输入的参数作为有符号的。

另外，Guava还为int和long提供了无符号的包装类型UnsignedInteger, UnsignedLong，它为类型系统区别有无符号提供了支持（以一点性能损失作为代价），这些类直接支持简单的数学运算（类似BigInteger）。

所有方法的签名使用Wrapper来引用相关的JDK包装类型，Prim来引用原生类型（Prims引用相关Guava的工具类）

原生数组工具

原生数组是原生类型最有效率（内存和性能）的聚合。Guava提供了一系列这方面的工具：

Sign-independent方法包括：Bytes, Shorts, Ints, Longs, Floats, Doubles, Chars, Booleans。不包括：UnsignedInts, UnsignedLongs, SignedBytes, UnsignedBytes。

Sign-dependent方法包括：SignedBytes, UnsignedBytes, Shorts, Ints, Longs, Floats, Doubles, Chars, Booleans, UnsignedInts, UnsignedLongs。不包括Bytes。

通用工具方法

Guava提供了一系列JDK6没有的方法，其中有一些在JDK7中已经提供。
签名 | 描述 | 适用范围
—- | —- | —-
int compare(prim a, prim b) | 原生类型的比较器，已在JDK7的包装类中提供 | Sign-dependent
prim checkedCast(long value) | 把指定值转换成prim，如果不能转换则抛出IllegalArgumentException | Sign-dependent for integral types only
prim saturatedCast(long value) | 把指定值转换成prim，如果不能转换则返回最近的prim值

这里的integral types包括：byte, short, int, long。不包括：char, boolean, float, double。

注意：double的近似值是在com.google.common.math.DoubleMath包中提供，且包含很多不同的舍入模式，详情查看这里.md)。

字节转换方法

Guava提供了使用大端序（big-endian）将原生类型转换为字节数组或字节数组转换为原生类型的方法。所有方法都是Sign-independent的（Booleans未提供这些方法所以除外）。

无符号支持

UnsignedInts和UnsignedLongs工具类提供了一些通用方法，这些方法是Java通过包装类给有符号类型提供的方法。UnsignedInts和UnsignedLongs直接和原生类型交互：确认传入这些方法的都是无符号类型。

另外，对于int和long，Guava提供了”无符号的”包装类型（UnsignedInteger和UnsignedLong）来确保在类型系统中无符号和有符号值的重复问题，当然，有一点性能上的损耗。

通用方法

下面这些方法的有符号版本已经在JDK的包装类中有相应的实现（这里仅是无符号的方法）：

包装

通过无符号类型的包装可以让使用和转换更加方便。