Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## org.apache.commons.net.ntp
Class NtpV3Impl

    java.lang.Object
      org.apache.commons.net.ntp.NtpV3Impl

All Implemented Interfaces:
  NtpV3Packet

public class NtpV3Impl
extends Object
implements NtpV3Packet

Implementation of NtpV3Packet with methods converting Java objects to/from the Network Time Protocol (NTP) data message header format described in RFC-1305.

Version:
  $Revision: 165675 $ $Date: 2005-05-02 15:09:55 -0500 (Mon, 02 May 2005) $
Author:
  Naz Irizarry, MITRE Corp, Jason Mathews, MITRE Corp

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
`NtpV3Impl()` Creates a new instance of NtpV3Impl

Method Summary
`DatagramPacket` | `getDatagramPacket()` Returns the datagram packet with the NTP details already filled in.
`int` | `getLeapIndicator()` Returns 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)
`int` | `getMode()` Returns mode as defined in RFC-1305 which is a 3-bit integer whose value is indicated by the MODE_xxx parameters.
`String` | `getModeName()` Return human-readable name of message mode type as described in RFC 1305.
`TimeStamp` | `getOriginateTimeStamp()` Returns the originate time as defined in RFC-1305.
`int` | `getPoll()` Returns 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.
`int` | `getPrecision()` Returns precision as defined in RFC-1305 encoded as an 8-bit signed integer (seconds to nearest power of two).
`TimeStamp` | `getReceiveTimeStamp()` Returns receive timestamp as defined in RFC-1305.
`int` | `getReferenceId()` Returns the reference id as defined in RFC-1305, which is a 32-bit integer whose value is dependent on several criteria.
`String` | `getReferenceIdString()` Returns the reference id string.
`TimeStamp` | `getReferenceTimeStamp()` Returns the reference time as defined in RFC-1305.
`int` | `getRootDelay()` Return root delay as defined in RFC-1305, which is the total roundtrip delay to the primary reference source, in seconds.
`double` | `getRootDelayInMillisDouble()` Return root delay as defined in RFC-1305 in milliseconds, which is the total roundtrip delay to the primary reference source, in seconds.
`int` | `getRootDispersion()` Returns root dispersion as defined in RFC-1305.
`long` | `getRootDispersionInMillis()` Returns root dispersion (as defined in RFC-1305) in milliseconds.
`double` | `getRootDispersionInMillisDouble()` Returns root dispersion (as defined in RFC-1305) in milliseconds as double precision value.
`int` | `getStratum()` Returns 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).
`TimeStamp` | `getTransmitTimeStamp()` Returns the transmit timestamp as defined in RFC-1305.
`String` | `getType()` Return type of time packet.
`int` | `getVersion()` Returns NTP version number as defined in RFC-1305.
`void` | `setDatagramPacket(DatagramPacket srcDp)` Set the contents of this object from source datagram packet.
`void` | `setLeapIndicator(int li)` Set leap indicator as defined in RFC-1305.
`void` | `setMode(int mode)` Set mode as defined in RFC-1305.
`void` | `setOriginateTimeStamp(TimeStamp ts)` Set originate timestamp given NTP TimeStamp object.
`void` | `setPoll(int poll)` Set poll interval as defined in RFC-1305.
`void` | `setPrecision(int precision)` Set precision as defined in RFC-1305.
`void` | `setReceiveTimeStamp(TimeStamp ts)` Set receive timestamp given NTP TimeStamp object.
`void` | `setReferenceId(int refId)` Set reference clock identifier field with 32-bit unsigned integer value.
`void` | `setReferenceTime(TimeStamp ts)` Set Reference time with NTP timestamp.
`void` | `setStratum(int stratum)` Set stratum level as defined in RFC-1305.
`void` | `setTransmitTime(TimeStamp ts)` Set transmit time with NTP timestamp.
`void` | `setVersion(int version)` Set NTP version as defined in RFC-1305.
`String` | `toString()` Returns details of NTP packet as a string.
`protected static int` | `ui(byte b)` Convert byte to unsigned integer.
`protected static long` | `ul(byte b)` Convert byte to unsigned long.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

Constructor Detail

### NtpV3Impl

    public NtpV3Impl()

  Creates a new instance of NtpV3Impl

Method Detail

### getMode

    public int getMode()

  Returns mode as defined in RFC-1305 which is a 3-bit integer whose value is indicated by the MODE_xxx parameters.

  Specified by:
    `getMode` in interface `NtpV3Packet`
  Returns:
    mode as defined in RFC-1305.

### getModeName

    public String getModeName()

  Return human-readable name of message mode type as described in RFC 1305.

  Specified by:
    `getModeName` in interface `NtpV3Packet`
  Returns:
    mode name as string.

### setMode

    public void setMode(int mode)

  Set mode as defined in RFC-1305.

  Specified by:
    `setMode` in interface `NtpV3Packet`
  Parameters:
    `mode` -

### getLeapIndicator

    public int getLeapIndicator()

  Returns 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:
    `getLeapIndicator` in interface `NtpV3Packet`
  Returns:
    leap indicator as defined in RFC-1305.

### setLeapIndicator

    public void setLeapIndicator(int li)

  Set leap indicator as defined in RFC-1305.

  Specified by:
    `setLeapIndicator` in interface `NtpV3Packet`
  Parameters:
    `li` - leap indicator.

### getPoll

    public int getPoll()

  Returns 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:
    `getPoll` in interface `NtpV3Packet`
  Returns:
    poll interval as defined in RFC-1305.

### setPoll

    public void setPoll(int poll)

  Set poll interval as defined in RFC-1305.

  Specified by:
    `setPoll` in interface `NtpV3Packet`
  Parameters:
    `poll` - poll interval.

### getPrecision

    public int getPrecision()

  Returns precision as defined in RFC-1305 encoded as an 8-bit signed integer (seconds to nearest power of two). Values normally range from -6 to -20.

  Specified by:
    `getPrecision` in interface `NtpV3Packet`
  Returns:
    precision as defined in RFC-1305.

### setPrecision

    public void setPrecision(int precision)

  Set precision as defined in RFC-1305.

  Parameters:
    `precision` -

### getVersion

    public int getVersion()

  Returns NTP version number as defined in RFC-1305.

  Specified by:
    `getVersion` in interface `NtpV3Packet`
  Returns:
    NTP version number.

### setVersion

    public void setVersion(int version)

  Set NTP version as defined in RFC-1305.

  Specified by:
    `setVersion` in interface `NtpV3Packet`
  Parameters:
    `version` - NTP version.

### getStratum

    public int getStratum()

  Returns 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:
    `getStratum` in interface `NtpV3Packet`
  Returns:
    Stratum level as defined in RFC-1305.

### setStratum

    public void setStratum(int stratum)

  Set stratum level as defined in RFC-1305.

  Specified by:
    `setStratum` in interface `NtpV3Packet`
  Parameters:
    `stratum` - stratum level.

### getRootDelay

    public int getRootDelay()

  Return 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:
    `getRootDelay` in interface `NtpV3Packet`
  Returns:
    root delay as defined in RFC-1305.

### getRootDelayInMillisDouble

    public double getRootDelayInMillisDouble()

  Return 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:
    `getRootDelayInMillisDouble` in interface `NtpV3Packet`
  Returns:
    root delay in milliseconds

### getRootDispersion

    public int getRootDispersion()

  Returns root dispersion as defined in RFC-1305.

  Specified by:
    `getRootDispersion` in interface `NtpV3Packet`
  Returns:
    root dispersion.

### getRootDispersionInMillis

    public long getRootDispersionInMillis()

  Returns root dispersion (as defined in RFC-1305) in milliseconds.

  Specified by:
    `getRootDispersionInMillis` in interface `NtpV3Packet`
  Returns:
    root dispersion in milliseconds

### getRootDispersionInMillisDouble

    public double getRootDispersionInMillisDouble()

  Returns root dispersion (as defined in RFC-1305) in milliseconds as double precision value.

  Specified by:
    `getRootDispersionInMillisDouble` in interface `NtpV3Packet`
  Returns:
    root dispersion in milliseconds

### setReferenceId

    public void setReferenceId(int refId)

  Set reference clock identifier field with 32-bit unsigned integer value. See RFC-1305 for description.

  Specified by:
    `setReferenceId` in interface `NtpV3Packet`
  Parameters:
    `refId` - reference clock identifier.

### getReferenceId

    public int getReferenceId()

  Returns the reference id as defined in RFC-1305, which is a 32-bit integer whose value is dependent on several criteria.

  Specified by:
    `getReferenceId` in interface `NtpV3Packet`
  Returns:
    the reference id as defined in RFC-1305.

### getReferenceIdString

    public String getReferenceIdString()

  Returns 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 hex string.

  Specified by:
    `getReferenceIdString` in interface `NtpV3Packet`
  Returns:
    the reference id string.

### getTransmitTimeStamp

    public TimeStamp getTransmitTimeStamp()

  Returns the transmit timestamp as defined in RFC-1305.

  Specified by:
    `getTransmitTimeStamp` in interface `NtpV3Packet`
  Returns:
    the transmit timestamp as defined in RFC-1305. Never returns a null object.

### setTransmitTime

    public void setTransmitTime(TimeStamp ts)

  Set transmit time with NTP timestamp. If `ts` is null then zero time is used.

  Specified by:
    `setTransmitTime` in interface `NtpV3Packet`
  Parameters:
    `ts` - NTP timestamp

### setOriginateTimeStamp

    public void setOriginateTimeStamp(TimeStamp ts)

  Set originate timestamp given NTP TimeStamp object. If `ts` is null then zero time is used.

  Specified by:
    `setOriginateTimeStamp` in interface `NtpV3Packet`
  Parameters:
    `ts` - NTP timestamp

### getOriginateTimeStamp

    public TimeStamp getOriginateTimeStamp()

  Returns the originate time as defined in RFC-1305.

  Specified by:
    `getOriginateTimeStamp` in interface `NtpV3Packet`
  Returns:
    the originate time. Never returns null.

### getReferenceTimeStamp

    public TimeStamp getReferenceTimeStamp()

  Returns the reference time as defined in RFC-1305.

  Specified by:
    `getReferenceTimeStamp` in interface `NtpV3Packet`
  Returns:
    the reference time as `TimeStamp` object. Never returns null.

### setReferenceTime

    public void setReferenceTime(TimeStamp ts)

  Set Reference time with NTP timestamp. If `ts` is null then zero time is used.

  Specified by:
    `setReferenceTime` in interface `NtpV3Packet`
  Parameters:
    `ts` - NTP timestamp

### getReceiveTimeStamp

    public TimeStamp getReceiveTimeStamp()

  Returns receive timestamp as defined in RFC-1305.

  Specified by:
    `getReceiveTimeStamp` in interface `NtpV3Packet`
  Returns:
    the receive time. Never returns null.

### setReceiveTimeStamp

    public void setReceiveTimeStamp(TimeStamp ts)

  Set receive timestamp given NTP TimeStamp object. If `ts` is null then zero time is used.

  Specified by:
    `setReceiveTimeStamp` in interface `NtpV3Packet`
  Parameters:
    `ts` - timestamp

### getType

    public String getType()

  Return type of time packet. The values (e.g. NTP, TIME, ICMP, ...) correspond to the protocol used to obtain the timing information.

  Specified by:
    `getType` in interface `NtpV3Packet`
  Returns:
    packet type string identifier which in this case is "NTP".

### getDatagramPacket

    public DatagramPacket getDatagramPacket()

  Returns the datagram packet with the NTP details already filled in.

  Specified by:
    `getDatagramPacket` in interface `NtpV3Packet`
  Returns:
    a datagram packet.

### setDatagramPacket

    public void setDatagramPacket(DatagramPacket srcDp)

  Set the contents of this object from source datagram packet.

  Specified by:
    `setDatagramPacket` in interface `NtpV3Packet`
  Parameters:
    `srcDp` - source DatagramPacket to copy contents from.

### ui

    protected static final int ui(byte b)

  Convert byte to unsigned integer. Java only has signed types so we have to do more work to get unsigned ops.

  Parameters:
    `b` -
  Returns:
    unsigned int value of byte

### ul

    protected static final long ul(byte b)

  Convert byte to unsigned long. Java only has signed types so we have to do more work to get unsigned ops

  Parameters:
    `b` -
  Returns:
    unsigned long value of byte

### toString

    public String toString()

  Returns details of NTP packet as a string.

  Returns:
    details of NTP packet as a string.

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 1997-2005 The Apache Software Foundation. All Rights Reserved.