Wombat::ValveContext - internal valve connection interface

- NAME
- SYNOPSIS
- DESCRIPTION
- PUBLIC METHODS
- SEE ALSO
- AUTHOR

# 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