Standard Servlet Annotations

} }

Files Prepare Run Troubleshooting Related Topics

About the Example

This example demonstrates how to use metadata annotations in a Web application. The Servlet 2.5 specification requires Servlets, Servlet Filters, Servlet event listeners, JavaServer Pages tag handlers and a few other class types to support serveral common annotations.

This example demonstrates the following features:

The Servlet CalculatorServlet uses the @EJB annotation to inject a reference to the Enterprises Session Bean CalculatorEJB into a variable. By using the @EJB annotation, you can avoid making a JNDI lookup call and declaring the EJB reference manually in the web.xml deployment descriptor file.
The ServletContextListener ContextInitializer and the Servlet Filter LoginFilter use the @PersistenceUnit annotation to inject a reference to a javax.persistence.EntityManagerFactory. LoginFilter authenticates requests by matching the username and pasword carried in the request with usernames and passwords stored in the sample database table. This table is populated during the startup of this sample web application by ContextInitializer.

Files Used in the Example

Directory Location:

MW_HOME/wlserver_10.3/samples/server/examples/webapp/servlets/annotations/standard

(where MW _HOME is the directory containing your Oracle WebLogic Server installation)

File Click source files to view code.	Description
application.xml	Java EE standard enterprise application deployment descriptor.
build.xml	Ant build file that contains targets for building and running the example.
CalculatorServlet.java	Servlet annotated with an @EJB metadata annotation.
Calculator.java	Business Interface for CalculatorEJB.
CalculatorEJB.java	Simple EJB which is referenced by the CalculatorServlet.
ContextInitializer.java	ServletContext Listener injected with a persistent unit.
ExamplesFooter.jsp	Java Server Page containing the Example Footer.
ExamplesHeader.jsp	Java Server Page containing the Example Header.
LoginFilter.java	Filter that authenticates requests for CalculatorServlet.
loginForm.jsp	Login form page for the standard annotations example Web Application.
persistence.xml	Descriptor for the Persistence Provider Runtime.
Visitor.java	Simple enity class.
web.xml	Standard Web application deployment descriptor.

Prepare the Example

Prerequisites

Before working with this example:

Install Oracle WebLogic Server, including the examples.
Start the Examples server.
Set up your environment.

Configure Oracle WebLogic Server

No special configuration is required for this example

Build and Deploy the Example

To build the example, follow these steps:

Change to the SAMPLES_HOME\server\examples\src\examples\webapp\servlets\annotations\standard directory, where SAMPLES_HOME refers to the main Oracle WebLogic Server examples directory, such as d:\Oracle\Middleware\wlserver_10.3\samples.
Execute the following command:

ant build

This command compiles and stages the example.
Execute the following command:

ant deploy

This command deploys the example on the wl_server domain of your Oracle WebLogic Server installation.

The Ant command uses the build.xml file, located in the SAMPLES_HOME\server\examples\src\examples\webapp\servlets\annotations\standard directory, to build the example.

Run the Example

To run the example, follow these steps:

Complete the steps in the "Prepare the Example" section.
In your development shell, run the example by executing the following command from the example directory (SAMPLES_HOME\server\examples\src\examples\webapp\servlets\annotations\standard):
prompt> ant run This command executes the build.xml run target, which opens your default browser to the following URL:
http://localhost:port/servlet_annotations/

Where:
- localhost refers to the machine on which Oracle WebLogic Server is running.
- port refers to port on which Oracle WebLogic Server is listening.
p>The loginForm page displays. Enter the Oracle WebLogic Administration Console username and password to log in to the CalculatorServlet page. (The default is weblogic/weblogic.)

Troubleshooting

General Troubleshooting Tips for Examples