Где находится документация для sun-ejb-jar.xml и ejb-jar.xml версии 3.1?

Question

У меня должен быть действительно плохой день, потому что независимо от того, что я ищу, я получаю только эту ссылку , в которой есть только список разрешенных тегов XML для этих дескрипторов развертывания.

Я почти уверен, что однажды увидел документ с подробным описанием этих файлов, но, похоже, сейчас не могу его найти.

Answer 1

:) Руководство по развертыванию приложений GF -> Элементы дескрипторов развертывания сервера предприятия

Answer 2

sun-ejb-jar.xml - это старое соглашение об именах для того, что сегодня называется glassfish-ejb-jar.xml. Он по-прежнему поддерживается для обратной совместимости (см. Руководство по развертыванию GlassFish 4 , стр. B-2).

glassfish-ejb-jar.xml - это специфичный для GlassFish файл дескриптора развертывания , описанный в руководстве по развертыванию . Руководство по развертыванию описывает его техническую структуру и является хорошим началом для любого вопроса о конкретном элементе файла. Примеры того, как на самом деле использовать файл, распространяется по всей базе документов .

Все остальные серверы приложений скорее всего будут игнорировать этот файл. Заставить ваше приложение зависеть от содержимого этого файла - то же самое, что сделать ваше приложение непереносимым . Таким образом, его следует избегать, насколько это возможно.

Позвольте мне процитировать руководство по развертыванию GlassFish (стр. 1-3):

Если не указано иное, параметры в развертывании сервера GlassFish дескрипторы переопределяют соответствующие настройки в стандарте Java EE дескрипторы и в конфигурации сервера GlassFish.

Перезаписываемый стандартный и переносимый файл дескриптора имеет значение ejb-jar.xml и описан в спецификации EJB 3.2 . Наличие файла необязательно и, вероятно, его не следует использовать, если все, что вы делаете с файлом, - это описание поведения бина и сервисов от используемого сервера приложений. Если разработчик и разработчик приложения не являются разными людьми с разными потребностями или если у вас нет требования определять разные компоненты на основе одного и того же класса, то вы будете более чем покрыты только аннотациями. Таким образом, заявленные службы сервера приложений более тесно связаны с кодом, который фактически использует эти службы. Это повысит читабельность вашего кода и станет более понятным для большего числа людей. Одним из спорных важных и рекомендуемых способов использования файла является размещение настраиваемых записей среды в файле дескриптора. Если ваше приложение упаковано в файл EAR, рассмотрите возможность использования файла дескриптора application.xml для объявления записей среды.