| Java EE 6 SDK |
Valves are filter-like components that are used by the web container to intercept the HTTP request and response objects and perform some pre-processing logic before they are passed to the application's filter chain and servlet, and to perform some post-processing logic after they return from the application's filter chain and servlet. For example, the container leverages valves for access logging and authentication purposes.
Valves are also provided as container extension points, and may be added and configured by administrators at the virtual server level in domain.xml, and by developers in their sun-web.xml.
Valves may implement one of two interfaces: the org.apache.catalina.Valve interface from Tomcat or the org.glassfish.web.valve.GlassFishValve interface from GlassFish.
This sample application declares a custom valve in its sun-web.xml and configures it with a single property. The web.servlet.customvalve_war.TestValve valve implementation class is bundled inside the application's WEB_INF/classes folder. The custom valve's pre-invocation logic sets the valve's property as a request attribute.
The test client accesses the application's servlet, which checks for the presence of this request attribute and reports an error if it is missing.
Perform the following steps to build, deploy, and run the
application:
app_dir is the sample application base
directory: samples_install_dir/javaee6/web/container/customvalve-war.Change directory to app_dir.
all
targetapp_dir> ant
all
You can replace the ant all command with the
following set of
commands:
app_dir> ant
default compiles and packages the application
app_dir> ant
deploy deploys it to application server
app_dir> ant
run runs the test
app_dir> ant
run undeploy to undeploy the application.
app_dir> ant
undeploy
clean to remove the temporary directories
like build and dist.
app_dir> ant
clean
Perform the following steps to build, deploy, and run the application using NetBeans IDE:
samples_install_dir/javaee6/web/container/ directory, select customvalve-war, and click Open Project.customvalve_war and select Run to build, deploy, and run the project.If you have problems when running the application, refer the troubleshooting document.
Copyright © 1997-2010 Oracle and/or its affiliates. All rights reserved.