在Tapestry中使用redirect-after-post模式控制表单提交

Tapestry中表单的提交有很多问题，刷新导致表单的重复提交、臭名昭著的dirty form warning、
显示不友好的URL等，这些都可以使用redirect-after-post模式来避免，也就是post表单之后将页面redirect一下，
这样地址栏显示的就是redirect之后的页面，刷新的也将是这个页面，而且redirect之后的页面一般为Page页面，
可以使用friendlyUrl来显示友好的url。<o:p></o:p>

要使用这个模式，不得不提到一个ILink接口，T4中可接受的listener方法中一个方法签名是这样的:<o:p></o:p>

java 代码
public ILink listenerMethod(Parameter parameter);

这个方法的返回值为ILink，如果T4侦测到是这个返回值的话，将自动redirect到ILink指定的页面。
而且ILink可以为纯页面的Link也可以是带有参数的Link。纯页面Link也就是page service生成的link，
带参数的link为external service生成的link，具体link的生成代码如下：<o:p></o:p>   

java 代码

@InjectObject("engine-service:page")

  public abstract IEngineService getPageService();

       public ILink getPageLink(String pageName) {

           return getPageService().getLink(false, pageName);

  }



      @InjectObject("engine-service:external")

  public abstract IEngineService getExternalService();

       public ILink getExternalLink(String pageName, Object[] parameters) {

     ExternalServiceParameter esp = new ExternalServiceParameter(pageName,

            parameters);

     return getExternalService().getLink(false, esp);

  }

<o:p></o:p>

将上述方法放入到你的项目中自定义的MyBasePage（继承Tapestry的BasePage）中，然后让你的

页面类继承MyBasePage，这样就可以使用上述方法了。<o:p></o:p>

这样在页面提交时可以如下调用

java 代码

public ILink onDelete(Long id){



//your code to delete object



return getPageLink(getPageName());//删除后重新redirect到本页面

}

当然如果这个页面带参数，例如catgoryId=1，则代码如下：

public ILink onDelete(Long id){



//your code to delete object



return getExternalLink(getPageName(),new Object[]{categoryId});
//删除后重新redirect到本页面,并带一个参数

}

上述方式通过继承来实现方法调用，感觉不是很好，我们可以利用Tapestry的易扩展特性来扩展它，
首先想到的就是注释方式来注入，例如我想实现如下注入

java 代码

@InjectPageLink（“Home“）

Public abstract ILink getHomeLink();



@InjectExternalLink（“Category“）

Public abstract ILink getCategoryLink(Long categoryId);

这样即去掉了页面的继承，也显得比较直接。

首先是定义注释类

java 代码

import java.lang.annotation.ElementType;

import java.lang.annotation.Retention;

import java.lang.annotation.RetentionPolicy;

import java.lang.annotation.Target;



@Target( { ElementType.METHOD })

@Retention(RetentionPolicy.RUNTIME)

public @interface InjectPageLink {

    String value();

}

<o:p></o:p>

然后写注释的worker类

<o:p></o:p>

java 代码
import java.lang.reflect.Method;

import java.lang.reflect.Modifier;



import org.apache.hivemind.ApplicationRuntimeException;

import org.apache.hivemind.Location;

import org.apache.hivemind.service.BodyBuilder;

import org.apache.hivemind.service.MethodSignature;

import org.apache.tapestry.annotations.AnnotationUtils;

import org.apache.tapestry.annotations.MethodAnnotationEnhancementWorker;

import org.apache.tapestry.engine.ILink;

import org.apache.tapestry.enhance.EnhancementOperation;

import org.apache.tapestry.spec.IComponentSpecification;



public class InjectPageLinkAnnotationWorker implements

       MethodAnnotationEnhancementWorker {



    public void performEnhancement(EnhancementOperation op,

           IComponentSpecification spec, Method method, Location location) {

       if (!method.getReturnType().equals(ILink.class))

           throw new ApplicationRuntimeException(

                  "InjectPage annotation must return ILink");



       InjectPageLink injectPageLink = method

              .getAnnotation(InjectPageLink.class);



       String pageName = injectPageLink.value();



       BodyBuilder builder = new BodyBuilder();



       builder.begin();

       builder

              .addln(

                     "return getPage().getRequestCycle().getInfrastructure().getServiceMap().getService(

org.apache.tapestry.Tapestry.PAGE_SERVICE).getLink(false,\"{0}\");",

                     pageName);



       builder.end();



       op.addMethod(Modifier.PUBLIC, new MethodSignature(method), builder

              .toString(), location);



       if (isGetter(method))

           op.claimReadonlyProperty(AnnotationUtils.getPropertyName(method));

    }



    boolean isGetter(Method method) {

       return method.getName().startsWith("get")

              && method.getParameterTypes().length == 0;

    }

}

External的同样两个类<o:p></o:p>

java 代码

import java.lang.annotation.ElementType;

import java.lang.annotation.Retention;

import java.lang.annotation.RetentionPolicy;

import java.lang.annotation.Target;



@Target( { ElementType.METHOD })

@Retention(RetentionPolicy.RUNTIME)

public @interface InjectExternalLink {

    String value();

}

<o:p></o:p>

Work类
java 代码
import java.lang.reflect.Method;

import java.lang.reflect.Modifier;



import org.apache.hivemind.ApplicationRuntimeException;

import org.apache.hivemind.Location;

import org.apache.hivemind.service.BodyBuilder;

import org.apache.hivemind.service.MethodSignature;

import org.apache.tapestry.Tapestry;

import org.apache.tapestry.annotations.AnnotationUtils;

import org.apache.tapestry.annotations.MethodAnnotationEnhancementWorker;

import org.apache.tapestry.engine.ILink;

import org.apache.tapestry.enhance.EnhancementOperation;

import org.apache.tapestry.spec.IComponentSpecification;



public class InjectExternalLinkAnnotationWorker implements

       MethodAnnotationEnhancementWorker {



    public void performEnhancement(EnhancementOperation op,

           IComponentSpecification spec, Method method, Location location) {

       if (!method.getReturnType().equals(ILink.class))

           throw new ApplicationRuntimeException(

                  "injectExternalLink annotation must return ILink");



       InjectExternalLink injectExternalLink = method

              .getAnnotation(InjectExternalLink.class);



       String pageName = injectExternalLink.value();



       BodyBuilder builder = new BodyBuilder();



       builder.begin();



       Class[] parameterTypes = method.getParameterTypes();

       int paramCount = Tapestry.size(parameterTypes);



       if (paramCount > 0) {

           if (parameterTypes[0].isArray()) {

              builder

                     .addln(

                            "return getPage().getRequestCycle().getInfrastructure().getServiceMap().

getService(org.apache.tapestry.Tapestry.EXTERNAL_SERVICE).getLink(false, new org.apache.tapestry.engine.ExternalServiceParameter(\"{0}\",$1));",

                            pageName);

} else {

              builder

                     .addln(

                            "java.lang.Object[] params = new java.lang.Object[{0}];",

                            paramCount);

              for (int i = 0; i < paramCount; i++) {

                  builder.add("params[{0}] = ", i);



                  if (parameterTypes[i].isPrimitive())

                     builder.add("($w) ");



                  // Parameter $0 is this, so $1 is the first real parameter.



                  builder.addln("${0};", i + 1);

              }

              builder

                     .addln(

                            "return getPage().getRequestCycle().getInfrastructure().getServiceMap().getService(org.apache.tapestry.Tapestry.EXTERNAL_SERVICE).getLink(false, new org.apache.tapestry.engine.ExternalServiceParameter(\"{0}\",params));",

                            pageName);

           }

       }



       builder.end();



       op.addMethod(Modifier.PUBLIC, new MethodSignature(method), builder

              .toString(), location);



       if (isGetter(method))

           op.claimReadonlyProperty(AnnotationUtils.getPropertyName(method));

    }



    boolean isGetter(Method method) {

       // We already know the return type is String



       return method.getName().startsWith("get")

              && method.getParameterTypes().length == 0;

    }

}

<o:p></o:p>

类写好了，然后就是贡献到Tapestry中<o:p></o:p>

xml 代码

<module id="your.model.annotation" version="1.0.0" package="your.package.annotations">

     <contribution configuration-id="tapestry.annotation.MethodWorkers">

      <worker annotation="InjectPageLink" object="instance:InjectPageLinkAnnotationWorker"/>

      <worker annotation="InjectExternalLink" object="instance:InjectExternalLinkAnnotationWorker"/>

    <!---->contribution>

<!---->module>

<o:p></o:p>

好了将你的module放入项目hivemodule.Xml作为子module。<o:p></o:p>

Ok，enjoy it！

<o:p></o:p>

<o:p> </o:p>

评论

6 楼 cgc520 2007-06-11  

我无语.

5 楼 tapestry 2006-12-18  

InjectPageLink和InjectExternalLink已经提交到tapestry的jira中，将集成到4.1.2版本中，呵呵，也算对开源做了贡献。

详细信息：
http://issues.apache.org/jira/browse/TAPESTRY-1184?page=history

4 楼 vlinux 2006-12-04  

太好了，mark，我前一段时间正在想解决这样的问题呢
不过现在先不能看，等考完SCJP和学期末考试再说

3 楼 zhangqidi 2006-11-29  

说到根本上，是概念不一致造成的问题。<br/>
<br/>
从web来看，url本身是一种uri，用于资源定位。但是从web开发实践看来，更多的把他作为web api的包装器。这种冲突，在ajax应用方面也有体现。<br/>
<br/>
url做为uri，被设计为没有状态的，但是做为api，就会有状态。如果不能让那些设计标准的专业人士认识到这种差距，那么这种尴尬总会存在。

2 楼 tapestry 2006-11-29  

是呀，tapestry的经典处理流程就是get page->set state->active
active调用的是forward方法，就是当前页面的实际页面与url上指示的页面不相符，这也无可厚非。tapestry如果真的要完全的OO的话，屏蔽URL上的处理是必须的。
取得ILink来redirect的一个好处是可以防止form提交后refresh。

1 楼 zhangqidi 2006-11-29  

不错，又学到了新东西。<br/>
<br/>
不过，就应用上讲，我的处理方式跟楼主提到的不一样。<br/>
<br/>
一是listener方法返回void，自己用cycle来激活。看起来直接。<br/>
如果仅仅是跳转，直接激活。如果需要refresh，直接通过ILink抛出异常算了。<br/>
<br/>
二是不太看好这种refresh的实际价值。<br/>
我的使用经验是，listener方法是对application中的page和component状态进行控制、设置和初始化的重要环节，如果 refresh掉，那么状态就丢失了，重新找状态很费事。这个listener就失去相当的价值。如果页面状态很简单，这倒是ok。但是如果状态复杂，就几乎没有这种可能性了。<br/>
<br/>
根本原因，是因为url是service调用接口的表现，而不是service如何执行的表现。这可能是没有办法的事情。记得胡子老大自己也说过，跟其他框架比起来，要追求漂亮的url，在tapestry里面奋战没有胜算。<br/>
<br/>
<br/>
<br/>
<br/>
<br/>