You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by "Henri Yandell (JIRA)" <ji...@apache.org> on 2006/07/05 06:01:41 UTC

[jira] Updated: (SANDBOX-125) [id] New TimeBasedAlphanumericIdentifierGenerator

     [ http://issues.apache.org/jira/browse/SANDBOX-125?page=all ]

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

    Component: Id

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

>   Components: Id
>  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