Технологии программирования. Компонентный подход (стр. 5 )

o <ejb-ref>
Может быть несколько, необязателен.
Предназначен для определения ссылок на другие компоненты, которые можно использовать для получения удаленного доступа к ним через JNDI.
Такой тег может содержать тег <description> (необязателен) и теги <ejb-ref-name> (обязателен), <ejb-ref-type> (обязателен, имеет значения Entity или Session), <remote> (обязателен, определяет имя удаленного интерфейса компонента), <home> (обязателен, определяет имя удаленного внешнего интерфейса компонента), <ejb-link> (необязателен, определяет имя копонента, если он описан в том же дексрипторе развертывания). Доступ к компоненту можно получить через интерфейс JNDI используя имя "java:comp/env/<name>". Рекомендуется использовать подконтекст "ejb/".

o <ejb-local-ref>
Может быть несколько, необязателен, появился в EJB 2.0.
Объявляет имя компонента, которое можно использовать для получения локального доступа к нему через JNDI.
По содержанию аналогичен <ejb-ref>, но вместо удаленных интерфейсов с помощью тегов <local>, <local-home> описывает локальные.

o <resource-ref>
Может быть несколько, необязателен.
Описывает ссылки на внешние ресурсы (классы фабрик ресурсов), которые можно использовать для получения к ним доступа через JNDI.
Такой тег может содержать тег <description> (необязателен) и теги <res-ref-name> (обязателен), <res-type> (обязателен, указывет полное имя класса фабрики ресурса), <res-auth> (обязателен, указывает ответственного за аутентификацию ресурса — Container или Application, т. е. контейнер или смо приложение).
Доступ к ресурсу можно получить через интерфейс JNDI используя имя "java:comp/env/<name>". Рекомендуется использовать подконтексты
"jdbc/" для ресурсов подключений к БД, например DataSource,
"jms/" для ресурсов, связанных с передачей сообщений, например QueueConnectionFactory и TopicConnectionFactory,
"mail/" для ресурсов службы JavaMail,
"url/" для ресурсов, связанных с доступом по Интернет, например javax.net.URL.
Если несколько компонентов в рамках одной транзакции должны работать содним ресурсом, в EJB 2.0 этот ресурс должен быть объявлен разделяемым при помощи необязательного тега <res-sharing-scope>, который может иметь значения Shareable и Unshareable.

o <resource-env-ref>
Может быть несколько, необязателен, появился в EJB 2.0.
Описывает ссылки на дополнительные объекты, необходимые для работы с ресурсами.
Может содержать тег <description> (необязателен) и теги <resource-env-ref-name> (обязателен), <resource-env-res-type> (обязателен, указывет полное имя класса дополнительного объекат).
В качестве дополнительных объектов могут фигурировать, например, темы сообщений, с которыми компонент хочет работать через службу JMS.

o <security-role-ref>
Может быть несколько, необязателен.
Указывает роли безопасности, используемые данным компонентом. Они при работе приложения служат для проверки безопасности — сопоставляются с ролями, которым разрешен доступ к тому или иному методу, чтоможно проверить при помощи метода EJBContext.isCallerInRole(String).
Может содержать тег <description> (необязателен) и теги <role-name> (обязателен), <role-link> (необязателен, служит для сопоставления указанного имени роли с логической ролью, описанной в <security-role> раздела <assembly-descriptor>).

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

o <session-type>
Требуется ровно один, используется в описании сеансовых компонентов.
Имеет значения Stateful или Stateless, в зависимости от того, с состоянием ли данный компонент или без.

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

o <query>
Может быть несколько, необязателен, появился в EJB 2.0.
Используется для описания запросов, с помощью которых реализуются некоторые методы компонентов данных. Запросы описываются на языке EJB QL, привязыются к методам с пмощью тегов <query-method>.
Например
<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>

· Элементы <message-driven>
Служат для описания компонентов данных и сеансовых компонентов. Могут содержать теги <description> с общим описанием компонента, <display-name> с меткой, используемой инструментами, <small-icon> и <large-icon> с указанием на файлы иконок для представления компонента в среде разработки.

o <ejb-name>
Требуется ровно один.
Задает имя компонента.

o <ejb-class>
Требуется ровно один.
Указывает имя класса компонента.

o <env-entry>, <ejb-ref>, <ejb-local-ref>, <resource-ref>, <resource-env-ref>, <security-identity>, <transaction-type>
Все эти теги имеют то же значение, что и для сеансовых компонентов и компонентов данных.

o <message-selector>
Селектор сообщений может использовать свойства сообщений в условынх выражениях для отбрасывания тех из них, которые не должны обрабатываться данным компонентом. Поскольку синтаксис этих выражений может конфликтовать с синтаксисом XML, их надо помещать в специальные разделы CDATA, которые не анализируются XML-процессорами.
Например,
<message-selector>
<![CDATA[
(Sum > 500.00) AND (Sum/Count >= 75.00) AND (State IN ('F', 'S', 'A', 'X'))
]]>
</message-selector>

o <acknowledge-mode>
Учитывается, только если компонент сам управляет транзакциями. Определяет используемый тип подтверждения получения соощений. Может иметь значения Auto-acknowledge, что означает немедленное подтверждение получения сообщения, или Dups-ok-acknowledge, если подтверждение может откладываться — это может повысить производительность, но и привести к повторным подтверждениям.

o <message-driven-destination>
Определяет тип подписки — на определенную очередь сообщений или на определенную тему, соответственно, javax.jms.Queue или javax.jms.Topic.

· Раздел <relationships>
Служит для описания отношений между компонентами, управляемых контейнером.
Для каждого отношния в этот раздел вносится тег <ejb-relation>, который может иметь следующие элементы.

o <ejb-relation-name>
Необязателен, только один.
Задает имя отношения.

o <ejb-relationship-role>
Обязательно два.
Описывает одну роль в рамах отношения.

§ <ejb-relationship-role-name>
Определяет имя роли в рамах отношения.

§ <multiplicity>
Определяет множественность — сколько экземпляров компонента могут участвовать в этой роли в рамках отношения с одним экземпляром в другой роли.
Имеет возможные значения One или Many.