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

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

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

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

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

В сканере исходного кода доступно быстрое исправление. Процедура быстрого исправления получает информацию из элементов Resource и создает ссылку на ресурс или ссылку на среду ресурса (в зависимости от требований) и соответствующее имя JNDI. В Tomcat рекомендуется (но не требуется) определять соответствующую ссылку на ресурс для элемента Resource в файле WEB-INF/web.xml. Процедура быстрого исправления ищет список элементов resource-ref и resource-env-ref для проверки на совпадение с уже существующими именами. Если такого имени нет, оно будет создано. Если элемент Resource содержит атрибут auth, то будет создан resource-ref. Если в элементе Resource атрибут auth отсутствует, то будет создан resource-env-ref. В обоих случаях значение name используется в качестве имени JNDI и определяется в привязках.

Пример: в файле META-INF/context.xml расположен следующий элемент Resource:

<Resource name="jdbc/exampleDB" auth="Container" type="javax.sql.DataSource" description="Example Database"/>

Процедура быстрого исправления может создать соответствующий элемент <resource-ref>:

<resource-ref> <description> Example Database</description> <res-ref-name>jdbc/exampleDB</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> <res-sharing-scope>Shareable</res-sharing-scope> </resource-ref>

По умолчанию ресурсы в Tomcat могут использоваться совместно. Если в элементе Resource не задана область, то при создании новой ссылки на ресурс для быстрого исправления область задается как доступная для совместного использования. Если в файле WEB-INF/web.xml уже существует соответствующая ссылка на ресурс, то не вносятся никакие изменения.

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

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

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

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