io.github.robolib.nettable

Interface ITable

All Known Implementing Classes:

NetworkTable

public interface ITable

A table whose values can be read and written to

Method Summary

Modifier and Type	Method and Description
void	addSubTableListener(ITableListener listener) This will immediately notify the listener of all current sub tables
void	addTableListener(ITableListener listener) Add a listener for changes to the table
void	addTableListener(ITableListener listener, boolean immediateNotify) Add a listener for changes to the table
void	addTableListener(java.lang.String key, ITableListener listener, boolean immediateNotify) Add a listener for changes to a specific key the table
boolean	containsKey(java.lang.String key)
boolean	containsSubTable(java.lang.String key)
boolean	getBoolean(java.lang.String key)
boolean	getBoolean(java.lang.String key, boolean defaultValue)
double	getNumber(java.lang.String key)
double	getNumber(java.lang.String key, double defaultValue)
java.lang.String	getString(java.lang.String key)
java.lang.String	getString(java.lang.String key, java.lang.String defaultValue)
ITable	getSubTable(java.lang.String key)
java.lang.Object	getValue(java.lang.String key) Gets the value associated with a key as an object
void	putBoolean(java.lang.String key, boolean value) Put a boolean in the table
void	putNumber(java.lang.String key, double value) Put a number in the table
void	putString(java.lang.String key, java.lang.String value) Put a string in the table
void	putValue(java.lang.String key, java.lang.Object value) Put a value in the table
void	removeTableListener(ITableListener listener) Remove a listener from receiving table events
void	retrieveValue(java.lang.String key, java.lang.Object externalValue)

Method Detail

containsKey

boolean containsKey(java.lang.String key)

Parameters:

key - the key to search for

Returns:

true if the table as a value assigned to the given key

containsSubTable

boolean containsSubTable(java.lang.String key)

Parameters:

key - the key to search for

Returns:

true if there is a subtable with the key which contains at least one key/subtable of its own

getSubTable

ITable getSubTable(java.lang.String key)

Parameters:

key - the name of the table relative to this one

Returns:

a sub table relative to this one

getValue

java.lang.Object getValue(java.lang.String key)
                   throws java.util.NoSuchElementException

Gets the value associated with a key as an object

Parameters:

key - the key of the value to look up

Returns:

the value associated with the given key

Throws:

java.util.NoSuchElementException - if there is no value associated with the given key

putValue

void putValue(java.lang.String key,
              java.lang.Object value)
       throws java.lang.IllegalArgumentException

Put a value in the table

Parameters:

key - the key to be assigned to

value - the value that will be assigned

Throws:

java.lang.IllegalArgumentException - when the value is not supported by the table

retrieveValue

void retrieveValue(java.lang.String key,
                   java.lang.Object externalValue)

putNumber

void putNumber(java.lang.String key,
               double value)

Put a number in the table

Parameters:

key - the key to be assigned to

value - the value that will be assigned

getNumber

double getNumber(java.lang.String key)
          throws java.util.NoSuchElementException

Parameters:

key - the key to look up

Returns:

the value associated with the given key

Throws:

java.util.NoSuchElementException - if there is no value associated with the given key

getNumber

double getNumber(java.lang.String key,
                 double defaultValue)

Parameters:

key - the key to look up

defaultValue - the value to be returned if no value is found

Returns:

the value associated with the given key or the given default value if there is no value associated with the key

putString

void putString(java.lang.String key,
               java.lang.String value)

Put a string in the table

Parameters:

key - the key to be assigned to

value - the value that will be assigned

getString

java.lang.String getString(java.lang.String key)
                    throws java.util.NoSuchElementException

Parameters:

key - the key to look up

Returns:

the value associated with the given key

Throws:

java.util.NoSuchElementException - if there is no value associated with the given key

getString

java.lang.String getString(java.lang.String key,
                           java.lang.String defaultValue)

Parameters:

key - the key to look up

defaultValue - the value to be returned if no value is found

Returns:

the value associated with the given key or the given default value if there is no value associated with the key

putBoolean

void putBoolean(java.lang.String key,
                boolean value)

Put a boolean in the table

Parameters:

key - the key to be assigned to

value - the value that will be assigned

getBoolean

boolean getBoolean(java.lang.String key)
            throws java.util.NoSuchElementException

Parameters:

key - the key to look up

Returns:

the value associated with the given key

Throws:

java.util.NoSuchElementException - if there is no value associated with the given key

getBoolean

boolean getBoolean(java.lang.String key,
                   boolean defaultValue)

Parameters:

key - the key to look up

defaultValue - the value to be returned if no value is found

Returns:

the value associated with the given key or the given default value if there is no value associated with the key

addTableListener

void addTableListener(ITableListener listener)

Add a listener for changes to the table

Parameters:

listener - the listener to add

addTableListener

void addTableListener(ITableListener listener,
                      boolean immediateNotify)

Add a listener for changes to the table

Parameters:

listener - the listener to add

immediateNotify - if true then this listener will be notified of all current entries (marked as new)

addTableListener

void addTableListener(java.lang.String key,
                      ITableListener listener,
                      boolean immediateNotify)

Add a listener for changes to a specific key the table

Parameters:

key - the key to listen for

listener - the listener to add

immediateNotify - if true then this listener will be notified of all current entries (marked as new)

addSubTableListener

void addSubTableListener(ITableListener listener)

This will immediately notify the listener of all current sub tables

Parameters:

listener -

removeTableListener

void removeTableListener(ITableListener listener)

Remove a listener from receiving table events

Parameters:

listener - the listener to be removed