SafeClock Class |
14c (14.1.1.0)
F23534-02
SafeClock maintains a "safe" time in milliseconds.
Inheritance HierarchyNamespace: Tangosol.Util
Assembly: Coherence (in Coherence.dll) Version: 14.1.1.14 (14.1.1.14)
SyntaxC#
public class SafeClock
The SafeClock type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | SafeClock(Int64) |
Create a new SafeClock with the default maximum expected jitter.
|
| SafeClock(Int64, Int64) |
Create a new SafeClock with the specified jitter threshold.
|
Methods| Name | Description | |
|---|---|---|
| Equals | Determines whether the specified object is equal to the current object. (Inherited from Object.) |
 | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
| GetHashCode | Serves as the default hash function. (Inherited from Object.) |
| GetLastSafeTimeMillis |
Returns the last "safe" time as computed by a previous call to the
GetSafeTimeMillis method.
Note: Since the underlying field is non-volatile, the returned
value is only guaranteed to be no less than the last value returned
by GetSafeTimeMillis() call on the same thread.
|
| GetSafeTimeMillis |
Returns a "safe" current time in milliseconds.
|
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
| ToString | Returns a string that represents the current object. (Inherited from Object.) |
| UpdateSafeTimeMillis |
Updates and returns a "safe" current time in milliseconds based on
the "unsafe" time.
|
Fields| Name | Description | |
|---|---|---|
  | DEFAULT_JITTER_THRESHOLD |
The default jitter threshold.
|
 | m_ldtLastSafe |
The last known safe time value.
|
| m_ldtLastUnsafe |
The last recorded unsafe time value.
|
| m_lJitter |
The maximum expected jitter exposed by the underlying unsafe clock.
|
Remarks
This clock guarantees that the time never "goes back". More
specifically, when queried twice on the same thread, the second query
will never return a value that is less then the value returned by the
first.
If we detect the system clock moving backward, an attempt will be made
to gradually compensate the safe clock (by slowing it down), so in the
long run the safe time is the same as the system time.
The SafeClock supports the concept of "clock jitter", which is a small
time interval that the system clock could fluctuate by without a
corresponding passage of wall time.
See Also