在Google App Engine中使用Struts2框架
"GAE"（Google App Engine）在早些时候发布了Java语言的支持，对广大的Java开发者来说，可以使用自己熟悉的语法来进行开发
，是很舒服的一件事情。Java世界中有大量已有的工具和框架，有一些是我们日常工作中就已经熟练使用的、而且广为流行的成熟
的，如果能够直接在GAE中使用，将大大提高我们的开发效率。
这几天利用Struts2，在GAE的Java版本支持环境中，写了个简单博客，现在将GAE + Struts2的组合经验，记录下来。
背景介绍
Python是一门有趣的语言，是作者第二个接触的动态脚本语言。第一个是大学时期做学生网站时期接触到Perl，后来工作后利
用Perl改写了公司的应用程序启动框架；几年后，由于Perl的语法实在是太过于羞涩难懂，便使用Python对启动框架进行了一次升
级。Python是面向对象的，同时也兼备了函数式编程的支持，另外，Python的语法强制缩进，非常容易读懂，因此Python版本的启
动框架对公司的Java开发者来说，也不难维护。
当然，这些都是题外话，GAE最先提供的是Python语言的支持，但是对我们Java开发者来说，要使用Python来进行大的应用开发
，还比较痛苦的一件事情。这时候GAE推出Java语言的支持，既是所有Java开发人员的福音，也是理所当然的一件事情，Google不可
能放弃目前企业应用开发领域里面最大的一股力量。
Struts2是目前应用最广泛的WEB开发框架，也是大部分的Java开发者最熟悉的开发框架，我们的GAE应用程序中，使用成熟的
Struts2可以减少很多额外的开发工作。
所需的Struts的库文件
目前Struts2的稳定版本是2.1.6，将下面的来自Struts-2.1.6的发行包的几个包，引入你的GAE项目工程中：
commons-fileupload-1.2.1.jareqpg 2009-9-8 12:05
commons-io-1.3.2.jar
commons-logging-1.0.4.jar
commons-logging-api-1.1.jar
freemarker-2.3.13.jar
ognl-2.6.11.jar
struts2-core-2.1.6.jar
xwork-2.1.2.jar
如果你使用IDEA来创建项目，只要选择Struts的2.1.6版本的支持，IDEA会自动帮你引入所需要的库文件。
为App Engine定制你的Struts
GAE里面的Servlet环境有一定的限制，不能使用线程（Thread），不能使用文件，还有别的一些要注意的地方。
首先，要加一个ServletContextListener的实现，在context初始化的时候，调用OgnlRuntime.setSecurityManager(null)，让
Struts可以在GAE环境里面正常跑起来：
package your.servlet.pkg;
import ognl.OgnlRuntime;
import javax.servlet.ServletContextListener;
import javax.servlet.ServletContextEvent;
public class StrutsAppEngineAdapter implements ServletContextListener {
public void contextInitialized(ServletContextEvent servletContextEvent) {
OgnlRuntime.setSecurityManager(null);
}
public void contextDestroyed(ServletContextEvent servletContextEvent) {
}
}
在web.xml中配置这个ServletContextListener的实例：
<web-app>
<listener>
<listener-class>your.servlet.pkg.StrutsAppEngineAdapter</listener-class>
</listener>
</web-app> eqpg 2009-9-8 12:06
做完上面的工作之后，就可以在你的GAE里面使用Struts的功能了！
定制GAE的常用对象的Converter
Struts提供了Converter的机制，让你常用的业务对象可以直接在页面中显示，或者接受类型为业务对象的请求数据。GAE里面
常用的一些对象，定义了对应的Converter之后，可以是业务代码更加简洁。下面介绍两个常用对象的Converter的代码：
TextConverter, 是针对com.google.appengine.api.datastore.Text对象的转换器，Text是GAE的存储中，大文本内容的保存对
象，在业务中很常用。先来看看TextConverter大的代码：
package your.servlet.pkg;
import com.google.appengine.api.datastore.Text;
import ognl.DefaultTypeConverter;
import java.util.Map;
public class TextConverter extends DefaultTypeConverter {
@Override
public Object convertValue(Map map, Object o, Class toType) {
if (toType == Text.class) {
String value = ((String[]) o)[0];
return new Text(value);
} else if (toType == String.class) {
Text text = (Text) o;
return text.getValue();
}
return null;
}
}
TextConverter的作用主要是用于在WEB页面中，直接显示存储对象中的大文本内容。
另外一个是KeyConverter，是对com.google.appengine.api.datastore.Key对象的转换器，Key是 GAE中三种主键（Long，
String，Key）的一种，在接收请求数据以及页面显示的时候，会经常用到。直接看代码：eqpg 2009-9-8 12:06
package your.servlet.pkg;
import com.google.appengine.api.datastore.Key;
import com.google.appengine.api.datastore.KeyFactory;
import ognl.DefaultTypeConverter;
import java.util.Map;
public class KeyConverter extends DefaultTypeConverter {
@Override
public Object convertValue(Map map, Object o, Class toType) {
if (toType == Key.class) {
String s = ((String[]) o)[0];
return KeyFactory.stringToKey(s);
} else if (toType == String.class) {
Key k = (Key) o;
return KeyFactory.keyToString(k);
}
return null;
}
}
在源代码的根目录，创建xwork-conversion.properties文件，内容如下：
com.google.appengine.api.datastore.Text=your.servlet.pkg.TextConverter
com.google.appengine.api.datastore.Key=your.servlet.pkg.KeyConverter
上面的工作都完成以后，就可以在你的Action里面直接使用Key类型的类变量，无需手工去做String和Key之间的转换！
Convention Plugin不能使用
Struts2里面，最常用的Plugin应该是Convertion了，"零配置"即减少了写配置文件的麻烦，代码的组织结构看起来也清晰很多
。
但是在GAE里面，无法读取文件系统，目前的Convertion版本还无法正常工作，非常可惜。不过建议你的GAE应用中，Action和
JSP文件，还是按照Convertion Plugin的组织方式来存放，一方面有利于后面的升级和迁移工作，另一方面也让你的应用的文件看
起来更清晰。
