Глава 4. Настройка JAWS

Содержание

Введение
Указание (Определение) источника данных
Опции JAWS
Как указать (рассказать) JAWS Ваши таблицы [Telling JAWS about your tables]
Декларирование методов поиска (Определение)[Declaring finders]
Определение карты типов [Defining a type mapping]
Зависимые объекты-значения [Dependant Value Objects [since JBoss 2.4]]

Автор:Sebastien Alborini <sebastien.alborini@m4x.org>

Совместимость с JBoss 2.2 проверена: Vincent Harcq <vincent.harcq@hubmethods.com>

Введение

JAWS это O/R mapper используемый JBoss'ом для управления CMP entity beans. JAWS сконфигурирован с помощью файла standardjaws.xml, находящегося в директории conf/config-name дистрибутива JBoss. Стандартное “имя конфигурации” [config-name] - “default”.

Этот файл конфигурирует JAWS для всех сущностей [instances] JBoss. Вы можете расширить эту конфигурацию для каждого приложения если поместите файл jaws.xml в директорию META-INF Вашего приложения. Во время развертывания Ваших бинов JAWS сперва обработает файл standardjaws.xml, и затем jaws.xml Вашего приложения (если он будет предоставлен).Заметьте, что если вкладываете Ваш jar архив внутрь ear архива для развертывания, файл jaws.xml должен быть помещен в директорию META-INF jar архива.

Вот все что Вы можете сделать при помощи standardjaws.xml / jaws.xml:

  • Определить источник данных и карты преобразований типов [type-mappings] для него

  • Определить набор опций относящихся к поведению jaws

  • Описать как JAWS должен компоновать [build]/использовать Ваши таблицы

  • Определить методы поиска для доступа к Вашим entity beans

  • Дефинировать карту преобразований типов [type mapping]

Если Вы хотите что-либо узнать о jaws.xml, загляните в Jaws.xml DTD. Там Вы найдете обобщенную структуру файла jaws.xml. Все части этого файла факультативны: Вы определяете только то, что Вам нужно!

Сгрузите и инсталлируйте весь исходный код как пояснено в в разделе “Загрузка примеров кода для документации”

Стартуйте команду "ant cmp-jaws-compile" из поддиректории "build/". Этим самым будет создан jar-архив "documentation-example/build-examples/cmp-jaws/ejb/class.jar". Скопируйте его в директорию "deploy" Вашей инсталляции JBoss. Этот пример демонстрирует все возможности описанные в этой главе. Если Вы захотите изменить файлы так, как пояснено в этой главе, просто перекомпонуйте[rebuild] Ваш EJB заново и разверните его чтобы увидеть изменения.

Наши друзья