Module com.aoindustries.aoserv.client

Package com.aoindustries.aoserv.client

Class GlobalTable<K,V extends GlobalObject<K,V>>

java.lang.Object

com.aoindustries.aoserv.client.AoservTable<K,V>

com.aoindustries.aoserv.client.GlobalTable<K,V>

All Implemented Interfaces:

Table<V>, Iterable<V>

Direct Known Subclasses:

BackupRetentionTable, GlobalTableDomainNameKey, GlobalTableIntegerKey, GlobalTablePosixPathKey, GlobalTableStringKey

public abstract class GlobalTable<K,V extends GlobalObject<K,V>>
extends AoservTable<K,V>

A GlobalTable is shared between all users. The data is cached so that subsequent lookups need not access the server.

Author:

AO Industries, Inc.

Nested Class Summary

Nested classes/interfaces inherited from class com.aoindustries.aoserv.client.AoservTable

AoservTable.OrderBy

Field Summary

Fields inherited from class com.aoindustries.aoserv.client.AoservTable

ASCENDING, connector, DESCENDING

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	GlobalTable(AoservConnector connector, Class<V> clazz)

Method Summary

Modifier and Type	Method	Description
void	clearCache()	Clears the cache, freeing up memory.
final int	getGlobalRowCount()	Gets the number of accessible rows in the table or -1 if the table is not yet loaded.
final List<V>	getIndexedRows(int col, Object value)	Gets the rows in a more efficient, indexed manner.
List<V>	getRows()	Gets the list of all accessible rows.
List<V>	getRowsCopy()	Gets a modifiable copy of the rows, which may then be manipulated, such as for sorting.
protected final V	getUniqueRowImpl(int col, Object value)	Gets a row given a unique column value.
final boolean	isLoaded()	Checks if the table is loaded.

Methods inherited from class com.aoindustries.aoserv.client.AoservTable

addProgressListener, addTableListener, addTableListener, addTableLoadListener, get, getCachedRowCount, getConnector, getDefaultOrderBy, getDefaultOrderBySqlExpressions, getIndexedRows, getMap, getNewObject, getObject, getObjects, getObjects, getObjects, getObjectsNoProgress, getObjectsNoProgress, getSize, getSortAlgorithm, getTableId, getTableName, getTableSchema, getUniqueRow, getUniqueRow, getUniqueRow, getUniqueRow, handleCommand, hasAnyTableListener, hasTableListener, isEmpty, iterator, printTable, removeProgressListener, removeTableListener, removeTableLoadListener, size, sortIfNeeded, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Details

GlobalTable

protected GlobalTable(AoservConnector connector,
 Class<V> clazz)

Method Details

getGlobalRowCount

public final int getGlobalRowCount()

Gets the number of accessible rows in the table or -1 if the table is not yet loaded.

getIndexedRows

public final List<V> getIndexedRows(int col,
 Object value)
                             throws IOException,
SQLException

Description copied from class: AoservTable

Gets the rows in a more efficient, indexed manner.

Implementation Note:
This default implementation simply throws UnsupportedOperationException.

Overrides:

getIndexedRows in class AoservTable<K,V extends GlobalObject<K,V>>

Throws:

IOException

SQLException

getUniqueRowImpl

protected final V getUniqueRowImpl(int col,
 Object value)
                            throws SQLException,
IOException

Description copied from class: AoservTable

Gets a row given a unique column value.

Specified by:

getUniqueRowImpl in class AoservTable<K,V extends GlobalObject<K,V>>

Parameters:

col - the column index to search

value - when null, no row is matched, even if there is a single row with a uniquely null value

Throws:

SQLException

IOException

getRows

public List<V> getRows()
                throws IOException,
SQLException

Description copied from class: AoservTable

Gets the list of all accessible rows.

Specified by:

getRows in interface Table<K>

Overrides:

getRows in class AoservTable<K,V extends GlobalObject<K,V>>

Returns:

a List containing all of the rows

Throws:

IOException - if unable to access the server

SQLException - if unable to access the database

See Also:

• AoservTable.getRowsCopy()

getRowsCopy

public List<V> getRowsCopy()
                    throws IOException,
SQLException

Description copied from class: AoservTable

Gets a modifiable copy of the rows, which may then be manipulated, such as for sorting.

This gives the table implementation a way to create a defensive copy most efficient to its underlying storage mechanism.

Note: It is best to use AoservTable.getSortAlgorithm() when sorting rows, as the choice of sorting can be very important when objects are pulled from non-heap source like filesystem-based objects. It is very easy for the sort itself to end up pulling all objects into heap.

Specified by:

getRowsCopy in class AoservTable<K,V extends GlobalObject<K,V>>

Throws:

IOException

SQLException

See Also:

• AoservTable.getRows()
• AoservTable.getSortAlgorithm()

isLoaded

public final boolean isLoaded()

Description copied from class: AoservTable

Checks if the table is loaded. A table is considered loaded when accessing any part of it will be done entirely locally, avoiding any network traffic.

Overrides:

isLoaded in class AoservTable<K,V extends GlobalObject<K,V>>

clearCache

public void clearCache()

Description copied from class: AoservTable

Clears the cache, freeing up memory. The data will be reloaded upon next use.

Overrides:

clearCache in class AoservTable<K,V extends GlobalObject<K,V>>