Usar descritores de implementação Java EE e ligações WebSphere para definir as referências do link de recurso

Esta regra sinaliza os elementos Context <ResourceLink> localizados no arquivo META-INF/context.xml que podem precisar de migração.

O Apache Tomcat permite que os elementos Context <ResourceLink> sejam definidos nestes locais:

• O arquivo META-INF/context.xml
• O arquivo de configuração XML do aplicativo no diretório conf do Tomcat
• O elemento <Host> no conf/server.xml

Como a ferramenta de migração pode não ter acesso ao diretório de configuração Tomcat, a ferramenta de migração migra apenas o arquivo META-INF/context.xml. As informações do ResourceLink definidas nos outros locais podem ser copiadas para o arquivo META-INF/context.xml para que sejam processadas.

Há uma correção rápida disponível no scanner de origem. A correção rápida toma as informações dos elementos ResourceLink e cria uma referência de recurso e um nome JNDI correspondente da seguinte maneira:

• A correção rápida procura a lista de resource-ref para ver se a entrada que corresponde ao nome já existe. Se não, uma será criada.
• O atributo de nome ResourceLink é usado para o res-ref-name em web.xml
• O atributo de tipo ResourceLink é usado para res-type em web.xml
• O atributo global ResourceLink é usado para o binding-name no arquivo de ligação IBM
• O res-auth é configurado como Container
• O res-sharing-scope é configurado como Shareable

Observe que os outros atributos ResourceLink (factory, username e password) não são migrados automaticamente. Se o seu aplicativo usar esses atributos em um ResourceLink, você precisará criar um recurso exclusivo na configuração do servidor, fornecer ao recurso um nome JNDI exclusivo e atualizar o arquivo de ligação IBM com o novo nome JNDI.

Se o projeto da for Java EE 5 ou superior e o WEB-INF/web.xml não existir, o WEB-INF/web.xml será criado e os novos elementos de referência do link de recurso serão incluídos. Se o projeto da web estiver em J2EE 1.4 ou inferior, a correção rápida relatará um erro.

Por exemplo, considerando um META-INF/Context.xml contendo o ResourceLink a seguir:

<ResourceLink global="jdbc/SampleWebGlobal" name="jdbc/SampleWeb" type="javax.sql.DataSource"/>

A correção rápida atualizará ou criará um novo resource-ref no arquivo web.xml semelhante a este exemplo:

<resource-ref id="ResourceRef_1313785392722"> <res-ref-name>jdbc/SampleWeb</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> <res-sharing-scope>Shareable</res-sharing-scope> </resource-ref>

O nome JNDI é incluído no arquivo de ligações IBM. Ele faz referência à referência existente no web.xml. Se o arquivo de ligações ainda não existir, ele será criado.

Você também precisará configurar o recurso na configuração do WebSphere Application Server.

Para obter informações adicionais sobre a definição de recurso do contexto no Tomcat, consulte:

• Referência de configuração do Apache Tomcat – Links de recurso.