验证JSSP ¶

前提条件¶

JSSP验证程序可用于以下函数 。

• js初始化时执行的init 函数
• 在IMART标签的action属性指定的Action 函数

• <imart type =“ form” />
• <imart type =”提交” />
• <imart type =”链接” />

验证的工作原理¶

JSSP验证程序根据以下流程执行该过程。

1. 客户端发送了一个请求。
2. JSSP验证程序根据验证配置文件中描述的规则来验证请求参数。
3. 如果验证失败，则将错误消息添加到错误Object 。
4. 如果错误Object 有错误消息，请执行错误处理程序函数 。如果没有错误消息，请执行由动作属性指定的Action 函数 ，例如初始化函数或形式。

验证规则¶

以下是验证规则的一览表 。 详细内容每个规则的详细信息， 详细内容 验证规则参考 。

JSSP验证器注释¶

在执行验证的函数中编写注释。在函数注释中编写@validate和@onerror批注。

/ **
*初始化过程
*
* ・ ・ ・
* @validate foo / bar_validation＃初始化
* @onerror handleErrors
* /
机能 初始化（要求）{
 ...
}

验证设置文件¶

描述变量的声明，并在属性中描述要验证的参数名称。在参数名称的属性中描述要验证的验证规则的关键字。

caption属性是生成错误消息所必需的。请务必描述。有关错误消息，请参见错误消息 。

在下面的示例中，确认请求参数“ xxx_name”是必填项目 ，并且不超过50个字符。

变种 初始化 = {
  'xxx_name'： { //请求参数名称
       字幕： “ CAP.Z.EXAMPLE.NAME”， //错误消息标题
       必填项： true，
       最大长度： 50
   }
}

验证设置文件中可以描述多个设置。使变量名称在配置文件中唯一。

var init = {'xxx_name'：{...}} var updateXXX = {'xxx_name'：{...}} var deleteXXX = {'xxx_name'：{...}}

错误讯息¶

如果请求验证失败，则生成错误消息。

下面描述一个示例，其中在验证配置文件中描述的标题属性的值为“ CAP.Z.EXAMPLE.NAME”，验证规则为“ required”和“ maxlength”。

变种 初始化 = {
  'xxx_name'： { //请求参数名称
       字幕： “ CAP.Z.EXAMPLE.NAME”， //错误消息标题
       必填项： true，
       最大长度： 50
   }
}

在此示例中，标题为“名称”。

帽。ž。范例。姓名=\ u540d \ u524d

在该示例中，由于在验证规则中设置了“ required”和“ maxlength”，因此请求验证失败时的错误消息如下。

名称为必填项。名称不得超过50个字符。

错误Object ¶

错误Object 到验证失败已经存储的请求参数的错误消息。下图是一个示例。

错误Object 的属性包含请求参数名称的数组，该属性包含验证失败的规则的键，该值包含错误消息。已成功验证的规则的键不存在。没有验证失败的参数存储没有属性的Object 。

getMessages方法针对未能验证所有请求参数的规则返回错误消息数组。

错误处理函数¶

验证所有请求参数的结果，如果任何参数验证失败，请执行错误处理程序函数 。用@onerror注释中描述的名称描述该函数 。

错误处理程序函数的第一请求发送到的参数Object ，第二个参数误差Object 将被传递到。获取存储在错误Object 的错误消息并执行错误处理。

在下面的示例中，获取了请求参数值和错误消息，并将其转发到错误页。

错误Object 的错误Object 请参考。

/ **
*初始化过程
*
* ・ ・ ・
* @onerror handleErrors
* /
机能 初始化（要求）{
 ...
}

/ **
*错误处理程序函数
*
* ・ ・ ・
* /
机能 handleErrors（要求， validationErrors） {
  变种 参数 = {
    富： 要求。富，
    错误： validationErrors。getMessages（）
  };
  向前（“ foo / bar_error”， 参数）;
}

用JavaScript实现¶

/ **
*自定义验证器
*
* ・ ・ ・
* /
机能 验证（要求， 配置， paramName， 字幕） {
  变种 价值 = 要求。getParameterValue（paramName）;
  如果 （条件） {
    归还 {isValid： true};
  } 别的 {
    归还 {isValid： false， 讯息： “验证失败”};
  }
}

以下Object 将传递给validate 函数的参数。

请在validate 函数的返回值中返回以下结构的Object 。 如果验证成功，则将isValid属性设置为true，否则将设置为false。如果验证失败，请在message属性中设置一条错误消息。

用Java实现¶

创建jp.co.intra_mart.foundation.jssp.validation.Validator接口的实现类。

包装 富;

进口 jp.co.intra_mart.foundation.jssp.validation.InitParam;
进口 jp.co.intra_mart.foundation.jssp.validation.RequestInfo;
进口 jp.co.intra_mart.foundation.jssp.validation.ValidationResult;
进口 jp.co.intra_mart.foundation.jssp.validation.Validator;
进口 jp.co.intra_mart.system.javascript.Context;
进口 jp.co.intra_mart.system.javascript.Scriptable;

公开的 类 CustomValidator 实施 验证者 {

    @Override
    公开的 虚空 破坏（） {
    }

    @Override
    公开的 验证结果 验证（请求信息 资讯） {
        最后的 弦乐 价值 = 资讯。getRequest（）。getParameter（资讯。getParameterName（））；
        如果 （条件） {
            归还 验证结果。好啦（）;
        } 别的 {
            归还 验证结果。ng（“验证失败”）;
        }
    }

    @Override
    公开的 虚空 初始化（初始化参数 参数， 语境 x， 可编写脚本 范围） {
    }
}

有关参数和返回值的说明，请参阅API列表。

jssp-validation-config设置¶

<？xml版本=“ 1.0”编码=“ UTF-8”？> <jssp-validation-config xmlns = “ http：// intra-mart .co.jp / system / jssp-validation” xmlns：xsi = “ http ：//www.w3.org/2001/XMLSchema-instance“ xsi：schemaLocation = ” http：// intra-mart .co.jp / system / jssp-validation ../../schema/jssp-validation-config .xsd“ > <！-JavaScript设置示例- > <validator> <validator-name> js_example </ validator-name> <validator-script> foo / custom_validator </ validator-script> </ validator> <！ -Java配置示例- > <validator> <validator-name> java_example </ validator-name> <validator-class> foo.CustomValidator </ validator-class> </ validator> </ jssp-validation-config>