Створення J2C bean-компонента з допомогою J2C Tools в Rational Application Developer V7.0

Введення


IBM Rational Application Developer V7.0 пропонує значне поліпшення для роботи користувачів з різними інструментами розробки додатків, включаючи Java 2 Platform, Enterprise Edition (J2EE) Connector (J2C). У даній статті описані деякі з поліпшень і показано, як, наприклад, розробник J2EE, може використовувати Rational Application Developer V7.0 для створення J2C bean-компонента, що забезпечує доступ до функцій основної системи IBM IMS (система управління інформацією).

У сучасному світі бізнес-додатків, керованих сервісами, дуже важливо забезпечити простий доступ до функції корпоративної інформаційної системи (EIS) (забезпечується за допомогою J2C bean-компонента) різним компонентів складної бізнес-екосистеми. У даній статті показано, як реалізувати такий доступ з сервісним управлінням до функцій EIS, а також як створити Web-сервіс, що забезпечує доступ до IMS за допомогою J2C bean-компонента.


Необхідна настройка


Для виконанню вправ даного керівництва необхідно встановити наступні програми:


Опис сценарію


У даному навчальному посібнику передбачається наступний сценарій: повинна бути встановлена програма Phonebook, Що виконується під управлінням IMS. Вивчення функції даної програми виконується за допомогою Web-сервісу. Але, відповідно до вимог, вхідними параметрами для програми повинні бути не тільки вхідні дані, необхідні для роботи серверної системи, а й властивість взаємодії interaction property executionTimeout IMS.
У цьому посібнику показано, як можна реалізувати даний сценарій:


  1. Створення класів прив'язки даних, що відповідають структурам вхідних і вихідних даних COBOL;
  2. Створення скелета J2C bean-компонента, що забезпечує доступ до IMS;
  3. Створення методу J2C bean-компонента, відповідального за виклик PhoneBook на серверній системі IMS;
  4. Створення Web-сервісу для аналізу функцій, що надаються створеним J2C bean-компонентом;
  5. Тестування створеного Web-сервісу за допомогою браузера Web-сервісів.

Вправа 1: Створення класів прив'язки даних, що відповідають структурам вхідних і вихідних даних COBOL


Класи прив'язки даних являють собою один із ключових артефактів, необхідних для доступу до функцій системи EIS. У цьому випадку система IMS повинна бути встановлена на сервері, на якому виконується додаток PhoneBook. Цей додаток очікує введення певних даних і створює деякі вихідні дані. Проблема полягає в тому, що для програми PhoneBook очікується, що структури даних будуть визначені на мові COBOL.


J2C bean-компонент діє у всесвіті Java і очікується, що всі дані будуть визначені у вигляді Java-класів. Тому необхідно створити Java-подання структур даних COBOL, яке можна використовувати для доступу до функцій IMS-додатки. У цьому посібнику будуть створена класи прив'язки даних, необхідні для запуску програми PhoneBook в системі IMS.


Для цього необхідно виконати наступні дії.



  1. Виберіть New > Other > J2C > CICS/IMS Java Data Binding wizard (Див. малюнок 1).

    Малюнок 1. Запуск майстра прив'язки даних


    На першій сторінці майстра прив'язки даних необхідно вибрати мову серверної системи для структури даних, які потрібно зіставити з Java.
    Доступні зіставлення:


    • COBOL to Java, Що дозволяє створювати Java-представлення структури даних, визначених на COBOL;
    • COBOL MPO to Java – Подібно COBOL to Java, але дозволяє використовувати структуру даних COBOL з декількома можливими вихідними даними;
    • PLI to Java, Що дозволяє створювати Java-представлення структури даних, визначених на PL1;
    • PLI MPO to Java – Подібно PLI to Java, але дозволяє використовувати структуру даних PL1 з декількома можливими висновками даних;
    • C to Java, Що дозволяє створювати Java-представлення структури даних, визначених на C.

  2. У даному сценарії буде використовуватися зіставлення COBOL to Java (див. малюнок 2).
    Також виберіть у файловій системі файл COBOL, що додається до даного навчального керівництву, і натисніть Next;

    Малюнок 2. Вибір зіставлення в майстрі прив'язки даних

  3. На наступній сторінці майстра прив'язки даних необхідно задати параметри, що відповідають властивостям серверної системи (в даному випадку IMS), на якій виконується програма COBOL. Оскільки комп'ютер з IMS працює під управлінням IBM z / OS, виберіть цю ОС в якості цільової платформи (див. рисунок 3);

    Малюнок 3. Завдання властивостей серверної системи в майстрі прив'язки даних

  4. Після визначення настройок серверної системи слід вибрати структуру даних, для якої буде виконано зіставлення в Java-презентації. Для цього натисніть Query, Виберіть структуру даних INPUT-MSG і натисніть Next (Див. рисунок 4);

    Малюнок 4. Вибір структури даних

  5. На останній сторінці майстра прив'язки даних необхідно задати проект та пакет, в якому потрібно створити Java-клас INPUTMSG, що представляє структуру даних INPUT_MSG COBOL в середовищі Java. У даному прикладі створимо цей клас у проекті IMSJavaProject (див. малюнок 5).

    Малюнок 5. Завдання призначення формування коду


    На даному етапі створено Java-клас, що представляє структуру вхідних даних для програми IMS. Також необхідно створити клас, що представляє структуру вихідних даних програми IMS. Для цього повторіть попередні 5 кроків за винятком того, що OUTPUT-MSG задається як необхідна структура даних COBOL і створюється клас OUTPUTMSG в тому ж проекті і пакеті, в якому створено клас INPUTMSG.


Після виконання даних кроків у IMSJavaProject будуть створені два файли, показані на малюнку 6.


Малюнок 6. Структура Java-проекту IMS

На даному етапі виконання вправи 1 завершується. Тепер в робочому просторі є Java-класи, що забезпечують Java-уявлення структур даних, необхідних для роботи програми PhoneBook на серверній системі IMS.
Тепер необхідно створити код, що визначає підключення до IMS. Це показано у вправі 2.


Вправа 2: Створення скелета J2C bean-компонента, що забезпечує доступ до IMS


Одна з найбільш важливих завдань, яке повинен виконувати J2C bean-компонент, полягає у визначенні способу підключення до серверної системи.



  1. Відкрийте майстер J2C Java Bean, представлений на малюнку 7, і подивіться, яку необхідно надати інформацію для створення кістяка J2C bean-компонента.

    Малюнок 7. Новий майстер J2C

    На першій сторінці майстра знаходиться список адаптерів, які можна використовувати для створення J2C bean-компонента. Rational Application Developer V7.0 поставляється з 2 IMS і 2 CICS (для версій 1.0 та 1.5 специфікацій J2C Architecture) адаптерами. У даному навчальному посібнику буде використовуватися адаптер IMS (для версії 1.5 специфікації J2C), що поставляється з Rational Application Developer V7.0;


  2. При виборі адаптера IMS (див. рисунок 8) відображається графічне представлення сценарію, для якого буде створений код.
    Майстер J2C створює J2C bean-компонент, що має достатньо інформації для доступу до IMS за допомогою певного адаптера IMS. Далі створений J2C bean-компонент можна буде використовувати для формування таких J2EE-артефактів, як сесійні компоненти Session Enterprise JavaBeans (EJB), JavaServer Pages (JSP) і Web-сервіси. Далі в даному навчальному посібнику буде створений Web-сервіс, що використовує створений J2C bean-компонент;

    Малюнок 8. Вибір адаптера IMS

  3. Якщо обраного адаптера ресурсів ще немає в робочому просторі, він імпортується в поточний робочий простір після натискання кнопки Next. Під час імпорту відображається індикатор ходу виконання, показаний на рисунку 9.

    Малюнок 9. Імпорт адаптера IMS


На наступній сторінці майстра можна ввести інформацію, використовувану для підключення до основної системи EIS за допомогою обраного адаптера ресурсів J2C. Ця інформація стосується тільки до серверної системи. Поставити інформацію про підключення можна трьома способами:


Чим ці три методи розрізняються?



У передових методах J2C розробки застосовується кероване підключення, оскільки воно дозволяє використовувати функції сервера додатків і розробляти складні багатоланкові системи. Кероване підключення також забезпечує краще багаторазове використання ресурсів, тому що певні на сервері фабрики підключень можуть використовуватися іншими програмами.


Пакет J2C tools надає зручний спосіб визначення нової (або вибору існуючої) фабрики управління підключення на сервері;



  1. Для цього задайте ім'я ресурсу JNDI для фабрики керованого підключення, яку потрібно створити, і натисніть New (Див. малюнки 10 і 11).

    Малюнок 10. Створення нової фабрики керованого підключення


    Як зазначено раніше, кероване підключення увазі, що відповідний адаптер ресурсів встановлено на сервері, що працює в автономному режимі (іншими словами, адаптер доступний для всіх EAR, встановлених на даному сервері). Якщо адаптер ресурсів не встановлений на заданому примірнику сервера, J2C tools автоматично встановлює адаптер ресурсів на сервері в процесі створення фабрики керованого підключення.


    Малюнок 11. Вибір примірника сервера


    Після визначення примірника сервера потрібно задати значення для властивостей IMS, необхідних для успішного підключення до системи IMS;


  2. Після натискання кнопки Finish J2C Tools намагається створити на примірнику сервера задану фабрику керованого підключення (див. малюнок 12).

    Якщо вибраний екземпляр WebSphere v6.1 вже запущений, фабрика керованого підключення створюється відразу ж. Якщо сервер не запущений, створення фабрики керованого підключення відкладається до наступного запуску сервера і повторної публікації його даних про конфігурації. Це значно полегшує роботу в порівнянні з попередніми версіями J2C Tools в Rational Application Developer, коли був потрібний запуск сервера;


    Малюнок 12. Створення фабрики керованого підключення

  3. Тепер можна переходити до наступній сторінці майстра J2C, на якій необхідно задати проект та пакет, в яких буде створюватися код для J2C bean-компонента, а також фактичні імена для файлів реалізації і інтерфейсу J2C bean-компонента.

    У даному навчальному посібнику J2C bean-компонент буде створений у тому ж проекті, де створювалися класи прив'язки даних. Рекомендується використовувати імена, вказані на малюнку 13, для забезпечення узгодження до угод про використовувані імена, застосовуваними далі в цьому посібнику;


    Малюнок 13. Java-властивості J2C bean-компонента

  4. Натисніть кнопку Finish, Майстер J2C створює код підключення до IMS. Розглянемо, як дана інформація представлена у створеному J2C bean-компоненті. Якщо відкрити створений J2C bean-компонент, то можна помітити, що JNDI-ім'я фабрики керованого підключення задано в коді в теге доклете;

    Малюнок 14. JNDI-ім'я в тезі доклете


    Зображення більшого розміру


 


  1. Перейдіть станицю далі і побачите, що конструктор анотацій доклете використовує інформацію, задану в тезі доклете, для створення фрагмента коду, відповідального за підключення до IMS (див. малюнок 15);

    Малюнок 15. JNDI-ім'я в створеному коді


    Зображення більшого розміру


  2. Тепер запустіть екземпляр сервера WebSphere v6.1, визначений при створенні фабрики керованого підключення, і відкрийте для цього сервера консоль адміністірованія. У ній відображається правильно визначена фабрика керованого підключення.

    Малюнок 16. JNDI-ім'я в консолі адміністірованія сервера


    Зображення більшого розміру


На даному етапі створено J2C bean-компонент, який забезпечує підключення до IMS, і класи прив'язки даних, що представляють дані, необхідні для запуску програми PhoneBook IMS. У наступній вправі буде показано, як можна визначити Java-метод в J2C bean-компоненті, що відповідає за виклик додатку PhoneBook в IMS.


Вправа 3: Створення методу J2C bean-компонента, відповідального за виклик PhoneBook на серверній системі IMS



  1. Щоб додати нового методу в J2C bean-компонент відкрийте Java-клас реалізації J2C bean-компонента, натисніть праву кнопку миші в будь-якому місці вихідного коду Java-класу і виберіть Source > Add Method to J2C bean (Див. малюнок 17).
    Інший спосіб полягає в додаванні J2C-методу за допомогою відповідного фрагмента коду J2C в панелі Snippets;

    Малюнок 17. Додавання нового J2C-методу з контекстного меню

  2. У діалоговому вікні New Java Method натисніть Add для додавання нового методу (див. малюнок 18);

    Малюнок 18. Діалогове вікно New J2C method

  3. Необхідно поставити безліч параметрів для визначення Java-методу, що відповідає роботі на сервері системи EIS. По-перше, необхідно задати ім'я методу (див. малюнок 19);
 Малюнок 19. Ім'я нового J2C-методу
 

 



  1. По-друге, необхідно поставити вхідний і вихідний типи для методу. Ці типи є типи прив'язки даних. створених у вправі 1. Тому необхідно просто натиснути кнопку Browse і вибрати ці класи (див. малюнок 20);

    Малюнок 20. Огляд вхідних і вихідних типів для нового J2C java-методу

  2. Після завдання вхідного і вихідного типів натисніть кнопку Next;
  3. На цій сторінці майстра можна задати властивості взаємодії і специфікації підключення, пов'язані з виконанням системи EIS, функції якої потрібно використовувати в якості вхідних аргументів бізнес-методів в J2C bean-компоненті. У цьому посібнику виберіть властивість специфікації взаємодії executionTimeout (Див. малюнок 21).

    Малюнок 21. Новий метод

    При виборі відповідного властивості можна переглянути зміна в сигнатурі методу у верхній частині сторінки. Можливість завдання даної інформації за допомогою користувальницького інтерфейсу є одне з багатьох удосконалень інструментальних засобів J2C пакета Rational Application Developer V7.0 у порівнянні з попередніми версіями.

    Зверніть увагу, що поле інтерфейсу, відповідне властивості executionTimeout, Недоступне в діалоговому вікні New Java Method. Це обумовлено тим, що жорстко закодоване значення для даної властивості взаємодії в даний момент надати неможливо, оскільки значення надається аргументом методу Java;


  4. У даному навчальному посібнику визначимо тільки один бізнес-метод для J2C bean-компонента. Тому натисніть кнопку Finish в діалоговому вікні New Java Method;

    Малюнок 22. Новий метод

  5. Якщо тепер відкрити файл реалізації J2C bean-компонента, то можна переглянути новий метод (див. малюнок 23). Зверніть увагу, що сигнатура повідомлення аналогічна сигнатурі, виділеної в діалоговому вікні New Method.

    Малюнок 23. Новий метод


Зображення більшого розміру


На даному етапі створено функціональний J2C bean-компонент, який забезпечує доступ до IMS і видобуває запису PhoneBook.
У наступній вправі показано, як використовувати цю функції за допомогою Web-сервісу.


Вправа 4: Створення Web-сервісу для аналізу функцій, що надаються створеним J2C bean-компонентом


Перед виконанням даної вправи запустіть сервер WebSphere v6.1, якщо він ще не запущений.


J2C Tools надають простий спосіб створення таких розгорнутих артефактів, як Web-сервіси, JSP і сесійні bean-компоненти, які можна використовувати для тестування роботи J2C bean-компонента. У даному навчальному посібнику створимо Web-сервіс, який виконує доступ до додатка PhoneBook за допомогою J2C bean-компонента.



  1. На сторінці вибору майстра виберіть майстер Web Page, Web Service, or EJB from J2C bean в категорії J2C (див. малюнок 24);

    Малюнок 24. Відкриття майстра розгортання J2C

  2. На першій сторінці цього майстра необхідно визначити, який J2C bean-компонент буде створювати розгортані артефакти (див. малюнок 25);

    Малюнок 25. Вибір J2C bean-компонента для створення артефактів розгортання

  3. На наступній сторінці задайте створення Web-сервісу (див. малюнок 26);

    Малюнок 26. Вибір створення Web-сервісу


На наступній сторінці необхідно задати (або створити новий) динамічний Web-проект, де буде створено Web-сервіс.
Для доступу до ресурсів, визначеним на сервері, рекомендується використовувати посилання на ресурси. Посилання на ресурси дозволяють переконатися, що фактичне JNDI-ім'я не закодовано жорстко. Посилання на ресурс визначається в дескрипторі розміщення програми, її можна змінити для вказівки на інший «реальний» ресурс в залежності від того, на якому сервері планується розгорнути програму. Якщо на цій сторінці майстра задати ім'я посилання на ресурс, J2C tools створює посилання на ресурс і автоматично оновлює дескриптор додатки.



  1. Натисніть кнопку Finish , Створюється Web-сервіс з налаштуваннями за замовчуванням (див. малюнок 27).
    Примітка: Якщо потрібно створити Web-сервіс з іншими настройками, використовуйте майстер Web-сервісів з пакету Web Service Tools для створення Web-сервісу висхідного типу (Web-сервіс з Java Bean) за допомогою даного набору інструментів;

    Малюнок 27. Створення Web-сервісу

  2. Подивіться на вміст Web-проекту: можна помітити, що створені артефакти Web-сервісу (див. малюнок 28).

    Малюнок 28. Артефакти Web-сервісу в Web-проекті

  3. Якщо вибрати перегляд вихідного коду, то можна побачити виняток, подібне показаному в лістингу 1 у розділі відгуку. Дане виняток вказує, що система не здатна завершити виконання протягом 1 мілісекунди.

Лістинг 1. Виняток





javax.resource.spi.EISSystemException: ICO0081E:
com.ibm.connector2.ims.ico.IMSTCPIPManagedConnection@
1b521b52.processOutputOTMAMsg(byte[],
IMSInteractionSpec, int) error. Execution timeout has occurred for this interaction.
The executionTimeout value specified was [1] milliseconds.
The value used by IMS Connect was [10] milliseconds.

Це означає, що є повнофункціональний Web-сервіс, який не тільки викликає функції серверної системи IMS, але і передає значення, відповідні різним властивостям взаємодій IMS.


Висновок


У даному навчальному посібнику показано, як можна використовувати пакет J2C tools, що входить до складу Rational Application Developer V7.0, для швидкого створення J2C bean-компонента, що забезпечує доступ до функцій серверної системи IMS. Також продемонстровано, як дану можливість можна використовувати для інших застосувань і бізнес-процесів з допомогою механізму Web-сервісів.

Схожі статті:


Сподобалася стаття? Ви можете залишити відгук або підписатися на RSS , щоб автоматично отримувати інформацію про нові статтях.

Коментарів поки що немає.

Ваш отзыв

Поділ на параграфи відбувається автоматично, адреса електронної пошти ніколи не буде опублікований, допустимий HTML: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>

*

*