Package eu.clarin.sru.client

Class SRUSimpleClient

java.lang.Object

eu.clarin.sru.client.SRUSimpleClient

public class SRUSimpleClient
extends Object

A simple client to perform SRU operations using callbacks. The application must provide the appropriate callbacks to receive the results of the operations.

This client is reusable but not thread-safe: the application may reuse a client object, but it may not be concurrently shared between multiple threads.

This class is modeled after Java's SAX-API.

See Also:

SRUExplainHandler, SRUScanHandler, SRUSearchRetrieveHandler, SRUDefaultHandlerAdapter

Constructor Summary

Constructors

Constructor	Description
SRUSimpleClient(SRUClientConfig config)	Constructor.

Method Summary

Modifier and Type	Method	Description
void	explain(SRUExplainRequest request, SRUExplainHandler handler)	Perform a explain operation.
void	scan(SRUScanRequest request, SRUScanHandler handler)	Perform a scan operation.
void	searchRetrieve(SRUSearchRetrieveRequest request, SRUSearchRetrieveHandler handler)	Perform a searchRetrieve operation.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SRUSimpleClient

public SRUSimpleClient(SRUClientConfig config)

Constructor.

Parameters:

config - the configuration to be used for this client.

Throws:

NullPointerException - if argument config is null

IllegalArgumentException - if an error occurred while registering record data parsers

See Also:

SRUClientConfig

Method Detail

explain

public void explain(SRUExplainRequest request,
                    SRUExplainHandler handler)
             throws SRUClientException

Perform a explain operation.

Parameters:

request - an instance of a SRUExplainRequest object

handler - an instance of SRUExplainHandler to receive callbacks when processing the result of this request

Throws:

SRUClientException - if an unrecoverable error occurred

NullPointerException - if any required argument is null

See Also:

SRUExplainRequest, SRUExplainHandler

scan

public void scan(SRUScanRequest request,
                 SRUScanHandler handler)
          throws SRUClientException

Perform a scan operation.

Parameters:

request - an instance of a SRUScanRequest object

handler - an instance of SRUScanHandler to receive callbacks when processing the result of this request

Throws:

SRUClientException - if an unrecoverable error occurred

NullPointerException - if any required argument is null

See Also:

SRUScanRequest, SRUScanHandler

searchRetrieve

public void searchRetrieve(SRUSearchRetrieveRequest request,
                           SRUSearchRetrieveHandler handler)
                    throws SRUClientException

Perform a searchRetrieve operation.

Parameters:

request - an instance of a SRUSearchRetrieveRequest object

handler - an instance of SRUSearchRetrieveHandler to receive callbacks when processing the result of this request

Throws:

SRUClientException - if an unrecoverable error occurred

NullPointerException - if any required argument is null

See Also:

SRUSearchRetrieveRequest, SRUSearchRetrieveHandler