JFreeChart Hacking-补丁贴

JFreeChart Hacking

<本文允许任意转载，请注明出处！最后一块骨头.2005-05-16>

JFreeChart 是什么？我就不再重复介绍了，网上文章大把...
官方主页：http://www.jfree.org/jfreechart/index.html

<--本文以jfreechart-1.0.0-pre2版本为基准-->

那么为什么要Hacking JFreeChart呢？

罪状一：中文Label显示模糊；
罪状二：无简体中文LocalizationBundle.properties文件；
罪状三：向下兼容性不好，官方说jdk1.2+，其实是jdk1.4+；
                兼容问题A：另存菜单输出PNG文件只能运行于jdk1.4+；
                兼容问题B：另存菜单不能输出JPEG格式图片；
                兼容问题C：jdk1.3-环境下中文ToolTips不能正常显示；

如果一定要加一条罪状的话：目前开源免费的chart项目无出其右；
十分感谢JFreeChart开发者的辛苦努力！虽然它现在还不完美。

Ok，下面为Hacking做一些准备工作...
1.下载jfreechart-1.0.0-pre2.zip解压；
2.将\解压目录\source\下的源码加入任意project并配置jdk&lib；
3.安装一个有批量文件查询/替换功能的工具，比如UtralEdit；

<本文允许任意转载，请注明出处！最后一块骨头.2005-05-16>

Hacking Begin

1.解决中文Label显示模糊问题
  原因分析：JFreeChart默认字体对中文的支持不完善；
  解决步骤：搜索\解压目录\source\下含有'new Font('的文件；
           发现JFreeChart默认字体为
           'foo'
           'Serif'
           'Dialog'
           'SansSerif'
           'Bitstream Vera Sans'
           批量替换他们为任意中文字体（推荐'黑体'）；
           当然你也可以把字体写入properties文件，
           但这里介绍的是最简单的方法；
           然后重新编译你修改过的文件，Ok，搞定！

2.无简体中文LocalizationBundle.properties文件
  org\jfree\chart\LocalizationBundle.properties
  主要用来显示右键功能菜单的文字，下面我们来汉化：

  注意：LocalizationBundle.properties的编码不是Unicode，
       简体中文要用GBK编码。
 
  获得GBK编码的方法是：
  cd ***\j2sdk1.*.*\bin
  native2ascii -encoding GBK 1.txt 2.txt
  注：1.txt放中文文本，2.txt输出GBK编码。
 
# org.jfree.chart.ChartPanel ResourceBundle properties file
#
# Changes (from 31-Aug-2003)
# --------------------------
# 31-Aug-2003 : Initial version (AL);
# 16-May-2005 : Add GBK version (FinalBone);
# 16-May-2005 : Add JPG_Image_Files (FinalBone);

#---------------EN---------------#
#Auto_Range=Auto Range
#All_Axes=Both Axes
#Chart_Properties=Chart Properties
#Copy=Copy
#Print...=Print...
#Save_as...=Save as...
#Properties...=Properties...
#PNG_Image_Files=PNG Image Files
#JPG_Image_Files=JPG Image Files
#Domain_Axis=Domain Axis
#Range_Axis=Range Axis
#Zoom_In=Zoom In
#Zoom_Out=Zoom Out

#---------------GBK---------------#
Auto_Range=\u81ea\u52a8\u8c03\u6574
All_Axes=\u6240\u6709\u5750\u6807\u8f74
Chart_Properties=\u56fe\u8868\u5c5e\u6027
Copy=\u590d\u5236
Print...=\u6253\u5370...
Save_as...=\u53e6\u5b58\u4e3a...
Properties...=\u5c5e\u6027...
PNG_Image_Files=PNG\u56fe\u50cf
JPG_Image_Files=JPG\u56fe\u50cf
Domain_Axis=\u57df\u5750\u6807\u8f74
Range_Axis=\u503c\u5750\u6807\u8f74
Zoom_In=\u653e\u5927
Zoom_Out=\u7f29\u5c0f

另外还有两个同名文件，希望大家有时间也汉化一下。
org\jfree\chart\ui\LocalizationBundle.properties
org\jfree\chart\plot\LocalizationBundle.properties

3.兼容性问题
   a.PNG输出问题 b.无JPEG输出菜单
    原因分析：javax.imageio.ImageIO这个类只有jdk1.4+才有。
    解决步骤：1.打开org.jfree.chart.ChartPanel，
               查看doSaveAs()方法，了解其结构；
             2.改写doSaveAs()方法，重新编译；
             3.如果运行环境是jdk1.3-
               打开org.jfree.chart.encoders.SunPNGEncoderAdapter
               注释掉javax.imageio.ImageIO，重新编译。

    /**
     * Updated by FinalBone 2005-5-16 PNG --> JPEG
     *
     * Opens a file chooser and gives the user an opportunity
     * to save the chart in JPEG format.
     *
     * @throws IOException if there is an I/O error.
     */
    public void doSaveAs() throws IOException {

        JFileChooser fileChooser = new JFileChooser();
        ExtensionFileFilter filter = new ExtensionFileFilter(
            localizationResources.getString('JPG_Image_Files'), '.jpg'
        );
        fileChooser.addChoosableFileFilter(filter);

        int option = fileChooser.showSaveDialog(this);
        if (option == JFileChooser.APPROVE_OPTION) {
            String filename = fileChooser.getSelectedFile().getPath();
            if (isEnforceFileExtensions()) {
                if (!filename.endsWith('.jpg')) {
                    filename = filename + '.jpg';
                }
            }
            ChartUtilities.saveChartAsJPEG(
                new File(filename), this.chart, getWidth(), getHeight()
            );
        }

    }

  c.中文ToolTips不能正常显示（显示为小方框）
    原因分析：相关字体找不到。
    解决步骤：1.打开org.jfree.chart.block.LabelBlock
               查看其构造函数public LabelBlock(String label)；
             2.修改构造函数的字体定义，重新编译。

    /**
     * Creates a new label block.
     *
     * @param label  the label.
     */
    public LabelBlock(String label) {
         /**
          * Updated by FinalBone 2005-05-16
          * 'Bitstream Vera Sans' --> '黑体'
          * For Chinese-Simplified ToolTips
          * JDK 1.3- Environment
          */
        this(label, new Font('黑体', Font.PLAIN, 11));
    }

Hacking End

<本文允许任意转载，请注明出处！最后一块骨头.2005-05-16>

这时的 JFreeChart 才是真正jdk1.2+兼容，完美支持中文。

希望下一版本的 JFreeChart 的字体定义写入properties文件，
并且不同路经下的properties文件最好不要重名。