|
对于最新的稳定版本，请使用 Spring Integration 6.3.4！ |
|
对于最新的稳定版本，请使用 Spring Integration 6.3.4！ |
Spring 集成通过依赖一些默认规则和定义某些约定，实现了一种灵活的工具，可以将消息映射到方法及其参数，而无需提供额外的配置。 以下各节中的示例阐明了这些规则。
示例场景
以下示例显示了一个未注释的参数（对象或基元），该参数不是 a 或具有非 void 返回类型的对象：MapProperties
public String doSomething(Object o);input 参数是消息负载。 如果参数类型与消息有效负载不兼容，则尝试使用 Spring 3.0 提供的转换服务对其进行转换。 返回值将合并为返回消息的有效负载。
以下示例显示了一个未注释的参数（对象或基元），该参数不是具有返回类型的 a 或 a：MapPropertiesMessage
public Message doSomething(Object o);input 参数是消息负载。 如果参数类型与消息有效负载不兼容，则尝试使用 Spring 3.0 提供的转换服务对其进行转换。 返回值是发送到下一个目标的新构造的消息。
下面的示例显示了一个参数，该参数是具有任意对象或原始返回类型的消息（或其子类之一）：
public int doSomething(Message msg);输入参数本身是一个 .
返回值将成为发送到下一个目标的 的有效负载。MessageMessage
下面的示例显示了一个参数，该参数是 a （或其子类之一） 作为返回类型：MessageMessage
public Message doSomething(Message msg);输入参数本身是一个 .
返回值是发送到下一个目标的新构造值。MessageMessage
以下示例显示了 type 或 a 作为返回类型的单个参数：MapPropertiesMessage
public Message doSomething(Map m);这个有点有趣。
尽管乍一看，直接映射到消息标头似乎很容易，但始终优先考虑有效负载。
这意味着，如果 payload 的类型为 ，则此 input 参数表示 payload。
但是，如果 payload 不是 type ，则转换服务不会尝试转换有效负载，并且 input 参数将映射到消息标头。MessageMessageMapMessageMessageMap
以下示例显示了两个参数，其中一个是不是 a 或 object 的任意类型 （对象或基元），另一个是 type 或 type （，无论返回结果如何） ：MapPropertiesMapProperties
public Message doSomething(Map h, <T> t);此组合包含两个输入参数，其中一个是 类型。
非参数（无论顺序如何）被映射到有效负载，or（无论顺序如何）被映射到消息头，从而为您提供一种与结构交互的良好 POJO 方式。MapMapMessageMapPropertiesMessage
以下示例显示无参数（无论返回结果如何）：
public String doSomething();此消息处理程序方法是根据发送到此处理程序所连接的输入通道的 Message 调用的。
但是，没有映射任何数据，因此 充当事件或触发器来调用处理程序。
根据前面描述的规则映射输出。MessageMessage
以下示例显示无参数和 void 返回：
public void soSomething();此示例与上一个示例相同，但它不会生成任何输出。
基于注释的映射
基于 Comments 的映射是将消息映射到方法的最安全且最不明确的方法。 下面的示例演示如何将方法显式映射到标头：
public String doSomething(@Payload String s, @Header("someheader") String b)正如您稍后所看到的，如果没有 Annotation，此签名将导致模棱两可的条件。
但是，通过将第一个参数显式映射到有效负载，将第二个参数显式映射到消息标头的值，我们可以避免任何歧义。Messagesomeheader
以下示例与前面的示例几乎相同：
public String doSomething(@Payload String s, @RequestParam("something") String b)@RequestMapping或任何其他非 Spring 集成映射注释都是无关紧要的，因此被忽略，使第二个参数未映射。
尽管第二个参数可以很容易地映射到有效负载，但只能有一个有效负载。
因此，注释使此方法不明确。
以下示例显示了另一种类似的方法，如果不是 annotation 来阐明意图，该方法将是模棱两可的：
public String foo(String s, @Header("foo") String b)唯一的区别是第一个参数隐式映射到消息有效负载。
以下示例显示了另一个签名，如果没有注释，该签名肯定会被视为不明确，因为它具有两个以上的参数：
public String soSomething(@Headers Map m, @Header("something") Map f, @Header("someotherthing") String bar)这个例子尤其有问题，因为它的两个参数是实例。
但是，使用基于注释的映射，可以轻松避免歧义。
在此示例中，第一个参数映射到所有消息标头，而第二个和第三个参数映射到名为 'something' 和 'someotherthing' 的消息标头的值。
有效负载未映射到任何参数。Map
复杂场景
以下示例使用多个参数：
多个参数可能会在确定适当的映射时产生很多歧义。
一般建议用 、 和 来注释您的方法参数。
本节中的示例显示了导致引发异常的不明确条件。@Payload@Header@Headers
public String doSomething(String s, int i)这两个参数的权重相等。 因此，无法确定哪一个是有效负载。
以下示例显示了一个类似的问题，只有三个参数：
public String foo(String s, Map m, String b)尽管 Map 可以很容易地映射到消息头，但无法确定如何处理这两个 String 参数。
以下示例显示了另一种不明确的方法：
public String foo(Map m, Map f)尽管有人可能会争辩说，一个可以映射到消息有效负载，另一个可以映射到消息标头，但我们不能依赖顺序。Map
任何具有多个非 （， ） 且具有未注释参数的方法签名都会导致不明确的情况并触发异常。Map<T> |
下一组示例分别显示了导致歧义的多种方法。
具有多个方法的消息处理程序根据前面描述的相同规则进行映射（在示例中）。 但是，某些方案可能仍然看起来令人困惑。
以下示例显示了具有合法（可映射和明确）签名的多种方法：
public class Something {
public String doSomething(String str, Map m);
public String doSomething(Map m);
}（方法具有相同的名称或不同的名称没有区别）。
可以映射到任一方法。
当消息有效负荷可以映射到 并且消息报头可以映射到 时，将调用第一种方法。
第二种方法也可以是候选方法，只需将消息报头映射到 .
更糟糕的是，这两种方法具有相同的名称。
起初，由于以下配置，这可能看起来模棱两可：Messagestrmm
<int:service-activator input-channel="input" output-channel="output" method="doSomething">
<bean class="org.things.Something"/>
</int:service-activator>它之所以有效，是因为 Map 首先基于有效负载，然后基于其他所有内容。 换句话说，其第一个参数可以映射到有效负载的方法优先于所有其他方法。
现在考虑另一个示例，它会产生一个真正模棱两可的条件：
public class Something {
public String doSomething(String str, Map m);
public String doSomething(String str);
}这两种方法都具有可以映射到消息有效负载的签名。
它们也具有相同的名称。
此类处理程序方法将触发异常。
但是，如果方法名称不同，则可以使用属性影响映射（如下一个示例所示）。
以下示例显示了具有两个不同方法名称的相同示例：method
public class Something {
public String doSomething(String str, Map m);
public String doSomethingElse(String str);
}下面的示例演示如何使用 attribute 来指示映射：method
<int:service-activator input-channel="input" output-channel="output" method="doSomethingElse">
<bean class="org.bar.Foo"/>
</int:service-activator>因为配置显式地映射了方法，所以我们消除了歧义。doSomethingElse
任何具有多个非 （， ） 且具有未注释参数的方法签名都会导致不明确的情况并触发异常。Map<T> |