Turbine Howto 之 Action Event [译]

核心提示：Turbine 有一个非常好的功能来帮助开发人员处理web耶面的提交数据.为了理解这一功能,你需要知道Turbine是如何处理一次提交的.事实上,当在一个URI中只要发现有action这个变量出现,在执行所有Screen类之前会执行一个程序,我们来看下面这个例子(来自VelocitySite的Howto示例):对于UR

　　Turbine 有一个非常好的功能来帮助开发人员处理web耶面的提交数据.为了理解这一功能,你需要知道Turbine是如何处理一次提交的.
　　事实上,当在一个URI中只要发现有action这个变量出现,在执行所有Screen类之前会执行一个程序,我们来看下面这个例子(来自VelocitySite的Howto示例):
　　
　　对于URL"http: //www.server.com/servlet/Turbine/template/AddUser/action/NewUser",Turbine 会首先执行一个名叫"NewUse"的Action类,在这种情况下,所有继续ActionEvent而不是Action的类都可以象如下的代码一样方便的处理:
　　
　　public class NewUser extends VelocityAction
　　{
　　public void doAdd (RunData data, Context context) throws Exception
　　{
　　// put code here to add the user to the system
　　context.put ("username", username );
　　data.setMessage("User Added!");
　　}
　　
　　public void doPerform(RunData data, Context context) throws Exception
　　{
　　data.setMessage("Button not found!");
　　}
　　}
　　
　　然后,在Html中这样写:
　　
　　<input type="submit" name="eventSubmit_doAdd" value="Add User">
　　
　　当Action执行的时候,将会收到一个"事件"来执行Action类中的"doAdd()"方法.这样处理最"酷"的就是你的每一种"action(操作,注:比如点击一个提交按钮等)"都可以对应到Action类中一个特定的方法.
　　
　　这个新的功能并不意味着你应该把所有的操作都写到一个类里,而是假设有一个页面里面有一些和这个页面关西很紧密的操作,这时最好是把这些操作都写到同一个类里.这样可以帮助你方便的判定并处理具体哪个按钮给点击了,而不是用一些"if-else"来.
　　
　　假如判定不出哪个按钮被点击了(找不到一个合适的方法执行),将会执行doPerform()方法.
　　
　　因为ParameterParser把所有的"key"都变成了小写,我们必须将提交的数据里得到一个合适的方法名,比如:一个按钮名叫 eventSubmit_doDelete,提交的时候就变成了eventsubmit_dodelete,因此,我们需要通过一些命名规范来得到真正的方法名,转换的规则是:
　　* 变量名(如:提交按钮)必需以"eventSubmit_"开头
　　* 变量名在这个前缀后必需是"do"
　　* 在"do"之后的第一个字母必须是大写并且其他都是小写
　　只要你遵循这些命名规范,在Action类中就能找到相应的方法来执行.
　　
　　(注:以上规则适合turbine2.1及以前的版本,在turbine2.2及以后的版本中 eventSubmit_doMySaveMethod也是一个合法的名子,因为在2.2以后的版本里,Parameterparser不会把"key" 都变成小写,这一点在取得提交数据的时候也要注重的)
　　
　　在TurbineResources.PRoperties里有一个属性,名叫"action.eventsubmit.needsvalue". 假如把这个属性设置成"true",那只有值不为空,并且不为0的事件才会被执行,这在一个FORM有多个不同的事件(或者说提交按钮),并且由客户端的代码(比如javascript)提交的时候比较有用.