Разработка различных уровней web приложений в J2EE и .NET

Дескрипторы развертывания компонентов EJB

Помимо декларации интерфейсов и классов компонентов, для построения EJB-компонента необходимо написать дескриптор развертывания — XML-файл в специальном формате, определяющий набор компонентов приложения и их основные свойства.

Чаще всего дескрипторы развертывания не пишут вручную, их готовят с помощью специализированных инструментов для развертывания J2EE-приложений или сред разработки (например, такими возможностями обладает среда NetBeans 4.0 [3]). Здесь мы опишем только часть содержимого дескрипторов развертывания. Полное описание используемых в них тегов и их назначения см. в [2].

Дескриптор развертывания упаковывается вместе с байт-кодом классов компонентов приложения в JAR-архив. При развертывании такой архив помещают в выделенную директорию, в которой сервером J2EE ищет развертываемые приложения. После этого сервер сам осуществляет запуск приложения и поиск кода компонентов, необходимых для обработки поступающих запросов, на основании информации, предоставленной дескриптором.

Заголовок дескриптора развертывания для набора EJB-компонентов версии 2.1 выглядит следующим образом.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE ejb-jar PUBLIC "-//Sun Microsystems, Inc.//DTD Enterprise JavaBeans 2.0//EN" 
                          http://java.sun.com/j2ee/dtds/ejb-jar_2_1.dtd">

Дескриптор развертывания содержит следующие теги.

• <ejb-jar>

  Обязательный элемент.

  Это корневой тег дескриптора развертывания набора EJB-компонентов, содержащий все остальные теги.
• <enterprise-beans>

  Обязательный элемент, должен появиться внутри <ejb-jar> ровно один раз.

  Содержит набор описаний отдельных EJB-компонентов в виде элементов <entity>, <session>, <message-driven>.
• <entity> и <session>

  Эти теги вложены в тег <enterprise-beans> и служат для описания, соответственно, компонентов данных и сеансовых компонентов. Они могут содержать следующие вложенные теги.

  • <ejb-name>

    Требуется ровно один.

    Задает имя компонента.
  • <home>

    Необязателен, начиная с EJB 2.0. В EJB 1.1 требуется ровно один.

    Указывает полное имя удаленного исходного интерфейса.
  • <remote>

    Необязателен, начиная с EJB 2.0. В EJB 1.1 требуется ровно один.

    Указывает полное имя удаленного интерфейса.
  • <local-home>

    Необязателен.

    Указывает полное имя локального исходного интерфейса.
  • <local>

    Необязателен.

    Указывает полное имя локального интерфейса.
  • <ejb-class>

    Требуется ровно один.

    Указывает полное имя класса компонента.
  • <primkey-field>

    Необязателен, используется в описании компонентов данных.

    Указывает имя поля, являющегося первичным ключом (если он состоит только из одного поля и синхронизацией компонента с базой данных управляет контейнер).
  • <prim-key-class>

    Требуется ровно один, используется в описании компонентов данных.

    Указывает имя класса первичного ключа. Можно отложить точное определение класса первичного ключа до развертывания, тогда в этом поле указывается java.lang.Object.
  • <persistence-type>

    Требуется ровно один, используется в описании компонентов данных.

    Имеет значения Bean или Container, в зависимости от того, управляется ли синхронизация компонента с базой данных самим компонентом или контейнером.
  • <cmp-version>

    Необязателен.

    Указывает версию спецификаций EJB, в соответствии с которой разработан компонент, что определяет способ управления этим компонентом. Может иметь значения 2.x и 1.x.
  • <abstract-schema-name>

    Необязателен.

    Задает уникальный идентификатор компонента для использования в запросах на языке EJB QL, который используется для описания запросов к схеме данных при реализации компонента данных, самостоятельно управляющего связью с СУБД.
  • <cmp-field>

    Один или более, используется в описании компонентов данных.

    Каждый такой элемент описывает одно поле данных, синхронизация которого с СУБД управляется EJB-контейнером. Он может содержать тег <description> с описанием поля и должен содержать тег <field-name> с именем поля. В EJB 2.0 это имя совпадает с именем абстрактного свойства (для которого в классе компонента декларированы методы getName() и setName() ), а в EJB 1.1 — с именем одного из полей класса компонента.
  • <security-role-ref>

    Один или более, необязателен.

    Указывает роли, используемые данным компонентом. Они при работе приложения служат для авторизации доступа — сопоставляются с ролями, которым разрешен доступ к тому или иному методу.

    Может содержать тег <description> (необязателен) и теги <role-name> (обязателен), <role-link> (необязателен, служит для сопоставления указанного имени роли с логической ролью, описанной в <security-role> раздела <assembly-descriptor> ).
  • <security-identity>

    Необязателен.

    Определяет, какую логическую роль будет играть данный компонент при обращениях к другим компонентам. Для этого может быть использован вложенный тег <run-as><role-name>…</role-name></run-as> для указания имени конкретной логической роли, или <use-caller-identity/> для указания того, что нужно использовать роль вызывающего клиента.
  • <session-type>

    Требуется ровно один, используется в описании сеансовых компонентов.

    Имеет значения Stateful или Stateless, в зависимости от того, использует ли данный компонент состояние сеанса.
  • <transaction-type>

    Требуется ровно один, используется в описании сеансовых компонентов.

    Имеет значения Container или Bean, в зависимости от того, управляет ли транзакциями данного компонента контейнер или он сам. В первом случае соответствующие транзакции должны быть описаны в разделе <assembly-descriptor> (см. далее).
  • <query>

    Один или более, необязателен.

    Используется для описания запросов, с чьей помощью реализуются некоторые методы компонентов данных, которые сами управляют связью с базой данных. Запросы описываются на языке EJB QL [X] и привязываются к методам компонента с помощью тегов <query-method>. Сам код запроса описывается внутри элемента CDATA во вложенном теге <ejb-ql>.

    Например

    <query>
      <query-method>
        <method-name>findByName</method-name>
        <method-params>
          <method-param>java.lang.String</method-param>
        </method-params>
      </query-method>
      <ejb-ql>
        <!CDATA[
          SELECT OBJECT(c) FROM Client c WHERE c.name = ?1
        ]]
      </ejb-ql>
    </query>
  • <relationships>

    Необязателен. Вложен в <ejb-jar>.

    Описывает набор отношений между компонентами, которые соответствуют связям в схеме базы данных и автоматически поддерживаются контейнером. Каждое отношение описывается с помощью вложенного тега <ejb-relation>.
  • <ejb-relation>

    Описывает одно отношение и может иметь следующие элементы.

    • <ejb-relation-name>

      Необязателен, только один. Задает имя отношения.
    • <ejb-relationship-role>

      Обязательно два. Описывает одну роль в рамах отношения. В описании роли должны присутствовать следующие данные.
    • Имя роли — во вложенном теге <ejb-relationship-role-name>.
    • Множественность — сколько экземпляров компонента могут играть такую роль в рамках данного отношения с одним экземпляром в другой роли. Описывается в теге <multiplicity> и может иметь значения One или Many.
    • Имя компонента, экземпляры которого играют данную роль в этом отношении. Определяется в теге <relationship-role-source> внутри тега <ejb-name> в виде имени, которое присвоено компоненту в рамках данного дескриптора.
    • Имя поля, которое хранит ссылку или коллекцию ссылок, поддерживающие это отношение в рамках экземпляра компонента. Определяется в теге <cmr-field>, во вложенном теге <cmr-field-name>, и для него в классе компонента должно быть определено абстрактное свойство с тем же именем.
• <assembly-descriptor>

  Этот обязательный тег внутри <ejb-jar> содержит дополнительные указания для сборки компонентов, в частности следующие.

  • <container-transaction>

    Один или более, необязателен.

    Содержит необязательный элемент <description>, а также приведенные ниже.

    Для компонента данных должно быть по одному такому элементу на каждый метод удаленного интерфейсов. Сеансовые компоненты, транзакциями которых управляет EJB-контейнер, также должны подчиняться этому правилу.

    • <method>

      Один или более.

      Содержит тег <ejb-name>, указывающий имя компонента, и <method-name>, указывающий имя метода или знак *, который обозначает применение указанного атрибута ко всем методам.

      Может также включать элементы <description>, <method-params> и <method-intf>, который может иметь значения Remote, Home, Local, Local-Home, в зависимости от того, в каком интерфейсе этот метод декларирован — для поддержки возможности декларировать методы с одним именем и набором параметром в разных интерфейсах.
    • <trans-attribute>

      Ровно один.

      Определяет атрибут транзакции, управляющий политикой включения в транзакции или создания новых транзакций.

      Для компонентов данных атрибуты транзакции должны быть определены для всех методов удаленного интерфейса и методов, декларированных в исходном интерфейсе, для сеансовых компонентов — для всех методов удаленного интерфейса.

      Может иметь значения NotSupported, Supports, Required, RequiresNew, Mandatory, Never. Об их смысле рассказывалось в предыдущей лекции.
  • <security-role>

    Один или более, необязателен.

    Определяет роли, служащие для контроля доступа к методам компонентов. В таком элементе должен содержаться тег <role-name>, задающий имя роли.
  • <method-permission>

    Один или более, необязателен.

    Указывает правила доступа ролей, определенных в тегах <security-role>, к методам компонентов.

    Содержит необязательный тег <description>, один или несколько тегов <role-name> и один или несколько тегов <method> (см. выше), кроме того, в нем может присутствовать тег <unchecked/>, который обозначает отсутствие проверки прав доступа во время работы, даже если они описаны.

    Каждый тег <method> содержит тег <ejb-name>, указывающий имя компонента, и <method-name>, указывающий имя метода или знак *, который обозначает применение указанного атрибута ко всем методам.
  • <exclude-list>

    Необязателен.

    Содержит один или несколько тегов <method> (см. выше), определяющих методы, которые не должны вызываться при работе приложения. Каждый вызов такого метода создает исключительную ситуацию.