Package edu.wpi.first.networktables

Class NetworkTableEntry

java.lang.Object
edu.wpi.first.networktables.NetworkTableEntry
All Implemented Interfaces:
Publisher, PubSub, Subscriber, AutoCloseable
public final class NetworkTableEntry extends Object implements Publisher, Subscriber
NetworkTables Entry.

For backwards compatibility, the NetworkTableEntry close() does not release the entry.

  • Constructor Details

    • NetworkTableEntry

      public NetworkTableEntry(NetworkTableInstance inst, int handle)
      Construct from native handle.
      Parameters:
      inst - Instance
      handle - Native handle

    • NetworkTableEntry

      public NetworkTableEntry(Topic topic, int handle)
      Construct from native handle.
      Parameters:
      topic - Topic
      handle - Native handle

  • Method Details

    • close

      public void close()
      Specified by:
      close in interface AutoCloseable
      Specified by:
      close in interface PubSub

    • isValid

      public boolean isValid()
      Determines if the native handle is valid.
      Specified by:
      isValid in interface PubSub
      Returns:
      True if the native handle is valid, false otherwise.

    • getHandle

      public int getHandle()
      Gets the native handle for the entry.
      Specified by:
      getHandle in interface PubSub
      Returns:
      Native handle

    • getTopic

      public Topic getTopic()
      Gets the subscribed-to / published-to topic.
      Specified by:
      getTopic in interface PubSub
      Returns:
      Topic

    • getInstance

      public NetworkTableInstance getInstance()
      Gets the instance for the entry.
      Returns:
      Instance

    • exists

      public boolean exists()
      Determines if the entry currently exists.
      Specified by:
      exists in interface Subscriber
      Returns:
      True if the entry exists, false otherwise.

    • getName

      public String getName()
      Gets the name of the entry (the key).
      Returns:
      the entry's name

    • getType

      public NetworkTableType getType()
      Gets the type of the entry.
      Returns:
      the entry's type

    • getLastChange

      public long getLastChange()
      Gets the last time the entry's value was changed.
      Specified by:
      getLastChange in interface Subscriber
      Returns:
      Entry last change time

    • getValue

      public NetworkTableValue getValue()
      Gets the entry's value. Returns a value with type NetworkTableType.kUnassigned if the value does not exist.
      Returns:
      the entry's value

    • getBoolean

      public boolean getBoolean(boolean defaultValue)
      Gets the entry's value as a boolean. If the entry does not exist or is of different type, it will return the default value.
      Parameters:
      defaultValue - the value to be returned if no value is found
      Returns:
      the entry's value or the given default value

    • getInteger

      public long getInteger(long defaultValue)
      Gets the entry's value as a long. If the entry does not exist or is of different type, it will return the default value.
      Parameters:
      defaultValue - the value to be returned if no value is found
      Returns:
      the entry's value or the given default value

    • getFloat

      public float getFloat(float defaultValue)
      Gets the entry's value as a float. If the entry does not exist or is of different type, it will return the default value.
      Parameters:
      defaultValue - the value to be returned if no value is found
      Returns:
      the entry's value or the given default value

    • getDouble

      public double getDouble(double defaultValue)
      Gets the entry's value as a double. If the entry does not exist or is of different type, it will return the default value.
      Parameters:
      defaultValue - the value to be returned if no value is found
      Returns:
      the entry's value or the given default value

    • getString

      public String getString(String defaultValue)
      Gets the entry's value as a String. If the entry does not exist or is of different type, it will return the default value.
      Parameters:
      defaultValue - the value to be returned if no value is found
      Returns:
      the entry's value or the given default value

    • getRaw

      public byte[] getRaw(byte[] defaultValue)
      Gets the entry's value as a byte[]. If the entry does not exist or is of different type, it will return the default value.
      Parameters:
      defaultValue - the value to be returned if no value is found
      Returns:
      the entry's value or the given default value

    • getBooleanArray

      public boolean[] getBooleanArray(boolean[] defaultValue)
      Gets the entry's value as a boolean[]. If the entry does not exist or is of different type, it will return the default value.
      Parameters:
      defaultValue - the value to be returned if no value is found
      Returns:
      the entry's value or the given default value

    • getBooleanArray

      public Boolean[] getBooleanArray(Boolean[] defaultValue)
      Gets the entry's value as a boolean array. If the entry does not exist or is of different type, it will return the default value.
      Parameters:
      defaultValue - the value to be returned if no value is found
      Returns:
      the entry's value or the given default value

    • getIntegerArray

      public long[] getIntegerArray(long[] defaultValue)
      Gets the entry's value as a long[]. If the entry does not exist or is of different type, it will return the default value.
      Parameters:
      defaultValue - the value to be returned if no value is found
      Returns:
      the entry's value or the given default value

    • getIntegerArray

      public Long[] getIntegerArray(Long[] defaultValue)
      Gets the entry's value as a boolean array. If the entry does not exist or is of different type, it will return the default value.
      Parameters:
      defaultValue - the value to be returned if no value is found
      Returns:
      the entry's value or the given default value

    • getFloatArray

      public float[] getFloatArray(float[] defaultValue)
      Gets the entry's value as a float[]. If the entry does not exist or is of different type, it will return the default value.
      Parameters:
      defaultValue - the value to be returned if no value is found
      Returns:
      the entry's value or the given default value

    • getFloatArray

      public Float[] getFloatArray(Float[] defaultValue)
      Gets the entry's value as a boolean array. If the entry does not exist or is of different type, it will return the default value.
      Parameters:
      defaultValue - the value to be returned if no value is found
      Returns:
      the entry's value or the given default value

    • getDoubleArray

      public double[] getDoubleArray(double[] defaultValue)
      Gets the entry's value as a double[]. If the entry does not exist or is of different type, it will return the default value.
      Parameters:
      defaultValue - the value to be returned if no value is found
      Returns:
      the entry's value or the given default value

    • getDoubleArray

      public Double[] getDoubleArray(Double[] defaultValue)
      Gets the entry's value as a boolean array. If the entry does not exist or is of different type, it will return the default value.
      Parameters:
      defaultValue - the value to be returned if no value is found
      Returns:
      the entry's value or the given default value

    • getStringArray

      public String[] getStringArray(String[] defaultValue)
      Gets the entry's value as a String[]. If the entry does not exist or is of different type, it will return the default value.
      Parameters:
      defaultValue - the value to be returned if no value is found
      Returns:
      the entry's value or the given default value

    • getNumber

      public Number getNumber(Number defaultValue)
      Gets the entry's value as a double. If the entry does not exist or is of different type, it will return the default value.
      Parameters:
      defaultValue - the value to be returned if no value is found
      Returns:
      the entry's value or the given default value

    • getNumberArray

      public Number[] getNumberArray(Number[] defaultValue)
      Gets the entry's value as a double array. If the entry does not exist or is of different type, it will return the default value.
      Parameters:
      defaultValue - the value to be returned if no value is found
      Returns:
      the entry's value or the given default value

    • readQueue

      public NetworkTableValue[] readQueue()
      Get an array of all value changes since the last call to readQueue.

      The "poll storage" subscribe option can be used to set the queue depth.

      Returns:
      Array of values; empty array if no new changes have been published since the previous call.

    • isValidDataType

      public static boolean isValidDataType(Object data)
      Checks if a data value is of a type that can be placed in a NetworkTable entry.
      Parameters:
      data - the data to check
      Returns:
      true if the data can be placed in an entry, false if it cannot

    • setDefaultValue

      public boolean setDefaultValue(Object defaultValue)
      Sets the entry's value if it does not exist.
      Parameters:
      defaultValue - the default value to set
      Returns:
      False if the entry exists with a different type
      Throws:
      IllegalArgumentException - if the value is not a known type

    • setDefaultBoolean

      public boolean setDefaultBoolean(boolean defaultValue)
      Sets the entry's value if it does not exist.
      Parameters:
      defaultValue - the default value to set
      Returns:
      False if the entry exists with a different type

    • setDefaultInteger

      public boolean setDefaultInteger(long defaultValue)
      Sets the entry's value if it does not exist.
      Parameters:
      defaultValue - the default value to set
      Returns:
      False if the entry exists with a different type

    • setDefaultFloat

      public boolean setDefaultFloat(float defaultValue)
      Sets the entry's value if it does not exist.
      Parameters:
      defaultValue - the default value to set
      Returns:
      False if the entry exists with a different type

    • setDefaultDouble

      public boolean setDefaultDouble(double defaultValue)
      Sets the entry's value if it does not exist.
      Parameters:
      defaultValue - the default value to set
      Returns:
      False if the entry exists with a different type

    • setDefaultString

      public boolean setDefaultString(String defaultValue)
      Sets the entry's value if it does not exist.
      Parameters:
      defaultValue - the default value to set
      Returns:
      False if the entry exists with a different type

    • setDefaultRaw

      public boolean setDefaultRaw(byte[] defaultValue)
      Sets the entry's value if it does not exist.
      Parameters:
      defaultValue - the default value to set
      Returns:
      False if the entry exists with a different type

    • setDefaultRaw

      public boolean setDefaultRaw(ByteBuffer defaultValue)
      Sets the entry's value if it does not exist.
      Parameters:
      defaultValue - the default value to set; will send from defaultValue.position() to defaultValue.capacity()
      Returns:
      False if the entry exists with a different type

    • setDefaultRaw

      public boolean setDefaultRaw(byte[] defaultValue, int start, int len)
      Sets the entry's value if it does not exist.
      Parameters:
      defaultValue - the default value to set
      start - Start position of data (in buffer)
      len - Length of data (must be less than or equal to value.length - start)
      Returns:
      False if the entry exists with a different type

    • setDefaultRaw

      public boolean setDefaultRaw(ByteBuffer defaultValue, int start, int len)
      Sets the entry's value if it does not exist.
      Parameters:
      defaultValue - the default value to set
      start - Start position of data (in buffer)
      len - Length of data (must be less than or equal to value.capacity() - start)
      Returns:
      False if the entry exists with a different type

    • setDefaultBooleanArray

      public boolean setDefaultBooleanArray(boolean[] defaultValue)
      Sets the entry's value if it does not exist.
      Parameters:
      defaultValue - the default value to set
      Returns:
      False if the entry exists with a different type

    • setDefaultBooleanArray

      public boolean setDefaultBooleanArray(Boolean[] defaultValue)
      Sets the entry's value if it does not exist.
      Parameters:
      defaultValue - the default value to set
      Returns:
      False if the entry exists with a different type

    • setDefaultIntegerArray

      public boolean setDefaultIntegerArray(long[] defaultValue)
      Sets the entry's value if it does not exist.
      Parameters:
      defaultValue - the default value to set
      Returns:
      False if the entry exists with a different type

    • setDefaultIntegerArray

      public boolean setDefaultIntegerArray(Long[] defaultValue)
      Sets the entry's value if it does not exist.
      Parameters:
      defaultValue - the default value to set
      Returns:
      False if the entry exists with a different type

    • setDefaultFloatArray

      public boolean setDefaultFloatArray(float[] defaultValue)
      Sets the entry's value if it does not exist.
      Parameters:
      defaultValue - the default value to set
      Returns:
      False if the entry exists with a different type

    • setDefaultFloatArray

      public boolean setDefaultFloatArray(Float[] defaultValue)
      Sets the entry's value if it does not exist.
      Parameters:
      defaultValue - the default value to set
      Returns:
      False if the entry exists with a different type

    • setDefaultDoubleArray

      public boolean setDefaultDoubleArray(double[] defaultValue)
      Sets the entry's value if it does not exist.
      Parameters:
      defaultValue - the default value to set
      Returns:
      False if the entry exists with a different type

    • setDefaultDoubleArray

      public boolean setDefaultDoubleArray(Double[] defaultValue)
      Sets the entry's value if it does not exist.
      Parameters:
      defaultValue - the default value to set
      Returns:
      False if the entry exists with a different type

    • setDefaultStringArray

      public boolean setDefaultStringArray(String[] defaultValue)
      Sets the entry's value if it does not exist.
      Parameters:
      defaultValue - the default value to set
      Returns:
      False if the entry exists with a different type

    • setDefaultNumber

      public boolean setDefaultNumber(Number defaultValue)
      Sets the entry's value if it does not exist.
      Parameters:
      defaultValue - the default value to set
      Returns:
      False if the entry exists with a different type

    • setDefaultNumberArray

      public boolean setDefaultNumberArray(Number[] defaultValue)
      Sets the entry's value if it does not exist.
      Parameters:
      defaultValue - the default value to set
      Returns:
      False if the entry exists with a different type

    • setValue

      public boolean setValue(Object value)
      Sets the entry's value.
      Parameters:
      value - the value that will be assigned
      Returns:
      False if the table key already exists with a different type
      Throws:
      IllegalArgumentException - if the value is not a known type

    • setBoolean

      public boolean setBoolean(boolean value)
      Sets the entry's value.
      Parameters:
      value - the value to set
      Returns:
      False if the entry exists with a different type

    • setInteger

      public boolean setInteger(long value)
      Sets the entry's value.
      Parameters:
      value - the value to set
      Returns:
      False if the entry exists with a different type

    • setFloat

      public boolean setFloat(float value)
      Sets the entry's value.
      Parameters:
      value - the value to set
      Returns:
      False if the entry exists with a different type

    • setDouble

      public boolean setDouble(double value)
      Sets the entry's value.
      Parameters:
      value - the value to set
      Returns:
      False if the entry exists with a different type

    • setString

      public boolean setString(String value)
      Sets the entry's value.
      Parameters:
      value - the value to set
      Returns:
      False if the entry exists with a different type

    • setRaw

      public boolean setRaw(byte[] value)
      Sets the entry's value.
      Parameters:
      value - the value to set
      Returns:
      False if the entry exists with a different type

    • setRaw

      public boolean setRaw(ByteBuffer value)
      Sets the entry's value.
      Parameters:
      value - the value to set; will send from value.position() to value.capacity()
      Returns:
      False if the entry exists with a different type

    • setRaw

      public boolean setRaw(byte[] value, int start, int len)
      Sets the entry's value.
      Parameters:
      value - the value to set
      start - Start position of data (in buffer)
      len - Length of data (must be less than or equal to value.length - start)
      Returns:
      False if the entry exists with a different type

    • setRaw

      public boolean setRaw(ByteBuffer value, int start, int len)
      Sets the entry's value.
      Parameters:
      value - the value to set
      start - Start position of data (in buffer)
      len - Length of data (must be less than or equal to value.capacity() - start)
      Returns:
      False if the entry exists with a different type

    • setBooleanArray

      public boolean setBooleanArray(boolean[] value)
      Sets the entry's value.
      Parameters:
      value - the value to set
      Returns:
      False if the entry exists with a different type

    • setBooleanArray

      public boolean setBooleanArray(Boolean[] value)
      Sets the entry's value.
      Parameters:
      value - the value to set
      Returns:
      False if the entry exists with a different type

    • setIntegerArray

      public boolean setIntegerArray(long[] value)
      Sets the entry's value.
      Parameters:
      value - the value to set
      Returns:
      False if the entry exists with a different type

    • setIntegerArray

      public boolean setIntegerArray(Long[] value)
      Sets the entry's value.
      Parameters:
      value - the value to set
      Returns:
      False if the entry exists with a different type

    • setFloatArray

      public boolean setFloatArray(float[] value)
      Sets the entry's value.
      Parameters:
      value - the value to set
      Returns:
      False if the entry exists with a different type

    • setFloatArray

      public boolean setFloatArray(Float[] value)
      Sets the entry's value.
      Parameters:
      value - the value to set
      Returns:
      False if the entry exists with a different type

    • setDoubleArray

      public boolean setDoubleArray(double[] value)
      Sets the entry's value.
      Parameters:
      value - the value to set
      Returns:
      False if the entry exists with a different type

    • setDoubleArray

      public boolean setDoubleArray(Double[] value)
      Sets the entry's value.
      Parameters:
      value - the value to set
      Returns:
      False if the entry exists with a different type

    • setStringArray

      public boolean setStringArray(String[] value)
      Sets the entry's value.
      Parameters:
      value - the value to set
      Returns:
      False if the entry exists with a different type

    • setNumber

      public boolean setNumber(Number value)
      Sets the entry's value.
      Parameters:
      value - the value to set
      Returns:
      False if the entry exists with a different type

    • setNumberArray

      public boolean setNumberArray(Number[] value)
      Sets the entry's value.
      Parameters:
      value - the value to set
      Returns:
      False if the entry exists with a different type

    • setPersistent

      public void setPersistent()
      Make value persistent through program restarts.

    • clearPersistent

      public void clearPersistent()
      Stop making value persistent through program restarts.

    • isPersistent

      public boolean isPersistent()
      Returns whether the value is persistent through program restarts.
      Returns:
      True if the value is persistent.

    • unpublish

      public void unpublish()
      Stops publishing the entry if it's been published.

    • equals

      public boolean equals(Object other)
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object