INT-894 Added validation to avoid multiple conflicting annotations, and added GatewayProxyMessageMappingTests.

This commit is contained in:
Mark Fisher
2009-12-08 20:43:25 +00:00
parent 5961c8f3a8
commit 990610fdb6
3 changed files with 207 additions and 16 deletions

View File

@@ -44,6 +44,7 @@ import org.springframework.integration.annotation.Header;
import org.springframework.integration.annotation.Headers;
import org.springframework.integration.annotation.Payload;
import org.springframework.integration.core.Message;
import org.springframework.integration.core.MessagingException;
import org.springframework.integration.message.InboundMessageMapper;
import org.springframework.integration.message.MessageBuilder;
import org.springframework.integration.message.MessageHandlingException;
@@ -215,7 +216,7 @@ public class ArgumentArrayMessageMapper implements InboundMessageMapper<Object[]
Class<? extends Annotation> type = annotation.annotationType();
if (type.equals(Payload.class) || type.equals(Header.class) || type.equals(Headers.class)) {
if (match != null) {
throw new IllegalArgumentException("At most one parameter annotation can be provided for message mapping, " +
throw new MessagingException("At most one parameter annotation can be provided for message mapping, " +
"but found two: [" + match.annotationType().getName() + "] and [" + annotation.annotationType().getName() + "]");
}
match = annotation;
@@ -226,7 +227,7 @@ public class ArgumentArrayMessageMapper implements InboundMessageMapper<Object[]
@SuppressWarnings("unchecked")
private Map<String, Object> mapArgumentsToMessage(Object[] arguments, Message<?> message) {
boolean mappedMessageOrPayload = false;
MethodParameter messageOrPayloadParameter = null;
Map<String, Object> messageArgumentsMap = new LinkedHashMap<String, Object>();
for (int i = 0; i < this.parameterList.size(); i++) {
Object argumentValue = arguments[i];
@@ -235,14 +236,14 @@ public class ArgumentArrayMessageMapper implements InboundMessageMapper<Object[]
if (annotation != null) {
if (annotation.annotationType().equals(Payload.class)) {
if (((Payload) annotation).value().length() != 0) {
throw new IllegalStateException(
throw new MessagingException(
"The Payload annotation does not support an expression when mapping to a Message.");
}
messageArgumentsMap.put("payload", argumentValue);
if (mappedMessageOrPayload) {
if (messageOrPayloadParameter != null) {
this.throwExceptionForMultipleMessageOrPayloadParameters(methodParameter);
}
mappedMessageOrPayload = true;
messageOrPayloadParameter = methodParameter;
}
else if (annotation.annotationType().equals(Header.class)) {
Object[] header = this.mapHeaderThruAnnotation(annotation, message, methodParameter, argumentValue);
@@ -260,43 +261,53 @@ public class ArgumentArrayMessageMapper implements InboundMessageMapper<Object[]
}
}
}
else if (!mappedMessageOrPayload) {
else if (messageOrPayloadParameter == null) {
if (argumentValue instanceof Message<?>) {
messageArgumentsMap.put("message", argumentValue);
}
else {
messageArgumentsMap.put("payload", argumentValue);
}
mappedMessageOrPayload = true;
}
messageOrPayloadParameter = methodParameter;
}
else if (Map.class.isAssignableFrom(methodParameter.getParameterType())) {
if (Map.class.isAssignableFrom(messageOrPayloadParameter.getParameterType())
&& messageOrPayloadParameter.getParameterAnnotation(Payload.class) == null) {
throw new MessagingException("Ambiguous method parameters; found more than one " +
"Map-typed parameter and neither one contains a @Payload annotation");
}
messageArgumentsMap.put("headers", argumentValue);
}
else {
this.throwExceptionForMultipleMessageOrPayloadParameters(methodParameter);
}
}
Assert.isTrue(mappedMessageOrPayload, "unable to determine a Message or payload parameter on method [" + method + "]");
Assert.isTrue(messageOrPayloadParameter != null, "unable to determine a Message or payload parameter on method [" + method + "]");
return messageArgumentsMap;
}
private void throwExceptionForMultipleMessageOrPayloadParameters(MethodParameter methodParameter) {
throw new IllegalStateException(
throw new MessagingException(
"At most one parameter may be mapped to the payload or Message, " +
"found more than one on method [" + methodParameter.getMethod() + "]");
}
private Message<?> buildMessageFromArgumentMap(Map<String, Object> messageArgumentsMap) {
MessageBuilder<?> builder = null;
Map<String, Object> headers = null;
Message<?> message = (Message<?>) messageArgumentsMap.get("message");
if (message != null) {
Object payload = message.getPayload();
headers = message.getHeaders();
builder = MessageBuilder.withPayload(payload).copyHeaders(headers);
builder = MessageBuilder.fromMessage(message);
}
else {
builder = MessageBuilder.withPayload(messageArgumentsMap.get("payload"));
}
Object headers = messageArgumentsMap.get("headers");
if (headers != null && headers instanceof Map) {
builder.copyHeadersIfAbsent((Map<String, Object>) headers);
}
for (Object headerName : messageArgumentsMap.keySet()) {
if (!headerName.equals("payload") && !headerName.equals("message")) { // everything else is a header
if (!headerName.equals("payload") && !headerName.equals("message") && !headerName.equals("headers")) {
// everything else is a header
builder.setHeader((String) headerName, messageArgumentsMap.get(headerName));
}
}

View File

@@ -0,0 +1,179 @@
/*
* Copyright 2002-2009 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.springframework.integration.gateway;
import static org.junit.Assert.assertEquals;
import static org.junit.Assert.assertNotNull;
import static org.junit.Assert.assertNull;
import java.util.HashMap;
import java.util.Map;
import org.junit.Before;
import org.junit.Test;
import org.springframework.integration.annotation.Header;
import org.springframework.integration.annotation.Headers;
import org.springframework.integration.annotation.Payload;
import org.springframework.integration.channel.QueueChannel;
import org.springframework.integration.core.Message;
import org.springframework.integration.core.MessagingException;
/**
* @author Mark Fisher
* @since 2.0
*/
public class GatewayProxyMessageMappingTests {
private final QueueChannel channel = new QueueChannel();
private volatile TestGateway gateway = null;
@Before
public void initializeGateway() throws Exception {
GatewayProxyFactoryBean factoryBean = new GatewayProxyFactoryBean();
factoryBean.setServiceInterface(TestGateway.class);
factoryBean.setDefaultRequestChannel(channel);
factoryBean.afterPropertiesSet();
this.gateway = (TestGateway) factoryBean.getObject();
}
@Test
public void payloadAndHeaderMapWithoutAnnotations() throws Exception {
Map<String, Object> m = new HashMap<String, Object>();
m.put("k1", "v1");
m.put("k2", "v2");
gateway.payloadAndHeaderMapWithoutAnnotations("foo", m);
Message<?> result = channel.receive(0);
assertNotNull(result);
assertEquals("foo", result.getPayload());
assertEquals("v1", result.getHeaders().get("k1"));
assertEquals("v2", result.getHeaders().get("k2"));
}
@Test
public void payloadAndHeaderMapWithAnnotations() throws Exception {
Map<String, Object> m = new HashMap<String, Object>();
m.put("k1", "v1");
m.put("k2", "v2");
gateway.payloadAndHeaderMapWithAnnotations("foo", m);
Message<?> result = channel.receive(0);
assertNotNull(result);
assertEquals("foo", result.getPayload());
assertEquals("v1", result.getHeaders().get("k1"));
assertEquals("v2", result.getHeaders().get("k2"));
}
@Test
public void headerValuesAndPayloadWithAnnotations() throws Exception {
gateway.headerValuesAndPayloadWithAnnotations("headerValue1", "payloadValue", "headerValue2");
Message<?> result = channel.receive(0);
assertNotNull(result);
assertEquals("payloadValue", result.getPayload());
assertEquals("headerValue1", result.getHeaders().get("k1"));
assertEquals("headerValue2", result.getHeaders().get("k2"));
}
@Test
public void mapOnly() throws Exception {
Map<String, Object> map = new HashMap<String, Object>();
map.put("k1", "v1");
map.put("k2", "v2");
gateway.mapOnly(map);
Message<?> result = channel.receive(0);
assertNotNull(result);
assertEquals(map, result.getPayload());
assertNull(result.getHeaders().get("k1"));
assertNull(result.getHeaders().get("k2"));
}
@Test
public void twoMapsAndOneAnnotatedWithPayload() {
Map<String, Object> map1 = new HashMap<String, Object>();
Map<String, Object> map2 = new HashMap<String, Object>();
map1.put("k1", "v1");
map2.put("k2", "v2");
gateway.twoMapsAndOneAnnotatedWithPayload(map1, map2);
Message<?> result = channel.receive(0);
assertNotNull(result);
assertEquals(map1, result.getPayload());
assertEquals("v2", result.getHeaders().get("k2"));
assertNull(result.getHeaders().get("k1"));
}
@Test(expected = MessagingException.class)
public void twoMapsWithoutAnnotations() {
Map<String, Object> map1 = new HashMap<String, Object>();
Map<String, Object> map2 = new HashMap<String, Object>();
map1.put("k1", "v1");
map2.put("k2", "v2");
gateway.twoMapsWithoutAnnotations(map1, map2);
}
@Test(expected = MessagingException.class)
public void twoPayloads() throws Exception {
gateway.twoPayloads("won't", "work");
}
@Test(expected = MessagingException.class)
public void payloadAndHeaderAnnotationsOnSameParameter() throws Exception {
gateway.payloadAndHeaderAnnotationsOnSameParameter("oops");
}
@Test(expected = MessagingException.class)
public void payloadAndHeadersAnnotationsOnSameParameter() throws Exception {
gateway.payloadAndHeadersAnnotationsOnSameParameter(new HashMap<String, Object>());
}
@Test(expected = MessagingException.class)
public void payloadWithExpression() throws Exception {
gateway.payloadWithExpression("test");
}
public static interface TestGateway {
void payloadAndHeaderMapWithoutAnnotations(String s, Map<String, Object> map);
void payloadAndHeaderMapWithAnnotations(@Payload String s, @Headers Map<String, Object> map);
void headerValuesAndPayloadWithAnnotations(@Header("k1") String x, @Payload String s, @Header("k2") String y);
void mapOnly(Map<String, Object> map);
void twoMapsAndOneAnnotatedWithPayload(@Payload Map<String, Object> payload, Map<String, Object> headers);
// invalid
void twoMapsWithoutAnnotations(Map<String, Object> m1, Map<String, Object> m2);
// invalid
void twoPayloads(@Payload String s1, @Payload String s2);
// invalid
void payloadAndHeaderAnnotationsOnSameParameter(@Payload @Header("x") String s);
// invalid
void payloadAndHeadersAnnotationsOnSameParameter(@Payload @Headers Map<String, Object> map);
// invalid
void payloadWithExpression(@Payload("oops") String s);
}
}

View File

@@ -31,6 +31,7 @@ import org.springframework.integration.annotation.Header;
import org.springframework.integration.annotation.Headers;
import org.springframework.integration.annotation.Payload;
import org.springframework.integration.core.Message;
import org.springframework.integration.core.MessagingException;
import org.springframework.integration.message.MessageBuilder;
import org.springframework.integration.message.MessageHandlingException;
import org.springframework.integration.message.StringMessage;
@@ -280,7 +281,7 @@ public class ArgumentArrayMessageMapperFromMessageTests {
Assert.assertTrue(args[1].equals("monday"));
}
@Test(expected = IllegalArgumentException.class)
@Test(expected = MessagingException.class)
public void fromMessageInvalidMethodWithMultipleMappingAnnotations() throws Exception {
Method method = MultipleMappingAnnotationTestBean.class.getMethod("test", String.class);
ArgumentArrayMessageMapper mapper = new ArgumentArrayMessageMapper(method);