Package org.apache.commons.net.ntp
Class NtpV3Impl
java.lang.Object
org.apache.commons.net.ntp.NtpV3Impl
- All Implemented Interfaces:
NtpV3Packet
Implements
NtpV3Packet to convert Java objects to and from the Network Time Protocol (NTP) data message header format described in RFC-1305.-
Field Summary
Fields inherited from interface org.apache.commons.net.ntp.NtpV3Packet
LI_ALARM_CONDITION, LI_LAST_MINUTE_HAS_59_SECONDS, LI_LAST_MINUTE_HAS_61_SECONDS, LI_NO_WARNING, MODE_BROADCAST, MODE_CLIENT, MODE_CONTROL_MESSAGE, MODE_PRIVATE, MODE_RESERVED, MODE_SERVER, MODE_SYMMETRIC_ACTIVE, MODE_SYMMETRIC_PASSIVE, NTP_MAXCLOCK, NTP_MAXPOLL, NTP_MINCLOCK, NTP_MINPOLL, NTP_PORT, TYPE_DAYTIME, TYPE_ICMP, TYPE_NTP, TYPE_TIME, VERSION_3, VERSION_4 -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionbooleanCompares this object against the specified object.Gets the datagram packet with the NTP details already filled in.intGets leap indicator as defined in RFC-1305 which is a two-bit code: 0=no warning 1=last minute has 61 seconds 2=last minute has 59 seconds 3=alarm condition (clock not synchronized)intgetMode()Gets the mode as defined in RFC-1305 which is a 3-bit integer whose value is indicated by the MODE_xxx parameters.Gets the human-readable name of message mode type as described in RFC 1305.Gets theoriginatetime as defined in RFC-1305.intgetPoll()Gets the poll interval as defined in RFC-1305, which is an eight-bit signed integer indicating the maximum interval between successive messages, in seconds to the nearest power of two (e.g. value of six indicates an interval of 64 seconds).intGets the precision as defined in RFC-1305 encoded as an 8-bit signed integer (seconds to the nearest power of two).Gets thereceivetimestamp as defined in RFC-1305.intGets the reference id as defined in RFC-1305, which is a 32-bit integer whose value is dependent on several criteria.Gets the reference id string.Gets the reference time as defined in RFC-1305.intGets the root delay as defined in RFC-1305, which is the total roundtrip delay to the primary reference source, in seconds.doubleGets the root delay as defined in RFC-1305 in milliseconds, which is the total roundtrip delay to the primary reference source, in seconds.intGets the root dispersion as defined in RFC-1305.longGets the root dispersion (as defined in RFC-1305) in milliseconds.doubleGets the root dispersion (as defined in RFC-1305) in milliseconds as double precision value.intGets the Stratum as defined in RFC-1305, which indicates the stratum level of the local clock, with values defined as follows: 0=unspecified, 1=primary ref clock, and all others a secondary reference (via NTP).Gets thetransmittimestamp as defined in RFC-1305.getType()Gets the type of time packet.intGets the NTP version number as defined in RFC-1305.inthashCode()Computes a hash code for this object.voidsetDatagramPacket(DatagramPacket srcDp) Sets the contents of this object from source datagram packet.voidsetLeapIndicator(int li) Sets leap indicator as defined in RFC-1305.voidsetMode(int mode) Sets mode as defined in RFC-1305.voidSets originate timestamp given NTP TimeStamp object.voidsetPoll(int poll) Sets poll interval as defined in RFC-1305.voidsetPrecision(int precision) Sets precision as defined in RFC-1305.voidSets receive timestamp given NTP TimeStamp object.voidsetReferenceId(int refId) Sets reference clock identifier field with 32-bit unsigned integer value.voidSets Reference time with NTP timestamp.voidsetRootDelay(int delay) Sets root delay as defined in RFC-1305.voidsetRootDispersion(int dispersion) Sets root dispersion as defined in RFC-1305.voidsetStratum(int stratum) Sets stratum level as defined in RFC-1305.voidSets transmit time with NTP timestamp.voidsetVersion(int version) Sets NTP version as defined in RFC-1305.toString()Returns details of NTP packet as a string.protected static final intui(byte b) Convert byte to unsigned integer.protected static final longul(byte b) Convert byte to unsigned long.
-
Constructor Details
-
NtpV3Impl
public NtpV3Impl()Creates a new instance of NtpV3Impl
-
-
Method Details
-
ui
Convert byte to unsigned integer. Java only has signed types, so we have to do more work to get unsigned ops.- Parameters:
b- input byte- Returns:
- unsigned int value of byte
-
ul
Convert byte to unsigned long. Java only has signed types, so we have to do more work to get unsigned ops- Parameters:
b- input byte- Returns:
- unsigned long value of byte
-
equals
Compares this object against the specified object. The result istrueif and only if the argument is notnulland is aNtpV3Implobject that contains the same values as this object. -
getDatagramPacket
Gets the datagram packet with the NTP details already filled in.- Specified by:
getDatagramPacketin interfaceNtpV3Packet- Returns:
- a datagram packet.
-
getLeapIndicator
Gets leap indicator as defined in RFC-1305 which is a two-bit code: 0=no warning 1=last minute has 61 seconds 2=last minute has 59 seconds 3=alarm condition (clock not synchronized)- Specified by:
getLeapIndicatorin interfaceNtpV3Packet- Returns:
- leap indicator as defined in RFC-1305.
-
getMode
Gets the mode as defined in RFC-1305 which is a 3-bit integer whose value is indicated by the MODE_xxx parameters.- Specified by:
getModein interfaceNtpV3Packet- Returns:
- mode as defined in RFC-1305.
-
getModeName
Gets the human-readable name of message mode type as described in RFC 1305.- Specified by:
getModeNamein interfaceNtpV3Packet- Returns:
- mode name as string.
-
getOriginateTimeStamp
Gets theoriginatetime as defined in RFC-1305.- Specified by:
getOriginateTimeStampin interfaceNtpV3Packet- Returns:
- the
originatetime. Never returns null.
-
getPoll
Gets the poll interval as defined in RFC-1305, which is an eight-bit signed integer indicating the maximum interval between successive messages, in seconds to the nearest power of two (e.g. value of six indicates an interval of 64 seconds). The values that can appear in this field range from NTP_MINPOLL to NTP_MAXPOLL inclusive.- Specified by:
getPollin interfaceNtpV3Packet- Returns:
- poll interval as defined in RFC-1305.
-
getPrecision
Gets the precision as defined in RFC-1305 encoded as an 8-bit signed integer (seconds to the nearest power of two). Values normally range from -6 to -20.- Specified by:
getPrecisionin interfaceNtpV3Packet- Returns:
- precision as defined in RFC-1305.
-
getReceiveTimeStamp
Gets thereceivetimestamp as defined in RFC-1305.- Specified by:
getReceiveTimeStampin interfaceNtpV3Packet- Returns:
- the
receivetime. Never returns null.
-
getReferenceId
Gets the reference id as defined in RFC-1305, which is a 32-bit integer whose value is dependent on several criteria.- Specified by:
getReferenceIdin interfaceNtpV3Packet- Returns:
- the reference id as defined in RFC-1305.
-
getReferenceIdString
Gets the reference id string. String cannot be null but value is dependent on the version of the NTP spec supported and stratum level. Value can be an empty string, clock type string, IP address, or a hexadecimal string.- Specified by:
getReferenceIdStringin interfaceNtpV3Packet- Returns:
- the reference id string.
-
getReferenceTimeStamp
Gets the reference time as defined in RFC-1305.- Specified by:
getReferenceTimeStampin interfaceNtpV3Packet- Returns:
- the reference time as
TimeStampobject. Never returns null.
-
getRootDelay
Gets the root delay as defined in RFC-1305, which is the total roundtrip delay to the primary reference source, in seconds. Values can take positive and negative values, depending on clock precision and skew.- Specified by:
getRootDelayin interfaceNtpV3Packet- Returns:
- root delay as defined in RFC-1305.
-
getRootDelayInMillisDouble
Gets the root delay as defined in RFC-1305 in milliseconds, which is the total roundtrip delay to the primary reference source, in seconds. Values can take positive and negative values, depending on clock precision and skew.- Specified by:
getRootDelayInMillisDoublein interfaceNtpV3Packet- Returns:
- root delay in milliseconds
-
getRootDispersion
Gets the root dispersion as defined in RFC-1305.- Specified by:
getRootDispersionin interfaceNtpV3Packet- Returns:
- root dispersion.
-
getRootDispersionInMillis
Gets the root dispersion (as defined in RFC-1305) in milliseconds.- Specified by:
getRootDispersionInMillisin interfaceNtpV3Packet- Returns:
- root dispersion in milliseconds
-
getRootDispersionInMillisDouble
Gets the root dispersion (as defined in RFC-1305) in milliseconds as double precision value.- Specified by:
getRootDispersionInMillisDoublein interfaceNtpV3Packet- Returns:
- root dispersion in milliseconds
-
getStratum
Gets the Stratum as defined in RFC-1305, which indicates the stratum level of the local clock, with values defined as follows: 0=unspecified, 1=primary ref clock, and all others a secondary reference (via NTP).- Specified by:
getStratumin interfaceNtpV3Packet- Returns:
- Stratum level as defined in RFC-1305.
-
getTransmitTimeStamp
Gets thetransmittimestamp as defined in RFC-1305.- Specified by:
getTransmitTimeStampin interfaceNtpV3Packet- Returns:
- the
transmittimestamp as defined in RFC-1305. Never returns a null object.
-
getType
Gets the type of time packet. The values (e.g. NTP, TIME, ICMP, ...) correspond to the protocol used to obtain the timing information.- Specified by:
getTypein interfaceNtpV3Packet- Returns:
- packet type string identifier which in this case is "NTP".
-
getVersion
Gets the NTP version number as defined in RFC-1305.- Specified by:
getVersionin interfaceNtpV3Packet- Returns:
- NTP version number.
-
hashCode
Computes a hash code for this object. The result is the exclusive OR of the values of this object stored as a byte array. -
setDatagramPacket
Sets the contents of this object from source datagram packet.- Specified by:
setDatagramPacketin interfaceNtpV3Packet- Parameters:
srcDp- source DatagramPacket to copy contents from, never null.- Throws:
IllegalArgumentException- if srcDp is null or byte length is less than minimum length of 48 bytes
-
setLeapIndicator
Sets leap indicator as defined in RFC-1305.- Specified by:
setLeapIndicatorin interfaceNtpV3Packet- Parameters:
li- leap indicator.
-
setMode
Sets mode as defined in RFC-1305.- Specified by:
setModein interfaceNtpV3Packet- Parameters:
mode- the mode to set
-
setOriginateTimeStamp
Sets originate timestamp given NTP TimeStamp object. Iftsis null then zero time is used.- Specified by:
setOriginateTimeStampin interfaceNtpV3Packet- Parameters:
ts- NTP timestamp
-
setPoll
Sets poll interval as defined in RFC-1305.- Specified by:
setPollin interfaceNtpV3Packet- Parameters:
poll- poll interval.
-
setPrecision
Sets precision as defined in RFC-1305.- Specified by:
setPrecisionin interfaceNtpV3Packet- Parameters:
precision- the precision to set- Since:
- 3.4
-
setReceiveTimeStamp
Sets receive timestamp given NTP TimeStamp object. Iftsis null then zero time is used.- Specified by:
setReceiveTimeStampin interfaceNtpV3Packet- Parameters:
ts- timestamp
-
setReferenceId
Sets reference clock identifier field with 32-bit unsigned integer value. See RFC-1305 for description.- Specified by:
setReferenceIdin interfaceNtpV3Packet- Parameters:
refId- reference clock identifier.
-
setReferenceTime
Sets Reference time with NTP timestamp. Iftsis null then zero time is used.- Specified by:
setReferenceTimein interfaceNtpV3Packet- Parameters:
ts- NTP timestamp
-
setRootDelay
Sets root delay as defined in RFC-1305.- Specified by:
setRootDelayin interfaceNtpV3Packet- Parameters:
delay- root delay- Since:
- 3.4
-
setRootDispersion
Sets root dispersion as defined in RFC-1305.- Specified by:
setRootDispersionin interfaceNtpV3Packet- Parameters:
dispersion- root dispersion- Since:
- 3.4
-
setStratum
Sets stratum level as defined in RFC-1305.- Specified by:
setStratumin interfaceNtpV3Packet- Parameters:
stratum- stratum level.
-
setTransmitTime
Sets transmit time with NTP timestamp. Iftsis null then zero time is used.- Specified by:
setTransmitTimein interfaceNtpV3Packet- Parameters:
ts- NTP timestamp
-
setVersion
Sets NTP version as defined in RFC-1305.- Specified by:
setVersionin interfaceNtpV3Packet- Parameters:
version- NTP version.
-
toString
Returns details of NTP packet as a string.
-