IBM Rational Application Developer V6.0.0.1 J2EE 连接器工具功能部件 - 发行说明

(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.

欢迎使用“IBM Rational Application Developer V6.0.0.1 J2EE 连接器”功能部件,它基于 Eclipse 技术发行版 3.0.1。

要查看此自述文件的最新版本,请访问以下 Web 地址:www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/6001/J2C/html/readme.html

此文件具有下列本地语言版本:

法语 巴西葡萄牙语 德语
简体中文 意大利语 西班牙语
日语 繁体中文 韩国语

目录

1.0 关于此发行版
2.0 安装信息
2.1 硬件需求
2.2 受支持的软件
2.2.1 WebSphere Application Server
2.2.2 资源适配器
2.2.3 IMS
3.0 已知局限性、问题和变通方法
3.1 局限性
3.1.1 IMS Connector for Java TCP/IP 和“本地选项”连接
3.1.2 IMS Connector for Java MFS 支持以及对 Rational Application Developer 的 J2C 更新
3.1.3 安装在同一运行时服务器实例上的多个资源适配器
3.2 已知问题和变通方法
3.2.1 在数据绑定类来源于实用程序 JAR 的情况下,将 J2C 实现 bean 作为会话 EJB 来部署
3.2.2 部署时发生异常
3.2.3 不能通过 J2C 向导来更改 ConnectionSpec
3.2.4 不能使用 IMS Connector for Java 应用程序来检索未传递的输出
3.2.5 如果将 IMS Connector for Java executionTimeout 属性设置为“永远等待”,WebSphere Application Server for z/OS 服务区域可能会重新启动
3.2.6 对于专用持久套接字连接,将忽略 IMS Connector for Java 属性 purgeAsyncOutput 和 reRoute
4.0 文档更新
5.0 与客户支持联系
6.0 关于 Eclipse
7.0 声明与商标

1.0 关于此发行版

“J2EE 连接器(J2C)体系结构”工具允许您创建集成和扩充了它们现有的“企业信息系统”(EIS)上的操作和数据的 J2EE 应用程序。

使用 J2C 工具来访问 EIS 系统具有下列优点:

缩短开发时间
J2C 向导使用适当的受管连接工厂来为目标 EIS 创建代码。
标准化
通过符合标准的 J2C 基础结构(例如,资源适配器和公共客户机接口)来访问 EIS。
简单化
能够快速而直接地创建 Java bean。每个方法都对应于一项 EIS 操作。创建了 Java bean 之后,就可以利用 Rational Application Developer 的其余功能来开发 Web 页面、Web Service 和 EJB。

J2C 工具由下列主要组件组成:

向导
Java bean 编辑
教程

一旦安装了 J2C 功能部件,就可以通过单击主菜单中的帮助 > 教程库 > 边做边学来访问各教程。这些教程包括:

有关 J2C 工具的更多信息,请参阅联机帮助文档;通过单击帮助 > 帮助内容,然后展开开发企业应用程序 > 连接至企业信息系统就可获得联机帮助文档。

2.0 安装信息

有关安装 Rational Application Developer J2C 功能部件的信息,请参阅 www.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/6001/install_instruction/ifeature_j2c/install_6001.html

2.1 硬件需求

有关安装 Rational Application Developer J2C 功能部件的硬件需求,请参阅 installation instructions

2.2 受支持的软件

如果使用 Rational Application Developer 中的 J2C 工具来开发应用程序,然后在 WebSphere Application Server V5 上运行它,则应确保您具有适用于 WebSphere Application Server V5 的必需维护。有关详细信息,请参阅 2.2.1 WebSphere Application Server 这一节。

有关 Rational Application Developer J2C 功能部件支持的软件和规范的更多详细信息,请参阅 installation instructions

有关 Rational Application Developer 中的特定工具支持的软件和规范的详细信息,请参阅联机帮助。

在安装此功能部件之前,必须安装了 IBM Rational Application Developer V6.0.0.1。

2.2.1 WebSphere Application Server

WebSphere V5.0 和 WebSphere V5.1 支持 J2C 1.0。下表列示了使用 J2EE 连接器工具所必需的 WebSphere Application Server 服务级别。Rational Application Developer V6.0 提供的旧测试环境需要下表中“需要的 WAS 分布式服务级别”这一列中所列示的服务。WebSphere Application Server 支持站点(www.ibm.com/software/webservers/appserv/was/support)中提供了 WebSphere Application Server 累计修订(例如,WAS 5.0.2.8)。在以下网址提供了版本 5.0 和 5.1 的 Integration Edition 运行时修订:www.ibm.com/support/docview.wss?rs=180&context=SSEQTP&dc=D410&dc=D420&uid=swg24004796&loc=en_US&cs=utf-8&lang=en。WebSphere Application Server for z/OS 支持站点(/www.ibm.com/software/webservers/appserv/zos_os390/support/)提供了 WebSphere Application Server for z/OS PTF。

WebSphere Application Server 需要的 WAS 分布式服务级别 需要的 WAS for z/OS 服务级别
5.0.x
  • 累计修订 5.0.2.8
  • 版本 5.0 的 Integration Edition 运行时修订
W502023(PTF UK00329)
5.1.x
版本 5.1 的 Integration Edition 运行时修订
W510205(PTF UK0028)

WebSphere V6 支持 J2C 1.5 应用程序。

2.2.2 资源适配器

J2C 工具中支持下列资源适配器:

2.2.3 IMS

IMS Connector for Java V9.1.0.1.1 和 IMS Connector for Java V9.1.0.2 建议不要使用下列类:

3.0 已知局限性、问题和变通方法

发行说明中包含特定于发行版的信息(例如,问题和局限性),这些信息要等到产品文档最终定稿之后才可用。

有关 Eclipse 基本组件中的已知问题和变通方法的信息,请参阅 readme_eclipse.html,该文件位于产品安装目录的 eclipse\readme 子目录中。此信息只提供了英文版本。

3.1 局限性

3.1.1 IMS Connector for Java TCP/IP 和“本地选项”连接
3.1.2 IMS Connector for Java MFS 支持以及对 Rational Application Developer 的 J2C 更新
3.1.3 安装在同一运行时服务器实例上的多个资源适配器

3.1.1 IMS Connector for Java TCP/IP 和“本地选项”连接
3.1.2 IMS Connector for Java MFS 支持以及对 Rational Application Developer 的 J2C 更新
Rational Application Developer 附带提供的 J2C 工具目前还没有用来从 MFS 源代码生成 Java 数据绑定的向导。但是,通过使用 WebSphere Studio Application Developer Integration Edition 从 MFS 源代码创建的企业应用程序仍然可以在 WebSphere Application Server V6 上运行。有关这方面的信息,请参阅 IMS MFS Web Support 页面(www.ibm.com/software/data/ims/toolkit/mfswebsupport/)上的标题为“Migrating MFS-based IMS applications to run on WebSphere Application Server 6.0”的技术说明。
3.1.3 安装在同一运行时服务器实例上的多个资源适配器
不能将同一 EIS 资源适配器的多个独立版本安装在 WAS 中,当它们用于同一 EIS 类型时更是如此。 例如,如果您同时安装了 CICS ECI 5.1 和 CICS ECI 6.0,就可能会发送冲突。 这是因为所有独立的资源适配器将共享同一个类载入器。

3.2 已知问题和变通方法

3.2.1 在数据绑定类来源于实用程序 JAR 的情况下,将 J2C 实现 bean 作为会话 EJB 来部署
3.2.2 部署时发生异常
3.2.3 不能通过 J2C 向导来更改 ConnectionSpec
3.2.4 不能使用 IMS Connector for Java 应用程序来检索未传递的输出
3.2.5 如果将 IMS Connector for Java executionTimeout 属性设置为“永远等待”,WebSphere Application Server for z/OS 服务区域可能会重新启动
3.2.6 对于专用持久套接字连接,将忽略 IMS Connector for Java 属性 purgeAsyncOutput 和 reRoute


3.2.1 在数据绑定类来源于实用程序 JAR 的情况下,将 J2C 实现 bean 作为会话 EJB 来部署
当 J2C 实现 bean(它是使用 J2C 工具生成的)使用位于工作空间中的独立 Java 项目中的数据绑定类型时(这相当于 EAR 受限制实用程序 JAR 上的运行时依赖性), 不会自动更新 EJB 项目的 MANIFEST.MF 文件以反映这种依赖性。 为了避免发生运行时错误,用户应该手工更新 EJB 项目的 META-INF/MANIFEST.MF 文件中的“Class-Path”属性,使它包含数据绑定类型所在的 EAR 受限制实用程序 JAR。 在将 EJB 项目部署至运行时服务器之前就应该完成此操作。
3.2.2 部署时发生异常
在创建 Web 页面、EJB 或 Web Service 期间,您可能会发现 WAS V6 服务器控制台中存在异常。 这并不会影响服务器或 J2C bean 的正常运行。 WebSphere Application Server V6.0.1(www.ibm.com/software/webservers/appserv/was/support/)中已经修正了此问题。

[2/21/05 18:55:49:781 EST] 00000017 SystemErr R java.lang.reflect.InvocationTargetException at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:85) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:58) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java(Compiled Code)) at java.lang.reflect.Method.invoke(Method.java(Compiled Code)) at com.ibm.ws.ffdc.DiagnosticModule.getDataForDirective(DiagnosticModule.java:316) at com.ibm.ws.ffdc.DiagnosticModule.getDataForDirectives(DiagnosticModule.java:287) at com.ibm.ws.ffdc.DiagnosticModule.dumpComponentData(DiagnosticModule.java:143) at com.ibm.ws.ffdc.DiagnosticEngine.processIncident(DiagnosticEngine.java:159) at com.ibm.ws.ffdc.FFDCFilter.filterEngine(FFDCFilter.java:434) at com.ibm.ws.ffdc.FFDCFilter.processException(FFDCFilter.java:195) at com.ibm.ws.management.AdminServiceImpl.outputWarningAndFFDC(AdminServiceImpl.java:1660) at com.ibm.ws.management.AdminServiceImpl.checkForOpDeprecation(AdminServiceImpl.java:1737) at com.ibm.ws.management.AdminServiceImpl.preInvoke(AdminServiceImpl.java:1670) at com.ibm.ws.management.AdminServiceImpl.access$400(AdminServiceImpl.java:100) at com.ibm.ws.management.AdminServiceImpl$1.run(AdminServiceImpl.java:899) at com.ibm.ws.security.util.AccessController.doPrivileged(AccessController.java(Compiled Code)) at com.ibm.ws.management.AdminServiceImpl.invoke(AdminServiceImpl.java:817) at com.ibm.ws.management.connector.AdminServiceDelegator.invoke(AdminServiceDelegator.java:139) at sun.reflect.GeneratedMethodAccessor23.invoke(Unknown Source) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java(Compiled Code)) at java.lang.reflect.Method.invoke(Method.java(Compiled Code)) at com.ibm.ws.management.connector.soap.SOAPConnector.invoke(SOAPConnector.java:325) at com.ibm.ws.management.connector.soap.SOAPConnector.service(SOAPConnector.java:193) at com.ibm.ws.management.connector.soap.SOAPConnection.handleRequest(SOAPConnection.java:55) at com.ibm.ws.http.HttpConnection.readAndHandleRequest(HttpConnection.java:641) at com.ibm.ws.http.HttpConnection.run(HttpConnection.java:469) at com.ibm.ws.util.ThreadPool$Worker.run(ThreadPool.java(Compiled Code)) Caused by: java.lang.NullPointerException at com.ibm.ws.management.dm.JmxDM.processAdminService(JmxDM.java:50) at com.ibm.ws.management.dm.JmxDM.ffdcDumpDefaultJmx(JmxDM.java:34) ... 28 more


3.2.3 不能通过 J2C 向导来更改 ConnectionSpec
J2C 向导未提供任何用户界面支持以便于用户更改 ConnectionSpec。 用户必须在生成的实现 Java 代码中直接更改它。 用户需要在编辑器中打开生成的实现 Java 文件,浏览至他们需要修改的方法,然后更改/添加/除去该方法的 doclet。
3.2.4 不能使用 IMS Connector for Java 应用程序来检索未传递的输出
为了允许使用同一个应用程序中的 SYNC_RECEIVE_ASYNCOUTPUT 交互来检索可共享持久套接字连接上未传递的输出, IMS Connector for Java 允许将 IMSInteractionSpec 属性 purgeAsyncOutput 和 reRoute 的值都设置为 FALSE。 但是,如果 SYNC_RECEIVE_ASYNCOUTPUT 交互未成功地检索已对输出进行排队的应用程序中的输出, 则未传递的输出将保留在 OTMA TPIPE 上,OTMA TPIPE 的名称就是可共享持久套接字连接的名称。 由于不能使用 IMS Connector for Java 应用程序来检索这种输出, 因此,在将 purgeAsyncOutput 和 reRoute 都设置为 FALSE 时一定要谨慎。
3.2.5 如果将 IMS Connector for Java executionTimeout 属性设置为“永远等待”,WebSphere Application Server for z/OS 服务区域可能会重新启动
缺省情况下,在 WebSphere Application Server for z/OS 应用程序中, 分派到服务区域中的工作是具有时间限制的。 通常,当正在分派的应用程序达到它的超时值时,分派它的服务区域就会异常结束,然后又重新启动。 因为,当应用程序运行于 WebSphere Application Server for z/OS 中时, 强烈建议您不要将 executionTimeout 的值设置为 -1(“永远等待”)。
3.2.6 对于专用持久套接字连接,将忽略 IMS Connector for Java 属性 purgeAsyncOutput 和 reRoute
IMSInteractionSpec 属性 purgeAsyncOutput 和 reRoute 不适用于专用持久套接字连接上的交互。不能清除或重新路由专用持久套接字连接上未传递的输出消息。 但是,如果您在专用持久套接字连接上执行交互并且为 purgeAsyncOutput 和 reRoute 提供值,这些值将被 IMS Connector for Java 忽略。 而 Java 应用程序将不会接收到异常。

4.0 文档更新

产品主页IBM developerWorks 都具有一个部分,该部分提供了对教程文档和其它文档的更新。

IBM Rational 园地(www.ibm.com/developerworks/rational)提供了技术文章、解决方法信息、教程、样本和新技术预览。

5.0 与客户支持联系

Rational Application Developer 的产品主页为 www.ibm.com/software/awdtools/developer/application/index.html。 有关 FAQ、已知问题与修订的列表以及其它支持信息,请访问产品主页上的 Support 页。

6.0 关于 Eclipse

Eclipse 是一个开放式源代码项目,它提供了一个用于开发插件的框架,使得创建、集成和使用软件工具更加容易。 通过合作和共享核心集成技术,工具生产者可以集中精力研究他们的专长领域和创造新的开发技术。 Eclipse 平台是用 Java 语言编写的,并且提供了许多构造插件的工具箱和示例。 已经在许多操作系统环境(包括基于 Linux、Mac OS X、QNX 和 Windows 的系统)上部署了它。在以下网址提供了 Eclipse 园地(Eclipse community)和用于说明 Eclipse 平台设计的白皮书的所有详细信息:www.eclipse.org

通过将同样是使用开放式源代码 Eclipse 平台构建的其它供应商的插件工具与 Rational Developer 环境进行集成,从而使它物超所值。

7.0 声明与商标

U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

本信息是为在美国提供的产品和服务编写的。IBM 可能在其他国家或地区不提供本文档中讨论的产品、服务或功能特性。有关您当前所在区域的产品和服务的信息,请向您当地的 IBM 代表咨询。任何对 IBM 产品、程序或服务的引用并非意在明示或暗示只能使用 IBM 的产品、程序或服务。只要不侵犯 IBM 的知识产权,任何同等功能的产品、程序或服务,都可以代替 IBM 产品、程序或服务。但是,评估和验证任何非 IBM 产品、程序或服务,则由用户自行负责。

IBM 公司可能已拥有或正在申请与本文档内容有关的各项专利。提供本文档并未授予用户使用这些专利的任何许可。您可以用书面方式将许可查询寄往:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

有关双字节(DBCS)信息的许可查询,请与您所在国家或地区的 IBM 知识产权部门联系,或用书面方式将查询寄往:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

本条款不适用英国或任何这样的条款与当地法律不一致的国家或地区:International Business Machines Corporation“按现状”提供本出版物,不附有任何种类的(无论是明示的还是暗含的)保证,包括但不限于暗含的有关非侵权、适销和适用于某种特定用途的保证。某些国家或地区在某些交易中不允许免除明示或暗含的保证。因此本条款可能不适用于您。

本信息中可能包含技术方面不够准确的地方或印刷错误。此处的信息将定期更改;这些更改将编入本资料的新版本中。IBM 可以随时对本资料中描述的产品和/或程序进行改进和/或更改,而不另行通知。

本信息中对非 IBM Web 站点的任何引用都只是为了方便起见才提供的,不以任何方式充当对那些 Web 站点的保证。那些 Web 站点中的资料不是 IBM 产品资料的一部分,使用那些 Web 站点带来的风险将由您自行承担。

IBM 可以按它认为适当的任何方式使用或分发您所提供的任何信息而无须对您承担任何责任。

本程序的被许可方如果要了解有关程序的信息以达到如下目的:(i)允许在独立创建的程序和其他程序(包括本程序)之间进行信息交换,以及(ii)允许对已经交换的信息进行相互使用,请与下列地址联系:

Intellectual Property Dept. for Rational Software
IBM Corporation
3600 Steeles Avenue East
Markham, Ontario
Canada L3R 9Z7

只要遵守适当的条件和条款,包括某些情形下的一定数量的付费,都可获得这方面的信息。

本资料中描述的许可程序及其所有可用的许可资料均由 IBM 依据 IBM 客户协议、IBM 国际软件许可协议或任何同等协议中的条款提供。

此处包含的任何性能数据都是在受控环境中测得的。因此,在其他操作环境中获得的数据可能会有明显的不同。有些测量可能是在开发级的系统上进行的,因此不保证与一般可用系统上进行的测量结果相同。此外,有些测量是通过推算而估计的,实际结果可能会有差异。本文档的用户应当验证其特定环境的适用数据。

涉及非 IBM 产品的信息可从这些产品的供应商、其出版说明或其他可公开获得的资料中获取。IBM 没有对这些产品进行测试,也无法确认其性能的精确性、兼容性或任何其他关于非 IBM 产品的声明。有关非 IBM 产品性能的问题应当向这些产品的供应商提出。

所有关于 IBM 未来方向或意向的声明都可随时更改或收回,而不另行通知,它们仅仅表示了目标和意愿而已。

本信息包含在日常业务操作中使用的数据和报告的示例。为了尽可能完整地说明这些示例,示例中可能会包括个人、公司、品牌和产品的名称。所有这些名称都是虚构的,如与实际商业企业所使用的名称和地址有任何雷同,纯属巧合。

版权许可:

本信息包括源语言形式的样本应用程序,这些样本说明不同操作平台上的编程方法。如果是为按照在编写样本程序的操作平台上的应用程序编程接口(API)进行应用程序的开发、使用、经销或分发为目的,您可以任何形式对这些样本程序进行复制、修改、分发,而无须向 IBM 付费。这些示例并未在所有条件下作全面测试。因此,IBM 不能担保或暗示这些程序的可靠性、可维护性或功能。用户如果是为了按照 IBM 应用程序编程接口开发、使用、经销或分发应用程序,则可以任何形式复制、修改和分发这些样本程序,而无须向 IBM 付费。

凡这些样本程序的每份拷贝或其任何部分或任何衍生产品,都必须包括如下版权声明:

(C)(贵公司的名称)(年)。此部分代码是根据 IBM 公司的样本程序衍生出来的。 (C) Copyright IBM Corp. 2000, 2005. All rights reserved.

如果您正以软拷贝格式查看本信息,图片和彩色图例可能无法显示。

编程接口信息

编程接口信息旨在帮助您创建使用此程序的应用软件。

通用编程接口允许您编写获取此程序的工具服务的应用软件。

然而,本信息还可能包含诊断、修改和调整信息。诊断、修改和调整信息用来帮助您调试应用软件。

警告:不要将此诊断、修改和调整信息用作编程接口,因为它是会更改的。

商标和服务标记

下列各项是 International Business Machines Corporation 在美国和/或其他国家或地区的商标:

Java 和所有基于 Java 的商标是 Sun Microsystems,Inc. 在美国和/或其他国家或地区的商标。

Microsoft 和 Windows 是 Microsoft Corporation 在美国和/或其他国家或地区的商标。

Linux 是 Linus Torvalds 在美国和/或其他国家或地区的商标。

其他公司、产品或服务名称可能是其他公司的商标或服务标记。