get(int count) method
Format
ArrayList<StreamTuple> get(int count)
Explanation
Acquires the number of tuples specified by the count parameter from the SDP server.
If there is no result data in the SDP server, an empty ArrayList type object 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
count
Specifies the number of data items to be acquired from the SDP server. You can specify between 1 and 1,048,576 data items.
The actual number of data items that will be acquired varies as shown below, depending on the value specified in this parameter and the state of the output stream queue.
Condition | Number that can be acquired |
---|---|
Value specified in count is less than or equal to the number of data items in the output stream queue. | Value specified in the count parameter |
Value specified in count is greater than the number of data items in the output stream queue. | Number of data items in the output stream queue |
Value specified in count is greater than the maximum size of the output stream queue. |
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)