commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Henri Yandell (JIRA)" <j...@apache.org>
Subject [jira] Updated: (SANDBOX-125) [id] New TimeBasedAlphanumericIdentifierGenerator
Date Wed, 17 May 2006 06:11:12 GMT
     [ http://issues.apache.org/jira/browse/SANDBOX-125?page=all ]

Henri Yandell updated SANDBOX-125:
----------------------------------

    Reporter: Joerg Schaible  (was: Jörg Schaible)

> [id] New TimeBasedAlphanumericIdentifierGenerator
> -------------------------------------------------
>
>          Key: SANDBOX-125
>          URL: http://issues.apache.org/jira/browse/SANDBOX-125
>      Project: Commons Sandbox
>         Type: Improvement

>  Environment: Operating System: All
> Platform: All
>     Reporter: Joerg Schaible
>     Priority: Minor
>  Attachments: TimeBasedAlphanumericIdentifierGenerator.java, TimeBasedAlphanumericIdentifierGeneratorTest.java
>
> Javadoc extract:
> ================
> TimeBasedAlphanumericIdentifierGenerator</code> is an Identifier Generator that
> generates an alphanumeric identifier in base 36 as a String object from the
> current UTC time and an internal counter.
> The generator guarantees that all generated ids have an increasing natural sort
> order (even if the time internally has an overflow). The implementation
> additionally guarantees, that all instances within the same process do generate
> unique ids. All generated ids have the same length (padding with 0's on the
> left), which is determined by the maximum size of a long value and the
> <code>postfixSize</code> parameter passed to the constructor.
> Note: To ensure unique ids that are created within the same millisecond (or
> maximum time resolution of the system), the implementation uses an internal
> counter. The maximum value of this counter is determined by the
> <code>postfixSize</code> parameter i.e. the largest value that can be
> represented in base 36. If the counter exceeds this value, an
> IllegalStateException is thrown.
> Note: The uniqueness of the generated ids cannot be guaranteed if the system
> performs time shifts, that affect the running processes.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Mime
View raw message