Apache Camel Route节点的消息载体Exchange

在Camel的route中,消息在Route的各个节点中是以Exchange的形式传递的,所以对Exchange结构的理解对使用Camel来说是很重要的. 
Exchange ID 如果不指定,Camel会默认设置一个,可以用来标识一个route的一次执行. 
MEP message exchange pattern,有InOnly和InOut方式. 
Exception 但route出异常的时候,抛出的异常赋值给这个变量(但在示例中似乎不是这样?). 
In message 上一个节点传入的内容,是mandatory.的. 
Out message 当MEP 是InOut的时候才用,不是mandatory.的. 
Headers 键值对<String Object>,在下一个节点可以再取出来. 
Attachments 在调用web service或者发邮件的时候放附件. 
Body 消息内容,java对象. 
Exchange的结构如下图所示:

Exchange可以直接作为参数在route用到的方法中使用,如果route中的方法不是Exchange,Camel会根据一套规则将Exchange中的Body转换成该方法的参数类型.

这个结构里的各部分内容可以像下面的代码示例的方式进行访问:

from("file:d:/temp/inbox?delay=3000").bean(new ExchangeManipulateBean(),"implicitConvert").bean(new ExchangeManipulateBean(),"traverseExchange").to("file:d:/temp/outbox");public class ExchangeManipulateBean {    private static Logger log = Logger.getLogger(ExchangeManipulateBean.class);    public void implicitConvert(String msg){                    log.debug("implicitConvert: " + msg);            }    public void traverseExchange(Exchange exchange){        log.debug("exchange.getExchangeId() " + exchange.getExchangeId());        log.debug("exchange.getPattern() " + exchange.getPattern());        log.debug("exchange.getException() " + exchange.getException());                Map<String, Object> props = exchange.getProperties();        for(String key:props.keySet()){            log.debug("props: " + key + " " + props.get(key));        }                Message in = exchange.getIn();//in always null,but can be accessed without exception                log.debug("exchange.getIn() " + in);        log.debug("in.getMessageId() " + in.getMessageId() );        log.debug("in.getClass().getName() " + in.getClass().getName());        Map<String, Object> headers = in.getHeaders();        for(String key:headers.keySet()){            log.debug("headers: " + key + " " + headers.get(key));        }                Object body = in.getBody();        log.debug("body " + body  + " " + body.getClass().getName());        log.debug("in.getAttachmentNames() " + in.getAttachmentNames());        //Message out = exchange.getOut();//whenever out is touched,information in headers are lost

1* implicitConvert 的方法接收的参数是String,Camel会在运行的时候根据一定的规则将"In Message"的Body转换成String,这里是将文件的内容转成String,这是由Camel内部的TypeConverter完成的. 
2* exchange.getException()不能得到Exception,需要通过这样的方式: Exception exception = (Exception) exchange.getProperty(Exchange.EXCEPTION_CAUGHT); 
3* exchange.getOut()被调用后,还需要将 "In Message"的header里的内容在copy到 "Out message"中去.通常都绕过out往下一个节点传值,可以用这种方式:exchange.getIn().setBody("$contents"), 
在下一个节点仍然可以得到内容,同时前面节点set在header中的内容也存在. 
4*本人用的是Camel 2.7.5,不知道后续的版本会不会把这些"pitfall"给填上.

原文链接：http://blog.csdn.net/kkdelta/article/details/7432867