Файлы описания Java EE и привязки WebSphere следует использовать для определения ссылок на ресурсы

Это правило отмечает элементы Context <ResourceLink> в файле META-INF/context.xml, для которых может потребоваться миграция.

Apache Tomcat позволяет определять элементы Context <ResourceLink> в следующих расположениях:

• Файл META-INF/context.xml
• Файл конфигурации XML приложения в каталоге Tomcat conf
• Элемент <Host> в файле conf/server.xml

Так как инструмент миграции может не иметь доступа к каталогу конфигурации Tomcat, то выполняет миграцию только файла META-INF/context.xml. Информация ResourceLink, определенная в других расположениях, может быть скопирована в файл META-INF/context.xml для обработки.

В сканере исходного кода доступно быстрое исправление. Процедура быстрого исправления получает информацию из элементов ResourceLink и создает ссылку на ресурс и соответствующее имя JNDI следующим образом:

• Процедура быстрого исправления выполняет поиск в списке resource-ref для проверки на совпадение с уже существующим именем. Если такого имени нет, оно будет создано.
• Атрибут имени ResourceLink используется для res-ref-name в файле web.xml
• Атрибут типа ResourceLink используется для res-type в файле web.xml
• Глобальный атрибут ResourceLink используется для binding-name в файле привязки IBM
• Атрибуту res-auth присвоено значение Container
• Атрибуту res-sharing-scope присвоено значение Shareable

Обратите внимание, что другие атрибуты ResourceLink (factory, username и password) не переносятся автоматически. Если приложение использует эти атрибуты в ResourceLink, то потребуется создать уникальный ресурс в конфигурации сервера. Укажите ресурс с уникальным именем JNDI и замените в файле привязки IBM имя на это новое имя JNDI.

Если веб-проект использует Java EE 5 или выше, а файл WEB-INF/web.xml не существует, то файл WEB-INF/web.xml будет создан, и в него будут добавлены элементы ссылок на ресурсы. Если веб-проект использует J2EE 1.4 или ниже, то процедура быстрого исправления выведет сообщение об ошибке.

Например, рассмотрим файл META-INF/Context.xml содержащий следующую запись ResourceLink:

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

Процедура быстрого исправления изменит (или создаст новый) элемент resource-ref в файле web.xml, как показано в следующем примере:

<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>

Имя JNDI добавляется в файл привязок IBM. Оно связывается с существующей ссылкой, определенной в web.xml. Если файл привязок еще не существует, он будет создан.

Также потребуется настроить ресурс в конфигурации WebSphere Application Server.

Дополнительная информация об определении ресурса контекста в Tomcat приведена в следующем разделе:

• Справочник по конфигурации Apache Tomcat - Ссылки на ресурсы.