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

Esta regra sinaliza Context <ResourceLink> localizado no arquivo META-INF/context.xml que pode precisar de migração.

Apache Tomcat permite Context <ResourceLink> a serem definidos nesses locais:

• O arquivo META-INF/context.xml
• O arquivo de configuração XML do aplicativo no diretório conf do Tomcat
• O <Host> no elemento 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. ResourceLink as informações definidas em outros locais podem ser copiadas para o arquivo META-INF/context.xml arquivo para para que ele seja processado.

A correção automatizada obterá as informações do ResourceLink e cria uma referência de recurso e um nome JNDI correspondente, como segue:

• A correção automatizada pesquisará a lista de resource-ref para ver se a entrada correspondente ao nome já existe. Se não, uma será criada.
• O ResourceLink é usado para o atributo de nome res-ref-name em web.xml
• O ResourceLink é usado para o atributo de tipo res-type em web.xml
• O ResourceLink é usado para o atributo global binding-name no arquivo de vinculação IBM
• O res-auth é definido como Container
• O res-sharing-scope está definido como Compartilhável

Observe que os outros ResourceLink (fábrica, nome de usuário e senha) não são migrados automaticamente. Se seu aplicativo usar esses atributos em a ResourceLink se o recurso for um recurso exclusivo, você precisará criar um recurso exclusivo na configuração do servidor, fornecer ao recurso um nome JNDI exclusivo e atualizar o arquivo IBM arquivo de vinculação 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 automática informará um erro.

Por exemplo, dado um META-INF/Context.xml contendo os seguintes ResourceLink :

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

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:

• Apache Tomcat Referência de configuração - Links de recursos.