|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
A Valve is a request processing component associated with a particular Container. A series of Valves may be associated with the same Container, creating a request processing pipeline.
HISTORICAL NOTE: The "Valve" name was assigned to this concept because a valve is what you use in a real world pipeline to control and/or modify flows through it.
Method Summary | |
Container |
getContainer()
Return the Container with which this Valve is associated, if any. |
java.lang.String |
getInfo()
Return descriptive information about this Valve implementation. |
Valve |
getNext()
Return the next Valve in the pipeline containing this Valve, if any. |
Valve |
getPrevious()
Return the previous Valve in the pipeline containing this Valve, if any. |
void |
invoke(Request request,
Response response)
Perform request processing as required by this Valve. |
void |
setContainer(Container container)
Set the Container with which this Valve is associated. |
void |
setNext(Valve valve)
Set the next Valve in the pipeline containing this Valve. |
void |
setPrevious(Valve valve)
Set the previous Valve in the pipeline containing this Valve. |
Method Detail |
public Container getContainer()
public void setContainer(Container container)
container
- The newly associated Containerjava.lang.IllegalArgumentException
- if this Valve refused to be
associated with the specified ContainerIllegalStateException
- if this Valve is already
associated a different Container.public java.lang.String getInfo()
public Valve getNext()
public void setNext(Valve valve)
valve
- The new next valve, or null
if nonepublic Valve getPrevious()
public void setPrevious(Valve valve)
valve
- The new previous valve, or null
if nonepublic void invoke(Request request, Response response) throws java.io.IOException, javax.servlet.ServletException
An individual Valve MAY perform the following actions, in the specified order:
getNext().invoke()
.
A Valve MUST NOT do any of the following things:
invoke()
has returned.
invoke()
has
returned.
request
- The servlet request to be processedresponse
- The servlet response to be createdjava.io.IOException
- if an input/output error occursjavax.servlet.ServletException
- if a servlet error occurs
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |