第 36 章 类型转换器


摘要

Apache Camel 具有一个内置类型转换机制,用于将消息正文和消息标头转换为不同的类型。本章介绍了如何通过添加您自己的自定义转换器方法扩展类型转换机制。

36.1. 类型转换器架构

概述

这部分论述了类型转换器机制的整体架构,如果您需要编写自定义类型转换器,则必须理解这些架构。如果您只需要使用内置类型转换器,请参阅 第 34 章 了解消息格式

类型转换器接口

例 36.1 “TypeConverter Interface” 显示 org.apache.camel.TypeConverter 接口的定义,所有类型转换器都必须实现。

例 36.1. TypeConverter Interface

package org.apache.camel;

public interface TypeConverter {
    <T> T convertTo(Class<T> type, Object value);
}
Copy to Clipboard Toggle word wrap

控制器类型转换器

Apache Camel 类型转换器机制遵循控制器/工作程序模式。有许多 worker 类型转换器,各自能够执行有限的类型转换,以及一个控制器类型转换器,它聚合了 worker 执行的类型转换。控制器类型转换器充当 worker 类型转换器的前端。当您请求控制器执行类型转换时,它会选择适当的 worker,并将转换任务委派给该 worker。

对于类型转换机制的用户,控制器类型转换器是最重要的,因为它提供了访问转换机制的入口点。在启动过程中,Apache Camel 会自动将控制器类型转换器实例与 CamelContext 对象关联。要获取对控制器类型转换器的引用,您需要调用 CamelContext.getTypeConverter () 方法。例如,如果您有一个交换对象 Exchange,您可以获取对控制器类型转换器的引用,如 例 36.2 “获取控制器类型转换程序” 所示。

例 36.2. 获取控制器类型转换程序

org.apache.camel.TypeConverter tc = exchange.getContext().getTypeConverter();
Copy to Clipboard Toggle word wrap

类型转换器

控制器类型转换器使用 类型转换器 来填充 worker 类型的转换器的 registry。类型转换器是实施 TypeConverterLoader 接口的任何类。Apache Camel 目前只使用一种类型 converter loader the 注解类型转换器加载器 ( AnnotationTypeConverterLoader 类型)。

类型转换过程

图 36.1 “类型转换过程” 概述类型转换过程,显示将给定数据值(值 转换为指定类型)中涉及的步骤。

图 36.1. 类型转换过程

类型转换机制如下:

  1. CamelContext 对象包含对控制器 TypeConverter 实例的引用。转换过程的第一步是通过调用 CamelContext.getTypeConverter () 来检索控制器类型转换器。
  2. 类型转换是通过在控制器类型转换器上调用 convertTo () 方法启动的。这个方法指示类型转换器将数据对象( 值为 )从原始类型转换为 toType 参数指定的类型。
  3. 因为控制器类型转换器是很多不同的 worker 类型转换器的前端,所以它会通过检查类型为映射器的 registry 来找到适当的 worker 类型转换器。类型为转换器的 registry 由类型映射对键 (toType,fromType)。如果在 registry 中找到合适的类型转换器,控制器类型转换器会调用 worker 的 convertTo () 方法并返回结果。
  4. 如果 无法在 registry 中找到合适的类型转换器,控制器类型转换器将使用类型转换器加载一个新的类型转换器。
  5. 类型转换器加载程序搜索 classpath 上的可用 JAR 库,以查找合适的类型转换器。目前,使用的加载程序策略由注解类型转换器实施,它尝试加载由 org.apache.camel.Converter 注解注解注解的类。请参阅 “创建 TypeConverter 文件”一节
  6. 如果类型转换器成功,则会加载一个新的 worker 类型转换器,并输入到类型转换器 registry。然后,使用这个类型转换器将 value 参数转换为 toType 类型。
  7. 如果数据成功转换,则返回转换的数据值。如果转换不成功,则返回 null
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat