Створення J2C bean-компонента за допомогою J2C Tools в Rational Application Developer V7.0, CASE-засоби (моделювання), Програмування, статті

Введення


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
Структура 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

    На першій сторінці майстра знаходиться список адаптерів, які можна використовувати для створення 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
    Вибір адаптера IMS

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

    Малюнок 9. Імпорт адаптера IMS
    Імпорт адаптера 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-компонента
    Java-властивості J2C bean-компонента

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

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


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


 


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

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


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


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

    Малюнок 16. JNDI-ім’я в консолі адміністірованія сервера
    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-метода з контекстного меню
    Додавання нового J2C-метода з контекстного меню

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

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

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

 



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

    Малюнок 20. Огляд вхідних і вихідних типів для нового J2C java-методу
    Огляд вхідних і вихідних типів для нового 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
    Відкриття майстра розгортання J2C

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

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

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

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


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



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

    Малюнок 27. Створення Web-сервісу
    Створення 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>

*

*