WebLogic Server 8.1 SP3 的注意事项.doc

WebLogic Server 8.1 SP3 的注意事项在 IBM AIX5.1 上使用 WebLogic Platform 8.1SP3 简体中文版本的安装程序时的注意事项:在IBM AIX5.1 上安装 WebLogic Platform 8.1SP3 简体中文版本时，有时会发生 java.lang.OutOfMemoryError 。为避免这种问题，可以通过设置下面的启动选项，即指定较大的 VM 堆的内存大小参数，执行正确安装。示例:-Xms256M -Xmx256M -jar pj_platform813_zh_CN_generic.jar 在管理控制台的首选项中添加语言设置 (CR173345)已在 WebLogic Server 8.1 SP3 的管理控制台首选项中添加了语言选项。下面列出了 SP3 的选项。简体中文/GB18030 简体中文/GB2312 简体中文/GBK 简体中文/UTF-8 繁体中文/Big5 繁体中文/Big5-HKSCS 繁体中文/UTF-8 英语英语/UTF-8 日语/EUC-JP 日语/Shift_JIS 日语/UTF-8朝鲜语/EUC-KR 包含多字节字符的用户登录管理控制台 (CR171053)在 WebLogic Server 8.1 SP3 中，包含多字节字符的用户名可以登录到管理控制台。BEA Oracle Driver (Type 4) 的“codePageOverride”属性 (CR130056)自 WebLogic Server 8.1 SP3 之后，已经添加了 BEA Oracle Driver (Type 4) 的“codePageOverride”属性。此属性会影响那些映射为 Unicode（这不同于 MS932 编码和其他转换器）的符号的处理，如“波形破折号”和“分币符号”。通过设置此属性，驱动程序可以按如下方式处理这些符号。codePageOverride - 对于 SJIS：正确处理由 SJIS 转换器映射的代码，但是不能保证正确处理由 MS932 转换器映射的代码。codePageOverride - 对于 MS932：正确处理由 MS932 转换器映射的代码，但是不能保证正确处理由 SJIS 转换器映射的代码。codePageOverride - 对于 UTF8：代码的处理是不一致的。之所以创建此设置，是为了确保 Oracle Thin Driver 与以前版本的兼容性。未指定“codePageOverride”属性时的默认行为等同于“SJIS”。因此，请注意，这样会失去 Oracle Thin Driver 与以前版本的兼容性。指定“UTF8”可以实现 Oracle Thin Driver 与以前版本的兼容性。在 SP3 中，如果未指定“codePageOverride”属性，默认行为等同于“SJIS”。因此，请注意，这样会失去 Oracle Thin Driver 与以前版本的兼容性。指定“UTF8”可以实现 Oracle Thin Driver 与以前版本的兼容性。在以后的版本中，计划将默认行为更改为“UTF8”。在 Sun JDK 1.4.2_04 中使用 ISO-2022-JP 编码的问题在 Sun JDK 1.4.2_04 或 JRockit8.1SP3 中使用 ISO-2022-JP 编码时，有时会发生 java.nio.BufferOverflowException。这是一个 Sun JDK 缺陷，该缺陷已经在 /bugdatabase/view_bug.do?bug_id=5017922 中报告。此问题已在 Sun JDK 1.4.2_05 中得到了修正。如果要采用 ISO-2022-JP 编码，则应当使用 Sun JDK 1.4.2_05 或 JRockit VM 的兼容版本。 （补充）具体而言，在使用以下代码时会出现异常。byte b = ?.getBytes(ISO-2022-JP);在 AIX5.1 上运行 WebLogic Server 时使用 ISO-2022-JP 编码的注意事项 (8.1SP2) (CR131694)使用 IBM JDK1.4.1 在 AIX5.1 上运行 WebLogic Server (SP2) 时，有时使用 ISO-2022-JP(JIS) 的 JSP 不能正确输出日语字符。在 IA64 HP-UX11.23 上运行 WebLogic Server 时使用管理控制台的注意事项(8.1SP2) (CR175985)当 WebLogic Server 8.1 SP2 在 IA64 HP-UX11.23 日语区域下使用 HP JDK1 运行时，有必要对管理控制台的使用发出警告。这种情况下，服务器日志不能在管理控制台中显示。此问题与 HP JDK 1 有关。有关解决办法，请直接参考服务器日志。基于表单的身份验证的输入编码规范 (CR123333)（不遵从 J2EE）自 SP2 之后，可以为表单中基于表单的身份验证指定输入编码。将如下方式使用的编码名指定为 j_character_encoding。此函数在 J2EE 规范中不存在，它是 WebLogic Server 的初始函数之一。 Username: <input type=text name=j_username<br / Password: <input type=password name=j_password<br / <input type=hidden name=j_character_encoding value=GB2312 <input type=submit value=Login <input type=reset value=Reset SOAP 消息中附加的 XML 编码在 Web Service SOAP 消息中附加 XML（javax.xml.transform.Source 对象）时，可以在 XML 头中指定可选编码。但是，当您收到消息并提取附加的 XML 数据时，头编码将为 UTF-8。在安装到 UNIX 时使用 zh_CN-Type 区域在安装到 UNIX 时使用 zh_CN-type 区域。使用简体中文版本的安装程序时，请将启动安装程序的命令外壳的区域更改为 zh_CN。如果使用 zh_CN 之外的其他区域（如 UTF-8、C 等），则样例代码中包含的简体中文文本文件将无法正确安装。安装时，请在以下区域环境下启动安装程序。Solaris : zh_CNHP : zh_CN.hp15CNLinux : zh_CN示例： LANG zh_CN生成包含简体中文的样例代码时，请在 zh_CN 区域中执行操作。有时，可能无法正确进行编译。在 JDK1.4.1 中更改“Shift_JIS”编码的别名在 JDK1.4.1 中，“Shift_JIS”编码作为“SJIS”编码进行处理。在使用 WebLogicServer 8.1 SP1 的 JVM 和 JDK1.4.1 中，“Shift_JIS”更改为“SJIS”别名。在 WebLogic Server 7.0 之前的版本使用的 JDK(JDK1.3) 中，“Shift_JIS”Java 编码名的别名是“MS932”。对于 WebLogicServer 系统中的 IANA-Java 映射，IANA 字符集名“Shift_JIS”作为 Java 编码名 Shift_JIS 进行处理。因此，在 JSP、Servlet 或 Web Service 中使用 Shift_JIS 时，其操作将与以前版本不同。例如，MS932 专有字符（“”等）将变为“?”。因此，如果希望一如既往地使用 MS932，则应当使用 IANA 名称“Windows-31j”。要使用 MS932，请采用下面的方法 1 或 2。在 AIX5.1 上运行 WebLogic Server 时使用 ISO-2022-JP 编码的注意事项 (8.1SP2) (CR131694)朝鲜语/UTF-8方法 1 - 重写 JSP/Servlet 的程序文件。1. - 对于 JSP，在 page 标记中将“Shift_JIS”重写为“Windows-31J”。 示例：JSP 中存在以下行且使用 MS932 字符时，将其按如下方式重写：2. - 在 Servlet 中更改 setContentType() 的规范。 对于 Servlet，存在以下规范且使用 MS932 字符时，response.setContentType(text/html;charset=Shift_JIS);将其按如下方式重写：response.setContentType(text/html;charset=Windows-31J); “Windows-31J”是在 IANA 中正式注册的字符集名称，等同于 Microsoft 代码页 932。在 Java 中，MS932 等同于 Microsoft 代码页 932。因此， Java 中的“MS932”便是 IANA 的“Windows-31J”。实际上在 Java 中，“Windows-31J”也作为 MS932 的别名存在。就目前而言，保持 Java 编码名与 IANA 名称的一致渐成趋势。如果您将来希望使用等同于 Microsoft 代码页 932 的字符集，我们强烈建议您使用“Windows-31J”。 方法 2 - 在 weblogic.xml 中更改映射（不遵从 J2EE）在 weblogic.xml 部署描述符文件中，可以将 IANA 名称“Shift_JIS”强制映射为 Java 名称“Windows-31J”。这样，您可以不必重写 JSP 或 Servlet 代码，便能够将 Shift_JIS 作为 Windows-31J 进行处理。请在 weblogic.xml 中包括以下项，然后重新部署 Web 应用程序。 代码列表 1-1：weblogic.xml Shift_JIS Windows-31J “高级”中，包含一个名为“总是以 UTF-8 发送 URL (需要重启动)”的选项，而且此选项必须处于启用状态（选中）。解码 URL 时指定字符编码的方法当用户代理是 Netscape 时如果用户代理是 Netscape，地址栏中的字符将按照 Netscape 运行环境的字符集进行编码。然后，对该字符串进行 URL 编码并将其发送到服务器。例如，在简体中文版 Windows 中编码为 MS936 的字符串将进行 URL 编码。在 WebLogic Server 8.1 中，可以将此请求设置为在进行 URL 解码之后将字节流解码为 MS936，从而正确接收此请求。 通过下面的 WebLogic Server 启动选项，可以更改用于执行 URL 解码的编码方式。-Dweblogic.http.URIDecodeEncoding=MS936（默认值为 UTF-8）但是，对于每个服务器实例，只能存在一个这样的设置。使用专有的用户代理时如果需要在请求 URI 中使用多字节字符，请将该字符串转换为 UTF-8 字符串，然后进行 URL 编码，再将其发送到 WebLogic Server。W3C 建议在创建 URI 时基于 UTF-8 进行 URL 编码。(/TR/charmod/#sec-URIs)按照 JSP J2EE 规范进行的更改（WebLogic Server 7.0 或更高版本）在 JSP 1.2 规范中，如果存在多个 Page 指令，则产生“致命转换错误”。(CR066562)摘自 JSP1.2 - JSP.2.10.1 JSP.2.10.1 page 指令page 指令定义一些与页面相关的属性，并将这些属性传送到 JSP 容器。转换单元（JSP 源文件及通过 include 指令包含的任何文件）可以包含 page 指令的多个实例，所有特性将应用于整个转换单元。（即 page 指令与位置无关）。但是，除 Import 特性之外，在给定的转换单元中，此指令定义的任何特性/值只应出现一次；Import 特性的使用次数将进行累计（使用有序集联合语义）。除此之外的其他多个特性/值定义（或重定义）将导致致命转换错误。 这就是说，如果一个编译单元出现多个 page 指令，将会产生致命转换错误。在 WebLogic Server 7.0 中，已将 JSP 操作更改为遵从此规范。 在将一个单独的 JSP 文件包括在静态包含 () 中时，如果包含源与包含目标都有相应的 page 指令，这种更改会出现问题。在静态包含中，JSP 容器计算所有的 JSP，这会导致它们好像包括在一个编译单元中一样，而且这种情况下会生成多个 page 指令，并出现“致命转换错误”。为避免这种问题，WebLogic Server 7.0 中准备了下列选项作为 weblogic.xml 的新参数。 代码列表 1-2：weblogic.xml 中新添加的参数 backwardCompatible true通过此参数，只要编码相同，即使一个编译单元中出现多个 page 指令，也不会出现错误。J2EE 默认编码规范（WebLogic Server 7.0 或更高版本）在 weblogic-application.xml 中，可以为整个 J2EE 企业应用程序的请求指定默认字符编码。(CR065921)在 weblogic-application.xml 中，可以通过以下参数来设置用于请求的默认编码。使用下列选项之一。 webapp.encoding.usevmdefault = true | false webapp.encoding.default = java encoding name 通过在 weblogic.xml 中指定与请求流有关的 input-charset 以及指定 setCharacterEncoding，可以改写这些值。将选项 2 或 webapp.encoding.default 的值指定为 Java 编码名称，而不是 IANA 字符集名称。 如果同时设置了上述两个选项，将使用选项 1 或 webapp.encoding.usevmdefault。代码列表 1-3：webapp.encoding.usevmdefault (weblogic-application.xml) 的用法示例 webapp.usevmdefault webapp.encoding.usevmdefault true或者代码列表 1-4：weblogic_application.xml 中 webapp.encoding.default 的用法示例 default encoding webapp.encoding.default EUC_CNWTC TUXEDO 域的编码规范 (CR052022)（WebLogic Server 7.0 或更高版本）可以为 TUXEDO 域指定 wtc 域编码。在启动时指定以下参数。更改服务器的启动脚本（StartWebLogic.cmd 文件等）-Dweblogic.wtc.encoding=Java encoding name此编码规范对于整个 TUXEDO 域有效。XML