10.7. 验证器
验证器会根据声明的输入类型和/或输出类型对声明性消息执行声明性验证,该定义声明了预期的消息类型。
只有在 type 声明中的 validate
属性为 true 时才执行验证。
如果在输入类型和/或输出类型声明上 验证
属性为 true,则 camel 内部处理器会从 registry 查找对应的验证器。
10.7.1. 数据类型格式
数据类型格式为 scheme:name
,其中 scheme 是 Java、xml
或 json
,name 是数据类型名称。
10.7.2. 支持的验证器
验证器 | 描述 |
---|---|
predicate Validator | 使用 Expression 或 Predicate 进行验证 |
endpoint Validator | 通过转发到与验证组件(如 Validation 组件或 Bean Validation 组件)搭配使用的 Endpoint 验证组件进行验证。 |
自定义验证器 |
使用自定义验证器类进行验证。验证器必须是 |
10.7.3. 常见选项
所有验证器都必须包括指定 Data type to validate 的 type 选项。
10.7.4. predicate 验证器选项
名称 | 描述 |
---|---|
expression | 用于验证的表达式或优先级。 |
指定验证 predicate 的示例:
Java DSL:
validator() .type("csv:CSVOrder") .withExpression(bodyAs(String.class).contains("{name:XOrder}"));
XML DSL:
<predicateValidator Type="csv:CSVOrder"> <simple>${body} contains 'name:XOrder'</simple> </predicateValidator>
10.7.5. 端点验证选项
名称 | 描述 |
---|---|
ref | 引用端点 ID。 |
uri | 端点 URI. |
在 Java DSL 中指定端点 URI 的示例:
validator() .type("xml") .withUri("validator:xsd/schema.xsd");
在 XML DSL 中指定端点 ref 的示例:
<validators> <endpointValidator uri="validator:xsd/schema.xsd" type="xml"/> </validators>
Endpoint Validator 将消息转发到指定的端点。在上例中,camel 会将消息转发到 validator:
端点,它是一个 Validation 组件。您还可以使用不同的验证组件,如 Bean Validation 组件。
10.7.6. 自定义验证选项
Validator 必须是 org.apache.camel.spi.Validator
的子类
名称 | 描述 |
---|---|
ref | 引用自定义验证器 bean ID。 |
className | 自定义验证类类的全限定类名称。 |
指定自定义验证类的示例:
Java DSL:
validator() .type("json") .withJava(com.example.MyCustomValidator.class);
XML DSL:
<validators> <customValidator className="com.example.MyCustomValidator" type="json"/> </validators>
10.7.7. 验证器示例
此示例分为两个部分,第一部分声明了用于验证消息的 Endpoint Validator。第二部分显示验证器如何应用到路由。
10.7.7.1. 第 I 部分
声明使用验证器组件从 xml:ABCOrder
进行身份验证的 Endpoint Validator。
Java DSL:
validator() .type("xml:ABCOrder") .withUri("validator:xsd/schema.xsd");
XML DSL:
<camelContext id="camel" xmlns="http://camel.apache.org/schema/spring"> <validators> <endpointValidator uri="validator:xsd/schema.xsd" type="xml:ABCOrder"/> </validators> </camelContext>
10.7.7.2. 第 II 部分
当 direct:abc
端点收到消息时,上述验证器会应用到以下路由定义。
inputTypeWithValidate
被使用在 Java DSL 中而不是 inputType
,在 XML DSL 中将 inputType 声明中的 verify 属性设置为 true
:
Java DSL:
from("direct:abc") .inputTypeWithValidate("xml:ABCOrder") .log("${body}");
XML DSL:
<camelContext id="camel" xmlns="http://camel.apache.org/schema/spring"> <route> <from uri="direct:abc"/> <inputType urn="xml:ABCOrder" validate="true"/> <log message="${body}"/> </route> </camelContext>