View Javadoc

1   /*
2    * Copyright 2004-2009 the Seasar Foundation and the Others.
3    *
4    * Licensed under the Apache License, Version 2.0 (the "License");
5    * you may not use this file except in compliance with the License.
6    * You may obtain a copy of the License at
7    *
8    *     http://www.apache.org/licenses/LICENSE-2.0
9    *
10   * Unless required by applicable law or agreed to in writing, software
11   * distributed under the License is distributed on an "AS IS" BASIS,
12   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
13   * either express or implied. See the License for the specific language
14   * governing permissions and limitations under the License.
15   */
16  package org.seasar.cubby.action;
17  
18  import java.lang.annotation.ElementType;
19  import java.lang.annotation.Retention;
20  import java.lang.annotation.RetentionPolicy;
21  import java.lang.annotation.Target;
22  
23  /**
24   * 要求をこの注釈で修飾されたアクションメソッドへ振り分けるための要求パラメータ名を指定します。
25   * <p>
26   * ひとつのフォームに複数のボタンを配置し、それぞれ異なるアクションメソッドを実行させたい場合に使用します。
27   * </p>
28   * 
29   * <pre>
30   * &lt;t:form action=&quot;${contextPath}/todo/save&quot; method=&quot;post&quot; value=&quot;${action}&quot;&gt;
31   * (1) &lt;input type=&quot;submit&quot; value=&quot;登録&quot;/&gt;
32   * (2) &lt;input type=&quot;submit&quot; name=&quot;confirm_back&quot; value=&quot;戻る&quot;/&gt;
33   * &lt;/t:form&gt;
34   * </pre>
35   * 
36   * <pre>
37   * public TodoAction extends Action {
38   * 
39   *   // (1)に対応
40   *   public ActionResult save() {
41   *   }
42   * 
43   *   // (2)に対応
44   *   &#064;OnSubmit(&quot;confirm_back&quot;)
45   *   &#064;Path(&quot;save&quot;)
46   * 	 public ActionResult back() {
47   *   }
48   * 
49   * }
50   * </pre>
51   * 
52   * @author baba
53   */
54  @Retention(RetentionPolicy.RUNTIME)
55  @Target( { ElementType.METHOD })
56  public @interface OnSubmit {
57  
58  	/**
59  	 * 要求パラメータ名を返します。
60  	 * 
61  	 * @return 要求パラメータ名
62  	 */
63  	String value();
64  
65  }