com.lightstreamer.javameclient.midp

Class ExtendedTableInfo

java.lang.Object

com.lightstreamer.javameclient.midp.SimpleTableInfo

com.lightstreamer.javameclient.midp.ExtendedTableInfo

public class ExtendedTableInfo
extends SimpleTableInfo

Contains the specification of a table to be subscribed to Lightstreamer Server. All the items and fields in the table are supplied. Group and Schema names to be sent to the Server are made by space separated concatenations of item and field names. This name convention is suitable for a Metadata Adapter derived from LiteralBasedProvider or equivalent to it.

Field Summary

Fields inherited from class com.lightstreamer.javameclient.midp.SimpleTableInfo

COMMAND, DISTINCT, MERGE, RAW

Constructor Summary

Constructors

Constructor and Description
ExtendedTableInfo(java.lang.String[] items, java.lang.String[] fields, java.lang.String mode) Constructs a table specification with basic table attributes.

Method Summary

Modifier and Type	Method and Description
java.lang.String[]	getFields() Recalls the fields contained in this table.
java.lang.String	getGroup() Gets the name of the Group of items contained in this table, as specified to the Server.
java.lang.String[]	getItems() Recalls the items contained in this table.
java.lang.String	getSchema() Gets the name of the Schema of fields used in this table, as specified to the Server.
void	setRange(int start, int end) Inherited from SimpleTableInfo, but ignored in this case.

Methods inherited from class com.lightstreamer.javameclient.midp.SimpleTableInfo

getBuffSize, getDataAdapter, getDistinctSnapshotLength, getEndRange, getMode, getRequestedMaxFrequency, getSelector, getStartRange, isSnapshotRequired, isUnfilteredMaxFreq, isUnlimitedBufferSize, isUnlimitedMaxFreq, setDataAdapter, setDistinctSnapshotLength, setItemsRange, setRequestedBufferSize, setRequestedMaxFrequency, setSelector, setSnaspshotRequired, setUnfilteredMaxFrequency, setUnlimitedBufferSize, setUnlimitedMaxFrequency, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ExtendedTableInfo

public ExtendedTableInfo(java.lang.String[] items,
                         java.lang.String[] fields,
                         java.lang.String mode)

Constructs a table specification with basic table attributes. The details of the items and fields used are specified. This requires that a LiteralBasedProvider or equivalent Metadata Adapter is configured on the Server. As a consequence, the item and field names specified cannot be empty or null and cannot contain spaces.

Parameters:

items - Array of names of the items in the table. A copy of the array is stored internally.

fields - Array of names of the fields for all items in the table. A copy of the array is stored internally.

mode - Subscription mode for all items in the table. Can be one of the following:

SimpleTableInfo.RAW

SimpleTableInfo.MERGE

SimpleTableInfo.DISTINCT

SimpleTableInfo.COMMAND

Throws:

java.lang.IllegalArgumentException - Thrown if any of the item or field names in the given arrays contains a space or it is empty or null.

Method Detail

getItems

public java.lang.String[] getItems()

Recalls the items contained in this table.

Returns:

an array of item names. A copy of the stored array is returned.

getFields

public java.lang.String[] getFields()

Recalls the fields contained in this table.

Returns:

an array of field names. A copy of the stored array is returned.

getGroup

public java.lang.String getGroup()

Gets the name of the Group of items contained in this table, as specified to the Server.

Overrides:

getGroup in class SimpleTableInfo

Returns:

a Group name made of a space separated list of the specified item names.

getSchema

public java.lang.String getSchema()

Gets the name of the Schema of fields used in this table, as specified to the Server.

Overrides:

getSchema in class SimpleTableInfo

Returns:

a Schema name made of a space separated list of the specified field names.

setRange

public void setRange(int start,
                     int end)

Inherited from SimpleTableInfo, but ignored in this case. Specifying a subrange of the specified Group of items to be requested is only meaningful when Group names must be used, so that an explicit specification for the needed subrange as a Group may not be available.

Parameters:

start - ignored.

end - ignored.