INT-3030 Add Error Channel to RMI Inbound Gateway

INT-3030 Polishing; Docs, Tests

Add test cases for error channel support.

Dynamically discover available RMI port.

Add What's New and `<important/>` to reference.

spring-integration-rmi/src/main/java/org/springframework/integration/rmi/config/RmiInboundGatewayParser.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2010 the original author or authors.
+ * Copyright 2002-2013 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.
@@ -21,11 +21,13 @@ import org.w3c.dom.Element;
 import org.springframework.beans.factory.support.BeanDefinitionBuilder;
 import org.springframework.integration.config.xml.AbstractInboundGatewayParser;
 import org.springframework.integration.config.xml.IntegrationNamespaceUtils;
+import org.springframework.integration.rmi.RmiInboundGateway;
 
 /**
- * Parser for the <inbound-gateway/> element of the 'rmi' namespace. 
- * 
+ * Parser for the <inbound-gateway/> element of the 'rmi' namespace.
+ *
  * @author Mark Fisher
+ * @author Gary Russell
  */
 public class RmiInboundGatewayParser extends AbstractInboundGatewayParser {
 
@@ -34,7 +36,7 @@ public class RmiInboundGatewayParser extends AbstractInboundGatewayParser {
 
 	@Override
 	protected String getBeanClassName(Element element) {
-		return "org.springframework.integration.rmi.RmiInboundGateway";
+		return RmiInboundGateway.class.getName();
 	}
 
 	@Override

spring-integration-rmi/src/main/resources/org/springframework/integration/rmi/config/spring-integration-rmi-3.0.xsd

@@ -49,6 +49,20 @@
 							</xsd:appinfo>
 						</xsd:annotation>
 					</xsd:attribute>
+					<xsd:attribute name="error-channel" type="xsd:string">
+						<xsd:annotation>
+							<xsd:appinfo>
+								<tool:annotation kind="ref">
+									<tool:expected-type type="org.springframework.integration.MessageChannel"/>
+								</tool:annotation>
+							</xsd:appinfo>
+							<xsd:documentation>
+								If a downstream exception is thrown and an error-channel is specified,
+								the MessagingException will be sent to this channel. Otherwise, any such exception
+								will be propagated to the calling system.
+							</xsd:documentation>
+						</xsd:annotation>
+					</xsd:attribute>
 				</xsd:extension>
 			</xsd:complexContent>
 		</xsd:complexType>

spring-integration-rmi/src/test/java/org/springframework/integration/rmi/BackToBackTests-context.xml

@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<beans xmlns="http://www.springframework.org/schema/beans"
+	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xmlns:int="http://www.springframework.org/schema/integration"
+	xmlns:int-rmi="http://www.springframework.org/schema/integration/rmi"
+	xsi:schemaLocation="http://www.springframework.org/schema/integration http://www.springframework.org/schema/integration/spring-integration.xsd
+		http://www.springframework.org/schema/integration/rmi http://www.springframework.org/schema/integration/rmi/spring-integration-rmi.xsd
+		http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">
+
+	<!-- Good -->
+
+	<int:channel id="good" />
+
+	<int-rmi:outbound-gateway remote-channel="foo" host="localhost"
+		request-channel="good" reply-channel="reply"
+		port="#{@port}"/>
+
+	<int-rmi:inbound-gateway request-channel="foo" registry-port="#{@port}" />
+
+	<int:service-activator input-channel="foo" expression="'reply:' + payload" />
+
+	<int:channel id="reply">
+		<int:queue/>
+	</int:channel>
+
+	<bean id="port" class="java.lang.Integer">
+		<constructor-arg value="#{T(org.springframework.integration.test.util.SocketUtils).findAvailableServerSocket(11099)}" />
+	</bean>
+
+	<!-- Bad -->
+
+	<int:channel id="bad" />
+
+	<int-rmi:outbound-gateway remote-channel="bar" host="localhost"
+		request-channel="bad" reply-channel="reply"
+		port="#{@port}"/>
+
+	<int-rmi:inbound-gateway request-channel="bar" registry-port="#{@port}"
+		error-channel="errors" />
+
+	<int:channel id="bar" /> <!-- Dispatcher has no subscribers to error channel -->
+
+	<int:service-activator input-channel="errors" expression="'error:' + payload.failedMessage.payload" />
+
+	<!-- Ugly -->
+
+	<int:channel id="ugly" />
+
+	<int-rmi:outbound-gateway remote-channel="baz" host="localhost"
+		request-channel="ugly" reply-channel="reply"
+		port="#{@port}"/>
+
+	<int-rmi:inbound-gateway request-channel="baz" registry-port="#{@port}" />
+
+	<int:channel id="baz" /> <!-- Dispatcher has no subscribers no error channel -->
+
+</beans>

spring-integration-rmi/src/test/java/org/springframework/integration/rmi/BackToBackTests.java

@@ -0,0 +1,86 @@
+/*
+ * Copyright 2013 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.rmi;
+
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertNotNull;
+import static org.junit.Assert.fail;
+
+import org.junit.Test;
+import org.junit.runner.RunWith;
+
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.context.support.AbstractApplicationContext;
+import org.springframework.integration.Message;
+import org.springframework.integration.core.PollableChannel;
+import org.springframework.integration.core.SubscribableChannel;
+import org.springframework.integration.message.GenericMessage;
+import org.springframework.test.context.ContextConfiguration;
+import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
+
+/**
+ * @author Gary Russell
+ * @since 3.0
+ *
+ */
+@ContextConfiguration
+@RunWith(SpringJUnit4ClassRunner.class)
+public class BackToBackTests {
+
+	@Autowired
+	private SubscribableChannel good;
+
+	@Autowired
+	private SubscribableChannel bad;
+
+	@Autowired
+	private SubscribableChannel ugly;
+
+	@Autowired
+	private PollableChannel reply;
+
+	@Autowired
+	private AbstractApplicationContext context;
+
+	@Test
+	public void testGood() {
+		good.send(new GenericMessage<String>("foo"));
+		Message<?> reply = this.reply.receive(0);
+		assertNotNull(reply);
+		assertEquals("reply:foo", reply.getPayload());
+	}
+
+	@Test
+	public void testBad() {
+		bad.send(new GenericMessage<String>("foo"));
+		Message<?> reply = this.reply.receive(0);
+		assertNotNull(reply);
+		assertEquals("error:foo", reply.getPayload());
+	}
+
+	@Test
+	public void testUgly() {
+		context.setId("context");
+		try {
+			ugly.send(new GenericMessage<String>("foo"));
+			fail("Expected exception");
+		}
+		catch (Exception e) {
+			assertEquals("Dispatcher has no subscribers for channel 'context.baz'.", e.getCause().getMessage());
+		}
+	}
+
+}

spring-integration-rmi/src/test/java/org/springframework/integration/rmi/RmiOutboundGatewayTests.java

@@ -35,6 +35,7 @@ import org.springframework.integration.gateway.RequestReplyExchanger;
 import org.springframework.integration.handler.AbstractReplyProducingMessageHandler;
 import org.springframework.integration.message.GenericMessage;
 import org.springframework.integration.support.MessageBuilder;
+import org.springframework.integration.test.util.SocketUtils;
 import org.springframework.remoting.RemoteLookupFailureException;
 import org.springframework.remoting.rmi.RmiServiceExporter;
 
@@ -44,7 +45,9 @@ import org.springframework.remoting.rmi.RmiServiceExporter;
  */
 public class RmiOutboundGatewayTests {
 
-	private final RmiOutboundGateway gateway = new RmiOutboundGateway("rmi://localhost:1099/testRemoteHandler");
+	private final static int port = SocketUtils.findAvailableServerSocket(11099);
+
+	private final RmiOutboundGateway gateway = new RmiOutboundGateway("rmi://localhost:" + port + "/testRemoteHandler");
 
 	private final QueueChannel output = new QueueChannel(1);
 
@@ -59,6 +62,7 @@ public class RmiOutboundGatewayTests {
 		exporter.setService(new TestExchanger());
 		exporter.setServiceInterface(RequestReplyExchanger.class);
 		exporter.setServiceName("testRemoteHandler");
+		exporter.setRegistryPort(port);
 		exporter.afterPropertiesSet();
 	}
 

spring-integration-rmi/src/test/java/org/springframework/integration/rmi/config/RmiInboundGatewayParserTests.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2010 the original author or authors.
+ * Copyright 2002-2013 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.
@@ -18,6 +18,7 @@ package org.springframework.integration.rmi.config;
 
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertNotNull;
+import static org.junit.Assert.assertSame;
 
 import org.junit.Test;
 
@@ -27,9 +28,11 @@ import org.springframework.context.support.ClassPathXmlApplicationContext;
 import org.springframework.integration.MessageChannel;
 import org.springframework.integration.core.MessagingTemplate;
 import org.springframework.integration.rmi.RmiInboundGateway;
+import org.springframework.integration.test.util.TestUtils;
 
 /**
  * @author Mark Fisher
+ * @author Gary Russell
  */
 public class RmiInboundGatewayParserTests {
 
@@ -71,9 +74,11 @@ public class RmiInboundGatewayParserTests {
 	public void gatewayWithHost() {
 		ApplicationContext context = new ClassPathXmlApplicationContext(
 				"rmiInboundGatewayParserTests.xml", this.getClass());
-		RmiInboundGateway gateway = (RmiInboundGateway) context.getBean("gatewayWithHost");
+		RmiInboundGateway gateway = (RmiInboundGateway) context.getBean("gatewayWithHostAndErrorChannel");
 		DirectFieldAccessor accessor = new DirectFieldAccessor(gateway);
 		assertEquals("localhost", accessor.getPropertyValue("registryHost"));
+		assertSame(context.getBean("testErrorChannel"),
+				TestUtils.getPropertyValue(gateway, "errorChannel"));
 	}
 
 	@Test

spring-integration-rmi/src/test/java/org/springframework/integration/rmi/config/rmiInboundGatewayParserTests.xml

@@ -14,12 +14,15 @@
 
 	<channel id="testChannel"/>
 
+	<channel id="testErrorChannel"/>
+
 	<rmi:inbound-gateway id="gatewayWithDefaults" request-channel="testChannel"/>
 
 	<rmi:inbound-gateway id="gatewayWithCustomProperties" request-channel="testChannel"
 			expect-reply="false" request-timeout="123" reply-timeout="456"/>
 
-	<rmi:inbound-gateway id="gatewayWithHost" request-channel="testChannel" registry-host="localhost"/>
+	<rmi:inbound-gateway id="gatewayWithHostAndErrorChannel" request-channel="testChannel" registry-host="localhost"
+		error-channel="testErrorChannel"/>
 
 	<rmi:inbound-gateway id="gatewayWithPort" request-channel="testChannel" registry-port="1234"/>