ORG.oclc.webz
Class SETDBAUTHO

java.lang.Object
  |
  +--ORG.oclc.webz.Verb
        |
        +--ORG.oclc.webz.ZVerb
              |
              +--ORG.oclc.webz.SETDBAUTHO

public class SETDBAUTHO

extends ZVerb

The SETDBAUTHO class is the WebZ Verb that performs a Z39.50 search and present. SETDBAUTHO uses input parameters contained in a RequestManager object, or a RequestManager object and a string containing a URL. A successful execution of SETDBAUTHO updates the UserStateObject with results of the search and sets up the next page or command for execution in the RequestManager object. If a failure occurs, the user variables code and msg are updated to contain the reason and the bad page or command for execution is set up in the RequestManager.

The processing flow of the SETDBAUTHO class is to initialize the user for Z39.50 activity, parse the URL input parameters to generate the appropriate Z39.50 search request, create and send the search, perform a Z39.50 sort if requested, retrieve and save the first set of results records from the search, and set up the next command to execute in the RequestManager object.

Fields inherited from class ORG.oclc.webz.ZVerb

bytesIn, bytesOut, dbGroupSearch, dbname, fmtClass, format, inputQueryInfo, numrecs, postings, ranked, recno, resultSetName, sorting, tempDb, traceMsgs, z39session, zDb, zQueryTerm, zServer, zUserData

Fields inherited from class ORG.oclc.webz.Verb

user, widgets

Constructor Summary

SETDBAUTHO()
Constructs a SETDBAUTHO object.

Method Summary

protected void	resumeCommand(RequestManager rMngr) Continues with the command if it was interrupted.
void	runit(RequestManager rMngr) Executes the SETDBAUTHO class using the parameters in the RequestManager object.
void	runit(RequestManager rMngr, String URLCmd) Executes the SETDBAUTHO class using the RequestManager object and the input parameters contained in the URLCmd.
protected void	setDbAutho() Retrieves the authos and passwords from the incoming URL and and sets the database authorizations where appropriate.

Methods inherited from class ORG.oclc.webz.ZVerb

doAccessControl, doSort, initZUser, restoreDbState, saveDbState, saveRecs, toString

Methods inherited from class ORG.oclc.webz.Verb

setUpPage

Methods inherited from class java.lang.Object

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

Constructor Detail

SETDBAUTHO

public SETDBAUTHO()

Constructs a SETDBAUTHO object.

Method Detail

runit

public void runit(RequestManager rMngr)

Executes the SETDBAUTHO class using the parameters in the RequestManager object. Each method called from the runit() method can throw a FailurePage exception. If this occurs, the catch logic for the exceptions invokes setup of the bad page or command to execute upon return. Successful execution of all steps sets up the next page for execution.

Parameters:

rMngr - the RequestManager object

Overrides:

runit in class Verb

runit

public void runit(RequestManager rMngr,
                  String URLCmd)

Executes the SETDBAUTHO class using the RequestManager object and the input parameters contained in the URLCmd. This is used when creating a SETDBAUTHO object from one of the application classes and sending in the SETDBAUTHO parameters in the URL String. Each method called from the runit() method can throw a FailurePage exception. If this occurs, the catch logic for the exceptions invokes setup of the bad page or command to execute upon return. Successful execution of all steps sets up the next page for execution.

Parameters:

rMngr - the RequestManager object

URLCmd - the command string with the widgets delimited by ":". For example, SETDBAUTHO:next=results.html:SETDBAUTHO=dog:numrecs=10:format=B

setDbAutho

protected void setDbAutho()
                   throws FailurePage

Retrieves the authos and passwords from the incoming URL and and sets the database authorizations where appropriate.

Throws:

FailurePage - when no valid authorizations are supplied.

resumeCommand

protected void resumeCommand(RequestManager rMngr)

Continues with the command if it was interrupted.