Apache Camel中setHeader与setProperty的作用及使用场景是什么？

核心本质差异 #

• setHeader 操作的是 Exchange 的 Message Header 集合：Header 和消息本身绑定，如果在路由中做消息转换、调用外部组件（HTTP、MQ 等），这些组件默认会读取/传递当前消息的 Header，部分组件还会把外部返回的响应头自动写入 Message Header。如果路由中做了消息替换（比如把当前 Message 替换为外部接口返回的新结果），原 Message 的 Header 不会自动带到新 Message 中，除非显式配置保留规则。
• setProperty 操作的是 Exchange 级别的属性集合：属性和整个交换（Exchange）绑定，只要整个 Exchange 生命周期未结束（即从路由入口到处理完成的全流程），设置的 Property 会一直存在，不会因为消息体、消息 Header 的替换丢失，也不会被外部组件默认读取/传递。

适用场景 #

使用 setHeader 的场景 #

• 给调用的外部组件传递配置参数：比如调用 HTTP 组件时设置 Content-Type、鉴权 Token 等 Header，组件会自动把这些 Header 放到实际发起的 HTTP 请求中；调用 Kafka/RocketMQ 组件时设置消息业务标签、KEY 等 Header，会被组件写入实际的消息元数据。
• 路由上下游传递和当前消息强绑定的元数据，后续消息要流转到其他服务/中间件时，这些 Header 可以跟着消息一起传递。

使用 setProperty 的场景 #

• 存储路由处理过程中的临时变量：比如在路由开头计算得到一个业务 ID，后续多个步骤都需要调用，就可以存在 Property 中，不用担心中间消息转换、组件调用把这个值弄丢。
• 存储路由的全局控制参数：比如开关标记、分页查询总条数、异常重试次数统计等，这些参数仅在当前 Exchange 的处理流程内有效，不需要对外传递。

常用获取使用方式 #

路由 DSL 中直接获取 #

通过 Simple 表达式引用即可，获取 Header 用 ${header.xxx}，获取 Property 用 ${exchangeProperty.xxx}，示例：

from("direct:testRoute")
    // 设置 Header
    .setHeader("requestId", simple("${uuid}"))
    // 设置 Property
    .setProperty("retryCount", constant(0))
    // 路由逻辑判断
    .choice()
        .when(simple("${exchangeProperty.retryCount} > 3"))
            .to("direct:exceedRetryLimit")
        .otherwise()
            // 调用 HTTP 组件时 Header 会自动传递
            .to("http://xxx.com/api")
    .end();

自定义 Processor 中获取 #

可以直接通过 Exchange 对象操作：

@Override
public void process(Exchange exchange) throws Exception {
    // 读取 Header
    String requestId = exchange.getMessage().getHeader("requestId", String.class);
    // 写入 Header
    exchange.getMessage().setHeader("newHeader", "testValue");
    
    // 读取 Property
    Integer retryCount = exchange.getProperty("retryCount", Integer.class);
    // 写入 Property
    exchange.setProperty("retryCount", retryCount + 1);
}

内容的提问来源于stack exchange，提问作者Gerry