분산된 환경에서 대량으로 동시에 생성하여도 고유성을 가진다.

Identifier를 발행시 마다 시간순으로 단조롭게 증가하여 순서성을 가진다. 항상 정렬되어 저장되는 db의 primary key같은 목적으로 사용 시 이점이 있다.

사람이 읽을 수 있도록 ASCII TEXT로 표현한다. 값으로부터 개체의 유형을 이해 할 수 있다.

Add dependency to project and follow this example

// generate a new tuid string
val idValue = tuid(123) // for type 123 identifier

// generate a new tuid object
val id = TUID(123) // for type 123 identifier 

// create a tuid object from identifier value
val id = TUID("Uzzzzz15ftgFAbwd5I0hIej11STX") 

id.type // get type of identifier
id.datetime // get datetime of identifier
id.fingerprint // get fingerprint of generator
id.sequence // get sequence in generator
id.random // get random value

TUID는 62진수 ASCII([0-9A-Za-z])로 표현되며, 총 28개의 문자로된 6개의 그룹을 묶어서 표현한다

이를테면 다음과 같다.

Uzzzzz15ftgFAbwd5I0hIej11STX => Uzzzzz 15ftgF Abwd5I 0hIej 11 STX

nanos초 단위와 tuid 버전정보를 산술적으로 묶어서 표현한다.

nanos+version = I62(nanos + ((tuid version - 1) * 1_000_000_000))

1초는 1,000,000,000 나노초이므로 표현에 필요한 최대 나노초는 999,999,999이다.

version이 3이고 1111인 경우 1111 + ((3 - 1) * 1000000000) = 2000001111 nanos+version파트의 값은 2000001111가 된다. 62진수로 표현하면 2BLneR이다

v1: 3769-12-05T03:13:03.999999999Z

아래의 모든 조건이 일치한 경우, 같은 ID가 발급될 수 있다.

• 나노초 단위의 같은 시각에
• id의 type이 같고 - 238328 case (62^3)
• 같은 fingerprint를 가지는 tuid generator에서 - 56800235584 case (62^6)
• 실행 순서가 같으며 (sequence) - 3844 case (62^2)
• 같은 random값이 생성 - 916132832 case (62^5)

• Jinsung Oh

Copyright 2020 Viva Republica, Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.