Apache Pivot初体验
Apache已经将Pivot升级为顶级项目，虽然从前不知道这个项目，但是看来还是有发展前途的。我看好它，因为我对FLEX语法实在不感冒，还是Java写着舒服。似乎也很少有人用AWT/Swing做商业产品，但Applet的应用还是常见的。就研究研究Pivot吧。既然Apache将其定位为RIA in Java，做J2EE的还是关注下吧。这是纯Java血统的东西(相比于FLEX)，下了开发包，看例子，语法类似Swing，还是比较容易接受的。但是官方例子中没有完整的目录结构，构建开发环境还是留下了一些障碍。可能是之前没有接触过。我自己摸索了一个适应web开发的目录结构，可能不是最好的，但是是可行的。如下：
这里用了ANT进行jar打包，之前用Eclipse的导出打包不好用，就自己写了个ANT构建脚本运行，还真好用了。
目录结构还是传统的web项目，不同的是webapp下也放置了lib，当然就是运行项目所需的lib库，如果放到WEB-INF/lib下，那页面是不能直接访问到的，而pivot程序是直接在页面显示调用类库的，就需要放到可见的位置。不过我是在WEB-INF/lib下也放置了一份，那里的在编译路径里的，这样不冲突，也为ANT构建省去来回设置类路径的麻烦。jar包也不大，基本的才1.29M，没有办法，谁让人家是RIA呢。
先从Java Application开始吧，我是参照官方示例学习的。但是如果你刚下载开发包，估计得看上一阵子呢。其实很简单，就是一个类，一个XML配置文件(Pivot中是以wtkx作为扩展名的)。下面用代码来说明，更为直观。
Java代码
[*]package pivot.tutorials.hellowtkx;
[*]
[*]
import org.apache.pivot.collections.Map;
[*]
import org.apache.pivot.wtk.Application;
[*]
import org.apache.pivot.wtk.DesktopApplicationContext;
[*]
import org.apache.pivot.wtk.Display;
[*]
import org.apache.pivot.wtk.Window;
[*]
import org.apache.pivot.wtkx.WTKXSerializer;
[*]
[*]
public class HelloWTKX implements Application {
[*]
private Window window = null;
[*]
[*]
public void startup(Display display, Map<String, String> map)
[*]
throws Exception {
[*]
WTKXSerializer wtkxSerializer = new WTKXSerializer();
[*]
window = (Window) wtkxSerializer.readObject(this, "helloWTKX.wtkx.xml");
[*]
window.setTitle("Hello JavaEye");
[*] window.open(display);
[*] }
[*]
[*]
public boolean shutdown(boolean optional) throws Exception {
[*]
if (window != null) {
[*] window.close();
[*] }
[*]
return false;
[*] }
[*]
[*]
public void resume() throws Exception {
[*] }
[*]
[*]
public void suspend() throws Exception {
[*] }
[*]
[*]
public static void main(String[] args) {
[*]
DesktopApplicationContext.main(HelloWTKX.class, args);
[*] }
[*]
[*]}
package pivot.tutorials.hellowtkx;
import org.apache.pivot.collections.Map;
import org.apache.pivot.wtk.Application;
import org.apache.pivot.wtk.DesktopApplicationContext;
import org.apache.pivot.wtk.Display;
import org.apache.pivot.wtk.Window;
import org.apache.pivot.wtkx.WTKXSerializer;
public class HelloWTKX implements Application {
private Window window = null;
public void startup(Display display, Map<String, String> map)
throws Exception {
WTKXSerializer wtkxSerializer = new WTKXSerializer();
window = (Window) wtkxSerializer.readObject(this, "helloWTKX.wtkx.xml");
window.setTitle("Hello JavaEye");
window.open(display);
}
public boolean shutdown(boolean optional) throws Exception {
if (window != null) {
window.close();
}
return false;
}
public void resume() throws Exception {
}
public void suspend() throws Exception {
}
public static void main(String[] args) {
DesktopApplicationContext.main(HelloWTKX.class, args);
}
}
官方示例中配置文件都以XXX.wtkx形式存在，其实就是XML文档，我就直接以.xml来编辑，这样在Eclipse中可以高亮显示，否则就是普通文本编辑了。配置文件的编写参考官方示例就行了。我还加上了的XML声明。
Xml代码
[*]<?xml version="1.0" encoding="UTF-8" ?>
[*]
<Window title="Hello WTKX" maximized="true"
[*]
xmlns:wtkx="ttp://pivot.apache.org/wtkx"
[*]
xmlns="org.apache.pivot.wtk">
[*]
<content>
[*]
<Label text="Hello JavaEye! - The Pivot WTKX Application"
[*]
styles="{font:'Arial bold 24',color:'#ff0000',
[*]
horizontalAlignment:'center',verticalAlignment:'center'}" />
[*]
</content>
[*]
</Window>
<?xml version="1.0" encoding="UTF-8" ?>
<Window title="Hello WTKX" maximized="true"
xmlns:wtkx="ttp://pivot.apache.org/wtkx"
xmlns="org.apache.pivot.wtk">
<content>
<Label text="Hello JavaEye! - The Pivot WTKX Application"
styles="{font:'Arial bold 24',color:'#ff0000',
horizontalAlignment:'center',verticalAlignment:'center'}" />
</content>
</Window>
基本的Pivot应用程序都是实现了Application接口，自然也要实现其中的抽象方法。从方法名启动，关闭，唤醒和挂起不难看出这是进程的状态转化方法。负责继承状态改变时的处理。主函数就是Pivot应用程序的执行方式，这都是固定的写法了，传入本类的class和主函数的参数。
类中定义一个私有属性window，就是Pivot应用程序的窗口对象，在startup方法中进行进程加载启动时的事情。WTKXSerializer类在官方文档中解释为“从XML中加载对象层次结构”，可以看出类似于MXML，控件的定义都是写在配置文件中的。只不过这个XML编码时IDE还不能给出提示。我想是Schema还没有最后固定，编码时只能按照已有定义来编写。程序就可以解析XML了。wtkxSerializer对象读取XML配置文件，并从中获取window实例(window是根元素)。中间可以是业务流程的处理。这里是对window的title进行了设置，编码风格很像Swing。最后一步是window的open()方法，传入display参数。在shutdown()方法中别忘记关闭window就可以了。
此时程序就可以以Application方式运行了。得到效果：
第一部分介绍到此结束，第二部分中将介绍Web应用中的Pivot部署和用ANT构建自定义jar包。
我们探究了如何构建Pivot开发框架，编写Pivot桌面应用程序。这一篇我们来说说如何在web环境中部署Pivot程序。webapp发布目录 如下所示：
css中的样式表和js下的JavaScript脚本都是根据官方示例中拷贝下来的，其中最重要的是deployJava.js，它是展示Java applet的工具包，Pivot在页面中就是以Applet的形式展现的，js文件在http://java.com/js/deployJava.js 下载。Lib下是Pivot应用所依赖的类库，可以看出pivot.jar是我自定义的jar，就是编好代码打的包，而WEB-INF/lib下的库和Pivot没有关系，那里的库正常是访问不到的。
下面展示HTML页面
Html代码
[*]<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
[*]
<html xmlns="http://www.w3.org/1999/xhtml">
[*]
<head>
[*]
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
[*]
<title>Push Buttons</title>
[*]
<script src="/pivot/js/deployJava.js" type="text/javascript"></script>
[*]
</head>
[*]
<body>
[*]
<script xmlns="" type="text/javascript">
[*]
var attributes = {
[*]code:'org.apache.pivot.wtk.BrowserApplicationContext$HostApplet',
[*] width:'480',
[*] height:'360'
[*] };
[*]
var libraries = [];
[*] libraries.push("/pivot/lib/pivot-core-1.4.jar");
[*] libraries.push("/pivot/lib/pivot-wtk-1.4.jar");
[*] libraries.push("/pivot/lib/pivot-wtk-terra-1.4.jar");
[*] libraries.push("/pivot/lib/pivot.jar");
[*]
attributes.archive = libraries.join(",");
[*]
var parameters = {
[*] codebase_lookup:false,
[*]
java_arguments:'-Dsun.awt.noerasebackground=true -Dsun.awt.erasebackgroundonresize=true',
[*] application_class_name:'pivot.tutorials.buttons.PushButtons'
[*] };
[*] deployJava.runApplet(attributes, parameters, "1.6");
[*]
</script>
[*]
</body>
[*]
</html>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<title>Push Buttons</title>
<script src="/pivot/js/deployJava.js" type="text/javascript"></script>
</head>
<body>
<script xmlns="" type="text/javascript">
var attributes = {
code:'org.apache.pivot.wtk.BrowserApplicationContext$HostApplet',
width:'480',
height:'360'
};
var libraries = [];
libraries.push("/pivot/lib/pivot-core-1.4.jar");
libraries.push("/pivot/lib/pivot-wtk-1.4.jar");
libraries.push("/pivot/lib/pivot-wtk-terra-1.4.jar");
libraries.push("/pivot/lib/pivot.jar");
attributes.archive = libraries.join(",");
var parameters = {
codebase_lookup:false,
java_arguments:'-Dsun.awt.noerasebackground=true -Dsun.awt.erasebackgroundonresize=true',
application_class_name:'pivot.tutorials.buttons.PushButtons'
};
deployJava.runApplet(attributes, parameters, "1.6");
</script>
</body>
</html>
关键是JS段代码，其实都是固定套路，只需修改自定义的jar即可，其他段根据字母意思即可理解，关键是lib库的位置一定要对。下面说说ANT打包。
Xml代码
[*]<?xml version="1.0" encoding="UTF-8" ?>
[*]
<project name="pivot" default="all">
[*]
<description>The Pivot Application</description>
[*]
<!-- 定义文件夹 -->
[*]
<property name="srcDir" location="." />
[*]
<property name="classDir" location="../webapp/WEB-INF/classes" />
[*]
<property name="libDir" location="../webapp/WEB-INF/lib" />
[*]
<property name="webDir" location="../webapp" />
[*]
<!--用于输出打包的文件夹-->
[*]
<property name="tempDir" location="${java.io.tmpdir}/${ant.project.name}" />
[*]
<property name="targetDir" location="../target" />
[*]
<!-- 定义classpath -->
[*]
<path id="master-classpath">
[*]
<fileset file="${libDir}/*.jar" />
[*]
<pathelement path="${classDir}" />
[*]
</path>
[*]
<!-- 执行清理 -->
[*]
<target name="clean">
[*]
<delete dir="${classDir}" />
[*]
<delete dir="${tempDir}" />
[*]
<delete file="${targetDir}/${ant.project.name}.jar" />
[*]
<delete file="${targetDir}/${ant.project.name}.war" />
[*]
<delete dir="${targetDir}" />
[*]
</target>
[*]
<!-- 初始化任务 -->
[*]
<target name="init" depends="clean">
[*]
<mkdir dir="${targetDir}" />
[*]
<mkdir dir="${tempDir}" />
[*]
<mkdir dir="${classDir}" />
[*]
</target>
[*]
<!-- 编译 -->
[*]
<target name="compile" depends="init" description="compile the source files">
[*]
<javac srcdir="${srcDir}" destdir="${classDir}" debug="true" encoding="UTF-8">
[*]
<classpath refid="master-classpath" />
[*]
</javac>
[*]
<copy todir="${classDir}" overwrite="true">
[*]
<fileset dir="${srcDir}">
[*]
<include name="**/*.xml" />
[*]
<include name="**/*.properties" />
[*]
</fileset>
[*]
</copy>
[*]
</target>
[*]
<!--打jar包-->
[*]
<target name="jar" depends="compile">
[*]
<jar jarfile="${targetDir}/${ant.project.name}.jar">
[*]
<fileset dir="${classDir}">
[*]
<include name="**/*" />
[*]
</fileset>
[*]
</jar>
[*]
</target>
[*]
<!—准备war包 -->
[*]
[*]
<target name="preWar" depends="jar">
[*]
<copy todir="${tempDir}/WEB-INF/lib" overwrite="true">
[*]
<fileset dir="${libDir}">
[*]
<include name="*.jar" />
[*]
</fileset>
[*]
</copy>
[*]
<copy todir="${tempDir}" overwrite="true">
[*]
<fileset dir="${webDir}">
[*]
<include name="**/*" />
[*]
</fileset>
[*]
</copy>
[*]
</target>
[*]
<!--打war包-->
[*]
<target name="war" depends="preWar">
[*]
<jar jarfile="${targetDir}/${ant.project.name}.war">
[*]
<fileset dir="${tempDir}">
[*]
<include name="**/*" />
[*]
</fileset>
[*]
</jar>
[*]
</target>
[*]
[*]
<!-- 清理临时目录 -->
[*]
<target name="all" depends="war">
[*]
<delete dir="${tempDir}" />
[*]
</target>
[*]
</project>
<?xml version="1.0" encoding="UTF-8" ?>
<project name="pivot" default="all">
<description>The Pivot Application</description>
<!-- 定义文件夹 -->
<property name="srcDir" location="." />
<property name="classDir" location="../webapp/WEB-INF/classes" />
<property name="libDir" location="../webapp/WEB-INF/lib" />
<property name="webDir" location="../webapp" />
<!--用于输出打包的文件夹-->
<property name="tempDir" location="${java.io.tmpdir}/${ant.project.name}" />
<property name="targetDir" location="../target" />
<!-- 定义classpath -->
<path id="master-classpath">
<fileset file="${libDir}/*.jar" />
<pathelement path="${classDir}" />
</path>
<!-- 执行清理 -->
<target name="clean">
<delete dir="${classDir}" />
<delete dir="${tempDir}" />
<delete file="${targetDir}/${ant.project.name}.jar" />
<delete file="${targetDir}/${ant.project.name}.war" />
<delete dir="${targetDir}" />
</target>
<!-- 初始化任务 -->
<target name="init" depends="clean">
<mkdir dir="${targetDir}" />
<mkdir dir="${tempDir}" />
<mkdir dir="${classDir}" />
</target>
<!-- 编译 -->
<target name="compile" depends="init" description="compile the source files">
<javac srcdir="${srcDir}" destdir="${classDir}" debug="true" encoding="UTF-8">
<classpath refid="master-classpath" />
</javac>
<copy todir="${classDir}" overwrite="true">
<fileset dir="${srcDir}">
<include name="**/*.xml" />
<include name="**/*.properties" />
</fileset>
</copy>
</target>
<!--打jar包-->
<target name="jar" depends="compile">
<jar jarfile="${targetDir}/${ant.project.name}.jar">
<fileset dir="${classDir}">
<include name="**/*" />
</fileset>
</jar>
</target>
<!—准备war包 -->
<target name="preWar" depends="jar">
<copy todir="${tempDir}/WEB-INF/lib" overwrite="true">
<fileset dir="${libDir}">
<include name="*.jar" />
</fileset>
</copy>
<copy todir="${tempDir}" overwrite="true">
<fileset dir="${webDir}">
<include name="**/*" />
</fileset>
</copy>
</target>
<!--打war包-->
<target name="war" depends="preWar">
<jar jarfile="${targetDir}/${ant.project.name}.war">
<fileset dir="${tempDir}">
<include name="**/*" />
</fileset>
</jar>
</target>
<!-- 清理临时目录 -->
<target name="all" depends="war">
<delete dir="${tempDir}" />
</target>
</project>
Eclipse中已经集成了ANT，只要新建build.xml的文件并且编写，右键就能直接运行，非常方便，ANT构建脚本的编写也很简单，关键是目录迭代不能遗漏，还有目录的定位，不过在IDE中都有提示，也很方便。
将打包好的jar放到webapp/lib下并且修改页面的js段代码即可看到效果了。
欢迎大家交流。
(全篇完)
页:
[1]