getAll(long timeout) method
Format
ArrayList<StreamTuple> getAll(long timeout)
Explanation
Acquires all tuples registered in the SDP server.
If there is no result data in the SDP server, this method waits until result data arrives or until the time specified in the timeout parameter elapses. If result data arrives while the method is waiting, an ArrayList type object containing the new data is returned. If the time specified in the timeout parameter elapses or if an interrupt occurs in the waiting thread, one of the following objects is returned:
If a stop notification has been issued to the query group when this method is called (a data transmission termination notification has been sent by a method, or a query group stop notification has been sent by a command), one of the following processes takes place:
This method is a polling method.
Parameters
timeout
Specifies the maximum amount of time (in milliseconds) to wait when there is no data.
One of the following processes takes place depending on the specified value:
Specified value | Process that is executed |
---|---|
Negative number | No waiting |
0 | Waits until result data arrives or until the stream ends. |
Positive number | Waits until result data arrives or until the specified time elapses. |
Exceptions
The following table shows the exceptions and the conditions for their generation.
Exception | Generation condition |
---|---|
SDPClientCommunicationException | A communication exception occurred during RMI connection. |
SDPClientEndOfStreamException | Processing of the transmitted data is finished. |
SDPClientException |
|
SDPClientQueryGroupHoldException | The query group is held. (Detailed exception of SDPClientQueryGroupStateException) |
SDPClientQueryGroupNotExistException | The query group was deleted. |
SDPClientQueryGroupStateException | The query group is not being executed. |
SDPClientQueryGroupStopException | There is no result data or the query group is stopped. (Detailed exception of SDPClientQueryGroupStateException) |
Return value
A tuple list (ArrayList<StreamTuple> type object)