Struts 独自のValidator

2024-12-262024
98.5% (360.7/366)
December
82.9% (25.7/31)
Week 52
53.1% (3.7/7)
Day 26 Thu
71.7% (17.2/24)

訪問者

total: 27758
today: 1
yesterday: 1
now: 1

↑

更新

MenuBar

一番シンプルなValidator
Formからの入力を受け取るValidator
/WEB-INF/validation.xml でパラメータが設定できるValidator
/WEB-INF/validator-rules.xml の分割

一番シンプルなValidator †

まずは、全ての入力がエラーになる単純なValidatorを作ります
Validatorクラス
```
 public class ExampleChecks implements Serializable {
 
  public ExampleChecks() {
    super();
  }
 
  public static boolean alwaysBad(
    Object bean,
    ValidatorAction va,
    Field field,
    ActionMessages errors,
    Validator validator,
    HttpServletRequest request) {
 
    errors.add(field.getKey(), 
        Resources.getActionMessage(request, va,  field));
 
    return false;
  }
 }
```
1. Serializableを実装しているのは、Strutsに標準で付いているValidatorがSerializableを実装しているから。何の意味があるのかは分かりません(^^;
2. Validatorメソッド定義
  - メソッド名は任意です
  - staticメソッドとして定義し、返値型はbooleanとしてます。
  - メソッド引数は上記のように、Object, ValidatorAction?, Filed, ActionMessage?, Validator, HttpServletRequeset?にします
3. 検証エラーを起こすには
  - Validatorメソッドの返値として false を返します。
4. 検証エラーを通知するには
  - 引数のActionMessages?に、add() します
  - ActionMessages?へのメッセージの追加は、上記のようなコードにします
  - どのようなメッセージを出すかは、/WEB-INF/validator-rule.xml で定義します

validator-rules.xml への登録

<validator name="bad"
  classname="com.snail.ExampleChecks"
  method="alwaysBad"
  methodParams="java.lang.Object,
                org.apache.commons.validator.ValidatorAction,
                org.apache.commons.validator.Field,
                org.apache.struts.action.ActionMessages,
                org.apache.commons.validator.Validator,
                javax.servlet.http.HttpServletRequest"
  depends=""
  msg="errors.bad"/>

application.properties への登録
```
errors.bad={0} is always bad.
```
これで bad ルールを標準のValidaortと同じように使えるようになります。
- /WEB-INF/validation.xml
```
<form name="ExampleForm">
  <field
    property="value"
    depends="bad">
    <arg key="label.value"/>
  </field>
</form>
```
- 実行結果
  - どんな場合にも検証エラーになります

↑

Formからの入力を受け取るValidator †

Formからの入力を受け取って検証するValidatorを作成します

Validatorクラス

 public class ExampleChecks implements Serializable {
 
  public ExampleChecks() {
    super();
  }
 
  public static boolean alwaysBad(Object bean, ValidatorAction va,
      Field field, ActionMessages errors, Validator validator,
      HttpServletRequest request) {
 
    errors.add(field.getKey(), 
        Resources.getActionMessage(request, va,  field));
 
    return false;
  }
 
  public static boolean onlyOkisOk(Object bean, ValidatorAction va,
      Field field, ActionMessages errors, Validator validator,
      HttpServletRequest request) throw JSPException {
    
    // 検証対象の切り出し
    String str = null;
    if( bean instanceof String ){
      str = (String)bean;
    }else{
      try {
        str = PropertyUtils.getProperty(bean,field.getProperty()).toString();
      } catch (Exception e) {
        throw new JspException(e);
      }
    }
    
    if("Ok".equals(str)){
      return true;
    }else{
      errors.add(field.getKey(), 
          Resources.getActionMessage(request, va,  field));
 
      return false;
    }
  }
 }

Validatorメソッド定義
- 一つのValidatorクラスに複数のValidatorメソッドを定義することが出来ます
検証結果の切り出しについて
- 引数のObjectから、サンプルコードのように property を切り出します
- 切り出せないときには、JSPException を投げます
値の検証について
- 検証に合格の場合には true を返します
- 検証に失敗したときには引数の ActionMessages? にメッセージを追記し、falseを返します

validator-rules.xml への登録

<validator name="OkIsOk"
  classname="com.snail.ExampleChecks"
  method="onlyOkisOk"
  methodParams="java.lang.Object,
                org.apache.commons.validator.ValidatorAction,
                org.apache.commons.validator.Field,
                org.apache.struts.action.ActionMessages,
                org.apache.commons.validator.Validator,
                javax.servlet.http.HttpServletRequest"
  depends=""
  msg="errors.onlyOkisOk"/>

application.properties への登録
```
errors.onlyOkisOk={0} is only Ok is ok.
```
これで onlyOkIsOk? ルールを標準のValidaortと同じように使えるようになります。
- /WEB-INF/validation.xml
```
<form name="ExampleForm">
  <field
    property="value"
    depends="OkIsOk">
    <arg key="label.value"/>
  </field>
</form>
```
- 実行結果
  - Okと入力すると検証に合格します
  - Goodと入力すると検証には不合格になります

↑

/WEB-INF/validation.xml でパラメータが設定できるValidator †

validation.xmlにパラメータを指定できる本格的なValidatorを作成します。ここでは、カンマ区切りで指定された候補の中に入力された文字列があるかどうかを検証します。

Validatorクラス

 public class ExampleChecks implements Serializable {
 
  public static boolean onlyAnyOneisOk(Object bean, ValidatorAction va,
      Field field, ActionMessages errors, Validator validator,
      HttpServletRequest request) throws JspException {
 
    // 検証対象の切り出し
    String str = null;
    if (bean instanceof String) {
      str = (String) bean;
    } else {
      try {
        str = PropertyUtils.getProperty(bean, field.getProperty())
            .toString();
      } catch (Exception e) {
        throw new JspException(e);
      }
    }
    
    // 検証対象がnullか空文字の場合には、検証成功とする
    if( str == null || "".equals(str.trim())){
      return true;
    }
 
    // 候補の読み込み
    String candidateList = field.getVarValue("Candidate");
    String[] candidates = candidateList.split(",");
 
    for (int cnt = 0; cnt < candidates.length; cnt++) {
      if (candidates[cnt].equals(str)) {
        return true;
      }
    }
    errors.add(field.getKey(), Resources.getActionMessage(request, va,
        field));
 
    return false;
  }
 }

本格的なValidatorでは、検証対象がnullや空文字の場合には検証成功とします。必須項目である事を検証する場合には、validator-rules.xml の depends で、Struts標準のrequiredを指定します。
validation.xml で指定されたパラメータを切り出すには、field.getVarValue?(String) を使います。
Map field.getVars() もありますが、Validatorプログラムは、どんなパラメータが来るのかあらかじめ知っているはずなのであまり使い道はないかも・・・

validator-rules.xml への登録

<validator name="AnyOneIsOk"
  classname="com.snail.ExampleChecks"
  method="onlyAnyOneisOk"
  methodParams="java.lang.Object,
                org.apache.commons.validator.ValidatorAction,
                org.apache.commons.validator.Field,
                org.apache.struts.action.ActionMessages,
                org.apache.commons.validator.Validator,
                javax.servlet.http.HttpServletRequest"
  depends=""
  msg="errors.AnyOneIsOk"/>

application.properties への登録

errors.AnyOneIsOk={0} must be one of {1}.

これで AnyOneisOk? ルールを標準のValidaortと同じように使えるようになります。
- /WEB-INF/validation.xml
```
<form name="ExampleForm">
  <field
    property="value"
    depends="AnyOneIsOk">
    <arg0 key="label.value"/>
    <arg1 key="${var:Candidate}" resource="false"/>
    <var>
      <var-name>Candidate</var-name>
      <var-value>diamond,perl,ruby,crystal,gold</var-value>
    </var>	
  </field>
</form>
```
- 実行結果
  - 何も入力しないと検証に合格します(もし必須チェックをしたければ、validator-rules.xml の depends に required を加える)
  - rubyと入力すると検証に合格します
  - silverでは検証に不合格になります

↑

/WEB-INF/validator-rules.xml の分割 †

自分で作成したValidatorに関する定義を切り出すことが出来ます。

StrutsBlank? などに入っている validator-rules.xml を参考に、 myValidator-rules.xmlを作成する

<!DOCTYPE form-validation PUBLIC
         "-//Apache Software Foundation//DTD Commons Validator Rules Configuration 1.1.3//EN"
         "http://jakarta.apache.org/commons/dtds/validator_1_1_3.dtd">
<form-validation>
  <global>
    <validator name="bad"
      classname="com.snail.ExampleChecks"
      method="alwaysBad"
      methodParams="java.lang.Object,
                    org.apache.commons.validator.ValidatorAction,
                    org.apache.commons.validator.Field,
                    org.apache.struts.action.ActionMessages,
                    org.apache.commons.validator.Validator,
                    javax.servlet.http.HttpServletRequest"
      depends=""
      msg="errors.bad"/>

    <validator name="OkIsOk"
      classname="com.snail.ExampleChecks"
      method="onlyOkisOk"
      methodParams="java.lang.Object,
                    org.apache.commons.validator.ValidatorAction,
                    org.apache.commons.validator.Field,
                    org.apache.struts.action.ActionMessages,
                    org.apache.commons.validator.Validator,
                    javax.servlet.http.HttpServletRequest"
      depends=""
      msg="errors.onlyOkisOk"/>

    <validator name="AnyOneIsOk"
      classname="com.snail.ExampleChecks"
      method="onlyAnyOneisOk"
      methodParams="java.lang.Object,
                    org.apache.commons.validator.ValidatorAction,
                    org.apache.commons.validator.Field,
                    org.apache.struts.action.ActionMessages,
                    org.apache.commons.validator.Validator,
                    javax.servlet.http.HttpServletRequest"
      depends=""
      msg="errors.AnyOneIsOk"/>

  </global>
</form-validation>

struts-config.xml の ValidatorPlugin? の設定で、myValidator-rules.xmlを登録する

 <plug-in className="org.apache.struts.validator.ValidatorPlugIn">
   <set-property
       property="pathnames"
       value="/WEB-INF/validator-rules.xml,/WEB-INF/validation.xml,/WEB-INF/myValidator-rules.xml"/>
 </plug-in>

myValidator-rules.xml を定義するときには、不要なスペースを消す。

myValidator-rules.xml に、スペースのみの行があることによってValidatorがうまく動かず、一日ムダにした。
下のような感じの定義ファイルをStrutsはうまく処理できないようだ(DOMで管理しているから?)

次のような置換を行えばよい (s/[ \t]+$//g = 行末からSPC/TABのみでできている部分をすべて削除)

誤

□□□□□□□□□□javax.servlet.http.HttpServletRequest"←
□□□depends=""←
□□□msg="errors.onlyOkisOk"/>←
■■←
□□<validator name="AnyOneIsOk"←
□□□classname="com.snail.ExampleChecks"←
□□□method="onlyAnyOneisOk"←
□□□methodParams="java.lang.Object,←
□□□□□□□□□□org.apache.commons.validator.ValidatorAction,←
□□□□□□□□□□org.apache.commons.validator.Field,←
□□□□□□□□□□org.apache.struts.action.ActionMessages,←
□□□□□□□□□□org.apache.commons.validator.Validator,←
□□□□□□□□□□javax.servlet.http.HttpServletRequest"←
□□□depends=""←
□□□msg="errors.AnyOneIsOk"/>←
■■←
□</global>←                               (□■:SPC , ←:改行)

正

□□□□□□□□□□javax.servlet.http.HttpServletRequest"←
□□□depends=""←
□□□msg="errors.onlyOkisOk"/>←
←
□□<validator name="AnyOneIsOk"←
□□□classname="com.snail.ExampleChecks"←
□□□method="onlyAnyOneisOk"←
□□□methodParams="java.lang.Object,←
□□□□□□□□□□org.apache.commons.validator.ValidatorAction,←
□□□□□□□□□□org.apache.commons.validator.Field,←
□□□□□□□□□□org.apache.struts.action.ActionMessages,←
□□□□□□□□□□org.apache.commons.validator.Validator,←
□□□□□□□□□□javax.servlet.http.HttpServletRequest"←
□□□depends=""←
□□□msg="errors.AnyOneIsOk"/>←
←
□</global>←                              (□:SPC , ←:改行)

Java#Struts

Struts 独自のValidator

目次

訪問者

更新

最新の10件

人気の10件

MenuBar

一番シンプルなValidator †

Formからの入力を受け取るValidator †

/WEB-INF/validation.xml でパラメータが設定できるValidator †

/WEB-INF/validator-rules.xml の分割 †