Criando e configurando as referências de recursos para Web 2.5, Web 3.0 e Web 3.1
É possível criar e configurar referências de recursos para projetos Web 2.5, Web 3.0 e Web 3.1 usando o descritor de implementação.
Sobre Esta Tarefa
Procedimento
- Expanda seu projeto da web e selecione WebContent > WEB-INF > web.xml.
- Clique com o botão direito em web.xml e selecione Abrir com > Editor do Descritor de Implementação do Aplicativo da Web.
- No campo Web application, selecione Add, selecione Resource Reference e clique em OK:

- Na seção Details, forneça os detalhes para sua referência de recurso:
- No campo Name, forneça um nome para sua referência de recurso.
- No campo Type, forneça o tipo da referência de recurso.
- No campo Authentication , selecione Application ou Container para a autenticação de sua referência de recurso.
- No campo Escopo de Compartilhamento, selecione Compartilhável ou Não Compartilhável para o escopo de compartilhamento de sua referência de recurso.
- No campo Description, digite uma descrição dessa referência de recurso.
- Para visualizar o código-fonte web.xml, selecione Origem:
<?xml version="1.0" encoding="UTF-8"?> <web-app id="WebApp_ID" version="3.0" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"> <servlet> <descrição> </description> <display-name> TestServlet</display-name> <servlet-name>TestServlet</servlet-name> <servlet-class>test.TestServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>TestServlet</servlet-name> <url-pattern> /TestServlet</url-pattern> </servlet-mapping> <welcome-file-list> <welcome-file>index.html</welcome-file> <welcome-file>index.htm</welcome-file> <welcome-file>index.jsp</welcome-file> <welcome-file>default.html</welcome-file> <welcome-file>default.htm</welcome-file> <welcome-file>default.jsp</welcome-file> </welcome-file-list> <resource-ref> <res-ref-name>SAMPLE</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> <res-sharing-scope>Shareable</res-sharing-scope> </resource-ref> </web-app> - Para editar sua referência de recurso, é possível fazer mudanças tanto na visualização Design quanto na Source da página do descritor de implementação.
- Para ligar esta referência de recurso a uma origem de dados no
servidor, com o nome JNDI jdbc/SAMPLE usando um alias de autenticação
JAAS denominado USER_AUTH, edite o arquivo ibm-web-bnd.xml
e inclua as definições a seguir:
- Se o arquivo ibm-web-bnd.xml não existir, crie o arquivo clicando com o botão direito no projeto e, em seguida, selecionando Ferramentas Java EE > Gerar Descritor de Implementação de Ligações do WebSphere.
- Clique com o botão direito no arquivo ibm-web-bnd.xml e selecione Abrir com > Editor de Ligações da Web.
- Inclua uma referência de recurso:
- Na visualização Design, clique em Add.
- Na janela Incluir Item, selecione Referência de Recurso. Clique em OK.
- No campo Nome, digite o nome de sua referência de recurso, por exemplo: SAMPLE.
- No campo Nome de Ligação, digite o nome de sua referência de recurso, por exemplo: jdbc/SAMPLE.
- Na visualização Design, destaque sua Referência de Recurso e clique em Add > Authentication Alias.
- Na seção Details, no campo Name, forneça um nome para seu Alias de Autenticação (por exemplo, utilize o alias de autenticação denominado USER_AUTH).

- Salve o arquivo.
- Para visualizar o código-fonte ibm-web-bnd.xml,
selecione Origem:
<?xml version="1.0" encoding="UTF-8"?> <web-bnd xmlns="http://websphere.ibm.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://websphere.ibm.com/xml/ns/javaee http://websphere.ibm.com/xml/ns/javaee/ibm-web-bnd_1_0.xsd" version="1.0"> <virtual-host name="default_host" /> <resource-ref name="SAMPLE" binding-name="jdbc/SAMPLE"> <authentication-alias name="USER_AUTH" /> </resource-ref> </web-bnd>
Tópico pai: Criando Módulos da Web