Sun ONE Studio 5 update 1, Standard Edition 发行说明
(Sun ONE Studio 5 update 1, Standard Edition)
要获得这些说明的最新版本,参见 Sun ONE Studio Developer Resources 网页上的版本,网址是 http://forte.sun.com/ffj/documentation
注意:对于 Sun ONE Studio 5 update 1, Standard Edition,产品及附带提供的 CD 的卷名称分别为:
zh_CN_studiose_5u1
studiose_5u1_companion
发行说明各部分... |
提供的信息... |
A. 简介 |
介绍本发行说明及 Sun ONE Studio 5 update 1, Standard Edition 产品。 |
B. 新特点:增强和新增功能
|
本版 Sun ONE Studio 5 update 1, Standard Edition 产品的新增和增强功能。 |
C. 限制 |
Sun ONE Studio 5 update 1, Standard Edition 产品的使用限制。 |
D. 系统要求 |
在任何支持平台上进行 Sun ONE Studio 5 update 1, Standard Edition 最小配置安装所需的硬件要求。 |
E. 操作系统、服务器、数据库、ORB 和版本控制系统 |
此版本所支持的操作系统及其它软件。 |
F. 平台 |
已在其上对 Sun ONE Studio 5 update 1, Standard Edition 进行过测试的操作系统。 |
G. 安装说明 |
除 Sun ONE Studio 5 入门指南中所提供信息之外的一般安装信息。请在 http://forte.sun.com/ffj/documentation 处参阅该文档。 |
H. 模块说明 |
有关各个模块的一般和杂项信息。 |
I. 错误和问题 |
与本发行版产品有关的错误和问题,并对某些问题提供了可用的回避方法。 |
J. 可访问性 |
Sun ONE Studio 1 update 1, Standard Edition 产品的可访问功能。 |
K. 其它文档 |
以文档形式提供的 Sun ONE Studio 5 update 1, Standard Edition 信息源。 |
L. 更新中心 |
有关 Sun ONE Studio 5 update 1, Standard Edition 更新中心的一般信息。 |
M. NetBeans 开放源代码项目 |
与 NetBeans 开放源代码项目相关的描述信息和网址。 |
N. 可再分发的文件 |
随本产品提供的可以再次分发的二进制文件。 |
O. 移动模块发行说明 |
随 Sun ONE Studio 5 update 1, Standard Edition 提供的 Mobile Edition 模块的发行说明。 |
A. 简介
本发行说明是对 Sun Open Net Environment Studio 5 update 1, Standard Edition 产品的标准版所作的发行说明。本说明还包含移动模块发行说明。
注意:Sun ONE Studio 5 update 1, Standard Edition 要求 Java 2 Software Development Kit, Standard Edition (J2SE SDK) v. 1.4.1_02 或更高版本。
Sun ONE 应用程序服务器 7
与 Sun Open Net Environment Studio 5 捆绑在一起的 Sun ONE 应用程序服务器 7 update 1 是仅限于开发者使用的产品,并非为运行时使用而设计。
要获得 Sun ONE 应用程序服务器当前版本的有关信息,请在命令提示符处输入 asadmin
version
:
<instance>/appserver/bin/asadmin version
用于 Solaris 9 OS x86 平台版的 Sun ONE Studio 5 update 1, Standard Edition
可以下载并安装用于 Solaris 9 OS x86 平台版的 Sun ONE Studio 5 update 1, Standard Edition。在产品下载网站上可以找到采用 web 下载方式下载并安装 x86 版本的说明。
还可以在 CD-ROM 上找到用于 Solaris 9 OS x86 平台版的安装程序。有关说明,请参考 Sun ONE Studio 5 update 1, Standard Edition 入门指南。从 CD-ROM 启动安装,按照 Solaris 9 OS 上的 IDE 安装说明进行操作。您需要使用根权限来安装本产品。
如果要安装用于 Solaris 9 OS x86 平台版的 Sun ONE Studio 5 update 1, Standard Edition,请注意下述限制:
- 不支持 Sun ONE 应用程序服务器 7, Update 1。运行安装程序时,将出现一条通知消息,指出用于 Solaris 9 OS x86 平台版的 Sun ONE Studio 5, Standard Edition 不支持 Sun ONE 应用程序服务器 7, Update 1。
- 用于 Solaris 9 OS x86 平台版的 Sun ONE Studio 5 update 1, Standard Edition 不支持 Sun ONE Studio 5, J2ME 无线工具箱 1.0.4.。您无法使用 Sun ONE Studio 更新中心提供的附加 Mobile Edition 模块
- 对于 Sun ONE Studio CORBA 模块的用户,可以使用 J2SE 1.4 ORB。但是,用于 Solaris 9 OS x86 平台版的 Sun ONE Studio 5 update 1, Standard Edition 不支持其它版本 Sun ONE Studio 5 当前支持的其它 ORB。
- 用于 Solaris 9 OS x86 平台版的 Sun ONE Studio 5, Standard Edition 不支持普通 VCS 模块,PVCS。有关详细信息,参见本文档中的 E. 操作系统、服务器、数据库、ORB 和版本控制系统。
- 用于 Solaris 9 OS x86 平台版的 Sun ONE Studio 5, Standard Edition 不支持 ClearCase。
知识库
通过访问一个可搜索的大型常见问题数据库,您可以找到许多问题的答案。该数据库是一个动态的知识增长库,会根据您的需求提供定制搜索。它被称为知识库,可通过 Sun ONE Studio Developer 的入口进行访问:
http://forte.sun.com/ffj/knowledgebase.html
首次运行 IDE 时,您可以导入在先前的 IDE 安装中使用的设置。
这些设置包括特定于项目的设置以及全局选项。
如果您选择不从以前的版本中导入设置,则 IDE 使用一组缺省设置开始运行。
[导入向导] 会引导您完成选择。
您可以从 NetBeans IDE 3.0、3.1、3.2、3.3 和 3.4 中导入设置。也可以从 Sun ONE Studio(原先叫做 Forte for Java)软件版本 2.0、3.0、4 和 4.1 中导入设置。
在 NetBeans IDE 3.2(或更高版本)和 Sun ONE Studio 3.0(或更高版本)产品中,您可以在运行软件时找到用户目录。选择 [帮助] | [关于],然后单击 [详细信息] 标签。
虽然可将先前的 IDE 安装中的设置导入到 Sun ONE Studio 5 update 1, Standard Edition 软件中,但并非 Sun ONE Studio 5 产品中的所有设置均可以导入到早期的 IDE 版本中。
将要除去的模块
在 Sun ONE Studio 5 update 1, Standard Edition 的后续版本中,将会除去三个模块。这些模块是 Forte for Java JNDI 模块、CORBA 模块以及 Forte for Java RMI 支持模块。虽然在 Studio ONE Studio 分发产品中将不再提供这三个模块,但您可以通过在 Sun ONE Studio 开发环境中编写代码来继续实现 RMI、CORBA 和 JNDI 功能。
B. 新特点:增强和新增功能
以下部分描述了随 Sun ONE Studio 5 update 1, Standard Edition 提供的增强和新增功能。
应用程序框架 2.1
Sun ONE Studio 应用程序框架 2.1 现在与 Sun ONE Studio 产品捆绑在了一起。Sun ONE Studio 应用程序框架产品是一个成熟、强大、基于标准建立的 J2EE Web 应用程序框架,很适于企业 Web 应用程序开发。Sun ONE Studio 应用程序框架将熟悉的概念(如显示字段、应用程序事件、组件分层结构和以页为中心的开发方法)与基于“模型-视图-控制器”和“服务到工作者”模式的最新设计结为一体。
现在,Sun ONE Studio 与 Sun ONE Studio 应用程序框架 2.1 产品的集成极大地提高了 RAD Web 应用程序的生产效率。
产品的特色是具有一个用于 Sun ONE Studio 产品的丰富的 GUI 工具集,利用它可以以可视方式快速开发基于久经考验的 Sun ONE 应用程序框架框架运行环境和行业标准 J2EE 平台的 Web 应用程序。
Sun ONE 应用程序框架工具集支持经过扩充的、功能强大的组件体系结构。
Sun ONE Studio 应用程序框架 2.1 产品自 Sun ONE 应用程序框架 2.0 版以后增加了下列功能:
- 新的模型组件
- Bean 适配器模型 - 与 java bean 属性相适应的模型
- 定制模型 - 可由开发人员完成的通用抽象模型实现
- 定制简单数据集模型 - 可由开发人员定制的具体模型实现
- 定制树模型 - 将由开发人员完成的抽象树模型实现
- HTTP 会话模型 - 使用 HTTP 会话作为其后备存储的模型
- JDBC 存储过程模型 - 使用 JDBC 在 RDBMS 上执行存储过程的模型
- 对象适配器模型 - 用于封装任意复杂的 Java 对象的模型
- 资源包模型 - 用于从可本地化的包中提供资源的模型
- 验证处理程序异常处理事件/命令描述符
- 新的可视组件
- 数据驱动的组合框
- 数据驱动的列表框
- 数据驱动的单选按钮
- 文件上载
- 验证文本字段
- 验证文本区域
- 命令
- 新的命令向导
- 链式命令能力
- 内置命令
- 执行模型命令
- 获得页命令
- 前进命令
- 转到页命令
- 包括页命令
- 重定向命令
- JSP
- 对 JSP 模板的支持
- 页面配件组件的 JSP 页面配件(TiledView 等)
- 对样式表 (CSS) 的支持
- 新的组件面板
- 通过指向并单击方式即可向页中添加组件
- 显示组件库中提供的可用“可视组件”,包括 S1AF 提供的组件和定制建立的组件
- 显示组件库中提供的可用“非可视组件”,包括 S1AF 提供的组件以及定制建立的组件
- 显示当前应用程序中可用的“应用程序级组件”
- 新的专用 S1AF 工作区...
- 在一个工作区中对公用功能方便地进行分组
- 可成套定制
- 导入 Web 应用程序
- 允许将现有 J2EE Web 应用程序导入至或转换成 Sun ONE 应用程序框架应用程序。
可导入任何 J2EE web 应用程序。例如,Struts 或其它类型的 J2EE 应用程序
- 新的文档
- 现在可以与 S1AF 应用程序一同使用 CVS 或 Clearcase
J2EE
- 现在可以与 J2EE 应用程序一同使用 CVS 或 Clearcase
- Sun ONE 应用程序服务器已取代 J2EE 引用实现服务器成为缺省的应用程序服务器。
Web 服务
- 对安全性(HTTP 基本鉴别和 HTTPS-SSL 安全)、SOAP 消息处理程序、有态 web 服务和附属功能提供附加的 JAX-RPC 支持
- 改进了 kSOAP 无线集成(复杂数据类型,MIDP 测试客户机的生成,验证)
- 改进后的测试客户机使用自 web 服务的 WSDL 生成的定制 JSP 标记库
- 将 Tomcat 无缝配置为本地 UDDI 注册的 web 容器。
IDE 的各项变化
- 增添了 JUnit 模块。
- Ant 支持版本更改为 1.5.1 版
- 实现了 [资源管理器] 节点的拖放功能。
- 增添了对 JDK 1.4 版功能的支持,例如断言。
- 在 [窗体编辑器] 中增添了 [撤消/重做] 功能。
- 现在,分析器错误在 [源编辑器] 窗口的空白隔条中以字型形式突出显示。
- 改进了 [调试器] 窗口的设计。
- IDE 现在具有“修复并继续”(HotSwap) 支持。
- IDE 现在具有 XML 架构和 XSL 变换支持。
- IDE 的 [源编辑器] 窗口中现在有了工具栏。
- 增添了 [导入管理工具],用以简化处理 Java 类中的导入。
- IDE 现在具有一个用于维护代码完成数据库的定制器。
- [资源管理器] 中不再有 Javadoc 标签。
- [Javadoc 管理器] 出现在 [工具] 菜单中,从而可以安装用 Javadoc 工具所生成文档的文件系统。
- [视图] 菜单现在包含有 [文档索引] 命令,利用此命令可在 web 浏览器中查看已安装的 Javadoc 文档。
- IDE 中不再有运行工作区。
- 所有标签上均有 [关闭] 按钮。
- IDE 以前版本中原有的一些功能已从标准分发版本中删除:
- XML 树编辑器(由于持久的性能问题 - 参见问题 31656)
- 对 JDK 1.1 版工具调试器的支持,该调试器在 JDK 1.4 版中不受支持。
- Ant 手册和用于 Ant 的 Javadoc。可从 NetBeans 更新中心下载 Ant 文档模块,将其添加到 IDE 中。
错误提交器
利用“错误提交器”功能,可以向 Sun Microsystems 提交与 Sun ONE Studio 有关的问题报告(错误)、改进意见(即改进要求 RFE)以及易用性建议 (EOU)。
首选方法是从 IDE 中打开 [问题提交器] 向导,填写各个字段,然后使用 HTTP 或 SMTP 协议发送报告。[问题提交器] 向导会自动从 IDE 中捕获特定的数据。
但是,如果 IDE 或该向导不可用,您可以使用 web 浏览器访问“问题提交器”网页,通过入口完成并发送报告。
向导和网页均可从 IDE 内部获得,这便是“问题提交器”功能的联机帮助。
C. 限制
本部分介绍与 Sun ONE Studio 5 update 1, Standard Edition 产品使用有关的限制。
自 WSDL 所创建的 Web 服务的客户机
当您自某个 WSDL 文件创建一项 web 服务时,自该 WSDL 文件创建的客户机将无法调用此 web 服务上的操作。要创建一个能够调用该 web 服务上操作的客户机,必须将此 web 服务作为源来创建它。
或者,也可自新创建的 web 服务生成一个 WSDL,然后将该 WSDL 作为此客户机的源。
D. 系统要求
E. 操作系统、服务器、数据库、ORB 和版本控制系统
下表描述了 Sun ONE Studio 5, Standard Edition 所支持的操作系统、服务器、数据库、版本控制系统和 ORB。
# |
操作系统 |
应用程序服务器 |
Web 服务器 |
Web 浏览器 |
VCS |
数据库服务器,JDBC 驱动程序,ORB |
1
|
Win2000 SP3 |
Sun ONE AS 7, SE、BEA WebLogic 6.1 SP4/7.0 SP2 |
Sun 应用程序服务器 7 Update 1, SE、Tomcat 4.1 Internal、TomCat 4.0.6 External |
Netscape 7.02 Internet Explorer 6 |
VSS 6.0、 CVS 1.11、ClearCase V2002 u2 |
Oracle 9i/JDBC Thin Driver 9
MS SQLServer 2000、JDBC-ODBC 网桥/SQL Server 2000 ODBC 驱动程序
Pointbase 4.2 网络版/Pointbase JDBC 驱动程序
IBM DB2 8.1/JDBC Thin Driver for DB2 8.1 VisiBroker 3.4、VisiBroker 4.0、Orbix 2000 for Java、OrbixWeb 3.2、ORBacus 4.0.4、J2SE 1.4 ORB、J2EE 1.2 ORB |
2
|
Windows XP Professional SP1 |
Sun ONE AS 7, SE、BEA WebLogic 6.1 SP4/7.0 SP2 |
Sun 应用程序服务器 7 Update 1, SE、Tomcat 4.1 Internal、TomCat 4.0.6 External |
Netscape 7.02 Internet Explorer 6 |
VSS 6.0、 CVS 1.11、ClearCase V2002 u2
|
Oracle 9i/JDBC Thin Driver 9
MS SQLServer 2000、JDBC-ODBC 网桥/SQL Server 2000 ODBC 驱动程序
Pointbase 4.2 网络版/Pointbase JDBC 驱动程序
IBM DB2 8.1/JDBC Thin Driver for DB2 8.1
VisiBroker 3.4、VisiBroker 4.0、Orbix 2000 for Java、OrbixWeb 3.2、ORBacus 4.0.4、J2SE 1.4 ORB、J2EE 1.2 ORB
|
3
|
Solaris 9 SPARC®(32/64 位) |
Sun ONE AS 7, SE、BEA WebLogic 6.1 SP2/7.0 SP2 |
Sun 应用程序服务器 7 Update 1, SE、Tomcat 4.1 Internal、TomCat 4.0.6 External |
Netscape 7.02 |
CVS 1.11、ClearCase V2002 u2 |
Oracle 9i/JDBC Thin Driver 9
Pointbase 4.2 网络版/Pointbase JDBC 驱动程序
IBM DB2 8.1/JDBC Thin Driver for DB2 8.1
VisiBroker 3.4、VisiBroker 4.0、Orbix 2000 for Java、OrbixWeb 3.2、ORBacus 4.0.4、J2SE 1.4 ORB、J2EE 1.2 ORB
|
4
|
Solaris 8 SPARC(32/64 位) |
Sun ONE AS 7, SE、BEA WebLogic 6.1 SP2/7.0 SP2 |
Sun ONE 应用程序服务器 7 Update 1, SE、Tomcat 4.1 Internal、TomCat 4.0.6 External |
Netscape 7.02 |
CVS 1.11、ClearCase V2002 u2 |
Oracle 9i/JDBC Thin Driver 9
Pointbase 4.2 网络版/Pointbase JDBC 驱动程序
IBM DB2 8.1/JDBC Thin Driver for DB2 8.1
VisiBroker 3.4、VisiBroker 4.0、Orbix 2000 for Java、OrbixWeb 3.2、ORBacus 4.0.4、J2SE 1.4 ORB、J2EE 1.2 ORB
|
5
| Solaris 9 OS x86 平台版 |
BEA WebLogic 6.1 SP2/7.0 SP2 |
Tomcat 4.1 Internal、TomCat 4.0.6 External |
Netscape 7.02 |
CVS 1.11 |
Oracle 9i/JDBC Thin Driver 9
Pointbase 4.2 网络版/Pointbase JDBC 驱动程序
IBM DB2 8.1/JDBC Thin Driver for DB2 8.1
J2SE 1.4 ORB
请参见以下限制:
用于 Solaris 9 OS x86 平台版的 Sun ONE Studio 5 update 1, Standard Edition
|
F. 平台
注意:Sun ONE Studio 5 update 1, Standard Edition 软件要求 J2SE SDK v. 1.4.1_02 或更高版本。
-
Sun ONE Studio 5 update 1, Standard Edition 已在下列平台上进行了测试:
-
- Win2000 SP3
- Windows XP Professional SP1
- Solaris 9 SPARC(32/64 位)
- Solaris 8 SPARC(32/64 位)
- Solari 9 OS x86 平台版
多用户平台:
SunRay 服务器
本部分提供有关安装 Sun ONE Studio 5, update 1, Standard Edition 的附加信息。有关安装 Sun ONE Studio 5, Standard Edition, update 1 的完整信息,参考“Sun ONE Studio 5 update 1, Standard Edition for Java 入门指南”,地址在 http://forte.sun.com/ffj/documentation
Solaris 软件包
在 Solaris 系统中随 Sun ONE Studio 一起安装 Sun ONE 应用程序服务器之前,必须验证 Solaris 系统中是否安装了下列软件包:
SUNWpr
4.1.2 版
SUNWtls
3.3.2 版
可使用以下命令显示这两个软件包的相关信息:
pkginfo -l SUNWpr
pkginfo -l SUNWtls
如果两个软件包都存在,则要验证是否安装了下列修补程序:
对于 Solaris 9:114049-03
对于 Solaris 8:114045-02
在系统中安装这些软件包:
-
-
解包其内容。
-
运行以下命令:
cd <UntarDirName>
pkgadd -d .SUNWpr SUNWtls
成功安装软件包后,必须应用修补程序:
仅限 Solaris 9:cd Solaris9;patchadd -d 114049
仅限 Solaris 8:cd Solaris8;patchadd -d 114045
注意:这些修补程序专用于 Solaris 操作系统的特定版本。应该只将 114049 应用于 Solaris 9 系统,而只将 114045 应用于 Solaris 8 系统。
要点:在 Solaris 9 上,如果系统中已安装了 SUNWpr
和 SUNWtls
软件包,则应用修补程序时可能会产生以下错误:
错误:该修补程序与已经应用于系统的修补程序 114045-02 不兼容...
倘若如此,必须使用 pkgrm
卸载 SUNWpr
和 SUNWtls
软件包,然后按上述指令重新安装这两个软件包。
Sun ONE 应用程序服务器 7 Update 1 安装指南 (817-2169-10) 第 2 章系统要求部分的“Solaris 修补程序要求”小节详细说明了为什么需要关注 Solaris 修补程序、如何安装 SUNWpr
、SUNWtls
软件包,以及如何(自磁带存档文件)安装分别用于 Solaris 8 和 Solaris 9 的修补程序 114045-02 和 114049-03。
注意:nss_nspr.tar
文件中包含 nss_nspr/README.txt
,它与“Sun ONE Studio 应用程序服务器 7 Update 1 安装指南”部分具有相同的文本,但只提供安装信息而不提供背景信息。
H. 模块说明
本部分提供有关 Sun ONE Studio 5 update 1, Standard Edition 产品各个组成模块的附加信息。
与 Sun ONE Studio 5 update 1, Standard Edition 一起使用的浏览器
J2EE EJB 生成器(EJB 初始化)
RMI、JNDI、CORBA
Web 服务
J2EE Web 层
Sun ONE 应用程序服务器
与 Sun ONE Studio 5 update 1, Standard Edition 一起使用的浏览器
在 Microsoft Windows 平台上,如果使用的是 Netscape 7,应使用 Netscape 6 的设置:
- 选择
[工具] -> [选项]
- 展开
[IDE 配置]
|
[服务器和外部工具设置] |
[Web 浏览器] |
[外部浏览器]
- 将 DDE 服务器属性设置为
Netscape 6
J2EE EJB 生成器(EJB 初始化)
使用 EJB 菜单项(“添加创建方法...”)向 EJB 添加诸如创建或 business 方法时,IDE 会在所有必需的类和接口中添加方法声明。另外,也可以直接编辑 EJB 接口,键入一个新方法,IDE 会将相关的方法声明添加到 bean 类中。
通过 EJB 向导创建新的 EJB 后,应在 [资源管理器] 窗口中选择新创建的 EJB 节点。
但在某些情况下,当 EJB 具有远程接口并且远程接口 Java 类的名称与该 EJB 名称(缺省情况下将具有的名称)相同时,IDE 会转而使这个 Java 类节点被选中。
由于未选择该 EJB 节点,所以该 EJB 不会在内部完全初始化。如果您随后编辑某一 EJB 接口并添加一个新方法,则 IDE 不会向 bean 类中添加相关的方法,因为该 EJB 尚未完全初始化。
解决方法是:通过 EJB 向导创建 EJB 节点之后选择该节点,以验证该 EJB 是否已完全初始化。
如果当前创建的 EJB 只具有本地接口,则不会出现此问题,因为在此情况下创建的类均不会与 EJB 具有相同的名称。
RMI、JNDI、CORBA
这些模块未与 Sun ONE Studio 安装程序捆绑在一起,但可作为 NetBeans 模块从 Sun ONE Studio 更新中心获得:
-
Sun(TM) ONE Studio 5,CORBA 技术模块
-
Sun(TM) ONE Studio 5,JNDI 技术模块
-
Sun(TM) ONE Studio 5,RMI 技术模块
Web 服务
两次重新启动间的 Tomcat 部署持续性
部署 Web 服务时,对 Tomcat web 服务器所做的部署在 IDE 两次重新启动之间不会持续,因为此类部署被部署到了一个临时目录中。Sun ONE Studio 一停机,该临时目录便会被“清除”。
如果您需要在 IDE 重新启动后再次使用该应用程序,您将需要确保其在使用前得以部署或执行。
Web 服务:XML 操作
XML 操作功能已过时。
J2EE Web 层
服务器信息。 Sun ONE 应用程序服务器和 Tomcat 服务器均与本产品版本捆绑在了一起。Tomcat 服务器源自 Apache Tomcat 服务器,后者存在于 Java Web 服务开发包 (JWSDP) 1.1 版中。现在,IDE 使用 Sun ONE 应用程序服务器作为 web 模块的缺省服务器。
下面的列表描述了 Tomcat 服务器插件与 Sun ONE 应用程序服务器插件间的区别:
- 执行操作不进行生成和部署。 如果 web 模块的目标服务器为 Sun ONE 应用程序服务器,则在您使用“执行”操作时,IDE 不会自动生成和部署该 web 模块。您必须转而先使用“部署”操作,然后再使用“执行”操作,以反映对该 web 模块的更改。此外,“执行(强制重新装入)”操作也不会强制对 Sun ONE 应用程序服务器执行重新装入。
- 必须部署 HTTP 监视器。 要与 Sun ONE 应用程序服务器一起使用 HTTP 监视器,必须首先部署该监视器。参见 HTTP 监视器帮助说明集中的“为 Web 模块部署 HTTP 监视器”主题。
- Pointbase 未与 Tomcat 插件自动集成在一起。 如果 web 模块的目标服务器为 Tomcat 服务器,并且此 web 模块要访问 PointBase 数据库,请进行下列操作之一,使得该数据库驱动程序能够为 Tomcat servlet 容器所用。
- 将该驱动程序复制到此 web 模块的 WEB-INF/lib 目录下。
- 要将一个驱动程序作为共享资源添加到内部 Tomcat 服务器中,请将其复制到
s1studio-install-directory/jwsdp/common/lib 目录中。注意,此目录中的文件为本次 IDE 安装的所有用户所共享。
- 要将驱动程序作为共享资源添加到外部 Tomcat 安装中,请将此驱动程序复制到 tomcat-install-directory/common/lib 目录中。
如果随 IDE 一起安装了 Sun ONE 应用程序服务器,PointBase 驱动程序将包含在以下目录下的 pbclient42RE.jar 文件中:
s1studio-install-directory/appserver7/pointbase/client_tools/lib
有关详细信息,参见 Tomcat 插件联机帮助“设置 Tomcat 安装属性”部分中的“外部执行进程”属性说明。有关启动 PointBase 服务器和设置数据库连接方面的信息,参见 Sun ONE Studio 5, Standard Edition 入门指南中的“与 IDE 一起使用数据库”。
对处于版本控制下的 Web 模块的特殊安装说明。如果 web 模块源驻留在版本控制系统 (VCS) 中,则必须在用于初始签出的系统信息库的根处安装该 web 模块。然后必须使用此相对安装点在该 web 模块的根处安装该 web 模块。您可以有选择地卸载与系统信息库的根相对应的原始 VCS 文件系统。有关完整说明,参见 JSP/Servlet 帮助集中的“与 Web 模块一起使用 CVS”。
Sun ONE 应用程序服务器
如果某个 Sun ONE 应用程序服务器实例启动失败,则 JMS 服务可能在此之前已启动失败。请检查实例的 server.log 以查找详细信息。
例如:
# /opt/imq/bin/imqcmd shutdown bkr -u admin -p admin -javahome
/usr/java/j2sdk1.4.1_01 -b localhost:7676
# /opt/imq/bin/imqcmd shutdown bkr -u admin -p admin -javahome
/usr/java/j2sdk1.4.1_01 -b localhost:33497
S1MQ 代理程序,即 MQ 的服务器进程,在缺省情况下(在 Linux 平台上)会将其实例数据保持在:
/var/opt/imq/instances/<ASdomain_name>_<ASinstance_name>
MQ 代理程序具有如下形式的实例名
<ASdomain_name>_<ASinstance_name>
实例的日志位于:
/var/opt/imq/instances/<ASdomain_name>_<ASinstance_name>/log/log.txt
有关详细信息,参考 SunSolve 文章 8270:
http://sunsolve.sun.com/pub-cgi/retrieve.pl?doc=fsunone%2F8270
http://sunsolve.sun.com/pub-cgi/retrieve.pl?doc=fsunone%2F8270
http://sunsolve.sun.com/pub-cgi/retrieve.pl?doc=fsunone%2F8270&zone_110=8270%2A%20
I. 错误和问题
本节介绍与本发行版产品有关的错误和问题,并对某些问题提供了可用的回避方法。
一般或核心 IDE 问题
Sun ONE 应用程序框架 2.1
BEA WebLogic 插件
CORBA
安装
国际化 (I18N)
J2EE 应用程序客户机
J2EE 组装
J2EE EJB 生成器
J2EE Web 层
JUNIT
RMI
Sun ONE 应用程序服务器
VCS(VSS、CVS、Clear Case)
一般或核心 IDE 问题
下面是针对 Sun ONE Studio 5 update 1, Standard Edition 的一些与 IDE 有关的一般性未解决错误和问题。
Sun ONE Studio 应用程序框架 2.1
- 4927794 描述:在 LinuxRH7.2 上的资源管理器中,新创建的数据源在“JDBC 数据源”下没有可见节点。此问题可能是 Linux JDK 或 Open API 错误。在创建应用程序时,您通常一次只会创建一个数据源。
回避方法:可以继续在 IDE 中工作,因为这不会影响开发工作;但是,如果您希望看到该数据源节点,可对该数据源节点使用刷新操作。或者,也可以安装或卸载项目。
- 4742714 描述:用户尝试更新主键字段时,[更新] 操作不起作用。
执行代码前,要由开发人员负责将属性表中某一给定索引字段的键值设置为真。这一点将在未来 S1AF 版本的文档中进行说明。
- 4926967 描述:IDE 可能会在应用程序卸载后挂起。
回避方法:杀死该 IDE 进程,然后重新启动。
BEA WebLogic 插件
4863921 描述:WL61SP4:服务器启动期间抛出异常
问题:当与 Sun ONE Studio 5 IDE 一起使用 WebLogic 6.1 SP4 时,您可能会在 Linux 平台上看到下列异常:
Please ensure that libmuxer library is in
:/home/rmv/bea61sp4/wlserver6.1/lib/linux
java.lang.UnsatisfiedLinkError:no muxer in java.library.path
at java.lang.ClassLoader.loadLibrary(ClassLoader.java:1344)
at java.lang.Runtime.loadLibrary0(Runtime.java:744)
at java.lang.System.loadLibrary(System.java:815)
at weblogic.socket.PosixSocketMuxer.<init>(PosixSocketMuxer.java:186)
at java.lang.Class.newInstance0(Native Method)
at java.lang.Class.newInstance(Class.java:232)
at weblogic.socket.SocketMuxer.makeTheMuxer(SocketMuxer.java:192)
at weblogic.socket.SocketMuxer.getMuxer(SocketMuxer.java:144)
at weblogic.t3.srvr.ListenThread.run(ListenThread.java:233)
回避方法:在 WL61 插件节点的 [附加库路径] 属性中添加以下路径:<WL61_HOME>/lib/linux/i686
CORBA
- 32865 描述:[复制客户机绑定代码] 产生了路径问题
[复制客户机绑定代码] 操作不会产生正确的路径。例如:
- 绑定一个上下文以及其下名为“a”的上下文和其中绑定的名为“b”的对象。
- 对“b”对象调用 [复制客户机绑定代码] 操作。
- 将代码粘贴到 Java 编辑器中。这将产生如下结果:代码为:
String[] client_name_hierarchy = new String [] {"b", ""};
但它应为:
String[] client_name_hierarchy = new String [] {"a", "", "b", ""};
如果该对象被绑定在此上下文的根内 - 它将产生:String[] client_name_hierarchy = new String [] {};
回避方法:
手动填写缺少的路径,而不使用 [复制] 操作。
- 33496 描述:更改子 POA 变量名后,源代码未正确更新。
当您更改子 POA 变量名时,源代码未正确更新。
- 从
CORBA|ServerMain
模板创建 Java 源文件。
- 选择
[文件|根 POA]
节点。
- 对 [根 POA] 节点使用
[添加|子
POA]
弹出菜单操作,添加子 POA。
- 对 [子 POA] 节点使用
[添加|Servant]
弹出菜单操作,在 [子 POA] 节点下添加一个 Servant。
- 打开 [子 POA] 节点的 [定制器](或 [属性] 窗口)。
- 将
[变量名称]
属性的值更改为其它值。
- 参考 [源编辑器]。
- [子 POA] 变量名仅在赋值和启动管理器时才会更改。该变量名在创建 servant 的行上未更改。[子 POA] 下所有类型的子项均会出现此问题。
安装
- 4855313 描述:安装程序对话框用于指示运行安装程序时使用了不适当的 JDK,它有可能未随文本出现。在 Solaris 9 平台上,如果路径中有任何 JDK 的版本小于
1.4.1_x
,则会出现此情况。
回避方法:如果该对话框未出现,请将安装程序窗口最小化,然后重新调整其大小。
国际化 (I18N)
有关国际化错误,请参考“Sun ONE Studio 知识库”。
J2EE 应用程序客户机
- 4859341 描述:完成导出客户机支持后,客户机 jar 在 IDE 中显示为
ejb_jar
。
J2EE 组装
- 4863509 描述:如果应用程序和 web 模块均存储在同一个 VCS 系统信息库中,当工作目录(从而绝对路径亦如此)可能不同时,IDE 将无法解决到 web 模块的链接。IDE 会在应用程序节点下方显示中断的 web 模块节点。
回避方法:
对应用程序节点下方中断的 web 模块节点使用弹出式菜单中的 [解决中断链接]
操作,选择所需的 web 模块文件系统。
J2EE EJB 生成器
J2EE Web 层
- 23135 描述:如果使用 Tomcat 作为其目标服务器的 web 模块包含具有相同名称但存储在不同的目录下的 JSP 页,则执行 [全部生成] 命令时,会导致编译错误。该问题出现的原因是 Tomcat JSP 编译器创建了两个具有相同路径名的 servlet。
回避方法:或者逐页编译 JSP 页,或者将 IDE 集成模式设置为最小。在 [执行环境] 标签上,展开 [服务器注册表] 节点,并导航到与适当 Tomcat 实例相对应的节点。在节点的属性表上,将 [IDE 集成模式] 属性设置为 [最小]。
- 20384 描述:在相关 web 模块中分析和执行 JSP 后,无法替换
WEB-INF/lib
目录下的标记库 JAR。JSP 分析器、编译器和/或执行器有时会固定住指向 WEB-INF/lib
目录下标记库 JAR 的指针。在 Windows 系统中,结果造成有时无法删除 JAR,从而导致出现“不能删除文件...”异常。在 Solaris 中,可以删除 JAR,但在用新的 JAR 进行替换时,编译器“看到”的将是 JAR 的旧版本。要正确执行 JAR 替换操作,必须重启 IDE。
回避方法:通过直接引用 TLD 和标记处理程序类来开发标记库,并且在开发周期结束之前,不将标记库封装到 JAR 文件中。
- 在
WEB-INF/lib
目录下创建标记库,并在此处进行所有的开发工作。
- 将标记处理程序生成根目录设置为 web 模块的
WEB-INF/classes
目录。
- 若要通过 JSP 页使用标记库,请直接以
/WEB-INF/lib/mytaglib.tld
形式引用 taglib URI,或者在具有标记库条目的部署描述符中设置一个别名。
- 26420 描述:使用 Tomcat 服务器测试或调试 web 应用程序时,可能会抛出异常(
org.apache.jasper.JasperException
或 javax.servlet.ServletException:类定义重复
)。它会出现在服务器日志文件和/或 web 浏览器窗口中。此错误是由 Tomcat 错误 6907 引起的。
回避方法:重新启动 Tomcat web 服务器。
- 28004 描述:在 JSP 的 <% 和 %> 标记之间设置的断点未映射到 servlet 中正确的行。
部分回避方法:不要在代码中将 <% 和 %> 标记置于其自身的行上。您在这些行上设置的任何断点都会被正确映射。但是,如果您在结束和关闭标记之间的行上设置断点,断点将会映射到与 JSP 中的 <% 行相对应的 servlet 行。
- 31924 描述:在 Linux 上运行 IDE 时,如果标记库包含日文字符,这些库将不会正确生成。
- 29657 描述:如果一个 web 模块包含与某些 AWT/Swing 类(例如,
com.foo.bar.mytaghandlers.TextArea
)具有相同类名(包除外)的标记处理程序,则该模块可能无法进行编译。
回避方法(采用以下方法之一):
- 如果当前使用的是 Tomcat 服务器,可通过将集成模式设置为最小来回避该问题。在 [执行环境] 标签上,展开 [服务器注册表] 节点,并导航到与适当 Tomcat 实例相对应的节点。将 [IDE 集成模式] 属性设置为 [最小]。
- 升级到 J2SE SDK 的 1.4.2 版(如果此版本已发布)。
- 24443 描述:调试 servlet 时,如果连续多次快速刷新浏览器,可能会出现异常。
回避方法:如果出现异常,请在继续调试前重启 Web 服务器。
- 31573 描述:访问 JSP 页时,如果与其相应的、JSP 所依赖的 JAR 文件已更改,将会出现“无效的 LOC 标题(错误签名)”异常。
回避方法:在 WEB-INF/classes
目录内开发 Java 类,而不将其置于 JAR 文件中。如果不能或不愿这样做,重启 IDE 将有助于避免此问题。
- 4840628 描述:在 Solaris 操作环境下,无法部署已作为 ClearCase 文件系统安装的有效 web 模块。
当您部署作为 ClearCase 文件系统安装的有效 web 模块时,IDE 显示 [部署失败] 对话框,其中包含以下消息:.../web.war 不是一个文件
回避方法:采用下列方法之一可避免该问题。
- 在与 IDE 相同的视图中启动应用程序服务器,例如,
cleartool setview
viewname
asadmin start-appserv
- 在视图扩展路径下安装文件系统,例如,
/view/
viewname/path
- 4861999 描述:NFS 上的用户目录可能会导致 web 模块部署失败。
回避方法:如果出现该问题,请用 the -userdir
local-directory 参数启动 IDE
JUNIT
- 33293 描述:虽然随 junit 模块一起提供了 JUnit 的 API 文档,但是由于文档封装不正确,它们未出现在 [查看 | 文档索引] 中。
回避方法:
- 打开 IDE 的安装目录以及安装目录中的
docs
文件夹。
- 解压缩
junit-3.8.1-api.zip
。
- 创建新的 ZIP 文件,从分层结构中删除
javadoc/
前缀,保留诸如 packages.html
和 junit/framework/Test.html
等条目。
新的 zip 文件必须与原来的 zip 文件 (junit-3.8.1-api.zip
) 同名
RMI
33763 描述:RMI 实现类的同步可能会导致死锁,特别是当源码是以手动方式创建的时。
回避方法:直接从 RMI 模板创建 RMI 实现类。
或者,也可以执行下列步骤
- 在 [选项] 对话框中,选择
[选项] -> [分布式应用程序支持] -> [RMI 设置]
。
- 在属性面板中,将
[检测
远程]
属性设置为 False
。
这将禁用自动检测功能。您可能需要通过以下步骤将对象标记为远程:
- 在资源管理器中选择此 Java 对象
- 从弹出式菜单中选择
[工具] -> [标记为 RMI]
。
Sun ONE 应用程序服务器和插件
- 4862160、4869294 描述:在两种情况下,相关的 CMP EJB 集可能会丢失其中一个相关 bean 上的映射字段属性。在第一种情况下,如果应用程序被多次创建、部署、卸下和重新创建,部署可能会因 CMP 映射错误而失败。第二种情况可能出现在创建相关 CMR EJB 之后。两种情况都要求较大的相关 CMP EJB 集,并且要求在发现问题之前多次尝试创建相关的 EJB。
更正问题:虽然此时的应用程序或 EJB 之间的关系不存在任何错误,但是必须为丢失了其应用程序服务器映射属性的 EJB 恢复映射。如果在使用相关的 EJB 时出现编译或部署错误,请检查 bean(在 EJB 模块中)上的映射属性,并重新映射未映射的 EJB。要做到这一点,可先映射到适当的 dbschema,然后映射到表,最后使用自动映射功能映射 bean 的字段。
- 4866924 描述:使用 CMR EJB 时,有时会抛出
concurrentModificationException
。该异常无害,但会记录到 ide.log 中。该异常出现时,可以关闭日志,对其置之不理。
- 4832430 描述:允许服务与桌面进行交互。缺省情况下,当您在 Windows 平台上运行 Sun ONE 应用程序服务器时,会打开一个控制台。偶尔可能会出现暂停或进程空闲。
回避方法:
- 打开
[控制面板] -> [管理工具] -> [服务]
工具。
- 选择 [Sun ONE 应用程序服务器]、[属性]。
- 单击
[登录]
标签,然后取消选中 [允许]
服务与桌面交互复选框。这将防止控制台被打开。server.log 输出仍将出现在 [输出窗口] 中。
- 4814643 描述:部署应用程序不会完全卸下先前的部署。
在将 J2EE 应用程序重新部署为 Sun ONE 应用程序服务器时,可能会出现错误,其中包含以下消息:
无法重命名
C:\Sun\AppServer7\domains\domain1\server1\generated\ejb\j2ee-apps\Checklist
为
C:\Sun\AppServer7\domains\domain1\server1\generated\ejb\j2ee-apps\Checklist_old
回避方法:
- 打开服务器注册表。
- 展开 Sun ONE 应用程序服务器注册的
[Admin 服务器]
、[已部署
应用程序]
节点。
- 卸下应用程序。
4889427 描述:不能部署关系的CMP EJB。
在部署包含相关的 CMP EJB 的 EJB 模块或 J2EE 应用时,将发生部署失败的错误。错误信息为:
部署错误 -- 运行 EJBC 时发生错误 -- EJB 编译器严重错误 ---- 处理 CMP Bean 时发生错误。
回避方法:
将 SunONE Studio 5 CD 3 (卷标为zh_CN_studiose_5u1) 放入 CDROM,在该 CD 的 Documentatation_zh/appserver_workaround 目录下,您会找到一个名为 fix_propfile.pl 的脚本文件,运行该脚本将会修复这个问题。具体步骤如下:
% su
passwd: 在此输入超级用户口令
# cd /cdrom/cdrom0/Documentation_zh/appserver_workaround
# perl fix_propfile.pl <您的 SunONE 应用服务器安装路径>
例如:/opt/studio5_se/appserver7
重新启动您的 SunONE 应用服务器。
4960034 描述:《SunONE 应用程序框架组件编写人员指南》中的程序范例在 J2SE 1.4.1 下出现异常。
回避方法:
使用 J2SE 1.4.2_xx 运行书中的例子。
VCS/(VSS、CVS、Clear Case)
- 33132 描述:执行“转换为 WebModule”操作后,一些节点显示得像是本地节点。
调用 [通过 Web 模块转换文件系统] 命令并将 web 模块添加到 ClearCase 中后,一些节点可能会以 [本地]
状态出现。
回避方法:右键单击该 web 模块节点,然后选择 [Clear
Case]
|
[刷新]
。
- 33551 描述:Sun ONE Studio 5 中不支持内置 CVS 客户机
虽然 IDE 的联机帮助提到了内置 CVS 客户机的可用性,但这种客户机在本版本中不可用。虽然包含内置 CVS 文件系统的导入项目仍能使用,但不能安装新的内置 CVS 文件系统。
对于新项目,请使用普通 VCS 文件系统安装您的 CVS 目录。如果您尝试将 CVS 目录安装为普通 VCS 文件系统,并且在您的系统中没有安装可执行的 CVS,您将会收到类似下面的错误消息:
“cvs”未被识别为内部或外部命令、可操作程序或是批处理文件。
回避方法:从 http://www.cvshome.org/ 下载并安装 CVS。使用 [新建普通 VCS] 向导安装 CVS 目录:
- 选择
[版本] >
[安装版本控制] >
[普通 VCS]
。
- 在 [新建普通 VCS] 向导的首页中,从
[选择
一个
配置文件]
组合框中选择 CVS。
- 在 [CVS 可执行文件] 文本框中键入路径或浏览到该 CVS 可执行文件。请注意,如果 PATH 环境变量包括到 CVS 可执行文件的路径,可以将 [CVS 可执行文件] 值简单设置为
cvs
(Linux 或 Unix)或 cvs.exe
(Windows)。
- 32186 描述:如果是在 Microsoft Windows 系统上运行且用户目录名中有空格,则在对普通 VCS 文件系统运行 [提交] 命令后,[资源管理器] 中会出现一个
Wincat.bat
节点。
回避方法:此节点无害,因此可以置之不理。也可以对文件系统运行 [刷新] 命令将其删除。
- 33474 描述:安装大型 VCS 文件系统时,IDE 变慢了。出现这种情况的原因是更新分析器数据库操作会消耗系统资源。
要提高性能,可禁止更新分析器数据库:
- 选择
[工具] -> [选项] -> [编辑] -> [编辑器设置] -> [Java 编辑器] -> [专家属性] -> [完成安装后更新代码
完成数据库]。
- 将属性设置为
[从不]
。
Web 服务
- 4791482 描述:
JSPTagException
:序列化错误:未注册任何序列化器
如果使用集合,必须提供集合当前返回的类,将其也作为序列化类,或者需要有一个返回该类的单独方法。
您可能会收到 JSP 标记异常,因为当前无法将集合返回值映射到特定的类。如果缺乏类方面的知识,则无法为其生成序列化器/解序列化器。
- 4794440 描述:对 JAX-RPC 结构无效的类型:
java.util.Enumeration
不能从返回 java.util.Enumeration 的方法中创建 web 服务操作。不支持 Java 方法中的 java.util.Enumeration
。JAX-RPC 中的枚举支持是单向的:从 XML 枚举到 Java 枚举。不支持从 Java 枚举到 XML 枚举。
- 4800280 描述:需要发送“字符串附件”的方法
您不能以附件形式发送“字符串”。在本 JAX-RPC 实现中不支持以附件形式发送字符串。
- 4782125 描述:在本地注册表中通过分类和标识符未能发现 WSDL。
当分类和标识符是在 IDE 中发布的 web 服务上指定的时,这些服务和 tModel 可以拥有与其相关联的分类和标识符。但这些分类和标识符不适用于业务。
如果在创建新客户机时查询 UDDI 注册表,您可以根据 NAICS 和 ISO 代码来查询它。但 IDE 不能在业务中设置这些值,因此,不能用“111”对本错误中指定的业务进行查询。
- 4782287 描述:用已设置的标识符查找 UDDI tModel 时,无法找到。
IDE 不支持根据“服务”或 tModel 中设置的标识符查询业务的能力,只支持某些在“业务”中设置的标识符或分类(不能从 IDE 内部执行该操作)。
- 4789390 描述:测试客户机代理服务器信息未被使用。
如果 web 服务运行于防火墙之内的服务器上,所输入的代理服务器信息将不会生效。如果 web 服务运行于防火墙之外的服务器上,则在调用服务操作时,不正确的代理服务器字符串会返回异常。只有正确的代理设置才能使调用顺利完成。
在 jdk java.net
软件包中实现了何时或如何使用代理服务器的机制。
- 4822421 描述:生成客户机代理时收到命名冲突错误消息。
在生成客户机代理时,如果存在命名冲突,您可能会收到以下错误消息:com.sun.forte4j.webdesigner.basecomponent.KomodoException:生成 web 服务时出现了下列命名冲突。
如果某个方法返回一个对象(例如,Restaurant),而另一个方法返回一个类似对象 (restaurant),则会发生该错误。所使用的 JAX-RPC RI 版本不能处理仅大小写不同的 2 个类型名。
- 4826665 描述:自本地以 web 为中心的 WSDL 创建服务结果导致了多层服务。
来自(为其提供了该功能的)外部源的 WSDL 文件对我们的体系结构一无所知。使用 WSDL 功能创建 web 服务时,我们的设计要求创建多层 web 服务。
- 4828115 描述:自带有图像附件的 WSDL 创建了无效的 EJB 和 web 服务。
映射到 JAX-RPC 所支持的 MIME 类型的 Java 类型不可序列化。当 web 服务创建自 WSDL 时,会在 EJB 中实现这些操作的地方创建多层 web 服务。由于 EJB 要求返回类型和参数可序列化,所以不能自具有附件的 WSDL 创建任何 web 服务。
- 4828670 描述:自 .Net WSDL 创建的 web 服务在生成期间失败。
不能从具有不含任何元素的复杂类型的 WSDL 中创建 web 服务。从 WSDL 文件的不含任何元素的复杂类型中创建了无任何字段的类,而且 web 服务文件生成将会失败。
- 4828682 描述:部署 .NET WSDL 创建的 web 服务时对 JAX-RPC 结构无效的类型。
如果 WSDL 具有文档/文字编码且类型无 JAX-RPC 映射,该类型会自动映射到 java.xml.soap.SOAPElement。如果这是 Sun ONE 应用程序服务器的 EJB 编译器的返回类型,则该返回类型在其类路径中需要有 saaj-api.jar。缺省情况下,此项不在类路径中,因此会产生错误。
解决方法是:在 Sun ONE 应用程序服务器的类路径中加入 saaj-api.jar
。
- 4828749 描述:自 MS WSDL 创建的 web 服务生成失败。
不能从具有枚举的 WSDL 中创建 web 服务。
如果 WSDL 具有一个含有枚举的类型,则会为该类型创建一个无缺省构造函数的类。因此,在生成 web 服务时验证将会失败。
- 4831579 描述:GenerateEjbException
WSFromWSDLGenerator.java:342
此问题适用于以下两种情况:
(a) 不能从具有简单类型 xsd:restriction
的 WSDL 中创建 web 服务。IDE 中的 JAX-RPC 实现不支持除枚举以外的简单类型约束。
(b) 不能从具有类型名为 Java 关键字的 WSDL 中创建 web 服务。这是 JAX-RPC 实现中的错误。
- 4845971 描述:UDDI 未能发现具有 HTTP 基本安全性的已发布 web 服务。
IDE 的 [发布到 UDDI] 向导中提供的缺省 WSDL URL 允许通过 web 服务自身 <web-service>?wsdl 来检索 WSDL。在 web 服务受保护的情况下,除非您已正确经过了身份验证,否则您将无法自该 WSDL URL 创建客户机。为了向 UDDI 发布可公开访问的 WSDL URL(在 web 服务一直受保护时),请在从 IDE 中发布时在发布向导中将该 WSDL URL 手动更改为
<web-service>/<web-service>.wsdl
。
- 4821656 描述:序列化错误:和 .NET 客户机一起使用的文字数据意外出现空值。
“字符”和“字节”被映射到不为测试客户机所支持的 SOAPElement
。客户机欢迎页面会提示不支持此操作。
执行返回 anyType 或 anyType
数组的 .NET 操作将会因 JAX-RPC 错误 #475866 而失败。该 JAX-RPC 错误在 JAX-RPC 1.0.3 (JWSDP 1.1) 中进行了修正,不过,Sun ONE Studio 目前仍在使用旧版本的 JWSDP。(1.0.01)。
- 4823830 描述:会话 bean 之外的方法未正确发挥启动器的作用。
Sun ONE Studio 不支持这种用途。如果正在使用会话 bean 在 web 服务中实现有态行为,则应将所有有态行为发送到该 EJB(例如,应将会话生命周期的边界发送到同一对象)。如果使用的是非 EJB,则它也应具有代表会话生命周期边界的签名。
- 4825458 描述:I18N - 未将 JSP 内容设置为 UTF-8。
无法翻译 JSP 的内容。
仅当您使用 Weblogic 7.0 时,此问题才会对您造成影响:BEA 支持通过页指令来应答发生在 setContentType
上的问题。或者将 WebLogic 升级到 SP1 或 SP2,或者应用 7.0 版的修补程序 (CR077944_70_GA)。
- 4727371 描述:JSP 无法将
java.lang.String
转换为 java.util.Calendar
。
JSP 操作失败,并产生不能将 java.lang.String 转换为 java.util.Calendar
错误。这是 Sun ONE Studio 5 产品中的一个局限。
- 4741049 描述:Web 服务为 W2000 生成了很长的
SoapBuildeClass
名称,从而导致 Sun ONE Studio 应用程序服务器 7 上部署失败。
尝试缩短 web 服务名称和绝对路径。
- 4761980 描述:
java.lang.NoClassDefFoundError:javax.xml.transform.Source
这是 IDE 当前使用的 JDK 版本的问题。如果当前与 IDE 一起运行的是 JDK 1.3.1,则 Tomcat 运行的也将是 JDK 1.3.1。JDK 1.3.1 不包含 JDK 1.4 及以上版本随带的 JAX-RPC 库,这些库是成功支持 web 服务所必需的。
您可以有两种选择:
选择 1:将 IDE 升级到 JDK 1.4(注意:如果您正在使用 Oracle 插件,则不能采取这种选择,因为该插件依赖于 JDK 1.3)
选择 2:将 <install-dir>/jwsdp/jwspd-common-lib/jwsdp-common
.jar 文件手动复制到 <install-dir>/tomcat401/common/lib
目录中,然后杀死 Tomcat 进程,重新执行该客户机。
- 4803858 描述:输入客户机信任存储密码时引发的
AccessControlException
。
当 web 服务测试客户机运行 Sun ONE 应用程序服务器(或启用了 java 安全策略的 WebLogic 服务器)时,从 web 服务测试客户机中设置代理信息和 SSL 信任存储时可能会产生以下异常:
该异常表示您的应用程序服务器的安全策略不允许更新相关的 Java 系统属性。要启用更新,请将下列权限添加到您应用程序服务器的安全策略文件中:
permission java.util.PropertyPermission "http.proxyHost", "read,write";
permission java.util.PropertyPermission "http.proxyPort", "read,write";
permission java.util.PropertyPermission "https.proxyHost", "read,write";
permission java.util.PropertyPermission "https.proxyPort", "read,write";
- 4823228 描述:应用程序客户机的安全回调函数句柄属性不起作用。
- 4857215 描述:Linux/CVS:将签出的 web 服务部署到 Sun ONE 应用程序服务器 7 时的 NPE。VCS:在客户机未签入的情况下生成签入的 web 服务时出现的问题。
如果签入的 web 服务有一个相关联的客户机,而该客户机未签入,则当从另一 VCS 视图生成 web 服务时,可能会遇到问题。解决方法是:在 web 服务之后签入客户机。
- 4832234 描述:部署 web 服务期间在 IDE.log 中出现的异常(如果该 web 服务发生了验证错误)。
- 4857887 描述:生成自 .net WSDL 创建的服务时出现的类型名重复错误。
不能从同时具有 X 数组和 ArrayOfX
两种类型声明的 WSDL 中创建 web 服务。
如果 WSDL 中既有 X 类型的数组又有 ArrayOfX 类型,则 web 服务文件生成将失败。当 JAX-RPC 产生器遇到具有数组类型(如“X[]”)的 WSDL 时,它会尝试在 SerializerRegistry 中将其注册为 ArrayOfX
。由于该 web 服务已包含类型 ArrayOfX
(来自 WSDL),所以会出现类型名重复错误。解决方法是:将 WSDL 中的 ArrayOfX
类型重命名为另一名称。
- 4804477 描述:停止内部 UDDI 注册服务器时的 NPE
如果在 UDDI 服务器的 Tomcat 输出窗口中停止内部 UDDI 注册服务器时出现下列异常,表明用户目录中的配置文件 jwsdp/uddi_base/conf/server.xml
版本太旧:
java.lang.NullPointerException
at
org.apache.catalina.core.NamingContextListener.lifecycleEvent(NamingContextListener.java:343)
at
org.apache.catalina.util.LifecycleSupport.fireLifecycleEvent(LifecycleSupport.java:166)
at
org.apache.catalina.core.StandardServer.stop(StandardServer.java:2217)
at org.apache.catalina.startup.Catalina.start(Catalina.java:535)
at org.apache.catalina.startup.Catalina.execute(Catalina.java:399)
at org.apache.catalina.startup.Catalina.process(Catalina.java:179)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at
sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
at
sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
at java.lang.reflect.Method.invoke(Method.java:324)
at org.apache.catalina.startup.Bootstrap.main(Bootstrap.java:203)
您需要使用新的 IDE 用户目录,或用更新版本的配置文件替换较旧版本的配置文件,如下所示:
- 复制
ide-install-dir>/jwsdp/uddi_base/conf/server.xml
和 ide-user-dir>/jwsdp/uddi_base/conf/server.xml
- 如果您已在 uddi server
.xml
中完成了端口更改,请将相同的更改设置应用于新的 server.xml
文件。
- 重新启动内部 UDDI 注册服务器
- 4838732 描述:内部 UDDI 服务器启动时出现的异常
UDDI 服务器启动时,IDE 会尝试验证到该 UDDI 服务器的连接。如果您此时在 UDDI 服务器 Tomcat 输出窗口中注意到以下异常,那么,只要内部 UDDI 服务器最终能完成启动,该异常便是无害的:
java.lang.RuntimeException:RegistryServerSevlet.initializeDB(...):
com.sun.xnode.XNodeException:aborting connection attempt.,
RegistryServerServlet.init(...):connection:1, Database failed to connect
at
com.sun.registry_server.server.RegistryServerServlet.initializeDB(RegistryServer Servlet.java:710)
at
com.sun.registry_server.server.RegistryServerServlet.init(RegistryServerServlet. java:93)
内部 UDDI 注册服务器成功启动后,IDE 资源管理器上方的状态字段将会显示文本“内部 UDDI 注册服务器已启动”。该异常是由瞬间状态所引起的,其时,UDDI 注册服务器 servlet 已准备好接受请求,但其后端数据库服务器 Xindice
尚未做好准备。
- 4803858 描述:使用 web 服务测试客户机时引发的 AccessControlException
当 Web 服务测试客户机在 S1AS(或启用了 java 安全策略的 WebLogic 服务器)中运行时,从“Web 服务测试客户机”中设置代理信息和 SSL 信任存储时可能会导致以下异常:
java.security.AccessControlException:access denied
(java.util.PropertyPermission javax.net.ssl.trustStore write)
at
java.security.AccessControlContext.checkPermission(AccessControlContext.java:270)
at
java.security.AccessController.checkPermission(AccessController.java:
401)
at
java.lang.SecurityManager.checkPermission(SecurityManager.java:542)
at java.lang.System.setProperty(System.java:653)
at
_jasper._GPASvcClient_SETUP_jsp._jspService(_GPASvcClient_SETUP_jsp.java:67)
....
该异常表示您应用程序服务器的安全策略不允许更新相关的 java 系统属性;要启用该功能,请将下列权限添加到您应用程序服务器的安全策略文件中:
permission java.util.PropertyPermission "http.proxyHost", "read,write";
permission java.util.PropertyPermission "http.proxyPort", "read,write";
permission java.util.PropertyPermission "https.proxyHost", "read,write";
permission java.util.PropertyPermission "https.proxyPort", "read,write";
- 4803631 描述:执行以参数形式获取附件的方法时出现的
FileUploadException
当 Web 服务测试客户机在 S1AS(或启用了安全策略的 WebLogic 服务器)中运行,并且您的测试客户机正在测试一个具有
附件输入参数的操作时,您可能会遇到以下异常:
该异常表示您应用程序服务器的安全策略不允许删除测试客户机从客户机向您的 web 服务器上载文件时所创建的临时文件,要启用该功能,请将下列权限添加到您应用程序服务器的安全策略文件中:
permission java.io.FilePermission "<<ALL FILES>>", "read,write,delete";
- 4816969 描述:在 Weblogic 7 上执行 Web 服务测试客户机时出现的
JspException
当在 Weblogic 7 上执行 Web 服务测试客户机时,可能会遇到以下异常:
java.io.IOException:javax.servlet.jsp.JspException:The taglib
validator rejected the page:"org.xml.sax.SAXParseE
xception:The value of attribute "contentType" must begin with either a single or double quote character., "
这是运行具有定制标记的 JSP 时 WebLogic 7 中的一个已知错误。可从 BEA 中获得一个 WebLogic 7 的修补程序,并且该错误还在
WebLogic 7 SP1 及更高版本中进行了修正。可以升级到 WebLogic 7 SP1 或 SP2,或者直接从 BEA 请求 WebLogic 7 的修补程序 (CR077944_70_GA
)。
- 4802443 描述:在 Web 服务中使用带有 XML 附件的 Java bean,可能会在 web 服务运行时产生异常。
如果 web 服务操作返回一个由某一 XML 附件类型属性组成的 java bean,则当该 XML 附件类型属性被声明为公共属性并且还具有一个公共的 getter 方法时,在运行/测试 web 服务时可能会出现异常。这是一个已知问题。
回避方法:将该属性声明为私有,然后提供一个公共的 getter 方法,或者将该属性声明为公共,然后删除公共的 getter 方法。
- 4825743 描述:无法将具有附件的 Web 服务及其客户机单独部署到同一个 web 容器中。
由于一个已知的 JAXM 错误 (#4763995),如果将具有附件的 web 服务部署到某个 web 容器,然后再单独将其测试客户机部署到同一个 web 容器,则将会产生以下异常:
java.lang.Error:DataContentHandlerFactory already defined
at
javax.activation.DataHandler.setDataContentHandlerFactory(DataHandler.java:628)
at
com.sun.xml.messaging.saaj.soap.AttachmentPartImpl.<clinit>(AttachmentPartImpl.java:35)
at
com.sun.xml.messaging.saaj.soap.MessageImpl.createAttachmentPart(MessageImpl.java:305)
回避方法:始终将具有附件的 web 服务和其缺省的测试客户机一起部署。
-
4850758 描述:仅 WebLogic614:运行时分析 JSP 失败。
由 Sun ONE Studio 生成的 Web 服务测试客户机使用 JSTL 1.0.1,它包括在 Java Web 服务开发包 1.0.1 中。在不完全支持 JSP 1.2 规范的 BEA WebLogic614 中,不能使用该版本的 JSTL。要在 WebLogic614 上运行 web 服务测试客户机,您可以有以下两个选择,或者
- 编辑生成的 JSP(以
_TAGLIB.jsp
结尾)以删除对 JSTL tld 和标记的所有引用,或者
- 编辑
<ide-install-dir>/bin/ide.cfg
,在其中加入以下标志:-J-Dwsdl.taglib=false
,然后重新启动 IDE。
这将指示 IDE 使用较早版本的 web 服务测试客户机产生器,其中未使用 JSTL。较早版本的测试客户机不支持对安全 web 服务及带附件的 web 服务进行测试。
- 4855196 描述:如果要创建一项没有缺省客户机的 web 服务,请将该 web 服务签入到 Clearcase 中,再将该 web 服务添加到 J2EE 应用程序中,然后部署/执行它(或仅从节点 - webcentric 服务中部署/执行该 web 服务)。将会通知您没有缺省的客户机,并询问您是否想让我们创建一个客户机。如果您同意,将会要求您签出该 web 服务;如果您回答“是”,IDE 将会创建客户机并尝试进行部署,该操作将因出现异常而失败。
回避方法:重新部署/执行该 web 服务。现在,该 web 服务便会被正确签出了。
J. 可访问性
本部分提供有关 Sun ONE Studio 5 update 1, Standard Edition 的可访问功能方面的信息。
文档
Sun ONE Studio 5 update 1, Standard Edition 文档以可访问的格式提供,可以通过辅助性技术来阅读。其中包括 Sun ONE Studio 5 update 1, Standard Edition 编程指南、入门指南以及 docs.sun.com
站点上的教程。
联机帮助文档
IDE 提供了许多可访问性功能,利用这些功能,您可以采用自己感觉最舒适便利的方式来阅读和使用本产品。
这些功能包括:
- 助记符和快捷键
- 可定制的字体
- 可定制的颜色
- 可定制的工具栏
- 可定制的样式表
要了解 IDE 的可访问性功能,请打开联机帮助,然后单击目录中的“可访问性”主题。
修改与可访问性相应的层叠样式表
联机帮助中对修改层叠样式表的说明要求附加信息。
大多数帮助集使用存储在 modules/docs/usersguide.jar
中的样式表。如果您更改了该样式表,大多数其它帮助集的显示也会受到影响。但“数据库模式”帮助集除外,它使用存储在 dbschema.jar
中的样式表。
更改联机帮助的层叠样式表:
1. 在 IDE 安装目录中,导航到 modules/docs
。
2. 使用 jar
命令行公用程序解压缩 JAR 文件。
在 Microsoft Windows 和 UNIX 系统中,该命令为:
jar xf jar-file
对于 jar-file,请使用下列某一项:
usersguide.jar
- 大多数帮助集使用的样式表
dbschema.jar -
“数据库模式”联机帮助
Jar 工具会制作文件副本并将其写到当前目录下。目录结构按照归档中的包结构重新产生。
3. 在提取得到的分层结构中,导航到要编辑的样式表所在的目录:
- 一般联机帮助 -
org/netbeans/modules/usersguide
- 数据库模式
- com/sun/forte4j/modules/dbmodel/docs
4. 用文本编辑器打开文件 ide.css
。按个人喜好编辑文件,然后保存该文件。
6. 返回到安装目录下的 modules/doc
,然后更新 JAR 文件。在 Microsoft Windows 和 UNIX 系统中,该命令为:
jar ufv jar-file input-file
对于 jar-file,请使用原始 JAR 文件的名称,例如,
usersguide.jar。对于 input-file,请使用下列某一项:
org
,对于“用户指南”帮助集
com
,对于“数据库模式”帮助集
Solaris 操作环境
Solaris 操作环境允许您使用“窗口样式管理器”来设置窗口行为。当与 IDE 一起使用助记符时,应将窗口行为设置为“单击(鼠标)激活窗口”。
如果未设置该选项,某些情况下,助记符可能会无法使用。
K. 其它文档
本部分概述了随 Sun ONE Studio 5 update 1, Standard Edition 产品提供的文档。
书籍
下列 Sun ONE Studio 5 update 1, Standard Edition 书籍可以在 http://forte.sun.com//ffj/documentation/index.html 以 PDF 格式下载。
联机帮助
可通过从主窗口中选择 [帮助] > [帮助集]
菜单项
来访问 IDE 的联机帮助。[帮助] 菜单还包括到 Sun ONE Studio Developer's Resources 主页及其它有用 URL 的链接。
实例
可在 Sun ONE Studio Developer's Resources 下一同找到教程和实例:网址为 http://forte.sun.com/ffj/documentation/tutorialsandexamples.html
在 IDE 分发版中提供了位于 Sun ONE Studio Developer's Resources 下的实例和教程的子集。
寻访错误
可通过“Java 开发人员连接”的 Bug Parade(错误陈列)寻访到 Sun ONE Studio 5, Standard Edition 的大多数错误,网址为:
http://developer.java.sun.com/developer/bugParade/index.jshtml
用设置向导选择浏览器
在 [设置] 向导中,您将能够选择 HTML 浏览器的类型,该浏览器可用来浏览文档以及外部网站,如 Sun ONE Studio Developer Web Resources 站点。
如果您已安装了 Netscape 或 Internet Explorer 之类的浏览器,一定要选择“外部浏览器”,而不是“Swing HTML 浏览器”。
Swing HTML 浏览器专门用于浏览文档,大多数网站都不能用它进行浏览。
可以使用“更新中心”功能来动态更新 IDE。当您连接到“更新中心”时,IDE 会查看是否有新模块或已安装模块的新版本可以获得。
如果可以获得新的或已更新的模块,您可以选择自己想要的模块。
然后下载那些模块,并将其安装到自己的 IDE 中。
注意:Sun ONE Studio 模块可通过 Sun ONE Studio 更新中心文件夹获得。
[自动更新向导] 允许您从更新中心安装模块,或安装先前已下载到系统中的模块(具有 .nbm 文件形式)。
对于这两种方法,模块都是 .nbm
格式。
如果选择使用 Sun ONE Studio 更新中心,您将需要输入更新中心登录名和密码。
如果没有更新中心登录名和密码,则需单击向导中的 [帐户维护] 按钮,然后按照所提供的说明来获取一个。
如果您没有注册,可将 [登录名] 和 [密码] 字段留为空白,此时您仍可连接到更新中心并可看到通常可以获得的免费模块。
但是,要获得已升级的第三方或企业版的访问许可,您必须注册。
更新中心使用该登录名和密码来跟踪用户对不同产品和模块的权利。
当您连接到更新中心时,IDE 将通过 HTTP 来发送登录名和密码。
当您在 Developer Resources 网站上注册以获取登录名和密码时,我们肯定会要求您提供一些个人信息,但您可以选择不与 Sun 联系。
有关 Sun 保密政策的详细信息,参见 Developer Resources 站点的 FAQ,网址为:http://forte.sun.com/ffj/feedback/sitefaq.html
如果需要设置代理以通过防火墙,可在向导的首页中单击 [代理配置]
。
也可以在 IDE 中更新模块,而不必连接到更新中心服务器。
脱机更新 IDE:
- 手动下载想要更新模块的 NBM 文件。
- 从主窗口中选择
[工具]
>
[更新
中心]
。
- 在向导的首页中,选择
[手动安装下载的模块]
按钮。
- 按照向导其余部分的说明继续操作。
缺省情况下,IDE 会定期询问您是否要连接到更新中心以检查是否有新的更新内容。
您可以设置该提示的间隔时间或将其完全关闭。
设置提示检查更新内容的频率:
- 从主窗口中选择
[工具]
>
[选项]
。
-
选择 [更新中心] 节点,然后设置 [检查周期]
属性。
M. NetBeans 开放源代码项目
Sun ONE Studio IDE 建立在 NetBeans 开放源代码项目上,后者位于 http://www.netbeans.org。
NetBeans 是一个建立在团体基础上的项目,鼓励以新的、富有创造性的方式使用 NetBeans IDE 平台。
欢迎所有开发者为扩展 NetBeans IDE 及改善其基础框架献力献策,以便创造出一套得自开发团体又为其所用的无比强大的工具。
N. 可再分发的文件
下列二进制文件随本产品一起提供,并可再次分发:
persistence-rt.jar
dbschema.jar
xerces.jar
cvslib.jar
TimerBean.jar
AbsoluteLayout.jar
sql.jar
standard.jar
jaxen-full.jar
jstl.jar
saxpath.jar
jato-2_1_0.jar
O. Mobile Edition 模块
Sun ONE Studio 5 update 1, Standard Edition 的 Sun ONE Studio, Mobile Edition 模块:
- Sun[tm] ONE Studio 5,J2ME 无线模块
- Sun[tm] ONE Studio 5,RetroGuard 集成模块
- Sun[tm] ONE Studio 5,JODE 集成模块
- Sun[tm] ONE Studio 5,J2ME 无线工具箱 1.0.4_01 模块
Mobile Edition 模块简介
本发行说明的这一部分针对的是 Sun Open Net Environment (Sun ONE) Studio 5 的 J2ME 无线模块、RetroGuard 集成模块、JODE 集成模块和 J2ME 无线工具箱模块。其中描述了特定于下列模块的重要功能和错误增删:
- J2ME 无线模块 (kjava.nbm)
- J2ME 无线工具箱模块 (kjava-emulator_xxx.nbm)
- RetroGuard 集成模块 (kjava-obfuscator-retroguard.nbm)
- JODE 集成模块 (kjava-obfuscator-jode.nbm)
这些模块共同形成了 Sun ONE Studio 5 update 1, Standard Edition 的 Sun ONE Studio Mobile Edition 模块,以后简称为“Mobile Edition 模块”。
文件 me_modules/README.html 中包含有将这些模块分别添加到 Sun ONE Studio 5 update 1, Standard Edition 中的说明。
Mobile Edition 模块是为支持和方便 J2METM 平台 CLDC/MIDP 应用程序的开发而专门定制的。它们将 J2ME 无线工具箱技术与 Sun ONE Studio 编程环境结合在了一起,可提供下列功能:
- MIDlets 和 MIDlet 套件的集成式编译、预检验和执行
- JAD 和 JAR 文件的自动生成
- MIDlets 的集成式源码级调试
- 针对 J2ME API 的代码完成
- 基于每个项目预设置缺省编译器/预检验器的能力
- 通过“统一仿真器接口”与第三方仿真器/SDK 的集成
- 用于创建 MIDlets 和 MIDlet 套件的模板
- 集成的缺省仿真器
- 为每个 MIDlet 套件动态切换仿真器的能力
- 允许您添加模块和扩展 IDE 其它功能的更新中心工具
- “无线工具箱”中允许您测试应用程序性能的公用程序。
有关 J2ME 无线工具箱的详细信息,参见“J2ME 无线工具箱发行说明”。请注意,有些信息可能不适用。例如,诸如 Ktoolbar 等工具尚未集成到 Mobile Edition 中。
Sun ONE Studio 5,J2ME RetroGuard 集成模块增添了以下特色:
- 支持 RetroGuard 混淆器。
- 将 RetroGuard 混淆器集成到了 IDE 中。
Sun ONE Studio 5,JODE 集成模块增添了以下特色:
- 支持 JODE 混淆器。可从 JODE 网站获取 JODE 混淆器,如 me_modules/README 中所述。
Mobile Edition 模块的系统要求
如果已经安装 Sun ONE Studio 5 update 1, Standard Edition,则安装这四个模块将另外需要 45 MB 的空间。
下面列出了已在其上测试过这些 Mobile Edition 模块的平台。还列出了已在其上测试过 J2ME 无线工具箱 1.0.4_01 的平台。
注意:Mobile Edition 模块支持的平台可能与您打算使用的仿真器支持的平台有所不同。应检验您的特定平台是否同时支持这些 Mobile Edition 模块和您打算使用的仿真器。
Sun ONE Studio 5 update 1, Standard Edition 的 Sun ONE Studio Mobile Edition 模块已在下列平台上经过测试,推荐您使用这些平台:
- Microsoft Windows XP Professional SP 1
- Microsoft Windows 2000 Professional 系统 (SP 2)
- Red Hat Linux 7.2
- Solaris 8 操作环境(64 位,SPARC 平台)
- Solaris 9 操作环境(64 位,SPARC 平台)
该版本在下列平台上进行过有限地测试:
- Solaris 8 操作环境(32 位,SPARC 平台)
- Solaris 9 操作环境(32 位,SPARC 平台)
J2ME 无线工具箱 1.0.4_01 版已在下列平台上经过了测试,推荐您使用这些平台:
- Microsoft Windows 2000 系统
J2ME 无线工具箱 1.0.4_01 版在下列不支持的系统上进行过有限地测试:
- Solaris 8 操作环境
- Red Hat Linux 6.2
- Red Hat Linux 7.1
Mobile Edition 错误和问题
注意:链接的错误,除了可通过 SunSolve 获得的那些以外,都要求进行“Java 开发人员连接”登录才能查看。
注意:Mobile Edition 模块被设计成在单用户模式下使用。如果多个用户并发访问同一个可执行文件,可能会出现错误。因此,不推荐在任何 Windows 平台的共享安装中使用该版本。
- 4641426 描述:v.1.0.4_01 以前版本的 J2ME 无线工具箱预检验器和某些第三方仿真器不支持 JDK 1.4.0 类。如果使用 J2SE v.1.4,缺省的“预检验”编译器为内部编译器。如果要使用外部编译器或下载已更新的内部编译器,需要在 Mobile Edition 中配置 [预检验编译器] 属性才能使用该外部编译器。
回避方法:选择 [工具] > [选项] > [构建] > [编译器类型]。单击 [Java 编译器] 属性字段,然后从菜单中选择 [外部编译]。单击 [外部编译器] 属性字段中的省略号 (...) 按钮,然后将开关 -target 1.1 添加到 [参数] 字段中。[外部编译器] 属性的语法为:{jdk.home}{/}bin{/}javac -target 1.1 {debug info} {deprecation} {optimize} {outputdir} {encoding} {source opt} {bootclasspath.opt} {bootclasspath} -classpath {filesystems}{:} {classpath} {files}。
- 4636172 描述:如果在套件外部执行或调试一个 MIDlet,则无任何应用程序描述符文件用于执行,并且该 MIDlet 的
getAppProperty()
方法返回 null
。回避方法:调试包含该 MIDlet 的 MIDlet 套件,而不是单独调试该 MIDlet。
- 4676586 描述:如果使用上下文菜单重命名一个 MIDlet 套件,因为 JAR 文件的 URL 尚未更改,所以该 MIDlet 套件无法执行。回避方法:更改套件的 [JAR URL] 属性。
- 4666440 描述:如果与 J2ME 无线工具箱 1.0.4_01 一起使用 JDK 1.4,则无法在 MIDlet 的构造函数内部调试代码。回避方法:查看最新提供的 J2ME 无线工具箱版本是否修正了该问题,使用另一不同的仿真器,或者将构造函数中的代码放到 MIDlet 的方法中并在该方法中设置断点。
- 4721207 描述:具有外部库(用户定义类路径中的库)的 MIDlet 套件可以编译,但无法执行。回避方法:将库添加到 MIDlet 套件 JAR 文件中,然后执行。
- J2ME 无线工具箱仿真器要求 JDK 1.3.1 或更高版本。如果运行 IDE 时令
-jdkhome
开关指向 JDK 1.3.1 或 1.4,但缺省系统设置为 1.2.1 或更低版本,则仿真器将不能执行任何程序。
- Sun ONE Studio 4 Update 1, Mobile Edition 使用的 Windows 注册表项为
HKEY_CURRENT_USER\Software\Sun Microsystems, Inc.\Forte for Java\ME\4.0
- J2ME 无线工具箱 v. 1.0.4_01 使用的 Windows 注册表项为
HKEY_LOCAL_MACHINE\SOFTWARE\Sun Microsystems, Inc.\J2ME Wireless Toolkit\1.0.4_01