Documentation Archive Developer
Search
PATH Documentation > WebObjects

Table of Contents

WOAdaptor


Inherits from:
Object
Package:
com.webobjects.appserver


Class Description


WOAdaptor is an abstract class that represents objects that can receive events from a WebObjects adaptor. A WebObjects adaptor is a process that handles communication between the server and a WebObjects application. The WebObjects application (a WOApplication instance) communicates with the adaptor using messages defined in the WOAdaptor class.

The purpose of the WOAdaptor class is to perform these tasks:




Constants


WOAdaptor constants:


Class Variable Description
DefaultListenQueueSize This class constant is an integer that specifies the maximum queue length for the listener thread. WOAdaptor's implementation sets this value to 128. Override this value by changing the WOListenQueueSize property.



Method Types


Constructors
WOAdaptor
Obtaining attributes
doesBusyRunOnce
dispatchesRequestsConcurrently
port
Event registering
registerForEvents
unregisterForEvents
Running
runOnce


Constructors



WOAdaptor

public WOAdaptor( String aName, NSDictionary someArguments)

Initializes a WOAdaptor with the name aName and arguments someArguments. aName is the name of the WOAdaptor subclass. someArguments are the default options specified for this adaptor (such as port number and listen queue depth).

The WOApplication method adaptorWithName invokes this message when it encounters an WOAdaptor option on the command line. The WOApplication retains each of its WOAdaptors.

See Also: adaptorWithName (WOApplication class)




Instance Methods



dispatchesRequestsConcurrently

public boolean dispatchesRequestsConcurrently()

Returns true if the adaptor is multi-threaded, false otherwise. If the adaptor is multi-threaded, the adaptor may dispatch requests to the application concurrently in separate threads.

See Also: adaptorsDispatchRequestsConcurrently (WOApplication class)



doesBusyRunOnce

public boolean doesBusyRunOnce()

Returns whether repeatedly invoking runOnce would result in busy waiting.

port

public int port()

After the application's constructor has been called, port returns the port number on which this adaptor will listen. During execution of the application's constructor, this method returns the value of the WOPort user default (or the value of the -WOPort command-line option, of one was specified when the application was started).

See Also: port (WOApplication class)



registerForEvents

public abstract void registerForEvents()

Performs any actions necessary to have the WOAdaptor start receiving events. WOAdaptor's implementation does nothing.

runOnce

public abstract void runOnce()

Invoked by the application's main loop. WOAdaptor's implementation does nothing.

See Also: doesBusyRunOnce



toString

public String toString()

Description forthcoming.

unregisterForEvents

public abstract void unregisterForEvents()

Undoes the actions performed in registerForEvents so that the WOAdaptor stops receiving events. WOAdaptor's implementation does nothing.

© 2001 Apple Computer, Inc. (Last Published April 15, 2001)


Table of Contents