Module

com.kesoftware.imu.Module

com.kesoftware.imu.Module

Since: 1.0

Description

Provides access to an EMu module.

Constructors

Constructor

Details

Module(table, session)

Module(String table, Session session)

Creates an object which can be used to access the EMu module specified by table.

Parameters:

table (String)

Name of the EMu module to be accessed.

session (Session)

A Session object to be used to communicate with the IMu server.

Module(table)

Module(String table)

Creates an object which can be used to access the EMu module specified by table and the Session class's default host and port values.

Parameters:

table (String)

Name of the EMu module to be accessed.

Methods

Method

Details

addFetchSet(name, columns)

int addFetchSet(String name, String columns)

Associates a set of columns with a logical name on the server. The name can be used instead of a column list when retrieving data using fetch( ).

Parameters:

name (String)

The logical name to associate with the set of columns.

columns (String)

A String containing the names of the columns to be used when name is passed to fetch( ). The column names must be separated by a semi-colon or a comma.

Returns:

int

The number of sets (including this one) registered on the server.

Throws:

IMuException

If a server-side error occurred.

addFetchSet(name, columns)

int addFetchSet(String name, String[] columns)

Associates a set of columns with a logical name on the server. The name can be used instead of a column list when retrieving data using fetch( ).

Parameters:

name (String)

The logical name to associate with the set of columns.

columns (String[])

An array of Strings containing the names of the columns to be used when name is passed to fetch( ).

Returns:

int

The number of sets (including this one) registered on the server.

Throws:

IMuException

If a server-side error occurred.

addFetchSet(name, columns)

int addFetchSet(String name, ArrayList<String> columns)

Associates a set of columns with a logical name on the server. The name can be used instead of a column list when retrieving data using fetch( ).

Parameters:

name (String)

The logical name to associate with the set of columns.

columns (ArrayList<String>)

A list of Strings containing the names of the columns to be used when name is passed to fetch( ).

Returns:

int

The number of sets (including this one) registered on the server.

Throws:

IMuException

If a server-side error occurred.

addFetchSets(sets)

int addFetchSets(Map sets)

Associates several sets of columns with logical names on the server. This is the equivalent of calling addFetchSet( ) for each entry in the map but is more efficient.

Parameters:

sets (Map)

A Map containing a set of mappings between a name and a set of columns.

Returns:

int

The number of sets (including this one) registered on the server.

Throws:

IMuException

If a server-side error occurred.

addSearchAlias(name, columns)

int addSearchAlias(String name, String columns)

Associates a set of columns with a logical name on the server. The name can be used when specifying search terms to be passed to findTerms( ). The search becomes the equivalent of an OR search involving the columns.

Parameters:

name (String)

The logical name to associate with the set of columns.

columns (String)

A String containing the names of the columns to be used when name is passed to findTerms( ). The column names must be separated by a semi-colon or a comma.

Returns:

int

The number of aliases (including this one) registered on the server.

Throws:

IMuException

If a server-side error occurred.

addSearchAlias(name, columns)

int addSearchAlias(String name, String[] columns)

Associates a set of columns with a logical name on the server. The name can be used when specifying search terms to be passed to findTerms( ). The search becomes the equivalent of an OR search involving the columns.

Parameters:

name (String)

The logical name to associate with the set of columns.

columns (String[])

An array of Strings containing the names of columns to be used when name is passed to findTerms( ).

Returns:

int

The number of aliases (including this one) registered on the server.

Throws:

IMuException

If a server-side error occurred.

addSearchAlias(name, columns)

int addSearchAlias(String name, ArrayList<String> columns)

Associates a set of columns with a logical name on the server.

The name can be used when specifying search terms to be passed to findTerms( ). The search becomes the equivalent of an OR search involving the columns.

Parameters:

name (String)

The logical name to associate with the set of columns.

columns (ArrayList<String>)

An array of Strings containing the names of columns to be used when name is passed tofindTerms( ).

Returns:

int

The number of aliases (including this one) registered on the server.

Throws:

IMuException

If a server-side error occurred.

addSearchAliases(aliases)

int addSearchAliases(Map aliases)

Associates several sets of columns with logical names on the server.

This is the equivalent of calling addSearchAlias( ) for each entry in the map but is more efficient.

Parameters:

aliases (Map)

A Map containing a set of mappings between a name and a set of columns.

Returns:

int

The number of sets (including this one) registered on the server.

Throws:

IMuException

If a server-side error occurred.

addSortSet(name, keys)

int addSortSet(String name, String keys)

Associates a set of sort keys with a logical name on the server.

The name can be used instead of a sort key list when sorting the current result set using sort( ).

Parameters:

name (String)

The logical name to associate with the set of columns.

keys (String)

A String containing the names of the keys to be used when name is passed to sort( ). The keys must be separated by a semi-colon or a comma.

Returns:

int

The number of sets (including this one) registered on the server.

Throws:

IMuException

If a server-side error occurred.

addSortSet(name, keys)

int addSortSet(String name, String[] keys)

Associates a set of sort keys with a logical name on the server.

Parameters:

name (String)

The logical name to associate with the set of columns.

keys (String[])

An array of Strings containing the names of the keys to be used when name is passed to sort( ). The keys must be separated by a semi-colon or a comma.

Returns:

int

The number of sets (including this one) registered on the server.

Throws:

IMuException

If a server-side error occurred.

addSortSet(name, keys)

int addSortSet(String name, ArrayList<String> keys)

Associates a set of sort keys with a logical name on the server.

Parameters:

name (String)

The logical name to associate with the set of columns.

keys (ArrayList<String>)

A list of Strings containing the names of the keys to be used when name is passed to sort( ). The keys must be separated by a semi-colon or a comma.

Returns:

int

The number of sets (including this one) registered on the server.

Throws:

IMuException

If a server-side error occurred.

addSortSets(sets)

Object addSortSets(Map sets)

Associates several sets of sort keys with logical names on the server.

This is the equivalent of calling addSortSet( ) for each entry in the map but is more efficient.

Parameters:

sets (Map)

A Map containing a set of mappings between a name and a set of keys.

Returns:

Object

The number of sets (including this one) registered on the server.

Throws:

IMuException

If a server-side error occurred.

fetch(flag, offset, count, columns)

ModuleFetchResult fetch(String flag, long offset, int count, String columns)

Fetches count records from the position described by a combination of flag and offset.

Parameters:

flag (String)

The position to start fetching records from. Must be one of: start, current, end

offset (long)

The position relative to flag to start fetching from.

count (int)

The number of records to fetch. A count of 0 is permitted to change the location of the current record without returning any results. A count of less than 0 causes all the remaining records in the result set to be returned.

columns (String)

A String containing the names of the columns to be returned for each record or the name of a column set which has been registered previously using addFetchSet( ). The column names must be separated by a semi-colon or a comma.

Returns:

ModuleFetchResult

A ModuleFetchResult object.

Throws:

IMuException

If a server-side error occurred.

fetch(flag, offset, count, columns)

ModuleFetchResult fetch(String flag, int offset, int count, String[] columns)

Fetches count records from the position described by a combination of flag and offset.

Parameters:

flag (String)

The position to start fetching records from. Must be one of: start, current, end

offset (int)

The position relative to flag to start fetching from.

count (int)

The number of records to fetch. A count of 0 is permitted to change the location of the current record without returning any results. A count of less than 0 causes all the remaining records in the result set to be returned.

columns (String[])

An array of Strings containing the names of the columns to be returned for each record or the name of a column set which has been registered previously using addFetchSet( ).

Returns:

ModuleFetchResult

A ModuleFetchResult object.

Throws:

IMuException

If a server-side error occurred.

fetch(flag, offset, count, columns)

ModuleFetchResult fetch(String flag, int offset, int count, ArrayList<String> columns)

Fetches count records from the position described by a combination of flag and offset.

Parameters:

flag (String)

The position to start fetching records from. Must be one of: start, current, end

offset (int)

The position relative to flag to start fetching from.

count (int)

The number of records to fetch. A count of 0 is permitted to change the location of the current record without returning any results. A count of less than 0 causes all the remaining records in the result set to be returned.

columns (ArrayList<String>)

A list of Strings containing the names of the columns to be returned for each record or the name of a column set which has been registered previously using addFetchSet( ).

Returns:

ModuleFetchResult

A ModuleFetchResult object.

Throws:

IMuException

If a server-side error occurred.

fetch(flag, offset, count)

ModuleFetchResult fetch(String flag, long offset, int count)

Fetches count records from the position described by a combination of flag and offset.

Parameters:

flag (String)

The position to start fetching records from. Must be one of: start, current, end

offset (long)

The position relative to flag to start fetching from.

count (int)

The number of records to fetch. A count of 0 is permitted to change the location of the current record without returning any results. A count of less than 0 causes all the remaining records in the result set to be returned.

Returns:

ModuleFetchResult

A ModuleFetchResult object.

Throws:

IMuException

If a server-side error occurred.

findKey(key)

long findKey(long key)

Searches for a record with the key value key.

Parameters:

key (long)

The key of the record being searched for.

Returns:

long

The number of records found. This will be either 1 if the record was found or 0 if not found.

Throws:

IMuException

If a server-side error occurred.

findKeys(keys)

long findKeys(long[] keys)

Searches for records with key values in the array keys.

Parameters:

keys (long[])

The list of keys being searched for.

Returns:

long

The number of records found.

Throws:

IMuException

If a server-side error occurred.

findKeys(keys)

long findKeys(ArrayList<Long> keys)

Searches for records with key values in the array keys.

Parameters:

keys (ArrayList<Long>)

An array of keys being searched for.

Returns:

long

The number of records found.

Throws:

IMuException

If a server-side error occurred.

findTerms(terms)

long findTerms(Terms terms)

Searches for records which match the search terms specified in terms.

Parameters:

terms (Terms)

The search terms.

Returns:

long

An estimate of the number of records found.

Throws:

IMuException

If a server-side error occurred.

findWhere(where)

long findWhere(String where)

Searches for records which match the TexQL WHERE clause.

Parameters:

where (String)

The TexQL WHERE clause to use.

Returns:

long

An estimate of the number of records found.

Throws:

IMuException

If a server-side error occurred.

restoreFromFile(file)

long restoreFromFile(String file)

Restores a set of records from a file on the server machine which contains a list of keys, one per line.

Parameters:

file (String)

The file on the server machine containing the keys.

Returns:

long

The number of records found.

Throws:

IMuException

If a server-side error occurred.

restoreFromTemp(file)

long restoreFromTemp(String file)

Restores a set of records from a temporary file on the server machine which contains a list of keys, one per line.

Operates the same way as restoreFromFile( ) except that the file parameter is relative to the server's temporary directory.

Parameters:

file (String)

The file on the server machine containing the keys.

Returns:

long

The number of records found.

Throws:

IMuException

If a server-side error occurred.

sort(keys, flags)

ModuleSortResult sort(String keys, String flags)

Sorts the current result set by the sort keys in keys.

Each sort key is a column name optionally preceded by a + (for an ascending sort) or a - (for a descending sort).

Parameters:

keys (String)

A String containing the list of sort keys. The keys must be separated by a semi-colon or a comma.

flags (String)

A String containing a set of flags specifying the behaviour of the sort. The flags must be separated by a semi-colon or a comma.

Returns:

ModuleSortResult

A ModuleSortResult object. If the report flag has not been specified, the result will be null.

Throws:

IMuException

If a server-side error occurred.

sort(keys, flags)

ModuleSortResult sort(String keys, String[] flags)

Sorts the current result set by the sort keys in keys.

Each sort key is a column name optionally preceded by a + (for an ascending sort) or a - (for a descending sort).

Parameters:

keys (String)

A String containing the list of sort keys. The keys must be separated by a semi-colon or a comma.

flags (String[])

An array of Strings specifying the behaviour of the sort.

Returns:

ModuleSortResult

A ModuleSortResult object. If the report flag has not been specified, the result will be null.

Throws:

IMuException

If a server-side error occurred.

sort(keys, flags)

ModuleSortResult sort(String keys, ArrayList<String> flags)

Sorts the current result set by the sort keys in keys.

Each sort key is a column name optionally preceded by a + (for an ascending sort) or a - (for a descending sort).

Parameters:

keys (String)

A String containing the list of sort keys. The keys must be separated by a semi-colon or a comma.

flags (ArrayList<String>)

A list of Strings specifying the behaviour of the sort.

Returns:

ModuleSortResult

A ModuleSortResult object. If the report flag has not been specified, the result will be null.

Throws:

IMuException

If a server-side error occurred.

sort(keys, flags)

ModuleSortResult sort(String[] keys, String flags)

Sorts the current result set by the sort keys in keys.

Each sort key is a column name optionally preceded by a +" (for an ascending sort) or a - (for a descending sort).

Parameters:

keys (String[])

An array of Strings containing the list of sort keys.

flags (String)

A String containing a set of flags specifying the behaviour of the sort. The flags must be separated by a semi-colon or a comma.

Returns:

ModuleSortResult

A ModuleSortResult object. If the report flag has not been specified, the result will be null.

Throws:

IMuException

If a server-side error occurred.

sort(keys, flags)

ModuleSortResult sort(String[] keys, String[] flags)

Sorts the current result set by the sort keys in keys.

Each sort key is a column name optionally preceded by a + (for an ascending sort) or a - (for a descending sort).

Parameters:

keys (String[])

An array of Strings containing the list of sort keys.

flags (String[])

An array of Strings specifying the behaviour of the sort.

Returns:

ModuleSortResult

A ModuleSortResult object. If the report flag has not been specified, the result will be null.

Throws:

IMuException

If a server-side error occurred.

sort(keys, flags)

ModuleSortResult sort(String[] keys, ArrayList<String> flags)

Sorts the current result set by the sort keys in keys. Passed as an array list.

Each sort key is a column name optionally preceded by a + (for an ascending sort) or a - (for a descending sort).

Parameters:

keys (String[])

An array of Strings containing the list of sort keys.

flags (ArrayList<String>)

A list of Strings specifying the behaviour of the sort.

Returns:

ModuleSortResult

A ModuleSortResult object. If the report flag has not been specified, the result will be null.

Throws:

IMuException

If a server-side error occurred.

sort(keys, flags)

ModuleSortResult sort(ArrayList<String> keys, String flags)

Sorts the current result set by the sort keys in keys.

Each sort key in a column name optionally preceded by a + (for an ascending sort) or a - (for a descending sort).

Parameters:

keys (ArrayList<String>)

A list of Strings containing the list of sort keys.

flags (String)

A String containing a set of flags specifying the behaviour of the sort. The flags must be separated by a semi-colon or a comma.

Returns:

ModuleSortResult

A ModuleSortResult object. If the report flag has not been specified, the result will be null.

Throws:

IMuException

If a server-side error occurred.

sort(keys, flags)

ModuleSortResult sort(ArrayList<String> keys, String[] flags)

Sorts the current result set by the sort keys in keys.

Each sort key is a column name optionally preceded by a + (for an ascending sort) or a - (for a descending sort).

Parameters:

keys (ArrayList<String>)

A list of Strings containing the list of sort keys.

flags (String[])

An array of Strings specifying the behaviour of the sort.

Returns:

ModuleSortResult

A ModuleSortResult object. If the report flag has not been specified, the result will be null.

Throws:

IMuException

If a server-side error occurred.

sort(keys, flags)

ModuleSortResult sort(ArrayList<String> keys, ArrayList<String> flags)

Sorts the current result set by the sort keys in keys.

Each sort key is a column name optionally preceded by a + (for an ascending sort) or a - (for a descending sort).

Parameters:

keys (ArrayList<String>)

A list of Strings containing the list of sort keys.

flags (ArrayList<String>)

A list of Strings specifying the behaviour of the sort.

Returns:

ModuleSortResult

A ModuleSortResult object. If the report flag has not been specified, the result will be null.

Throws:

IMuException

If a server-side error occurred.