com.webobjects.appserver
Class WORequestHandler

java.lang.Object
  |
  +--com.webobjects.appserver.WORequestHandler

public abstract class WORequestHandler

extends Object

WORequestHandler is an abstract class that defines request handlers. A request handler is an object that can handle requests received by the WebObjects adaptor. All WebObjects applications have multiple request handlers that can handle certain types of requests. Three private request handlers are defined in the WebObjects framework:

• WOComponentRequestHandler, which handles requests for actions implemented in a component.
• WODirectActionRequestHandler, which handles requests for actions implemented in a WODirectAction class.
• WOResourceRequestHandler, which handles requests for resources.

These three request handlers handle most types of requests that an application can typically receive. If you want to create your own type of request, then you should write your own WORequestHandler. Unless you write your own request handler, your code typically won't have to directly interact with WORequestHandler objects at all.

Field Summary

static String

DidHandleRequestNotification This constant contains a String that names the notification that is posted by each request handler after a request has been handled.

Constructor Summary

protected

WORequestHandler() Default constructor for WORequestHandler that only calls super().

Method Summary

abstract WOResponse	handleRequest(WORequest aRequest) Request handlers must implement this method and perform all request-specific handling.
String	toString() Returns a string representation of the receiver.

Methods inherited from class java.lang.Object

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

Field Detail

DidHandleRequestNotification

public static String DidHandleRequestNotification

This constant contains a String that names the notification that is posted by each request handler after a request has been handled.

Constructor Detail

WORequestHandler

protected WORequestHandler()

Default constructor for WORequestHandler that only calls super().

Method Detail

handleRequest

public abstract WOResponse handleRequest(WORequest aRequest)

Request handlers must implement this method and perform all request-specific handling. By default, a request is an HTTP request. You must supply your own server-side adaptor to accept anything other than HTTP.

Parameters:

aRequest - the WORequest object to be processed

Returns:

a WOResponse that an application returns to a requesting server to complete a cycle of the request-response loop

See Also:

WOAdaptor

toString

public String toString()

Returns a string representation of the receiver.

Overrides:

toString in class Object

Returns:

a String containing a string representation of the receiver