org.seasar.s2click.control
クラス S2ClickForm

java.lang.Object
  上位を拡張 net.sf.click.control.AbstractControl
      上位を拡張 net.sf.click.control.Form
          上位を拡張 org.seasar.s2click.control.S2ClickForm
すべての実装されたインタフェース:
java.io.Serializable, net.sf.click.Control
直系の既知のサブクラス:
MobileForm

public abstract class S2ClickForm
extends net.sf.click.control.Form

publicフィールドを自動的にコントロールとして登録してくれるForm拡張クラスです。 SubmitコントロールによってJavaScriptバリデーションを行うかどうかを制御する機能も備えています。

publicフィールドの自動登録

このクラスのサブクラスでsetFieldAutoRegisteration(boolean)trueが設定された場合、 S2ClickFormはサブクラスのpublicフィールドとして宣言されたコントロール群を自動的にadd(Field)します。 初期化コードでadd(Field)を呼び出す必要はありません。

 public SampleForm extends S2ClickForm {
   private TextField userId = new TextField("userId");
   private PasswordField password = new PasswordField("password");
   private Submit submit = new Submit("submit");

   public SampleForm(){
     setFieldAutoRegisteration(true);
   }

   ...
 } 

送信前に確認ダイアログを表示する

addConfirmMessage(String, String)を使用することで フォームの送信前にJavaScriptによる確認ダイアログを表示することができます。

 public SampleForm extends S2ClickForm {
   ...
   private Submit register = new Submit("register");
   private Submit cancel = new Submit("cancel");

   public SampleForm(){
     addConfirmMessage("register", "登録します。よろしいですか?");
   }

   ...
 

JavaScriptバリデーションを行わないSubmitコントロール

addNoJavaScriptValidateAction(String)を使用することで、 JavaScriptバリデーションを行わないSubmitコントロールを指定することができます。

 public SampleForm extends S2ClickForm {
   ...
   private Submit register = new Submit("register");
   private Submit cancel = new Submit("cancel");

   public SampleForm(){
     addNoJavaScriptValidateAction("register");
   }

   ...
 } 

copyTo()、copyFrom()のpublicフィールド対応

ClickのFormクラスはJavaBeanとフォームの値を相互変換するために copyTo()メソッド、copyFrom()メソッドを備えています。 S2ClickFormではこれらのメソッドをpublicフィールドに対応させています。 なお、S2ClickUtilsを使用することでもpublicフィールドを使用したJavaBeanと フォームの値を相互変換することができます。

作成者:
Naoki Takezoe
関連項目:
直列化された形式

フィールドの概要
protected  java.util.Map<java.lang.String,java.lang.String> confirmMessages
           
protected  boolean fieldAutoRegisteration
           
protected  java.util.List<java.lang.String> noJavaScriptValidateActions
           
 
クラス net.sf.click.control.Form から継承されたフィールド
ALIGN_CENTER, ALIGN_LEFT, ALIGN_RIGHT, buttonAlign, buttonList, buttonStyle, columns, defaultFieldSize, disabled, enctype, error, errorsAlign, errorsPosition, errorsStyle, fieldList, fields, fieldStyle, fieldWidths, FOCUS_JAVASCRIPT, FORM_NAME, HTML_IMPORTS, javaScriptValidation, LABEL_NOT_REQUIRED_PREFIX, LABEL_NOT_REQUIRED_SUFFIX, LABEL_REQUIRED_PREFIX, LABEL_REQUIRED_SUFFIX, labelAlign, labelNotRequiredPrefix, labelNotRequiredSuffix, labelRequiredPrefix, labelRequiredSuffix, labelsPosition, labelStyle, listener, listenerMethod, method, MULTIPART_FORM_DATA, POSITION_BOTTOM, POSITION_LEFT, POSITION_MIDDLE, POSITION_TOP, readonly, SUBMIT_CHECK, validate
 
クラス net.sf.click.control.AbstractControl から継承されたフィールド
attributes, messages, name, parent, styles
 
インタフェース net.sf.click.Control から継承されたフィールド
CONTROL_MESSAGES
 
コンストラクタの概要
S2ClickForm()
          Create a Form with no name defined.
S2ClickForm(java.lang.String name)
          Construct the Form with the given name.
 
メソッドの概要
 void add(net.sf.click.control.Field field)
           
 void addConfirmMessage(java.lang.String action, java.lang.String message)
           
 void addNoJavaScriptValidateAction(java.lang.String action)
           
 void copyFrom(java.lang.Object object)
           
 void copyFrom(java.lang.Object object, boolean debug)
           
 void copyTo(java.lang.Object object)
           
 void copyTo(java.lang.Object object, boolean debug)
           
 java.lang.String endTag()
           
 java.lang.String getActionURL()
           
 boolean isFieldAutoRegistration()
           
 void onInit()
           
protected  void renderHeader(net.sf.click.util.HtmlStringBuffer buffer, java.util.List formFields)
           
protected  void renderHiddenFields(net.sf.click.util.HtmlStringBuffer buffer, java.util.List formFields)
           
protected  void renderValidationJavaScript(net.sf.click.util.HtmlStringBuffer buffer, java.util.List formFields)
           
protected  boolean requiresJavaScript()
          JavaScriptを使用する必要があるかどうかを判定します。
 void setFieldAutoRegisteration(boolean fieldAutoRegisteration)
           
 java.lang.String startTag()
           
 void toHidden()
          このフォームのフィールドをすべてhiddenフィールドに変換します。
 
クラス net.sf.click.control.Form から継承されたメソッド
add, clearErrors, clearValues, getAttributes, getButtonAlign, getButtonList, getButtonStyle, getColumns, getDefaultFieldSize, getEnctype, getError, getErrorFields, getErrorsAlign, getErrorsPosition, getErrorsStyle, getField, getFieldList, getFields, getFieldStyle, getFieldValue, getFieldWidths, getFormSizeEst, getHtmlImports, getHtmlImportsAll, getJavaScriptValidation, getLabelAlign, getLabelNotRequiredPrefix, getLabelNotRequiredSuffix, getLabelRequiredPrefix, getLabelRequiredSuffix, getLabelsPosition, getLabelStyle, getMethod, getValidate, isDisabled, isFormSubmission, isReadonly, isValid, onDeploy, onDestroy, onProcess, onRender, onSubmitCheck, onSubmitCheck, onSubmitCheck, performSubmitCheck, remove, removeField, removeFields, renderButtons, renderErrors, renderFields, renderFocusJavaScript, setButtonAlign, setButtonStyle, setColumns, setDefaultFieldSize, setDisabled, setEnctype, setError, setErrorsAlign, setErrorsPosition, setErrorsStyle, setFieldStyle, setJavaScriptValidation, setLabelAlign, setLabelNotRequiredPrefix, setLabelNotRequiredSuffix, setLabelRequiredPrefix, setLabelRequiredSuffix, setLabelsPosition, setLabelStyle, setListener, setMethod, setName, setReadonly, setValidate, toString
 
クラス net.sf.click.control.AbstractControl から継承されたメソッド
addStyleClass, appendAttributes, getAttribute, getContext, getId, getMessage, getMessage, getMessage, getMessages, getName, getPage, getParent, getStyle, getStyles, hasAttribute, hasAttributes, hasStyles, removeStyleClass, setAttribute, setId, setParent, setStyle
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

confirmMessages

protected java.util.Map<java.lang.String,java.lang.String> confirmMessages

noJavaScriptValidateActions

protected java.util.List<java.lang.String> noJavaScriptValidateActions

fieldAutoRegisteration

protected boolean fieldAutoRegisteration
コンストラクタの詳細

S2ClickForm

public S2ClickForm()
Create a Form with no name defined.


S2ClickForm

public S2ClickForm(java.lang.String name)
Construct the Form with the given name.

パラメータ:
name - the form name
メソッドの詳細

setFieldAutoRegisteration

public void setFieldAutoRegisteration(boolean fieldAutoRegisteration)

isFieldAutoRegistration

public boolean isFieldAutoRegistration()

addConfirmMessage

public void addConfirmMessage(java.lang.String action,
                              java.lang.String message)

addNoJavaScriptValidateAction

public void addNoJavaScriptValidateAction(java.lang.String action)

requiresJavaScript

protected boolean requiresJavaScript()
JavaScriptを使用する必要があるかどうかを判定します。

戻り値:
JavaScriptを使用する必要がある場合true、必要ない場合false

add

public void add(net.sf.click.control.Field field)
オーバーライド:
クラス net.sf.click.control.Form 内の add

startTag

public java.lang.String startTag()
オーバーライド:
クラス net.sf.click.control.Form 内の startTag

endTag

public java.lang.String endTag()
オーバーライド:
クラス net.sf.click.control.Form 内の endTag

renderValidationJavaScript

protected void renderValidationJavaScript(net.sf.click.util.HtmlStringBuffer buffer,
                                          java.util.List formFields)
オーバーライド:
クラス net.sf.click.control.Form 内の renderValidationJavaScript

onInit

public void onInit()
定義:
インタフェース net.sf.click.Control 内の onInit
オーバーライド:
クラス net.sf.click.control.Form 内の onInit

copyFrom

public void copyFrom(java.lang.Object object,
                     boolean debug)
オーバーライド:
クラス net.sf.click.control.Form 内の copyFrom

copyFrom

public void copyFrom(java.lang.Object object)
オーバーライド:
クラス net.sf.click.control.Form 内の copyFrom

copyTo

public void copyTo(java.lang.Object object,
                   boolean debug)
オーバーライド:
クラス net.sf.click.control.Form 内の copyTo

copyTo

public void copyTo(java.lang.Object object)
オーバーライド:
クラス net.sf.click.control.Form 内の copyTo

toHidden

public void toHidden()
このフォームのフィールドをすべてhiddenフィールドに変換します。


renderHeader

protected void renderHeader(net.sf.click.util.HtmlStringBuffer buffer,
                            java.util.List formFields)
オーバーライド:
クラス net.sf.click.control.Form 内の renderHeader

renderHiddenFields

protected void renderHiddenFields(net.sf.click.util.HtmlStringBuffer buffer,
                                  java.util.List formFields)

getActionURL

public java.lang.String getActionURL()
オーバーライド:
クラス net.sf.click.control.Form 内の getActionURL