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

É necessário criar um projeto da web usando Web 2.5, Web 3.0 e Web 3.1 para que você possa criar e configurar referências de recursos. Selecione Gerar descritor de implementação no assistente de criação de projeto.

Procedimento

  1. Expanda seu projeto da web e selecione WebContent > WEB-INF > web.xml.
  2. Clique com o botão direito em web.xml e selecione Abrir com > Editor do Descritor de Implementação do Aplicativo da Web.
  3. No campo Web application, selecione Add, selecione Resource Reference e clique em OK:
    Incluir referência de recurso
  4. Na seção Details, forneça os detalhes para sua referência de recurso:
    1. No campo Name, forneça um nome para sua referência de recurso.
    2. No campo Type, forneça o tipo da referência de recurso.
    3. No campo Authentication , selecione Application ou Container para a autenticação de sua referência de recurso.
    4. No campo Escopo de Compartilhamento, selecione Compartilhável ou Não Compartilhável para o escopo de compartilhamento de sua referência de recurso.
    5. No campo Description, digite uma descrição dessa referência de recurso.
  5. 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>
  6. 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.
  7. 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:
    1. 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.
    2. Clique com o botão direito no arquivo ibm-web-bnd.xml e selecione Abrir com > Editor de Ligações da Web.
    3. Inclua uma referência de recurso:
      1. Na visualização Design, clique em Add.
      2. Na janela Incluir Item, selecione Referência de Recurso. Clique em OK.
      3. No campo Nome, digite o nome de sua referência de recurso, por exemplo: SAMPLE.
      4. No campo Nome de Ligação, digite o nome de sua referência de recurso, por exemplo: jdbc/SAMPLE.
    4. Na visualização Design, destaque sua Referência de Recurso e clique em Add > Authentication Alias.
    5. 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).
      Inclua a ligação de JNDI
    6. Salve o arquivo.
    7. 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>
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: tcreateconfigresref.html