commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bugzi...@apache.org
Subject DO NOT REPLY [Bug 36683] New: - [id] New TimeBasedAlphanumericIdentifierGenerator
Date Fri, 16 Sep 2005 09:02:42 GMT
DO NOT REPLY TO THIS EMAIL, BUT PLEASE POST YOUR BUG·
RELATED COMMENTS THROUGH THE WEB INTERFACE AVAILABLE AT
<http://issues.apache.org/bugzilla/show_bug.cgi?id=36683>.
ANY REPLY MADE TO THIS MESSAGE WILL NOT BE COLLECTED AND·
INSERTED IN THE BUG DATABASE.

http://issues.apache.org/bugzilla/show_bug.cgi?id=36683

           Summary: [id] New TimeBasedAlphanumericIdentifierGenerator
           Product: Commons
           Version: unspecified
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: enhancement
          Priority: P2
         Component: Sandbox
        AssignedTo: commons-dev@jakarta.apache.org
        ReportedBy: joerg.schaible@gmx.de


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.

-- 
Configure bugmail: http://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.

---------------------------------------------------------------------
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