svn commit: r1067626 - /camel/trunk/components/camel-test/src/main/java/org/apache/camel/test/AvailablePortFinder.java

[da...@apache.org]

Author: davsclaus
Date: Sun Feb  6 10:08:14 2011
New Revision: 1067626

URL: http://svn.apache.org/viewvc?rev=1067626&view=rev
Log:
CAMEL-3593: Added avail port finder to camel-test. Thanks to Tracy Snell for patch.

Added:
    camel/trunk/components/camel-test/src/main/java/org/apache/camel/test/AvailablePortFinder.java   (with props)

Added: camel/trunk/components/camel-test/src/main/java/org/apache/camel/test/AvailablePortFinder.java
URL: http://svn.apache.org/viewvc/camel/trunk/components/camel-test/src/main/java/org/apache/camel/test/AvailablePortFinder.java?rev=1067626&view=auto
==============================================================================
--- camel/trunk/components/camel-test/src/main/java/org/apache/camel/test/AvailablePortFinder.java (added)
+++ camel/trunk/components/camel-test/src/main/java/org/apache/camel/test/AvailablePortFinder.java Sun Feb  6 10:08:14 2011
@@ -0,0 +1,113 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You 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.apache.camel.test;
+
+import java.io.IOException;
+import java.net.DatagramSocket;
+import java.net.ServerSocket;
+import java.util.NoSuchElementException;
+
+/**
+ * Finds currently available server ports.
+ *
+ * @see <a href="http://www.iana.org/assignments/port-numbers">IANA.org</a>
+ */
+public final class AvailablePortFinder {
+    /**
+     * The minimum server port number. Set at 1024 to avoid returning privileged
+     * port numbers.
+     */
+    public static final int MIN_PORT_NUMBER = 1024;
+
+    /**
+     * The maximum server port number.
+     */
+    public static final int MAX_PORT_NUMBER = 49151;
+
+    /**
+     * Creates a new instance.
+     */
+    private AvailablePortFinder() {
+        // Do nothing
+    }
+
+    /**
+     * Gets the next available port starting at the lowest port number.
+     *
+     * @throws NoSuchElementException if there are no ports available
+     */
+    public static int getNextAvailable() {
+        return getNextAvailable(MIN_PORT_NUMBER);
+    }
+
+    /**
+     * Gets the next available port starting at a port.
+     *
+     * @param fromPort the port to scan for availability
+     * @throws NoSuchElementException if there are no ports available
+     */
+    public static int getNextAvailable(int fromPort) {
+        if (fromPort < MIN_PORT_NUMBER || fromPort > MAX_PORT_NUMBER) {
+            throw new IllegalArgumentException("Invalid start port: " + fromPort);
+        }
+
+        for (int i = fromPort; i <= MAX_PORT_NUMBER; i++) {
+            if (available(i)) {
+                return i;
+            }
+        }
+
+        throw new NoSuchElementException("Could not find an available port above " + fromPort);
+    }
+
+    /**
+     * Checks to see if a specific port is available.
+     *
+     * @param port the port to check for availability
+     */
+    public static boolean available(int port) {
+        if (port < MIN_PORT_NUMBER || port > MAX_PORT_NUMBER) {
+            throw new IllegalArgumentException("Invalid start port: " + port);
+        }
+
+        ServerSocket ss = null;
+        DatagramSocket ds = null;
+        try {
+            ss = new ServerSocket(port);
+            ss.setReuseAddress(true);
+            ds = new DatagramSocket(port);
+            ds.setReuseAddress(true);
+            return true;
+        } catch (IOException e) {
+            // Do nothing
+        } finally {
+            if (ds != null) {
+                ds.close();
+            }
+
+            if (ss != null) {
+                try {
+                    ss.close();
+                } catch (IOException e) {
+                    /* should not be thrown */
+                }
+            }
+        }
+
+        return false;
+    }
+}

Propchange: camel/trunk/components/camel-test/src/main/java/org/apache/camel/test/AvailablePortFinder.java
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: camel/trunk/components/camel-test/src/main/java/org/apache/camel/test/AvailablePortFinder.java
------------------------------------------------------------------------------
    svn:keywords = Rev Date