Установка и запуск J2EE Pet Store Application 1.1.2 с использованием Borland AppServer 4.5

Для развертывания Pet Store Application на J2EE-сервере вы должны определить метаданные развертывания, специфичные для конкретного сервера. Этот документ позволит вам использовать Borland AppServer в качестве целевой платформы развертывания демнстрационной системы J2EE - Pet Store.

Получение и установка Borland AppServer

Если у вас нет Borland AppServer (BAS), вы можете переписать его полнофункциональную 60-дневную trial версию с сайта Borland: http://www.borland.com/appserver. Borland AppServer с лицензией на одного разработчика входит в поставку Borland JBuilder 5 Enterprise.

Для установки BAS следуйте инструкциям, описанным в его документации - Installation Guide (русская версия документации версии 4.1 доступна по адресу http://www.borland.ru/appserver).

Получение и установка J2EE Pet Store

Перепишите Sun Java(TM) Pet Store 1.1.2 с сайта Sun: http://java.sun.com/j2ee/download.html#blueprints и распакуйте архив или используйте соответствующий готовый к развертыванию EAR (Enterprise-архив), предоставленный Borland (см. следующий раздел).

Напоминаем, что каталог jps1.1.2 должен быть распакован под именем <jps1.1.2>.

Получение и установка Borland Pet Store Collateral (дополнительные материалы)

Получите дополнительные материалы Borland Pet Store по адресу: http://www.borland.com/devsupport/appserver/downloads/4_5/borland_petstore112.zip и распакуйте их в каталог <jps1.1.2>.

В результате этой операции будет создан каталог<jps1.1.2>\borland и соответствующий файл <jps1.1.2>\src\petstore\src\borland_build.bat.

Равертывание Datasource Definitions для Pet Store

Datasource definitions (определение источника данных) и драйвер Oracle JDBC представлены в дополнительных материалах Borland Pet Store:

• <jps1.1.2>\borland\jndi-definitions.xml.
  
• <this_download>\lib\classes12_01.zip (вы должны использовать именно эту версию драйвера Oracle!)
  

В данном случае источник данных сконфигурирован для использования Oracle (мы также планируем обеспечить в будущем поддержку JDataStore). Отредактируйте значение <driver-datasource> в соответствии с вашей конфигурацией Oracle.

В первую очередь, вы должны установить драйвер Oracle рестартовать сервер для того, чтобы он "увидел" новый classpath:

• Запустите Borland AppServer Console, выберите пункт меню Wizards и обратитесь к J2EE Deployment Wizard.
  
• Шаг 1: перейдите в каталог <jps1.1.2>\borland\lib и выберите classes12_01.zip, после чего нажмите кнопку Next
  
• Шаг 2: Next для перехода на Шаг 3 визарда
• Шаг 3: Next для перехода на Шаг 4 визарда
• Шаг 4:
  • Если у вас запущен только один сервер нажмите на кнопку Add All Targets и, затем, Next.
  • Если у вас несколько серверов:
    • Выберите целевой сервер с помощью кнопки Add AppServer
      
    • Нажмите Next
• Как только архив будет помещен на сервер вы можете выбрать Finish. Сервер должен автоматически рестартовать.

Теперь вы должны развернуть на сервер соответствующие jndi-definitions:

• Запустите Borland AppServer Console, выберите Wizards пункт меню Wizards и обратитесь к J2EE Deployment Wizard.
  
• Шаг 1: перейдите в каталог <jps1.1.2>\borland и выберите jndi-definitions.xml, после чего нажмите Next
  
• Шаг 2: Next
  
• Шаг 3: Next
  
• Шаг 4: отметьте опцию "Deploy jndi objects to the Name Service" и нажмите Next.
  

Как только файл будет помещен на сервер вы можете выбрать Finish.

Развертывание Pet Store на Borland AppServer

Теперь вы можете просто разместить borland_petstore.ear представленный в <jps1.1.2>\borland\borland_petstore.ear или использовать немодифицированный Sun Pet Store .

Развертывание borland_petstore.ear:

Запустите Borland AppServer Console, выберите Wizards пункт меню Wizards и обратитесь к J2EE Deployment Wizard.

• Шаг 1: перейдите в каталог <jps1.1.2>\borland и выберите borland_petstore.ear, после чего нажмите Next
  
• Шаг 2: Next
  
• Шаг 3: Next
  
• Шаг 4:
  
  • Если у вас запущен только один сервер нажмите на кнопку Add All Targets и, затем, Next.
    
  • Если у вас несколько серверов:
    
    • Выберите целевой сервер с помощью кнопки Add AppServer
      
    • Нажмите Next
      
• Как только архив будет помещен на сервер вы можете выбрать Finish.

Развертывание оригинального (немодифицированного) Sun Pet Store:

• Добавьте Inprise deployment descriptors:
  
  • перейжите в каталог <jps1.1.2>\src\petstore\src
    
    • Усатновите переменную окружения BAS_INSTALL в значение каталога, в котором установлен Borland AppServer.
      
    • Запустите "borland_build.bat" для генерации <jps1.1.2>\src\petstore\src\borland_petstore.ear.
      Этот сценарий построит архив Pet Store и добавит в него дескрипторы развертывания Borland AppServer.

Замечание: Вы можете проигнорировать следующие сообщения об ошибках, которые являются результатом Sun Pet Store build system, пытающейся построить EAR для развертывания на показательной платформе Sun J2EE Reference Edition.

Executing Target: ear
[error] java.lang.NoClassDefFoundError: com/sun/enterprise/tools/packager/Main
[error] Exception in thread "main"
[exec] Result: 1
Executing Target: runtime
[error] java.lang.NoClassDefFoundError: com/sun/enterprise/tools/packager/Main
[error] Exception in thread "main"
[exec] Result: 1
[error] java.lang.NoClassDefFoundError: com/sun/enterprise/tools/packager/Main
[error] Exception in thread "main"
[exec] Result: 1

• Используйте Borland Deployment Descriptor Editor для конфигурирования полученного borland_petstore.ear для работы с Oracle и изменения информации в переменых окружения с "Sun Reference" на "Borland AppServer":
  
  • Запустите Borland Deployment Descriptor Editor (ddeditor)
    
    • Откройте <jps1.1.2>\src\petstore\src\ borland_petstore.ear
      
    • Выберите модуль customerEjb.jar , выберите компонент EJB TheOrder и на соответствующей ему странице Environment tab измените значение свойства ejb/order/OrderDAOClass с com.sun.j2ee.blueprints.customer.order.dao.OrderDAOCS на com.sun.j2ee.blueprints.customer.order.dao.OrderDAOOracle (вы можете сделать это просто заменив строку OrderDAOCS на OrderDAOOracle. )
      
    • Выберите модуль petstore.war и на соответствующей ему странице Environment tab установите значение свойства server/ServerType в Borland AppServer 4.5.
      
    • Сохраните сделанные изменения и выйдите из редактора
  • Установите полученный EAR-файл на сервера как это описано выше в разделе "Развертывание borland_petstore.ear"

Доступ к Pet Store

Для доступа к Pet Store используйте адрес http://localhost:8080/estore

Поддержка

Список рассылки j2eeblueprints является идеальным местом для получения ответов на вопросы об использовании Deployathon с Java 2 SDK, Enterprise Edition 1.2.1 for Solaris. Для подключения к списку рассылки пошлите email по адресу listserv@java.sun.com. Укажите "subscribe j2eeblueprints-interest ваша фималия ваше имя " в теле сообщения.