OrderedTimeCodecTest.php 8.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253
  1. <?php
  2. declare(strict_types=1);
  3. namespace Ramsey\Uuid\Test\Codec;
  4. use Mockery;
  5. use PHPUnit\Framework\MockObject\MockObject;
  6. use Ramsey\Uuid\Builder\DefaultUuidBuilder;
  7. use Ramsey\Uuid\Builder\UuidBuilderInterface;
  8. use Ramsey\Uuid\Codec\OrderedTimeCodec;
  9. use Ramsey\Uuid\Converter\Number\GenericNumberConverter;
  10. use Ramsey\Uuid\Converter\NumberConverterInterface;
  11. use Ramsey\Uuid\Converter\Time\GenericTimeConverter;
  12. use Ramsey\Uuid\Converter\TimeConverterInterface;
  13. use Ramsey\Uuid\Exception\InvalidArgumentException;
  14. use Ramsey\Uuid\Exception\UnsupportedOperationException;
  15. use Ramsey\Uuid\Math\BrickMathCalculator;
  16. use Ramsey\Uuid\Nonstandard\Fields as NonstandardFields;
  17. use Ramsey\Uuid\Nonstandard\UuidBuilder;
  18. use Ramsey\Uuid\Rfc4122\Fields;
  19. use Ramsey\Uuid\Test\TestCase;
  20. use Ramsey\Uuid\Uuid;
  21. use Ramsey\Uuid\UuidFactory;
  22. use Ramsey\Uuid\UuidInterface;
  23. use function hex2bin;
  24. use function pack;
  25. use function serialize;
  26. use function str_replace;
  27. use function unserialize;
  28. class OrderedTimeCodecTest extends TestCase
  29. {
  30. /**
  31. * @var UuidBuilderInterface & MockObject
  32. */
  33. private $builder;
  34. /**
  35. * @var UuidInterface & MockObject
  36. */
  37. private $uuid;
  38. /**
  39. * @var Fields
  40. */
  41. private $fields;
  42. /**
  43. * @var string
  44. */
  45. private $uuidString = '58e0a7d7-eebc-11d8-9669-0800200c9a66';
  46. /**
  47. * @var string
  48. */
  49. private $optimizedHex = '11d8eebc58e0a7d796690800200c9a66';
  50. protected function setUp(): void
  51. {
  52. parent::setUp();
  53. $this->builder = $this->getMockBuilder(UuidBuilderInterface::class)->getMock();
  54. $this->uuid = $this->getMockBuilder(UuidInterface::class)->getMock();
  55. $this->fields = new Fields((string) hex2bin('58e0a7d7eebc11d896690800200c9a66'));
  56. }
  57. protected function tearDown(): void
  58. {
  59. parent::tearDown();
  60. unset($this->builder, $this->uuid, $this->fields);
  61. }
  62. public function testEncodeUsesFieldsArray(): void
  63. {
  64. $this->uuid->expects($this->once())
  65. ->method('getFields')
  66. ->willReturn($this->fields);
  67. $codec = new OrderedTimeCodec($this->builder);
  68. $codec->encode($this->uuid);
  69. }
  70. public function testEncodeReturnsFormattedString(): void
  71. {
  72. $this->uuid->method('getFields')
  73. ->willReturn($this->fields);
  74. $codec = new OrderedTimeCodec($this->builder);
  75. $result = $codec->encode($this->uuid);
  76. $this->assertSame($this->uuidString, $result);
  77. }
  78. public function testEncodeBinary(): void
  79. {
  80. $expected = hex2bin($this->optimizedHex);
  81. $numberConverter = Mockery::mock(NumberConverterInterface::class);
  82. $timeConverter = Mockery::mock(TimeConverterInterface::class);
  83. $builder = new DefaultUuidBuilder($numberConverter, $timeConverter);
  84. $codec = new OrderedTimeCodec($builder);
  85. $factory = new UuidFactory();
  86. $factory->setCodec($codec);
  87. $uuid = $factory->fromString($this->uuidString);
  88. $this->assertSame($expected, $codec->encodeBinary($uuid));
  89. }
  90. public function testDecodeBytesThrowsExceptionWhenBytesStringNotSixteenCharacters(): void
  91. {
  92. $string = '61';
  93. $bytes = pack('H*', $string);
  94. $codec = new OrderedTimeCodec($this->builder);
  95. $this->expectException(\InvalidArgumentException::class);
  96. $this->expectExceptionMessage('$bytes string should contain 16 characters.');
  97. $codec->decodeBytes($bytes);
  98. }
  99. public function testDecodeReturnsUuidFromBuilder(): void
  100. {
  101. $string = 'uuid:58e0a7d7-eebc-11d8-9669-0800200c9a66';
  102. $this->builder->method('build')
  103. ->willReturn($this->uuid);
  104. $codec = new OrderedTimeCodec($this->builder);
  105. $result = $codec->decode($string);
  106. $this->assertSame($this->uuid, $result);
  107. }
  108. public function testDecodeBytesRearrangesFields(): void
  109. {
  110. $bytes = (string) hex2bin($this->optimizedHex);
  111. $calculator = new BrickMathCalculator();
  112. $numberConverter = new GenericNumberConverter($calculator);
  113. $timeConverter = Mockery::mock(TimeConverterInterface::class);
  114. $builder = new DefaultUuidBuilder($numberConverter, $timeConverter);
  115. $codec = new OrderedTimeCodec($builder);
  116. $factory = new UuidFactory();
  117. $factory->setCodec($codec);
  118. $expectedUuid = $factory->fromString($this->uuidString);
  119. $uuidReturned = $codec->decodeBytes($bytes);
  120. $this->assertTrue($uuidReturned->equals($expectedUuid));
  121. }
  122. public function testEncodeBinaryThrowsExceptionForNonRfc4122Uuid(): void
  123. {
  124. $nonRfc4122Uuid = '58e0a7d7-eebc-11d8-d669-0800200c9a66';
  125. $fields = new NonstandardFields((string) hex2bin(str_replace('-', '', $nonRfc4122Uuid)));
  126. $numberConverter = Mockery::mock(NumberConverterInterface::class);
  127. $timeConverter = Mockery::mock(TimeConverterInterface::class);
  128. $builder = new DefaultUuidBuilder($numberConverter, $timeConverter);
  129. $codec = new OrderedTimeCodec($builder);
  130. $uuid = Mockery::mock(UuidInterface::class, [
  131. 'getVariant' => 0,
  132. 'toString' => $nonRfc4122Uuid,
  133. 'getFields' => $fields,
  134. ]);
  135. $this->expectException(InvalidArgumentException::class);
  136. $this->expectExceptionMessage(
  137. 'Expected RFC 4122 version 1 (time-based) UUID'
  138. );
  139. $codec->encodeBinary($uuid);
  140. }
  141. public function testEncodeBinaryThrowsExceptionForNonTimeBasedUuid(): void
  142. {
  143. $nonTimeBasedUuid = '58e0a7d7-eebc-41d8-9669-0800200c9a66';
  144. $numberConverter = Mockery::mock(NumberConverterInterface::class);
  145. $timeConverter = Mockery::mock(TimeConverterInterface::class);
  146. $builder = new DefaultUuidBuilder($numberConverter, $timeConverter);
  147. $codec = new OrderedTimeCodec($builder);
  148. $factory = new UuidFactory();
  149. $factory->setCodec($codec);
  150. $uuid = $factory->fromString($nonTimeBasedUuid);
  151. $this->expectException(InvalidArgumentException::class);
  152. $this->expectExceptionMessage(
  153. 'Expected RFC 4122 version 1 (time-based) UUID'
  154. );
  155. $codec->encodeBinary($uuid);
  156. }
  157. public function testDecodeBytesThrowsExceptionsForNonRfc4122Uuid(): void
  158. {
  159. $nonRfc4122OptimizedHex = '11d8eebc58e0a7d716690800200c9a66';
  160. $bytes = (string) hex2bin($nonRfc4122OptimizedHex);
  161. $calculator = new BrickMathCalculator();
  162. $numberConverter = new GenericNumberConverter($calculator);
  163. $timeConverter = new GenericTimeConverter($calculator);
  164. $builder = new UuidBuilder($numberConverter, $timeConverter);
  165. $codec = new OrderedTimeCodec($builder);
  166. $this->expectException(UnsupportedOperationException::class);
  167. $this->expectExceptionMessage(
  168. 'Attempting to decode a non-time-based UUID using OrderedTimeCodec'
  169. );
  170. $codec->decodeBytes($bytes);
  171. }
  172. public function testDecodeBytesThrowsExceptionsForNonTimeBasedUuid(): void
  173. {
  174. $nonTimeBasedOptimizedHex = '41d8eebc58e0a7d796690800200c9a66';
  175. $bytes = (string) hex2bin($nonTimeBasedOptimizedHex);
  176. $numberConverter = Mockery::mock(NumberConverterInterface::class);
  177. $timeConverter = Mockery::mock(TimeConverterInterface::class);
  178. $builder = new DefaultUuidBuilder($numberConverter, $timeConverter);
  179. $codec = new OrderedTimeCodec($builder);
  180. $factory = new UuidFactory();
  181. $factory->setCodec($codec);
  182. $this->expectException(UnsupportedOperationException::class);
  183. $this->expectExceptionMessage(
  184. 'Attempting to decode a non-time-based UUID using OrderedTimeCodec'
  185. );
  186. $codec->decodeBytes($bytes);
  187. }
  188. public function testSerializationDoesNotUseOrderedTimeCodec(): void
  189. {
  190. $expected = '9ec692cc-67c8-11eb-ae93-0242ac130002';
  191. $codec = new OrderedTimeCodec(
  192. (new UuidFactory())->getUuidBuilder()
  193. );
  194. $decoded = $codec->decode($expected);
  195. $serialized = serialize($decoded);
  196. /** @var UuidInterface $unserializedUuid */
  197. $unserializedUuid = unserialize($serialized);
  198. $expectedUuid = Uuid::fromString($expected);
  199. $this->assertSame($expectedUuid->getVersion(), $unserializedUuid->getVersion());
  200. $this->assertTrue($expectedUuid->equals($unserializedUuid));
  201. }
  202. }