camel-commits mailing list archives

git commit: CAMEL-7472: Polished Javadoc describing the required steps for the manual run of the test.

Date

Thu, 29 May 2014 22:15:49 GMT

Repository: camel
Updated Branches:
refs/heads/camel-2.13.x 933d1ba6d -> 9afb04ab8
CAMEL-7472: Polished Javadoc describing the required steps for the manual run of the test.
Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/9afb04ab
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/9afb04ab
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/9afb04ab
Branch: refs/heads/camel-2.13.x
Commit: 9afb04ab8a9d45d16826610ad3482c6f0e9bdeff
Parents: 933d1ba
Author: Babak Vahdat <bvahdat@apache.org>
Authored: Fri May 30 00:14:43 2014 +0200
Committer: Babak Vahdat <bvahdat@apache.org>
Committed: Fri May 30 00:15:41 2014 +0200
----------------------------------------------------------------------
.../netty/NettyUDPMulticastAsyncTest.java | 32 +++++++++-----------
1 file changed, 15 insertions(+), 17 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/9afb04ab/components/camel-netty/src/test/java/org/apache/camel/component/netty/NettyUDPMulticastAsyncTest.java
----------------------------------------------------------------------
diff --git a/components/camel-netty/src/test/java/org/apache/camel/component/netty/NettyUDPMulticastAsyncTest.java
b/components/camel-netty/src/test/java/org/apache/camel/component/netty/NettyUDPMulticastAsyncTest.java
index 78bc7ce..4d9e816 100644
--- a/components/camel-netty/src/test/java/org/apache/camel/component/netty/NettyUDPMulticastAsyncTest.java
+++ b/components/camel-netty/src/test/java/org/apache/camel/component/netty/NettyUDPMulticastAsyncTest.java
@@ -29,28 +29,26 @@ import org.junit.Test;
/**
* To run this test manually through Maven first remove the {@link Ignore}
- * annotation below, then make sure you've got a Network interface with the name
+ * annotation below, then make sure you've got a network interface with the name
* <code>en0</code> as given by the route below. If this is not the case run
- * your OS specific command to find out which Network interfaces you've got
- * supporting IPv4. For example on OS-X you can use the following command for
- * this:
+ * your OS specific command to find out which network interfaces you've got
+ * supporting IPv4 (e.g. on OS-X that would be the {@code ifconfig -a} command.
+ * Next you need to enable UDP multicast on your OS for the given multicast
+ * address of this test ({@code 224.1.2.3}). For this purpose e.g. on OS-X
+ * follow the steps being described <a href=
+ * "http://blogs.agilefaqs.com/2009/11/08/enabling-multicast-on-your-macos-unix/"
+ * >here</a>. Now running the test manually should succeed (<b>but only</b>
when
+ * using Java7+):
*
* <pre>
- * <code>$> ifconfig -a</code>
+ * mvn test -Djava.net.preferIPv4Stack=true -Dtest=NettyUDPMulticastAsyncTest
* </pre>
*
- * Then replace the <code>en0</code> Network interface name below with your own
- * one. Now running the test manually should succeed (<b>only</b> when using
- * Java7+):
- *
- * <pre>
- * <code>mvn test -Djava.net.preferIPv4Stack=true -Dtest=NettyUDPMulticastAsyncTest</code>
- * </pre>
- *
- * Note that the usage of JUnit {@link BeforeClass} annotation to achieve the
- * same effect would not work in this case as at that stage it would be too late
- * to use {@link System#setProperty(String, String) the Java API} to reach the
- * same effect. Also setting such a system property through the surefire-plugin
+ * Please note that using the JUnit {@link BeforeClass} annotation together with
+ * the corresponding {@link System#setProperty(String, String) Java API} to set
+ * the {@code java.net.preferIPv4Stack} system property would not work here as
+ * at that moment it would be too <b>late</b> to set this system property. On
+ * the other hand setting such a system property through the surefire-plugin
* would cause side effect by the other tests of this component.
*/
@Ignore("See the Javadoc")