Working with Web Applications

See the following sections for information on Web Applications:

• Adding a Servlet with Servlet Mapping and Security Constraints

• Adding an ejb-ref/ejb-local-ref and Reference-Description

• Adding a Resource-Reference

• Adding a Listener Class

• Adding a Filter with Filter Mapping

• Defining a Match Map Class

• Setting Welcome and Error Pages

• Adding a Tag Library

• Adding a Virtual Directory

Adding a Servlet with Servlet Mapping and Security Constraints

This section describes how to add servlets to your Web Application's deployment descriptor files, and configure them with security roles, constraints, and assignments.

Adding a Servlet with URL Mapping

Use the following procedure to add a new servlet to the deployment descriptor file:

1. Under your Web Application's name in the navigational tree, select Servlets.

2. In the Servlets panel, select the servlet and click Add.

3. In the General tab, enter the Servlet Name and servlet class or JSP file.

4. Optionally, add URL mappings to the servlet in the URL mappings list by entering the URL pattern and clicking Add.

5. Click OK.

   The servlet's name appears in the Servlet node in the navigational tree.

Adding Security Roles, Constraints, and Assignments

Add security constraints and assignments to security roles using the following procedures.

1. Under the Web Application node in the navigational tree, select Security Roles.

2. In the editing panel, click Add, enter security role names and descriptions, and click OK.

3. Under the Web Application node in the navigational tree, select Security Role Assignments.

4. In the editing panel, select a Role and click Add.

5. In the edit dialog, add the names of members of the Role.

6. Expand the Security Constraints node, and select a role node.

7. In the Resources/Pages tab, set the following:

   • Web Resource Name

   • URL patterns for

   • HTTP methods

   • allowed and disallowed roles

   • Transport Guarantee

   • Display Name

8. In the Roles tab, set the Roles for which the Resources/Pages settings are allowed.

Adding an ejb-ref/ejb-local-ref and Reference-Description

1. In the navigational tree, under the name of your Web Application, open the Servlets directory and select J2EE References.

2. In the J2EE References editing panel, select the EJB Refs tab and click Add.

3. Use the edit dialog to specify for the EJB the following, and then click OK:

   • EJB Reference Name

   • Link Name (optional)

   • EJB Type (Session or Entity)

   • Remote Interface

   • Home Interface

   • Run As (optional)

   • Description (optional)

     WebLogic Builder writes the EJB reference to web.xml. and lists it in the EJB Refs tab of the J2EE References editing panel.

Adding a Resource-Reference

Add a resource-reference to web.xml and then to weblogic.xml using the following procedure.

1. In the navigational tree, under the name of your Web Application, open the Servlets directory and select J2EE References.

2. In the J2EE editing panel, select the Resource Refs tab and click Add.

3. In the edit dialog, select the following:

   • Reference Type

   • Resource Sharing

   • Resource Authentication

     Add a description and the Reference name, and click OK.

4. In the navigational tree, expand the WebLogic Settings node under Web Applications, select J2EE Links and click Add.

5. Select the Resource Reference that you added in step 3, enter its JNDI name for WebLogic, and click OK.

Adding a Listener Class

Add an event listener class to a Web Application using the following procedures:

1. In the navigational tree, under the name of your Web Application, select Miscellaneous.

2. In the Miscellaneous panel, select Listeners and click Add.

3. Enter the classname of the event and click OK.

Adding a Filter with Filter Mapping

1. Under the name of your Web Application in the navigational tree, select Filters.

2. In the Filters edit panel, click Add.

3. In the edit dialog, enter the display settings for the filter:

   • Display Name

   • Small Icon (must reside within the Web Application)

   • Description (optional)

   • Large Icon (also must reside within the Web Application)

4. Still in the dialog, select the Init Parameters tab and click Add.

5. Enter the filter's parameter name and value, and click OK.

Defining a Match Map Class

1. Under the name of your Web Application in the navigational tree, select Miscellaneous—>Container Settings.

2. Specify an URL match-map class name for this Web Application by entering its name in the URL match-map class name field.

Setting Welcome and Error Pages

Set the welcome and error pages for your Web Application using the following procedures:

1. Select your Web Application's name in the navigational tree.

2. In the edit panel for the Web Application, select Welcome Files.

3. Set the order for existing welcome files using the Move up, Move down buttons, or add new files by entering the filenames and clicking Add.

4. Select the Error Pages tab and click Add.

5. Enter the filename or browse to the file. Set HTTP Error Code or Exception Type, and click OK.

Adding a Tag Library

Add tag libraries using the following procedure:

1. Under your Web Application name in the navigational tree, select Tag Libraries.

2. In the Tag Libraries editing panel, click Add.

3. Enter the URI for the tag library.

4. Enter the location of the TLD or JAR file, or browse to it and select it.

5. Click OK.
    
    
    

Adding a Virtual Directory

Add a virtual directory to your Web Application using the following procedures:

1. In the navigational tree, under Web Application, WebLogic Settings, select VirtualDirectoryMappings and click Add.

2. Set a local directory path by entering it, and add its URL patterns by entering them in the bottom text field and clicking Add. Then click OK.