diff options
Diffstat (limited to 'libjava/java/net/NetworkInterface.java')
| -rw-r--r-- | libjava/java/net/NetworkInterface.java | 228 |
1 files changed, 228 insertions, 0 deletions
diff --git a/libjava/java/net/NetworkInterface.java b/libjava/java/net/NetworkInterface.java new file mode 100644 index 00000000000..d42e69d5052 --- /dev/null +++ b/libjava/java/net/NetworkInterface.java @@ -0,0 +1,228 @@ +/* NetworkInterface.java + Copyright (C) 2002 Free Software Foundation, Inc. + +This file is part of GNU Classpath. + +GNU Classpath is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2, or (at your option) +any later version. + +GNU Classpath is distributed in the hope that it will be useful, but +WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +General Public License for more details. + +You should have received a copy of the GNU General Public License +along with GNU Classpath; see the file COPYING. If not, write to the +Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA +02111-1307 USA. + +Linking this library statically or dynamically with other modules is +making a combined work based on this library. Thus, the terms and +conditions of the GNU General Public License cover the whole +combination. + +As a special exception, the copyright holders of this library give you +permission to link this library with independent modules to produce an +executable, regardless of the license terms of these independent +modules, and to copy and distribute the resulting executable under +terms of your choice, provided that you also meet, for each linked +independent module, the terms and conditions of the license of that +module. An independent module is a module which is not derived from +or based on this library. If you modify this library, you may extend +this exception to your version of the library, but you are not +obligated to do so. If you do not wish to do so, delete this +exception statement from your version. */ + +package java.net; + +import java.util.Enumeration; +import java.util.Vector; + +/** + * @author Michael Koch <konqueror@gmx.de> + * @since 1.4 + */ +public final class NetworkInterface +{ + private static Vector networkInterfaces; + + private String name; + + private Vector inetAddresses; + + private NetworkInterface (String name, InetAddress address) + { + this.name = name; + this.inetAddresses = new Vector (1, 1); + this.inetAddresses.add (address); + } + + private native static Vector getRealNetworkInterfaces () + throws SocketException; + + /** + * Returns the name of the network interface + */ + public String getName () + { + return name; + } + + /** + * Returns all available addresses of the network interface + * + * If a @see SecurityManager is available all addresses are checked + * with @see SecurityManager::checkConnect() if they are available. + * Only InetAddresses are returned where the security manager doesn't + * thrown an exception. + * + * @return An enumeration of all addresses. + */ + public Enumeration getInetAddresses () + { + SecurityManager s = System.getSecurityManager (); + + if (s == null) + return inetAddresses.elements (); + + Vector tmpInetAddresses = new Vector (1, 1); + + for (Enumeration addresses = inetAddresses.elements (); + addresses.hasMoreElements (); ) + { + InetAddress addr = (InetAddress) addresses.nextElement (); + try + { + s.checkConnect (addr.getHostAddress (), 58000); + tmpInetAddresses.add (addr); + } + catch (SecurityException e) + { + } + } + + return tmpInetAddresses.elements (); + } + + /** + * Returns the display name of the interface + */ + public String getDisplayName () + { + return name; + } + + /** + * Returns an network interface by name + * + * @param name The name of the interface to return + */ + public static NetworkInterface getByName (String name) + throws SocketException + { + if (networkInterfaces == null) + networkInterfaces = getRealNetworkInterfaces (); + + for (Enumeration e = networkInterfaces.elements (); + e.hasMoreElements (); ) + { + NetworkInterface tmp = (NetworkInterface) e.nextElement (); + + if (name.equals (tmp.getName ())) + return tmp; + } + + throw new SocketException ("no network interface with this name exists"); + } + + /** + * Return a network interface by its address + * + * @param addr The address of the interface to return + */ + public static NetworkInterface getByInetAddress (InetAddress addr) + throws SocketException + { + if (networkInterfaces == null) + networkInterfaces = getRealNetworkInterfaces (); + + for (Enumeration interfaces = networkInterfaces.elements (); + interfaces.hasMoreElements (); ) + { + NetworkInterface tmp = (NetworkInterface) interfaces.nextElement (); + + for (Enumeration addresses = tmp.inetAddresses.elements (); + addresses.hasMoreElements (); ) + { + if (addr.equals ((InetAddress) addresses.nextElement ())) + return tmp; + } + } + + throw new SocketException ( + "no network interface is bound to such an IP address"); + } + + /** + * Return an Enumeration of all available network interfaces + */ + public static Enumeration getNetworkInterfaces () + throws SocketException + { + if (networkInterfaces == null) + networkInterfaces = getRealNetworkInterfaces (); + + Enumeration tmp = networkInterfaces.elements (); + if (tmp.hasMoreElements ()) + return tmp; + + return null; + } + + /** + * Checks if the current instance is equal to obj + * + * @param obj The object to compare with + */ + public boolean equals (Object obj) + { + if (!(obj instanceof NetworkInterface)) + return false; + + NetworkInterface tmp = (NetworkInterface) obj; + return name.equals (tmp.name) && + inetAddresses.equals (tmp.inetAddresses); + } + + /** + * Returns the hashcode of the current instance + */ + public int hashCode () + { + // FIXME: hash correctly + return name.hashCode () + inetAddresses.hashCode (); + } + + /** + * Returns a string representation of the interface + */ + public String toString () + { + // FIXME: check if this is correct + String result; + + result = "name: " + getDisplayName () + " (" + getName () + + ") addresses:\n"; + + for (Enumeration e = inetAddresses.elements (); + e.hasMoreElements (); ) + { + InetAddress address = (InetAddress) e.nextElement (); + result += address.toString () + "\n"; + } + + return result; + } +} // class NetworkInterface |
