org.glite.rgma
Interface SecondaryProducer

All Superinterfaces:
Resource

public interface SecondaryProducer
extends Resource

A client uses a secondary producer to republish or store information from other producers.


Method Summary
 void declareTable(java.lang.String tableName, java.lang.String predicate, TimeInterval historyRetentionPeriod)
          Declares a table, specifying the retention period for history tuples.
 TimeInterval getHistoryRetentionPeriod(java.lang.String tableName)
          Gets the retention period that is applied to history tuples for the specified table.
 
Methods inherited from interface org.glite.rgma.Resource
close, destroy, getResourceEndpoint, getTerminationInterval, setTerminationInterval, showSignOfLife
 

Method Detail

getHistoryRetentionPeriod

public TimeInterval getHistoryRetentionPeriod(java.lang.String tableName)
                                       throws RemoteException,
                                              UnknownResourceException,
                                              RGMAException
Gets the retention period that is applied to history tuples for the specified table.

Parameters:
tableName - Name of the table
Returns:
The retention period for history tuples.
Throws:
RemoteException - If the service could not be contacted.
UnknownResourceException - If the resource could not be found.
RGMAException - If the table has not been declared.
See Also:
declareTable(String, String, TimeInterval)

declareTable

public void declareTable(java.lang.String tableName,
                         java.lang.String predicate,
                         TimeInterval historyRetentionPeriod)
                  throws RemoteException,
                         UnknownResourceException,
                         RGMAException
Declares a table, specifying the retention period for history tuples. Tuples will be removed from storage when the history retention period expires.

Parameters:
tableName - The name of the table to declare.
predicate - An SQL WHERE clause defining the subset of a table that this Producer will publish. To publish to the whole table, an empty predicate can be used.
historyRetentionPeriod - The retention period for history tuples
Throws:
RemoteException - If the service could not be contacted.
UnknownResourceException - If the producer resource could not be found
RGMAException - If the tableName is unknown. If the predicate is invalid. If historyRetentionPeriod is invalid.
See Also:
getHistoryRetentionPeriod(String)