作者：davanum srinivas

java 技巧 86：jdk1.3 中的本地绘制支持 -- javaword
在不牺牲本地 gui 代码性能的条件下获得可移植性并缩短开发周期

（本文选自ibm developerworks中文网站）

　

摘要
如果您正在使用 jdk1.3，则您可以借助于 java 2 awt 本地接口,使用 c 或 c++ 方法来绘制基于 awt 的 canvas 对象。因此，本地 gui 组件可以嵌入到 java 应用程序中；同时，正像 jdk1.3 以前的其他版本一样，您可以使用 java 本地接口从 java 应用程序中调用本地方法。davanum srinivas 解释了如何在 java 中使用现有的本地用户界面库。他还提供了 win32 操作系统下的一个具体示例。
在 jdk1.3 出现以前，您仅能将 java 本地接口用于非用户界面的工作。jdk 1.3 引入了新的 java 2 awt 本地接口，这使您可以在 java 程序中使用非 java 的 gui 组件，尽管这样做会失去纯 java 解决方案的可移植性。在使用 j2awt 时,您必须针对要使用它的每个平台制作本地动态连接库或共享库。
下面这段话摘自 jdk1.3 的某个头文件，它说明了这种新的 api 的开发背景及原因:


awt 支持使用本地 c 或 c++ 应用程序访问 awt 的本地结构。这是为了便于将原有的 c 或 c++ 应用程序移植到 java 并满足需要 ... [这些应用程序] 出于性能方面的原因在画布上自行进行本地绘制
在 jdk1.3 以前，java 编程没有明确的方法来访问基层的同等 gui 组件的句柄。在 jdk 1.3 中, sun 公司创建了一种标准机制，通过这种机制，开发人员可以使本地 gui 应用程序和库在 java awt canvas 对象中进行绘制。这意味着现在有一种正式的、有保证的方法来获得支持这一功能的信息。当 jdk 1.3 与其他操作平台对接时，所有的接口都提供相同的信息 -- 而不管使用的是什么系统。jdk 1.3 的 windows 版本和 solaris 版本是首先提供这种支持的实现。

sun 公司引入这一功能组件有几方面的原因。首先, jdk 1.3 使得人们可以将依赖第三方产品的复杂原有软件移植到 java 上，而不必等到第三方产品本身完成移植以后。第二个原因即性能；如果本地的 gui 代码经过人们长时期的努力得到优化，则原样保留这些软件具有重要的商业价值。

在本文中，我将介绍一些该功能部件的基本概念。我将逐步开发一个窗口小部件样例，该窗口小部件使用win32 api 进行绘制。下图是最终的窗口小部件的快照，一个带有笑脸的圆形窗口。



运行中的窗口小部件

分步概览
第一步，定义一个 java 类 -- 比如说，mywindow -- 使其继承 canvas 类并重载 paint 方法。您使用 paint 方法执行 awt 对象的绘制操作，并在覆盖该方法时加上 native 关键字。覆盖方法使您能够使用自己的本地代码。您必须构建自己的本地代码并把它编译成一个动态连接库，就像我们处理其他的 java 本地接口应用程序一样，在本例中，我们将调用 mywindow.dll 库。在 solaris 和 linux 上则为共享对象或共享库。您还需要用 system.loadlibrary("mywindow") 调用将 mywindow.dll 库加载到您的名为 mywindow 的 java 类中。

完成这一示例需要二个部分：其一是 mywindow.java ,它提供 canvas 类的子类，其二是 mywindow.cpp ,它包含基于 java 本地接口的绘制子程序的入口点。 在参考资源部分可找到 mywindow.java、mywindow.cpp 及自动执行编译的批处理文件 build.bat。

第一步: 创建 mywindow java 类
j2awt 用于这种方法时有一个主要的局限性：本地代码只能对 java.awt.canvas 类的子类进行操作。这正是 mywindow 继承 canvas 类的原因。在 java 应用程序中，您可以像使用 canvas 的其它子类那样使用 mywindow；在本例中，我将 mywindow 添加到 jwindow 中。

import java.awt.*;
import javax.swing.*;

public class mywindow extends canvas {
static {
//加载包含 paint 代码的库。
system.loadlibrary("mywindow");
}

//绘制操作的本地入口点
public native void paint(graphics g);

public static void main( string[] argv ){
frame f = new frame();
f.setsize(300,400);

jwindow w = new jwindow(f);
w.setbackground(new color(0,0,0,255));
w.getcontentpane().setbackground(new color(0,0,0,255));
w.getcontentpane().add(new mywindow());
w.setbounds(300,300,300,300);
w.setvisible(true);
}
}


请注意：您是在静态块中加载 mywindow.dll。这正是 java 应用程序访问本地代码的方式。（我稍候就会开发这段本地代码。）同时还应注意：paint 方法是用 native 关键字声明的，并且没有提供任何实现；这样做是为了让虚拟机知道，应该从在静态块中加载的动态连接库中调用该本地方法。

第二步：生成该类的 jni 头文件
要为以上定义的类生成 java 本地接口头文件，需使用 javah mywindow.class 命令。首先应确保这个类文件在您的 classpath 中。以下是所生成的 mywindow.h 的一部分，给出了函数声明。

/*
* class: mywindow
* method: paint
* signature: (ljava/awt/graphics;)v
*/
jniexport void jnicall java_mywindow_paint
(jnienv *, jobject, jobject);


第三步：开发完整的 mywindow.cpp
以下是完整的 mywindow.cpp，其中包含 mywindow.java 中所需要的绘图程序的本地代码。

#include <windows.h>
#include <assert.h>
#include "jawt_md.h"
#include "mywindow.h"

#define x(x) (int)(xleft + (x)*xscale/100) // 缩放宏
#define y(y) (int)(ytop + (y)*yscale/100) // 以使尺度在 0-100 之间
#define cx(x) (int)((x)*xscale/100)
#define cy(y) (int)((y)*yscale/100)

void drawsmiley(hwnd hwnd, hdc hdc);
hrgn hrgn = null;

jniexport void jnicall
java_mywindow_paint(jnienv* env, jobject canvas, jobject graphics)
{
jawt awt;
jawt_drawingsurface* ds;
jawt_drawingsurfaceinfo* dsi;
jawt_win32drawingsurfaceinfo* dsi_win;
jboolean result;
jint lock;

// 获取 awt
awt.version = jawt_version_1_3;
result = jawt_getawt(env, &awt);
assert(result != jni_false);
// 获取绘图界面
ds = awt.getdrawingsurface(env, canvas);
if(ds == null)
return;
// 锁定绘图表面
lock = ds->lock(ds);
assert((lock & jawt_lock_error) == 0);

// 获取绘图表面的信息
dsi = ds->getdrawingsurfaceinfo(ds);

// 获取特定平台的绘图信息
dsi_win = (jawt_win32drawingsurfaceinfo*)dsi->platforminfo;

hdc hdc = dsi_win->hdc;
hwnd hwnd = dsi_win->hwnd;
//////////////////////////////
// !!! 在此处进行绘图 !!! //
//////////////////////////////
if(hrgn == null)
{
rect rcbounds;
getwindowrect(hwnd,&rcbounds);
long xleft = 0; // 用于缩放宏
long ytop = 0;
long xscale = rcbounds.right-rcbounds.left;
long yscale = rcbounds.bottom-rcbounds.top;
hrgn = createellipticrgn(x(10), y(15), x(90), y(95));
setwindowrgn(getparent(hwnd),hrgn,true);
invalidaterect(hwnd,null,true);
} else {
drawsmiley(hwnd,hdc);
}
// 释放绘图表面的信息
ds->freedrawingsurfaceinfo(dsi);
// 为绘图表面解锁
ds->unlock(ds);
// 释放绘图表面
awt.freedrawingsurface(ds);
}

void drawsmiley(hwnd hwnd, hdc hdc)
{
rect rcbounds;
getwindowrect(hwnd,&rcbounds);
long xleft = 0; // 用于缩放宏
long ytop = 0;
long xscale = rcbounds.right-rcbounds.left;
long yscale = rcbounds.bottom-rcbounds.top;

// 基于控制大小的画笔宽度
int ipenwidth = max(cx(5), cy(5));
hbrush brushblack;
hbrush brushyellow;
hpen penblack = createpen(ps_solid, ipenwidth, rgb(0x00,0x00,0x00));
// 用于绘制填充椭圆的空画笔
hpen pennull = createpen(ps_null, 0, (colorref)0);

brushblack = createsolidbrush(rgb(0x00,0x00,0x00));
brushyellow = createsolidbrush(rgb(0xff,0xff,0x00));

hpen ppensave = (hpen)selectobject(hdc, penblack);
hbrush pbrushsave = (hbrush)selectobject(hdc,brushyellow);
ellipse(hdc,x(10), y(15), x(90), y(95)); // 头部

arc(hdc,x(25), y(10), x(75), y(80), // 嘴部（微笑）
x(35), y(70), x(65), y(70));

selectobject(hdc,&pennull); // 无绘图宽度
selectobject(hdc,&brushblack);

ellipse(hdc,x(57), y(35), x(65), y(50));
ellipse(hdc,x(35), y(35), x(43), y(50)); // 右眼
ellipse(hdc,x(46), y(50), x(54), y(65)); // 鼻子

setbkmode(hdc,transparent); // 使用前景颜色

selectobject(hdc,pbrushsave);
selectobject(hdc,ppensave);
}


这里的关键数据结构是 jawt，它是在 jawt.h 中定义的（通过 jawt_md.h 包含在内）。它使程序可以访问本地代码在基于 java 的 gui 组件上绘图所需的所有信息。本地方法的第一部分是套式：置入 jawt 结构，获得一个 jawt_win32drawingsurfaceinfo 结构，锁定表面（请一次只使用一种绘图工具！）,然后，获取一个 jawt_drawingsurfaceinfo 结构，该结构包含特定平台下绘图所必需的指针（在 platforminfo字段中）。它也包含绘图界面的矩形界限框及当前剪切区域。有关详细信息，请查看 jawt.h 和 jawt_md.h （请参阅下面标题为 “构建环境”的部分）。

java_mywindow_paint 是一个入口点，jvm 通过调用它来绘制 mywindow。辅助函数 drawsmiley 使用 win32 调用来完成实际的绘制工作。要在您的应用程序中包含 getdrawingsurfaceinfo，请使用外部库 jawt.lib（请参阅 “构建环境”）。

第四步：编辑 build.bat
在运行 build.bat 之前首先对它进行编辑，并像如下所示的那样，为您的 visual c++ 及 jdk1.3 设置路径。build.bat 对 mywindow.java 进行编译，生成 mywindow.h，然后将 mywindow.cpp 编译为 mywindow.dll。

set devstudio=d:program filesmicrosoft visual studiovc98
set jdk13=d:jdk1.3


好了，一切准备就绪。在运行该样例之前，请确保 mywindow.dll、jdk1.3bin 及 jdk1.3jrebin 都在 path 内，还要保证当前目录在 classpath 中；这将确保 mywindow.class 会被成功加载。在确信 path 和 classpath 都设置妥当后，在命令行输入 java mywindow 来运行此应用程序。为方便您的使用，window.zip 中包含了一个批处理文件 run.bat（请参阅参考资源）。要为 jdk 1.3 设置path 和 classpath，请编辑 run.bat。

构建环境


头文件：在 jdk 的 include 目录中新增了专用于 windows 的 c 头文件。它们是：
include/jawt.h.
include/win32/jawt_md.h.


依据 javasoft 网站的说明，这些头文件并不是 java 2 平台正式规范的组成部分；提供这些头文件只是为希望用一种标准化方法访问本地绘图功能的开发人员提供一种便利。我认为这表示将 jdk 移植到其它平台的厂商可以不提供这个 api。


库：一个以 jawt.lib 命名的新库已添加到 sdk 的库目录中。如前所述，这个库包含一个用于把 j2awt 包含到您的应用程序中所需要的入口点。例如，要链接到 getdrawingsurfaceinfo 入口点，您需要在您的程序中包含 jawt.lib。

工具：javah 工具用来为 java 类的本地函数生成 c/c++ 头文件，javac 工具用来编译 java 源文件。

小结
将原有软件系统移植到 java 中并不容易，尤其是当原有软件包含高性能的绘图器时。java 2 awt 本地接口使得分阶段移植变得较为容易，它允许您首先移植对性能要求不高的代码，然后再移植关键的绘制代码。它同时使第三方窗口小部件开发厂商更能严肃地看待针对 java 产品的开发。有了 java 2 awt 本地应用程序接口，您就可以移植原有的 gui 代码，并更快地完成开发，这样就不会牺牲您为提高本地代码关键部分的性能而作的投资。

作者简介
davanum srinivas 目前在 computer associates 公司从事软件开发工作。

参考资源

本压缩文件包含本文章涉及的所有源代码和一个批处理文件：
window.zip
sun 公司对 awt 本地接口的介绍：
http://java.sun.com/products/jdk/1.3/awt_native_interface.html
sun 公司在 java 2 sdk，版本 1.3 中所作的增强：
http://java.sun.com/products/jdk/1.3/docs/guide/awt/enhancements.html
sun 公司对本地绘图 jawt 接口的改进，post-kestrel（只需免费注册）：
http://developer.java.sun.com/developer/bugparade/bugs/4281429.html
"enhance your java application with java native interface (jni)," tallyron（javaworld，1999 年 10 月）：
http://www.javaworld.com/javaworld/jw-10-1999/jw-10-jni.html
"java tip 23: write native methods," john d. mitchell (javaworld):
http://www.javaworld.com/javaworld/javatips/jw-javatip23.html