验证规则 › 如何实施自定义验证规则 › JavaScript 实施 › 任务级别验证的 Java 接口

任务级别验证的 Java 接口

任务级别验证的 Java 接口的定义如下所示：

语法

public boolean validate(
   BLTHContext context,
   String attributeValue,
   StringRef changedValue,
   StringRef errorMessage
   );

参数

context

输入参数

指定包含用于检索当前任务会话信息的方法的对象。

attributeValue

输入参数

指定待验证的属性的值。

changedValue

输出参数

提供一个可选的转换值，该值替换用户提供的待验证的值。 如果不需要转换，传回 null。

errorMessage

输出参数

如果验证失败，它向用户显示消息。

此消息通过 AttributeValidationException 来显示。 如果方法返回 false，CA Identity Manager 生成此异常。 

备注

输出参数 changedValue 和 errorMessage 的数据类型是 StringRef。 StringRef 是包含您为其赋值的字段 reference 的预定义数据类型，如下列示例中所示：

• 为正确格式化的电话号码添加前缀 1：

  changedValue.reference="+1 " + phoneNumber;
  

• 为未正确格式化的号码相关提供错误消息：

  errorMessage.reference="Phone number " + phoneNumber + 
              " does not match the format nnn-nnn-nnnn.";
  

返回值

• True。 该实施将 attributeValue 的值视为有效的，或者在 changedValue 中传回转换后的值。
• False。 该实施将 attributeValue 视为无效的。 CA Identity Manager 生成包含 errorMessage 的 AttributeValidationException。

目录级别验证的 JavaScript 接口

目录级别验证的 JavaScript 接口的定义如下所示：

语法

public boolean validate(
   String attributeValue,
   StringRef changedValue,
   StringRef errorMessage
   );

参数

attributeValue

输入参数

指定待验证的属性的值。

changedValue

输出参数

提供一个可选的转换值，该值替换用户提供的待验证的值。 如果不需要转换，传回 null。

errorMessage

输出参数

如果验证失败，它向用户显示消息。

此消息通过 AttributeValidationException 来显示。 如果方法返回 false，CA Identity Manager 生成此异常。 

备注

输出参数 changedValue 和 errorMessage 的数据类型是 StringRef。 StringRef 是包含您为其赋值的字段 reference 的预定义数据类型，如下列示例中所示：

• 为正确格式化的电话号码添加前缀 1：

  changedValue.reference="+1 " + phoneNumber;
  

• 为未正确格式化的号码相关提供错误消息：

  errorMessage.reference="Phone number " + phoneNumber + 
               " does not match the format nnn-nnn-nnnn.";
  

返回值

• True－该实施将 attributeValue 的值视为有效的，或者在 changedValue 中传回转换后的值。
• False－该实施将 attributeValue 视为无效的。 CA Identity Manager 生成包含 errorMessage 的 AttributeValidationException。