Python——uuid

　　uuid模块在Python 2.5以后引入，接口包括：不可变对象UUID（UUID类）和函数uuid1()、uuid3()、uuid4()和uuid5()，后面的四个函数用于生成 RFC 4122 规范中指定的第1、3、4、5版UUID。使用uuid1()或uuid4()可以获得一个唯一的ID，uuid1()包含了主机的网络名称，uuid4()不涉及网络主机名，仅生成一个随机UUID，因此从隐私保护角度uuid4()更加安全。

class uuid.UUID([hex[, bytes[, bytes_le[, fields[, int[, version]]]]]])

　　该类用于从参数给定的内容中实例化UUID对象（hex, bytes, bytes_le, fields, int 必须且只能指定一个）：

　　hex：指定32个字符以创建UUID对象，当指定一个32个字符构成的字符串来创建一个UUID对象时，花括号、连字符和URN前缀等都是可选的；

　　bytes：指定一个大端字节序的总长16字节的字节串来创建UUID对象；

　　bytes_le：指定一个小端字节序的总长16字节的字节串来创建UUID对象；

　　fields：指定6个整数域，共计128位来创建UUID（其中，32位作为time_low段，16位作为time_mid段，16位作为time_hi_version段，8位作为clock_seq_hi_variant段，8位作为clock_seq_low段，48位作为node段）；

　　int：直接指定一个长度为128个二进制位的整数用于创建UUID对象；

　　version：（可选）指定UUID的版本，从1到5，一旦指定了该参数，生成的UUID将具有自己的变体（variant）和版本数，具体请参考RFC 4122，

例.

下面的各种方法创建相同的UUID对象，

u = UUID('{12345678-1234-5678-1234-567812345678}')
u = UUID(hex = '12345678123456781234567812345678')
u = UUID('urn:uuid:12345678-1234-5678-1234-567812345678')
u = UUID(bytes='\x12\x34\x56\x78'*4)
u = UUID(bytes_le='\x78\x56\x34\x12\x34\x12\x78\x56' +
              '\x12\x34\x56\x78\x12\x34\x56\x78')
u = UUID(fields=(0x12345678, 0x1234, 0x5678, 0x12, 0x34, 0x567812345678))
u = UUID(int=0x12345678123456781234567812345678)

UUID对象含有以下只读属性

UUID.bytes

　　以16个字节构成的字节串形式表示UUID，包含6个大端字节序的整数域；

>>> u.bytes
'\x124Vx\x124Vx\x124Vx\x124Vx'

　　

UUID.bytes_le

　　以16个字节构成的字节串形式表示UUID，包含6个小端字节序的整数域；

>>> u.bytes_le
'xV4\x124\x12xV\x124Vx\x124Vx'

　　

 UUID.fields 

　　以元组形式存放的UUID的6个整数域，该元组中的6个元素分别可以通过6个属性查看，还额外导出了两个属性（下面的每个域的名称也是UUID对象的一个属性）：

域	含义
time_low	UUID的初始32位
time_mid	接前一域的16位
time_hi_version	接前一域的16位
clock_seq_hi_variant	接前一域的8位
clock_seq_low	接前一域的8位
node	UUID的最后48位
time	UUID的总长60位的时间戳
clock_seq	14位的序列号

>>> u.fields
(305419896L, 4660L, 22136L, 18L, 52L, 95073701484152L)

 

 UUID.hex 

　　以32个字符表示的UUID

>>> u.hex
'12345678123456781234567812345678'

　　

 UUID.int 

　　以一个长度为128个二进制位的整数表示的UUID；

>>> u.int
24197857161011715162171839636988778104L

　　

 UUID.urn 

　　以 RFC 4122 中指定的URN形式表示的UUID；

>>> u.urn
'urn:uuid:12345678-1234-5678-1234-567812345678'

　　

 UUID.variant 

　　UUID变体（variant），决定UUID内部的布局，已有的值为 RESERVED_NCS、RFC_4122、RESERVED_MICROSOFT 或 RESERVED_FUTURE；

>>> u.variant
'reserved for NCS compatibility'

　　

 UUID.version 

　　UUID版本，只有当变体为 RFC_4122 时才有效。

>>> u.version
>>>

　　这里由于u.variant == 'reserved for NCS compatibility'，所以此处u.version为空。

　　

uuid模块还定义了如下函数

 

 uuid.getnode() 

　　获取硬件的地址并以48位二进制长度的正整数形式返回，这里所说的硬件地址是指网络接口的MAC地址，如果一个机器有多个网络接口，可能返回其中的任一个。如果获取失败，将按照RFC 4122的规定将随机返回的48位二进制整数的第8位设置成1。

>>> uuid.getnode()
152667293855L

　　

 uuid.uuid1([node[, clock_seq]]) 

　　利用主机ID、序列号和当前时间生成一个UUID，如果参数 node 没有给定，会调用 getnode() 来获取硬件地址。如果参数中指定了 clock_seq ，使用参数中给定的时钟序列作为序列号，否则使用一个随机的14位长的序列号。

>>> uuid.uuid1()
UUID('a89e9d00-a710-11e4-a84a-00238bae089f')

　　

 uuid.uuid3(namespace, name) 

　　基于命名空间标识符（实质上是一个UUID）和一个名称（实质上是一个字符串）的MD5哈希值生成UUID。

　　

 uuid.uuid4() 

　　生成一个随机的UUID

>>> uuid4()
UUID('b9f9fb88-49f3-4cea-9885-19e57c3572c6')

　　

 uuid.uuid5(namespace, name) 

　　基于命名空间标识符（实质上是一个UUID）和一个名称（实质上是一个字符串）的SHA-1哈希值生成UUID

　　

关于uuid3()和uuid5()中提到的命名空间标识符，uuid模块定义了如下的备选项

 uuid.NAMESPACE_DNS 

　　当指定该命名空间时，参数 name 是一个完全限定的（fully-qualified）域名

　　

 uuid.NAMESPACE_URL 

　　当指定该命名空间时，参数 name 是一个URL

　　

 uuid.NAMESPACE_OID 

　　当指定该命名空间时，参数 name 是一个ISO OID

　　

 uuid.NAMESPACE_X500 

　　当指定该命名空间时，参数 name 是一个DER格式或文本格式的X.500 DN。

　　

关于属性variant，uuid模块定义了如下的常量

　　

 uuid.RESERVED_NCS 

　　该常量为兼容NCS而保留；

　　

 uuid.RFC_4122 

　　按照 RFC 4122 的规定来确定UUID的布局；

　　

 uuid.RESERVED_MICROSOFT 

　　该常量位兼容微软而保留

 　　

 uuid.RESERVED_FUTURE 

　　该常量为未来可能的定义保留

可以在Python中查看这些常量：

>>> uuid.RESERVED_NCS
'reserved for NCS compatibility'
>>> uuid.RFC_4122
'specified in RFC 4122'
>>> uuid.RESERVED_MICROSOFT
'reserved for Microsoft compatibility'
>>> uuid.RESERVED_FUTURE
'reserved for future definition'