web.xml Visual Editor: Resource References

Use the Resource References section to add, remove, and view the web application's resource references.

To access a data source, a JMS connection factory, a JavaMail session, or a URL link from a web application, you must declare a resource reference in the application's web application deployment descriptor. The resource reference specifies a JNDI name, the object type, and the kind of authentication used when the resource is accessed. To connect the resource reference to the resource, you must map the JNDI name of the former to the latter. This mapping is done in the server-specific deployment descriptor file, such as the sun-web.xml file for the Glassfish application server.

You use the resource reference in your code to extract the resource you need. For example, a resource reference defined in the web.xml file is used to extract data from a data source as shown in Example: Resource Reference

Example 18-3 Resource Reference

public BookDBAO () throws Exception {
   try  {
      Context initCtx = new InitialContext();
      Context envCtx = (Context)
        initCtx.lookup("java:comp/env");
      DataSource ds = (DataSource) envCtx.lookup("jdbc/BookDB");
      con =  ds.getConnection();
     System.out.println("Created connection to database.");
   } catch (Exception ex) {
     System.out.println("Couldn't create connection." + 
       ex.getMessage());
   throw new 
       Exception("Couldn't open connection to database: "
       + ex.getMessage());
}

To declare a resource reference, you must register it in the web.xml file. When you do this, you provide information needed by the server to use the resource reference.

In the Visual Editor, click References at the top of the editor to open the References section, then click the Resource References header to open the Resource References section.

Click Add to define a resource reference element with the following properties:

Element Description

Resource Name

Specifies the resource reference's name, such as myDataSource.

Resource Type

Specifies the variable's name for validation, such as java.lang.String.

Authentification

Specifies the source of the authentification credentials.

    Application

Programmatic authentification, provided by the application.

    Container

(Default) Provided by the caller who logged in to the server and created the component instance.

Sharing Scope

By default, connections to a resource manager are shareable across web components in an application that use the same resource in the same transaction context.

Description

Specifies a description, such as Resource Reference for My Data Source.


Related Topics

Developing Applications with NetBeans IDE,

Developing Applications with NetBeans IDE,

Copyright © 2015, Oracle and/or its affiliates. All rights reserved.