6.11 输入校验

在本章中, 已经讨论了很多种用来解析 input 的方法。 如果格式不对,那这些基本的实现都是抛出异常。 如果数据丢失一部分, FixedLengthTokenizer 也会抛出异常。 同样, 使用 FieldSetMapper 时,如果读取超出 RowMapper 索引范围的值,又或者返回值类型不匹配,都会抛出异常。 所有的异常都会在 read 返回之前抛出。 然而, 他们不能确定返回的item是否是合法的。 例如, 如果其中一个字段是 age , 很显然不能是负数。 解析为数字是没问题的, 因为确实存在这个数, 所以就不会抛出异常。 因为当下已经有大量的第三方验证框架, 所以 Spring Batch 并不提供另一个验证框架, 而是提供了一个非常简单的接口, 其他框架可以实现这个接口来提供兼容:

  1. public interface Validator {
  3.     void validate(Object value) throws ValidationException;
  4. }

The contract is that the validate method will throw an exception if the object is invalid, and return normally if it is valid. Spring Batch provides an out of the box ItemProcessor:

约定是如果对象无效则 validate 方法抛出一个异常, 如果对象合法那就正常返回。 Spring Batch 提供了开箱即用的 ItemProcessor:

  1. <bean class="org.springframework.batch.item.validator.ValidatingItemProcessor">
  2.     <property name="validator" ref="validator" />
  3. </bean>
  5. <bean id="validator"
  6.       class="org.springframework.batch.item.validator.SpringValidator">
  7.     <property name="validator">
  8.         <bean id="orderValidator"
  9.               class="org.springmodules.validation.valang.ValangValidator">
  10.             <property name="valang">
  11.                 <value>
  12.                     <![CDATA[
  13.            { orderId : ? > 0 AND ? <= 9999999999 : 'Incorrect order ID' : 'error.order.id' }
  14.            { totalLines : ? = size(lineItems) : 'Bad count of order lines'
  15.                                               : 'error.order.lines.badcount'}
  16.            { customer.registered : customer.businessCustomer = FALSE OR ? = TRUE
  17.                                  : 'Business customer must be registered'
  18.                                  : 'error.customer.registration'}
  19.            { customer.companyName : customer.businessCustomer = FALSE OR ? HAS TEXT
  20.                                   : 'Company name for business customer is mandatory'
  21.                                   :'error.customer.companyname'}
  22.                     ]]>
  23.                 </value>
  24.             </property>
  25.         </bean>
  26.     </property>
  27. </bean>

这个示例展示了一个简单的 ValangValidator, 用来校验 order 对象。 这样写目的是为了尽可能多地演示如何使用 Valang 来添加校验程序。