NAME

Wombat::ValveContext - internal valve connection interface


SYNOPSIS


DESCRIPTION

This interface specifies a component that allows a Valve to trigger the execution of the next Valve in a Pipeline without having to know anything about internal implementation mechanisms. An instance of a class implementing this interface is passed as a parameter to invoke() for each executed Valve.


PUBLIC METHODS

invokeNext ($request, $response)
Cause invoke() to be called on the next Valve in the Pipeline that is currently being processed, passing on the specified Request and Response objects plus this ValveContext instance. Exceptions thrown by a subsequently executed Valve, Filter or Servlet will be passed on to the caller.

If there are no more Valves to be executed, an appropriate ServletException will be thrown by this ValveContext.

Parameters

$request
the Wombat::Request to be processed

$response
the Wombat::Response to be created

Throws:

Servlet::ServletException
if a servlet error occurs or is thrown by a subsequently invoked Valve, Filter or Servlet, or if there are no further Valves configured in the Pipeline currently being processed

Servlet::Util::IOException
if an input or output error occurs


SEE ALSO

the Servlet::Util::Exception manpage, the Wombat::Exception manpage, the Wombat::Pipeline manpage, the Wombat::Request manpage, the Wombat::Response manpage, the Wombat::Valve manpage


AUTHOR

Brian Moseley, bcm@maz.org