Пример Java EE 6 — Galleria

Вы когда-нибудь задумывались, где найти хорошие примеры сквозных примеров сборки с помощью Java EE 6? У меня есть. Большая часть информации, которую вы найдете в сети, очень проста и не решает реальных проблем. Это верно для учебника по Java EE 6. Все остальные вещи, как и большинство из того, что публикует Адам Бин, представляют собой очень узкие примеры, которые также не указывают на более полное решение.

Итак, мне было очень приятно наткнуться на более сложный пример, сделанный Винет Рейнольдс. Он называется « Java EE 6 Galleria », и вы можете скачать исходный код из bitbucket. Vineet — разработчик программного обеспечения, участвующий в проекте Arquillian; более конкретно, он внес исправления ошибок и работал над несколькими запросами функций для Arquillian Core, а также интеграции GlassFish, WebLogic и Tomcat для Arquillian. Здесь я впервые встретил его имя. И вслед за аркиллианскими ребятами он чуть ближе и прямо направит меня к этому примеру. Огромное спасибо Vineet за руку помощи во время моих первых попыток начать работу. Следите за ним, если вам нравится твиттер @VineetReynolds .

Вот краткое объяснение его предыстории, и это также серия из серии о том, как запускать ее в разных настройках, и указание на некоторые дополнительные детали под капотом. Это основное введение.

О Галерее

Общее описание проекта следующее: Java EE 6-Galleria — это демонстрационное приложение, демонстрирующее использование JSF 2.0 и JPA 2.0 в проекте Java EE с использованием Domain Driven Design. Он был написан, чтобы служить образцом для доменного проектирования в Java EE 6. Доменная модель приложения не является анемичной и состоит из объектов JPA. Затем объекты используются в сессиях EJB, которые действуют как прикладной уровень. Фасеты JSF используются на уровне презентации с использованием Mojarra и PrimeFaces. Проект стремится обеспечить всестороннее покрытие за счет использования как модульных, так и интеграционных тестов, написанных в JUnit 4. Модульные и интеграционные тесты для EJB и модель предметной области опираются на контейнерный API EJB 3.1. Интеграционные тесты для уровня представления опираются на проект Arquillian и его расширение Drone (для выполнения тестов Selenium).

Доменное проектирование с использованием Java EE 6

DDD как архитектурный подход возможен в Java EE 6. Это связано, прежде всего, с изменениями, внесенными в EJB 3.x и введением JPA. Улучшения, внесенные в спецификации EJB 3.x и JPA, позволяют моделировать домен и прикладной уровень в Java EE 6 с использованием DDD. Основная идея здесь состоит в том, чтобы спроектировать приложение, гарантирующее, что службы персистентности внедряются в уровень приложения и используются для доступа / сохранения объектов в контексте транзакции, установленном уровнем приложения.

Уровень домена

Приложение на данный момент содержит четыре объекта домена — Пользователь, Группа, Альбом и Фото, которые совпадают с объектами JPA в логической модели данных .

Слой репозитория

Помимо логической модели данных вы можете найти четыре репозитория — UserRepository, GroupRepository, AlbumRepository и PhotoRepository. Каждый для одной из четырех сущностей домена. Даже если DDD требует, чтобы у вас были репозитории только для агрегированного корня, а не для всех сущностей домена, он разработан таким образом, чтобы позволить прикладному уровню получать доступ к сущностям домена «Альбом и фотография» без необходимости перемещаться по альбомам и фотографиям через UserRepository. Репозитории являются сеансными компонентами без сохранения состояния без интерфейса и построены с использованием шаблона универсальной службы CRUD, опубликованного Адамом Бьеном .

Прикладной уровень

Прикладной уровень предоставляет услуги, которые должны использоваться уровнем представления. Он также отвечает за управление транзакциями, а также служит барьером отказов для нижележащих уровней. Прикладной уровень координирует работу с репозиториями домена и объектами домена для достижения желаемых целей предоставляемых сервисов. В некотором смысле этот уровень эквивалентен уровню обслуживания в традиционных приложениях. Прикладной уровень предоставляет свои сервисы через интерфейсы UserService, GroupService, AlbumService и PhotoService, а также отвечает за проверку предоставления доменных объектов из вышеперечисленных слоев, прежде чем координировать действия среди объектов в доменном слое. Это делается с помощью ограничений JSR-303 для доменных объектов.

Как это выглядит

И вот как выглядит этот пример, если вы используете его на последней версии GlassFish 3.1.2. Хотите настроить это самостоятельно? Ждите следующего поста или попробуйте сами;)

Ниже мы собираемся настроить пример как он есть непосредственно с последними версиями GlassFish 3.1.2, Hibernate и Derby.

подготовка

Настройтесь на какую-то конфигурацию. Установите Grep последнюю версию NetBeans 7.1 (в версию Java EE уже включена необходимая версия GlassFish 3.1.2 ) и установите ее. Я также предполагаю, что у вас есть приличный Java SDK 7 (6 тоже подойдет). В зависимости от стратегии развития вам также понадобятся Mercurial Client и Maven. По крайней мере, Maven также включен в NetBeans, так что … я имею в виду … зачем делать вашу жизнь сложнее, чем она есть сейчас? 😉

Среды

Еще несколько слов об окружающей среде. Этот пример был настроен для поддержки различных сред. Начиная с простой среды «разработки», вам также необходимо настроить «тестовую» и последнюю, но не менее важную «рабочую» среду. Все различные среды обрабатываются профилями maven, поэтому вам, возможно, придется немного настроить в течение следующих минут.

Создайте экземпляры базы данных

Первое, что нужно сделать, это решить, куда положить все свои вещи. В примерах используется дерби из коробки, и поэтому вы должны либо установить Java DB (часть JDK), либо использовать экземпляр дерби GlassFish, который предварительно сконфигурирован для NetBeans. Давайте усложним это и предположим, что мы используем установку Java DB, которая поставляется с вашим JDK. Продолжайте, откройте приглашение CMD и перейдите к папке% JAVA_HOME% и далее вниз по папке / bin базы данных. Выполните сценарий «startNetWorkServer» и следите за запуском экземпляра derby. Теперь откройте другое приглашение CMD и перейдите в папку db / bin и выполните сценарий «ij». Это должно придумать подсказку ”ij>. Теперь введите следующую строку подключения:

Эта команда соединяет вас с экземпляром derby и создает базу данных GALLERIATEST, если она еще не существует. В примере Galleria в качестве инструмента управления изменениями базы данных используется удобный небольшой инструмент под названием dbdeploy . Это позволяет вам делать постепенные обновления физической модели базы данных, которые отслеживаются в таблице изменений. (Подробнее об этом позже в серии). Вы должны создать таблицу изменений:

  CREATE TABLE changelog (
   change_number DECIMAL (22,0) NOT NULL,
   complete_dt TIMESTAMP NOT NULL,
   apply_by VARCHAR (100) NOT NULL,
   описание VARCHAR (500) НЕ NULL
 );

 ALTER TABLE changelog ADD CONSTRAINT Pkchangelog PRIMARY KEY (номер_смены);

Вы можете повторить шаги для любого другого необходимого вам экземпляра (производственного и т. Д.), Просто изменив имя базы данных в операторе соединения. И не забудьте создать таблицу изменений в каждом экземпляре.

И если вам не нравится этот подход. Запустите NetBeans, перейдите на вкладку служб, выберите «Новое соединение» и добавьте новое сетевое соединение Java DB с хостом: localhost, порт: 1527 и База данных: GALLERIATEST; create = true. Установите для пользователя и пароля значение «APP» и нажмите «Test Connection». Выберите APP в качестве схемы для вашей новой БД. И вы сделали!