• Проект используетпример базы данных, доступный для серверов баз данных MySQL или JavaDB. Для получения более подробной информации по использованию сервера баз данных MySQL с помощью среды IDE и созданию подключения к базе данных см. руководство Подключение к базе данных MySQL. Кроме того, можете использовать подключение к примеру базы данных JavaDB. База данных создается и регистрируется в среде IDE по умолчанию, если вы установите вместе со средой IDE сервер GlassFish.

Загрузка и установка сервера

Перед регистрацией сервера необходимо загрузить установщик сервера WebLogic и выполнять действия, описанные в руководстве по установке сервера Oracle WebLogic для установки сервера на локальную машину. Кроме установки сервера, необходимо создать домен WebLogic, прежде чем можно будет зарегистрировать сервер в среде IDE.

1. Загрузите установщик со страницы Загрузки для сервера Oracle WebLogic.
2. Установите сервер, следуя указаниям в руководстве по установке сервера Oracle WebLogic.

   Не забудьте указать имя пользователя и пароль.

3. Создайте домен WebLogic.

   Можно использовать графический режим мастера настройки WebLogic для создания домена.

Будет также полезно посмотреть следующие разделы руководства по установке сервера WebLogic о деталях установки и настройки сервера.

• Подготовка к установке
• Введение в домены WebLogic
• Создание домена WebLogic

Регистрация сервера в IDE

После установки сервера вы можете использовать мастер добавления экземпляра сервера для регистрации экземпляра сервера, указав его домен.

1. Откройте окно "Services".
2. Щелкните правой кнопкой мыши узел "Servers" и выберите "Добавить сервер".
3. Выберите сервер Oracle WebLogic. Нажмите кнопку "Далее".
4. Нажмите кнопку "Поиск" и укажите директорию, содержащую установочный файл сервера. Нажмите кнопку "Далее".

   IDE автоматически идентифицирует домен для экземпляра сервера.

5. Введите имя пользователя и пароль для домена.
6. Активируйте JPA 2.0 (если он еще не активен). Нажмите кнопку "Готово".

   Примечание. Если вы регистрируете экземпляр сервера WebLogic 12c (12.1.1.0), JPA 2.0 активирован по умолчанию. Если вы регистрируете экземпляр сервера WebLogic 11g Rel 1 (10.3.4 или 10.3.5), вы можете активировать JPA 2.0 при регистрации сервера или в диспетчере серверов после регистрации. Для получения более подробной информации см. раздел Активация поддержки для JPA 2.0 ниже.

Когда вы нажмете кнопку "Готово", в узле серверов (окно "Services") появится сервер Oracle WebLogic.

Вы можете щелкнуть правой кнопкой мыши узел сервера Oracle WebLogic для выполнения различных действий, включая следующие:

• Запуск и остановка сервера
• Открытие администраторской консоли в обозревателе
• Просмотр журнала сервера в окне вывода IDE

Открытие администраторской консоли

В этом упражнении вы будете открывать администраторскую консоль сервера WebLogic в вашем обозревателе. Администраторская консоль позволяет настраивать сервер, а также просматривать запущенные приложения и доступные ресурсы.

1. Запустите сервер, щелкнув правой кнопкой мыши узел сервера Oracle WebLogic в окне "Services" и выбрав команду "Start".

   После запуска сервера вы увидите его журнал во вкладке сервера Oracle WebLogic в окне вывода.

   Если вкладка не видна, вы можете щелкнуть правой кнопкой мыши узел сервера Oracle WebLogic и выбрать команду "Просмотреть журнал сервера".

2. Щелкните правой кнопкой мыши узел сервера Oracle WebLogic и выберите команду "Просмотреть администраторскую консоль".

   При выборе команды "Просмотреть администраторскую консоль" в вашем обозревателе откроется экран входа на сервер.

3. Войдите с помощью имени пользователя и пароля, которые вы указали при установке сервера.

После входа вы увидите домашнюю страницу администраторской консоли в окне обозревателя.

Активация поддержки для JPA 2.0

Если вы используете сервер Oracle WebLogic 11g (10.3.4, 10.3.5), то вам необходимо активировать поддержку для интерфейса API сохранения состояния Java (JPA) 2.0 и установить поставщиком сохранения состояния по умолчанию TopLink. Сервер Oracle WebLogic 11g является контейнером Java EE 5 и совместим с JPA 1.0 и JPA 2.0. JPA 1.0 активируется по умолчанию при установке сервера Oracle WebLogic 10.3.4 и 10.3.5, но установка сервера WebLogic включает необходимые и для поддержки JPA 2.0. Вы можете активировать JPA 2.0 для сервера WebLogic при регистрации экземпляра сервера или в диспетчере серверов в среде IDE. Кроме того, вы можете воспользоваться инструкциями для Использования JPA 2.0 с TopLink в сервере WebLogic в документации сервера WebLogic.

Сервер WebLogic поддерживает интерфейс API сохранения состояния Java (JPA) и поставляется в пакете с библиотеками сохранение состояния Oracle TopLink и Kodo. В этом упражнении вы поменяете поставщика сохранения состояния по умолчанию с Kodo на Oracle Toplink в администраторской консоли сервера WebLogic.

Примечание. Поддержка TopLink и JPA 2.0 активированы по умолчанию при установке сервера WebLogic 12c.

Для активации поддержки JPA 2.0 в диспетчере серверов и установки поставщика сохранения состояния по умолчанию выполните следующие действия.

1. Щелкните правой кнопкой мыши узел сервера Oracle WebLogic в окне "Services" и выберите команду "Свойства", чтобы открыть диспетчер серверов.

   Для открытия диспетчера серверов вы также можете выбрать команды Инструменты > Серверы из главного меню.

   

   Вкладка "Домен" диспетчера серверов позволяет просматривать и изменять имя пользователя и пароль.

2. Выберите "Активировать JPA 2". Выберите "Close".

   Когда вы выберете команду "Активировать JPA 2", IDE изменит путь класса сервера WebLogic для добавления файлов с целью активации поддержки JPA 2.

   Примечание. Вы также можете активировать JPA 2.0 с помощью автоообновления Oracle или изменения пути класса сервера WebLogic вручную. Для получения более подробной информации про активацию поддержки для JPA 2.0 см. следующие ссылки.

   • Использование JPA 2.0 с TopLink в сервере WebLogic
   • Дискуссионный форум OTN: 11g Release 1 Patch Set 3 (WLS 10.3.4)
   • Запуск JPA 2.0 API на WebLogic 10.3
3. Откройте администраторскую консоль сервера Oracle WebLogic в браузере и войдите в систему.
4. Выберите команду Домен в разделе "Конфигурации домена" администраторской консоли.
5. Нажмите вкладку JPA в разделе "Конфигурация".
6. Выберите команду TopLink в раскрывающемся списке "Поставщик JPA по умолчанию". Нажмите кнопку "Сохранить".

Когда вы нажмете кнопку "Сохранить", Oracle TopLink станет поставщиком сохранения состояния по умолчанию для приложений, которые запускаются на сервере, если для данных приложений не указан конкретный поставщик сохранения состояния.

Примечание. Приложение в данном руководстве будет использовать интерфейс API транзакций Java. JTA активируется по умолчанию при установке WebLogic. Вы можете изменить настройки JTA во вкладке JTA, раздел "Конфигурации" для домена.

Создание проекта

В этом упражнении вы будете использовать мастер нового проекта для создания веб-приложения и укажете сервер Oracle WebLogic как целевой.

1. Выберите команды Файл > Новый проект (Ctrl-Shift-N; &#8984-Shift-N для Mac).
2. Выберите "Веб-приложение" в категории "Java Web". Нажмите кнопку "Далее".
3. Введите имя проекта WebLogicCustomer и укажите местоположение проекта.
4. Снимите флажок "Использовать отдельную папку", если он установлен. Нажмите кнопку "Далее".
5. Выберите сервер Oracle WebLogic из раскрывающегося списка серверов.
6. Выберите Java EE 5 как версию Java EE. Нажмите кнопку "Далее".
   
7. Выберите платформу JavaServer Faces.
8. Выберите JSF 2.0 из раскрывающегося списка серверных библиотек. Нажмите кнопку "Готово".
   

   Сервер Oracle WebLogic включает библиотеки, необходимые для использования JSF 1.2 и JSF 2.0 в ваших приложения, но по умолчанию они неактивны. Вам необходимо запустить и установить библиотеки перед использованием. Если библиотека еще не установлена; IDE может установить ее за вас, если вы выберете библиотеку в мастере новых проектов.

   

   Примечание. Библиотеку необходимо устанавливать только один раз.

   Когда вы нажмете кнопку "Закончить", IDE создаст проект веб-приложения и откроет файл index.xhtml в редакторе. IDE изменила web.xml, указав faces/index.xhtml в качестве начальной страницы по умолчанию.

9. Расширьте узел "Файлы конфигурации" в окне "Проекты" и дважды щелкните на файле дескриптора weblogic.xml для его открытия в редакторе.
   

   Когда вы откроете файл дескриптораweblogic.xml в редакторе, он будет примерно такого вида:

   <?xml version="1.0" encoding="UTF-8"?>
   <weblogic-web-app xmlns="http://www.bea.com/ns/weblogic/90" xmlns:j2ee="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.bea.com/ns/weblogic/90 http://www.bea.com/ns/weblogic/90/weblogic-web-app.xsd">
     <jsp-descriptor>
       <keepgenerated>true</keepgenerated>
       <debug>true</debug>
     </jsp-descriptor>
     <context-root>/WebLogicCustomer</context-root>
     <fast-swap>
       <enabled>true</enabled>
     </fast-swap>
   </weblogic-web-app>

   Примечание.Если целевой сервер - WebLogic 11g, когда вы просматриваете файл дескриптора weblogic.xml, то можете увидеть, что IDE изменил файл, указав библиотеку JSF, которая будет использоваться с вашим приложением. Вы увидите, что ссылка на библиотеку в файлеweblogic.xml соответствует версии JSF 2.0 JAR, которую вы активировали на панели "Платформы" в мастере новых проектов.

   <?xml version="1.0" encoding="UTF-8"?>
   <weblogic-web-app xmlns="http://www.bea.com/ns/weblogic/90" xmlns:j2ee="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.bea.com/ns/weblogic/90 http://www.bea.com/ns/weblogic/90/weblogic-web-app.xsd">
     <context-root>/WebLogicCustomer</context-root>
     <library-ref>
         <library-name>jsf</library-name>
         <specification-version>2.0</specification-version>
         <implementation-version>1.0.0.0_2-0-2</implementation-version>
         <exact-match>true</exact-match>
     </library-ref>
     <fast-swap>
       <enabled>true</enabled>
     </fast-swap>
   </weblogic-web-app>

10. Внесите следующие изменения в элемент <fast-swap> в weblogic.xml, чтобы изменить значение на false. Сохраните изменения.

        <fast-swap>
            <enabled>false</enabled>
        </fast-swap>
    </weblogic-web-app>

Создание подключения к базе данных

Данное руководство использует базу данных с именемsample, работающую на сервере базы данных MySQL. В этом упражнении вы используете IDE для создания базы данных и заполнения ее таблиц. Затем вы откроете подключение к базе данных. IDE будет использовать детали подключения к базе данных для создания элемента устойчивости приложения. Для получения более подробной информации об использовании сервера базы данных MySQL с IDE см. руководство Подключение к базе данных MySQL

Примечание. Кроме того, если вы установили сервер GlassFish при установке IDE, вы можете использовать подключение к примерной базе данных на сервере JavaDB, который был зарегистрирован автоматически во время установки IDE.

В этом упражнении вы создадите и откроете подключение к базе данных.

1. Щелкните правой кнопкой мыши на узле сервера MySQL в окне "Service" и выберите команду "Подключиться".
2. Введите имя пользователя и пароль. Нажмите кнопку "ОК".
3. Правой кнопкой мыши щелкните узел "Сервер MySQL" и выберите команду "Создать базу данных".
4. Выберите sample в раскрывающемся списке имен новой базы данных. Нажмите кнопку "ОК".
   

   Примечание. В зависимости от конфигурации базы данных вам может потребоваться указать разрешения для доступу к новой базе данных.

   Когда вы нажмете кнопку ОК, IDE создаст примерную базу данных и заполнит ее таблицы. Если вы расширите узел сервера MySQL, то увидите, что теперь список баз данных содержит новую базу данных sample.

5. Расширьте узел сервера MySQL, щелкните правой кнопкой мыши базу данных sample и выберите команду "Подключиться".

Когда вы нажмете кнопку "Подключиться", в узле "Базы данных" появится узел для подключения. Вы можете расширить узел для просмотра таблиц базы данных.

IDE использует подключение к базе данных для получения информации о ней. IDE также использует детали подключения к базе данных для генерирования файла XML, который используется сервером WebLogic для создания источников данных на сервере и идентификации соответствующих драйверов.

Если у вас не установлена база данных MySQL, вы можете использовать базу данных sample на JavaDB. Если база данных sample не существует, вы можете нажать правой кнопкой мыши узел MySQL (или JavaDB) и выбрать команду "Создать базу данных".

Для получения более подробной информации см. руководствоПодключение к базе данных MySQL .

Создание блока сохранения состояния

Для управления сохранением состояния в приложении вам всего лишь необходимо создать блок сохранения состояния, указать источник данных и диспетчер сущностей для использования, а затем контейнер будет выполнять всю работу по управлению сущностями и сохранением состояния. Блок сохранения состояния можно создать, определив его в файле persistence.xml.

Примечание. Для демонстрационных целей в этом упражнении вы будете использовать мастер создания нового блока сохранения состояния для создания файла persistence.xml. Мастер поможет вам указать свойства блока сохранения состояния. Вы также можете создать блок сохранения состояния в новом классе сущностей из мастера баз данных. Если блока сохранения состояния не существует, мастер предложит вариант создания блока сохранения состояния для проекта. Мастер создаст блок сохранения состояния, который использует поставщик сохранения состояния сервера WebLogic по умолчанию.

1. Щелкните правой кнопкой мыши узел проекта в окне "Проекты" и выберите команду "Свойства".
2. В категории "Источники" окна "Свойства" выберите JDK 6 как исходный/двоичный формат. Нажмите кнопку "ОК".
3. Выберите команду Новый файл (Ctrl-N; &#8984-N для Mac), чтобы открыть мастер нового файла.
4. Выберите "Блок сохранения состояния" в категории "Сохранение состояния". Нажмите кнопку "Далее".
5. Оставьте для блока сохранения состояния имя по умолчанию, предложенное мастером.
6. Выберите EclipseLink в раскрывающемся списке поставщиков сохранения состояния.
7. Выберите "Новый источник данных" в раскрывающемся списке источников данных.
8. Введите jdbc/mysql-sample как имя JNDI в диалоговом окне "Новый источник данных".
9. Выберите подключение к примеру базы данных MySQL. Нажмите кнопку "ОК" для закрытия диалогового окна.
10. Нажмите кнопку "Готово" в мастере нового блок сохранения состояния.

Когда вы нажмете кнопку "Готово", для вашего проекта будет создан файлpersistence.xml и открыт в редакторе. Вы можете щелкнуть на XML в панели инструментов редактора, чтобы просмотреть файлpersistence.xml в XML-режиме. Этот файл содержит всю информацию, которая нужна серверу для управления сущностями и сохранением состояния приложения.

Примечание. Если вы не используете существующий источник данных, среда IDE будет генерировать файл XML в узле ресурсов сервера (например, datasource-1-jdbc.xml), который содержит детали, использующиеся для создания источника данных на сервере, включая драйвер JDBC для базы данных.

Если вы откроете файл persistence.xml в редакторе XML, то увидите, что IDE указал версию сохранения состояния 2.0 и схему persistence_2_0.xsd. Среда IDE указывает org.eclipse.persistence.jpa.PersistenceProvider как поставщика сохранения состояния в файлеpersistence.xml. EclipseLink является основной реализацией сохранения состояния для Oracle TopLink и образцовой реализацией JPA.

<?xml version="1.0" encoding="UTF-8"?>
<persistence version="2.0" xmlns="http://java.sun.com/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_2_0.xsd">
  <persistence-unit name="WebLogicCustomerPU" transaction-type="JTA">
    <provider>org.eclipse.persistence.jpa.PersistenceProvider</provider>
    <jta-data-source>jdbc/mysql-sample</jta-data-source>
    <exclude-unlisted-classes>false</exclude-unlisted-classes>
    <properties>
      <property name="eclipselink.ddl-generation" value="create-tables"/>
    </properties>
  </persistence-unit>
</persistence>

Вы также можете выбрать TopLink в мастере; в этом случае мастер укажет oracle.toplink.essentials.PersistenceProvider как поставщика сохранения состояния в файле persistence.xml. Среда IDE добавит библиотеки Oracle TopLink Essentials - 2.0.1 к пути класса. В текущей и будущих версиях Oracle TopLink, Oracle TopLink Essentials заменен на EclipseLink. По возможности стоит использовать Oracle TopLink/EclipseLink вместо Oracle TopLink Essentials.

Создание классов сущностей

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

1. Выберите команду "Новый файл" (Ctrl-N) для открытия мастера нового файла.
2. Выберите "Классы сущностей" в разделе "База данных", категория "Устойчивость". Нажмите кнопку "Далее".
3. В классах сущностей из мастера баз данных выберите jdbc/mysql-sample из раскрывающегося списка источников данных и введите пароль, если это необходимо.
4. Выберите таблицу Customer из доступных таблиц и нажмите "Добавить". Нажмите кнопку "Далее".

   Мастер содержит таблицу customer и связанные с ней в разделе "Выделенные таблицы".

5. Введите ejb как пакет для сгенерированных классов. Нажмите кнопку "Готово".

Когда вы нажмете кнопку "Готово", среда IDE сгенерирует классы сущностей для каждой из выделенных таблиц. Вы можете расширить узел исходного пакета ejb для просмотра генерированных классов сущностей.

Генерирование страниц JSF

В этом упражнении вы будете использовать мастер для генерирования страниц JSF на основе имеющихся классов сущностей.

1. Щелкните узел проекта правой кнопкой мыши и выберите команду "Создать" > "Другие".
2. Выберите страницы JSF из классов сущностей в категории JavaServer Faces мастера нового файла. Нажмите кнопку "Далее".
3. Нажмите кнопку "Добавить все" для создания страниц JSF для всех доступных сущностей. Нажмите кнопку "Далее".
4. Введите webв полях пакета контроллера JPA и пакета классов JSF. Нажмите кнопку "Готово".

Когда вы нажмете кнопку "Готово", среда IDE сгенерирует страницы JSF 2.0, а также классы контроллера и преобразователя для страниц JSF.

Выполнение проекта

В этом упражнении вы построите и запустите веб-приложение на сервере WebLogic. Вы будете использовать команду "Запустить" в среде IDE для сборки, разворачивания и запуска приложения.

1. Щелкните правой кнопкой мыши узел проекта и выберите "Выполнить".

Когда вы нажмете "Выполнить", среда IDE построит проект и запустит архив WAR на сервере WebLogic, создаст и зарегистрирует новый источник данных JDBC. В вашем обозревателе открывается первая страница приложения (http://localhost:7001/WebLogicCustomer/).

Если вы зайдете в администраторскую консоль, то можете нажать "Запуск" в разделе "Ваши запущенные ресурсы", чтобы увидеть таблицу с ресурсами, уже запущенными на сервере.

Как видите, теперь таблица содержит веб-приложение WebLogicCustomer.warи конфигурацию JDBC jdbc/mysql-sample, кроме библиотеки JSF 2.0. Щелкните имя ресурса для просмотра дополнительной информации о нем. В таблице "Запускаемые элементы" также можно удалять ресурсы.

При расширении экземпляра сервера Oracle WebLogic в окне "Сервисы" можно просмотреть приложения и ресурсы, запускаемые на сервере.

Как видите, ресурсы JDBC были созданы на сервере, а библиотеки JSF установлены.

Для получения более подробной информации о запуске приложений см.Запуск приложений на сервере WebLogic