WebSphere Application Server 5.0在Linux平台上中文界面乱码问题的解决

http://www.ibm.com/developerworks/cn/websphere/library/techarticles/yangyaping0307/waslinux.html

级别: 初级

刘洋 (yangliu@cn.ibm.com), IBM中国软件开发中心软件工程师
杨亚平 (yangyap@cn.ibm.com), IBM中国开发中心高级软件工程师

2003 年 8 月 01 日

当WebSphere Application Server（以下简称为WAS）安装到中文Linux平台时，经常出现中文被显示为方块的情况,本文将告诉您如何解决这个中文显示问题。

第一部分：问题描述

当WebSphere Application Server（以下简称为WAS）安装到中文Linux平台时，经常出现中文被显示为方块的情况，如下图所示：

图 1 应用程序组装工具乱码现象

图 2 FirstStep程序乱码现象

本文以在United Linux1.0下配置WebSphere Application Server 5.0 Base版本为例，描述了定位及解决中文显示乱码问题的过程。

回页首

第二部分：问题定位

Linux下Java程序界面中中文显示的问题，经常存在于XWindow配置、Java程序内部错误和Java环境配置等几个方面。为了辅助进行错误定位，我们可以写一个简单的Swing程序，如下所示：

//在JDK 1.3.1 下调试运行通过（Linux & Windows 平台）
import javax.swing.*;          
import java.awt.*;
import java.awt.event.*;
public class HZSwingTest {
    //Define two strings that containing DBCS and English character.
    private static String DBCSValue = "This is a DBCS string[汉字]";
    private static String DBCSWindowTitle = "DBCS Title[汉字]";
    public Component createComponents() {
        final JLabel label = new JLabel(DBCSValue);
        JPanel pane = new JPanel();
        pane.setBorder(BorderFactory.createEmptyBorder(30, 30, 10, 30));
        pane.setLayout(new GridLayout(0, 1));
        pane.add(label);
        return pane;
    }
    public static void main(String[] args) {
        try {
            UIManager.setLookAndFeel(
                UIManager.getCrossPlatformLookAndFeelClassName());        } catch (Exception e) { }
        //Create the top-level container and add contents to it.
        JFrame frame = new JFrame(DBCSWindowTitle);
        HZSwingTest app = new HZSwingTest();
        Component contents = app.createComponents();
        frame.getContentPane().add(contents, BorderLayout.CENTER);
        //Finish setting up the frame, and show it.
        frame.addWindowListener(new WindowAdapter() {
            public void windowClosing(WindowEvent e) {
                System.exit(0);
            }
        });
        frame.pack();
        frame.setVisible(true);
    }
}

该程序简单模拟了WAS出错时的界面，创建一个标题为中文字符串的窗口，其中还包含一个显示中文字符串的标签。在Windows 2000 中文版和United Linux 1.0平台上，其运行结果如下所示：

图 3 United Linux 1.0运行结果

图 4 Windows 2000中文版运行结果

由于Windows平台下程序运行正常，说明该测试程序在汉字显示代码上的编写没有问题。而该测试程序在United Linux 1.0上的错误现象，跟图1、2一致，因此错误可能在XWindow配置和Java环境配置上。

而在Java虚机实现时，Java程序窗口的生成是通过调用操作系统API来完成的，跟具体操作系统相关。因此，同样的Java程序窗口在不同操作系统上，其标题栏按钮、标题栏显示风格、边框风格各不相同。而对于具体的Java窗口内部Swing和AWT控件，其生成和显示是由Java虚机本身来完成的，跟具体操作系统无关。由于图1、2、3中Java窗口标题栏部分中文显示正常，表明XWindow已经能够支持中文的显示，可以初步排除XWindow配置的问题。因此，下边的分析主要针对Java环境字体配置进行。

在Java平台中，字体配置信息主要定义于font.properties系列文件中，存放于JRE/lib目录下。其中定义了五种平台无关的逻辑字体：Serif, SansSerif, Monospaced, Dialog和DialogInput，每一个JVM的实现，都必须包含这五种字体。另外，还定义了逻辑字体跟实际字体的映射等信息。为了支持不同的操作系统版本和Locale，font.properties包含了附带不同后缀的多个版本。

从Sun的文档"Adding Fonts to the Java Runtime"[参见参考文献1]中，我们可以得知：在英文环境下，字体属性由无后缀的font.properties 定义。为了一些操作系统的特殊问题，字体属性文件的名字可以加入操作系统的版本号作为后缀。例如，Solaris 2.5.1 不支持 TrueType 字体，所以字体属性文件font.properties.5.5.1 将只包含 F3 字体。在大多数操作系统中，版本后缀的值由System.getProperty("os.version")来确定。

如果环境是日文、韩文、简体中文或繁体中文，就必须使用相应于特定环境的 font.properties 文件。这些文件可以通过文件名后边加上相应的国家或者locale后缀识别，格式为font.properties.<locale>。该<locale>实际上由<language>_<region>_<encoding>三部分构成。而<language>、<region>和<encoding>分别对应了系统属性（由System.getProperty方法返回的字符串）"user.language"、"user.region"和"file.encoding"。而这个font.properties.<locale>名也可以跟操作系统的版本结合使用。

概括的讲，Java按照以下顺序搜索字体属性文件：

font.properties.<language>_<region>_<encoding>.<osVersion>
font.properties.<language>_<region>_<encoding>
font.properties.<language>_<region>.<osVersion>
font.properties.<language>_<region>
font.properties.<language>_<encoding>.<osVersion>
font.properties.<language>_<encoding>
font.properties.<language>_<osVersion>
font.properties.<language>
font.properties.<encoding>.<osVersion>
font.properties.<encoding>
font.properties.<osVersion>
font.properties

为了确定United Linux下使用的字体属性文件，我们写了以下的程序：

public class PrintLocale {
    public static void main(String[] args) {
        System.out.println(System.getProperty("user.language"));
        System.out.println(System.getProperty("user.region"));
        System.out.println(System.getProperty("file.encoding"));
        System.out.println(System.getProperty("os.version"));
    }
}

其执行过程及结果如下所示：

linux:/opt/WebSphere/AppServer/java/bin # ./java PrintLocale
zh
CN
GB2312
2.4.19-4GB
linux:/opt/WebSphere/AppServer/java/bin #

通过该执行结果、以及与JRE/lib目录下的Java字体属性文件名的比较，我们可以确定，在United Linux 1.0中文环境下，选用的字体文件是font.properties.zh。

经过对font.properties.zh的检查，我们可以发现以下几行：

filename.song_medium_r=gkai00mp.ttf
filename.song_medium_i=gkai00mp.ttf
filename.song_bold_r=gkai00mp.ttf
filename.song_bold_i=gkai00mp.ttf
filename.fangsong_medium_r=gkai00mp.ttf
filename.fangsong_medium_i=gkai00mp.ttf
filename.fangsong_bold_r=gkai00mp.ttf
filename.fangsong_bold_i=gkai00mp.ttf
filename.kai_medium_r=gkai00mp.ttf

它主要用来指定逻辑字体名跟实际物理字体名之间的映射。而所指定的物理字体gkai00mp.ttf在WAS安装目录/java/jre/lib/fonts并不存在。

这就是问题的根源！

回页首

第三部分：问题解决

经过以上的分析，我们可以得知中文字符显示错误，是因为font.properties.zh中指定的字体丢失引起的。两种可能的修改方法如下：

方法一：

将一个符合要求的TTF字体文件拷贝到jre/lib/fonts目录下，改名成gkai00mp.ttf即可。

例如，在United Linux 1.0下，可以做以下操作：

cd /usr/lib/X11/fonts/truetype/
cp hya6gb3.ttf /opt/WebSphere/AppServer/java/jre/lib/fonts
cd /opt/WebSphere/AppServer/java/jre/lib/fonts
mv hya6gb3.ttf gkai00mp.ttf

方法二：

打开 font.properties.zh，将对gkai00mp.ttf的引用替换成对操作系统中实际存在的字体引用，并且在font.properties.zh中加上该字体的路径，做法如下：

（1）打开font.properties.zh

（2）将"gkai00mp.ttf"全文替换成"hya6gb3.ttf"（共九处）

（3）在该文件末尾加上一行：appendedfontpath=/usr/lib/X11/fonts/truetype

以上只修改了WAS安装目录下Java子目录中的虚机，解决了WAS的一些工具界面上的乱码问题。而对于安装和卸载界面上的乱码，修改方法相同，只是对应虚机路径有所改变，分别是"安装程序根目录/jdk"和"WAS安装目录/_uninst/_jvm"

回页首

第四部分：问题测试

修改完毕后，在WAS安装目录下的bin目录分别运行assembly.sh和firststep.sh，即可得到以下的运行界面：

图 5 正常的应用程序组装工具界面

图 6 正常的FirstStep程序界面

参考资料

Adding Fonts to the Java Runtime, http://java.sun.com/products/jdk/1.2/docs/guide/internat/fontprop.html
Java Tutorial, http://java.sun.com/docs/books/tutorial/index.html

作者简介


		刘洋，是IBM中国开发中心软件工程师，毕业于北京航空航天大学，获计算机硕士学位。致力于IBM WebSphere Application Server, IBM WebSphere Application Developer, WebSphere Portal相关的应用开发和技术支持。你可以通过 yangliu@cn.ibm.com与他联系。


		杨亚平，是IBM中国开发中心高级软件工程师，毕业于北京航空航天大学，获计算机硕士学位。致力于IBM WebSphere Application Server, IBM WebSphere Application Developer, WebSphere Portal相关的应用开发和技术支持。你可以通过 yangyap@cn.ibm.com与她联系。