jActiveRecord-EL

jActiveRecord-EL — это вспомогательный проект jActiveRecord, который упрощает доступ к данным в выражениях EL. Он позволяет работать с объектами типов Record и Table так же, как с обычными JavaBeans. Проект подходит для веб-приложений, использующих jActiveRecord.

• Домашняя страница проекта: http://github.com/redraiment/jactiverecord-el.
• Javadoc: http://zzp.me/jactiverecord-el/.
• Страница jActiveRecord: http://github.com/redraiment/jactiverecord.

Управление проектом осуществляется с помощью Maven. В файле pom.xml необходимо добавить следующую зависимость:

<dependency>
  <groupId>me.zzp</groupId>
  <artifactId>jactiverecord-el</artifactId>
  <version>1.2</version>
</dependency>

Доступ к свойствам Record

Предположим, что у экземпляра Record user есть строковое свойство name. Если не использовать jActiveRecord-EL, то для получения значения этого свойства в выражении EL нужно написать следующее:

<h1>${user.get("name")}</h1>

После применения jActiveRecord-EL можно сделать так:

<h1>${user.name}</h1>

Таким образом, jActiveRecord-EL упрощает доступ к свойствам объектов Record в выражениях EL, позволяя работать с ними так же, как с JavaBeans.

Доступ к методам Table

Также jActiveRecord-EL упрощает работу с методами объектов Table. Поддерживаются следующие виды запросов: all, first, last и по индексу.

• all: вызов Table#all(). То есть ${User.all} эквивалентно ${User.all()}.
• first: вызов Table#first(). То есть ${User.first} эквивалентно ${User.first()}.
• last: вызов Table#last(). То есть ${User.last} эквивалентно ${User.last()}.
• По индексу: вызов Table#find(int id). То есть ${User[1]} эквивалентно ${User.find(1)}.

Обратите внимание, что ${User[1]} и ${User.all[1]} имеют разное значение. Первый возвращает запись из таблицы с идентификатором 1, а второй — вторую запись среди всех записей (индексация начинается с нуля).

Конфигурация

Расширение выражений EL

Для использования jActiveRecord-EL необходимо добавить в файл web.xml следующую информацию:

<listener>
  <listener-class>me.zzp.ar.el.ResolverSetup</listener-class>
</listener>

Использование метода именования CamelCase (опционально)

По умолчанию этот параметр включён. Это означает, что выражения EL, такие как ${user.created_at} и ${user.createdAt}, будут эквивалентны. Чтобы отключить автоматическое преобразование, добавьте в файл web.xml следующий параметр контекста:

<context-param>
  <param-name>jactiverecord-el-camel-case</param-name>
  <param-value>false</param-value>
</context-param>

Создание объекта базы данных (опционально)

При использовании jActiveRecord в веб-проектах обычно первым шагом является создание объекта базы данных через DataSource (javax.sql.DataSource). Поэтому jActiveRecord-EL предоставляет дополнительный прослушиватель контекста, который автоматически создаёт объект базы данных при запуске сервера и добавляет его в контекст. Для настройки необходимо выполнить следующие действия:

<listener>
  <listener-class>me.zzp.ar.el.DatabaseSetup</listener-class>
</listener>
<context-param>
  <param-name>jactiverecord-el-data-source</param-name>
  <param-value>java:/comp/env/jdbc/DataSource</param-value>
</context-param>

Переименование имён свойств (опционально)

Имя созданного объекта базы данных по умолчанию — dbo. Если вы хотите изменить это имя, можно указать следующую информацию в файле web.xml:

<context-param>
  <param-name>jactiverecord-el-attribute-name</param-name>
  <param-value>database</param-value>
</context-param>

В этом случае имя будет изменено на database.