edu.iris.Fissures.IfSeismogramDC
Interface DataCenterOperations

All Known Subinterfaces:
DataCenter, GroupingDataCenter, GroupingDataCenterOperations
All Known Implementing Classes:
_DataCenterStub, _GroupingDataCenterStub, DataCenterPOA, DataCenterPOATie, GroupingDataCenterPOA, GroupingDataCenterPOATie

public interface DataCenterOperations

The data center provide for retrieval of seismograms from a data warehouse. Its provides for both asynchronous delivery where the clients makes and request and waits for the results. It also provides asynchronous access where a client makes a request and is later delivered the results or must return to check the status of the request and retrieve the results


Method Summary
 RequestFilter[] available_data(RequestFilter[] a_filterseq)
           
 void cancel_request(java.lang.String a_request)
           
 java.lang.String queue_seismograms(RequestFilter[] a_filterseq)
           
 java.lang.String request_seismograms(RequestFilter[] a_filterseq, DataCenterCallBack a_client, boolean long_lived, Time expiration_time)
          if long_lived is true then the request is "sticky" in that the client wants the data center to return not just the data that it has in its archive currently, but also any data that it receives up to the expiration_time.
 java.lang.String request_status(java.lang.String a_request)
           
 LocalSeismogram[] retrieve_queue(java.lang.String a_request)
           
 LocalSeismogram[] retrieve_seismograms(RequestFilter[] a_filterseq)
           
 

Method Detail

available_data

RequestFilter[] available_data(RequestFilter[] a_filterseq)

request_seismograms

java.lang.String request_seismograms(RequestFilter[] a_filterseq,
                                     DataCenterCallBack a_client,
                                     boolean long_lived,
                                     Time expiration_time)
                                     throws FissuresException
if long_lived is true then the request is "sticky" in that the client wants the data center to return not just the data that it has in its archive currently, but also any data that it receives up to the expiration_time. For instance if a station sends its data by mailing tapes, then a researcher could issue a request for data that is expected to be delivered from a recent earthquake, even thought the data center does not yet have the data. Note that expiration_time is ignored if long_lived is false.

Throws:
FissuresException

retrieve_seismograms

LocalSeismogram[] retrieve_seismograms(RequestFilter[] a_filterseq)
                                       throws FissuresException
Throws:
FissuresException

queue_seismograms

java.lang.String queue_seismograms(RequestFilter[] a_filterseq)
                                   throws FissuresException
Throws:
FissuresException

retrieve_queue

LocalSeismogram[] retrieve_queue(java.lang.String a_request)
                                 throws FissuresException
Throws:
FissuresException

cancel_request

void cancel_request(java.lang.String a_request)
                    throws FissuresException
Throws:
FissuresException

request_status

java.lang.String request_status(java.lang.String a_request)
                                throws FissuresException
Throws:
FissuresException