Constructor Detail

• TimestampSynchronizer

  protected TimestampSynchronizer()

Method Detail

• initialize

  protected abstract long initialize()
                              throws IOException

  Initialization method is will be called on an instance by UUIDTimer right after it's been configured with one. At this point the implementation instance should have been properly configured, and should be able to determine the first legal timestamp value (return value). Method should also initialize any locking that it does (if any), such as locking files it needs.

  Return value thus indicates the lowest initial time value that can be used by the caller that can not have been used by previous incarnations of the UUID generator (assuming instance was able to find properly persisted data to figure that out). However, caller also needs to make sure that it will call update(long) when it actually needs the time stamp for the first time, since this method can not allocate timestamps beyond this initial value at this point.

  Returns:

  First (and last) legal timestamp to use; 0L if it can not determine it and caller can use whatever value (current timestamp) it has access to.

  Throws:

  IOException

• deactivate

  protected abstract void deactivate()
                              throws IOException

  Method UUIDTimer will call if this synchronizer object is being replaced by another synchronizer (or removed, that is, no more synchronization is to be done). It will not be called if JVM terminates.

  Throws:

  IOException

• update

  protected abstract long update(long now)
                          throws IOException

  Method called by UUIDTimer to indicate that it has generated a timestamp value that is beyond last legal timestamp value. The method should only return once it has "locked" specified timestamp value (and possible additional ones).

  Parameters:

  now - Timestamp value caller wants to use, and that the synchronizer is asked to protect.

  Returns:

  First timestamp value that can NOT be used by the caller; has to be higher than the input timestamp value

  Throws:

  IOException