ORG.oclc.isoill
Class IllRequest

java.lang.Object
  |
  +--ORG.oclc.isoill.IllRequest

public class IllRequest

extends Object

The IllRequest class sends an ISOILL 10161 request to OCLC ILL. IllRequest uses the IllSession, IllPatronInfo and IllTxnInfo objects to collect all pieces of the request, uses a BerConnect to transmit, and then creates an IllAnswer or an IllStatusOrErrorReport with the reply. If the execution of IllRequest fails, an Exception is thrown.

Field Summary

IllAnswer	answer IllAnswer object containing an ISO10161 APDU which is returned from OCLC if the request is loaded to the Review file
IllStatusOrErrorReport	error IllStatusOrErrorReport object containing an ISO10161 APDU which is returned from OCLC if the request is produced (directToProfile or directToLender) or encounters an error.
IllSession	isession IllSession object containing information about this ILL session.
IllPatronInfo	patron IllPatronInfo object containing information about the patron.
IllTxnInfo	txn IllTxnInfo object containing information pertaining to this transaction

Constructor Summary

IllRequest()
Constructs an IllRequest object.

IllRequest(IllSession session)
Constructs an IllRequest object using an existing IllSession.

Method Summary

void	doIll(IllTxnInfo txn) Performs an ILL transaction
BerString	Request(IllTxnInfo txn) Creates the BerString request that will be transmitted to OCLC.
void	Response(BerString response) Decodes the BerString response into a DataDir
void	Response(DataDir response) Unpacks the DataDir response and creates either an IllAnswer or an IllStatusOrErrorReport
String	toString() Generate a String representation of the object.

Methods inherited from class java.lang.Object

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

Field Detail

patron

public IllPatronInfo patron

IllPatronInfo object containing information about the patron.

txn

public IllTxnInfo txn

IllTxnInfo object containing information pertaining to this transaction

error

public IllStatusOrErrorReport error

IllStatusOrErrorReport object containing an ISO10161 APDU which is returned from OCLC if the request is produced (directToProfile or directToLender) or encounters an error.

answer

public IllAnswer answer

IllAnswer object containing an ISO10161 APDU which is returned from OCLC if the request is loaded to the Review file

isession

public IllSession isession

IllSession object containing information about this ILL session.

Constructor Detail

IllRequest

public IllRequest()

Constructs an IllRequest object.

IllRequest

public IllRequest(IllSession session)

Constructs an IllRequest object using an existing IllSession.

Parameters:

session - and existing ILLSession.

Method Detail

doIll

public void doIll(IllTxnInfo txn)
           throws Exception

Performs an ILL transaction

Parameters:

txn - this ILL transaction

Throws:

an - Exception containing a message about why the request failed.

Request

public BerString Request(IllTxnInfo txn)

Creates the BerString request that will be transmitted to OCLC.

Parameters:

txn - the ILL transaction

Response

public void Response(BerString response)
              throws Exception

Decodes the BerString response into a DataDir

Parameters:

response - the BerString

Throws:

an - Exception containing the error message from an IllStatusOrErrorReport.

Response

public void Response(DataDir response)
              throws Exception

Unpacks the DataDir response and creates either an IllAnswer or an IllStatusOrErrorReport

Parameters:

the - response in the form of a DataDir

Throws:

an - Exception containing the error message from an IllStatusOrErrorReport.

toString

public String toString()

Generate a String representation of the object.

Returns:

String

Overrides:

toString in class Object