svn commit: r1001753 - /camel/trunk/camel-core/src/main/java/org/apache/camel/Exchange.java

[da...@apache.org]

Author: davsclaus
Date: Mon Sep 27 14:16:19 2010
New Revision: 1001753

URL: http://svn.apache.org/viewvc?rev=1001753&view=rev
Log:
CAMEL-3157: Added more comments to Exchange API

Modified:
    camel/trunk/camel-core/src/main/java/org/apache/camel/Exchange.java

Modified: camel/trunk/camel-core/src/main/java/org/apache/camel/Exchange.java
URL: http://svn.apache.org/viewvc/camel/trunk/camel-core/src/main/java/org/apache/camel/Exchange.java?rev=1001753&r1=1001752&r2=1001753&view=diff
==============================================================================
--- camel/trunk/camel-core/src/main/java/org/apache/camel/Exchange.java (original)
+++ camel/trunk/camel-core/src/main/java/org/apache/camel/Exchange.java Mon Sep 27 14:16:19 2010
@@ -57,6 +57,12 @@ import org.apache.camel.spi.UnitOfWork;
  * Camel components.
  * <br/>
  * See also this <a href="http://camel.apache.org/using-getin-or-getout-methods-on-exchange.html">FAQ entry</a> for more details.
+ * <p/><br/>
+ * The {@link ExchangePattern Message Exchange Pattern} and the {@link #getIn()} and {@link #getOut()} methods
+ * are <b>not</b> strictly mapped. For example if the MEP is {@link org.apache.camel.ExchangePattern#InOnly} then
+ * you can still invoke the {@link #getOut()} method. The {@link ExchangePattern Message Exchange Pattern} is
+ * essentially just a flag to indicate the message pattern. That means you can still set an out message using
+ * the {@link #getOut()} method despite the pattern is {@link org.apache.camel.ExchangePattern#InOnly}.
  *
  * @version $Revision$
  */