This documentation differs from the official API. Jadeite adds extra features to the API including: variable font sizes, constructions examples, placeholders for classes and methods, and auto-generated “See Also” links. Additionally it is missing some items found in standard Javadoc documentation, including: generics type information, “Deprecated” tags and comments, “See Also” links, along with other minor differences. Please send any questions or feedback to bam@cs.cmu.edu.


java.net
class NetworkInterface

java.lang.Object extended by java.net.NetworkInterface

Most common way to construct:

Enumeration e = …;

NetworkInterface ni = (NetworkInterface)e.nextElement();

Based on 51 examples


public final class NetworkInterface
extends Object

This class represents a Network Interface made up of a name, and a list of IP addresses assigned to this interface. It is used to identify the local interface on which a multicast group is joined. Interfaces are normally known by names such as "le0".

See Also (auto-generated):

InetAddress

Enumeration

Socket


Method Summary
 boolean

          Compares this object against the specified object.
static NetworkInterface

          Convenience method to search for a network interface that has the specified Internet Protocol (IP) address bound to it.
static NetworkInterface

          Searches for the network interface with the specified name.
 String

          Get the display name of this network interface.
 byte[]

          Returns the hardware address (usually MAC) of the interface if it has one and if it can be accessed given the current privileges.
 Enumeration

          Convenience method to return an Enumeration with all or a subset of the InetAddresses bound to this network interface.
 List

          Get a List of all or a subset of the InterfaceAddresses of this network interface.
 int

          Returns the Maximum Transmission Unit (MTU) of this interface.
 String

          Get the name of this network interface.
static Enumeration

          Returns all the interfaces on this machine.
 NetworkInterface

          Returns the parent NetworkInterface of this interface if this is a subinterface, or null if it is a physical (non virtual) interface or has no parent.
 Enumeration

          Get an Enumeration with all the subinterfaces (also known as virtual interfaces) attached to this network interface.
 int

          Returns a hash code value for the object.
 boolean

          Returns whether a network interface is a loopback interface.
 boolean

          Returns whether a network interface is a point to point interface.
 boolean

          Returns whether a network interface is up and running.
 boolean

          Returns whether this interface is a virtual interface (also called subinterface).
 boolean

          Returns whether a network interface supports multicasting or not.
 String

          Returns a string representation of the object.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

equals

public boolean equals(Object obj)
Compares this object against the specified object. The result is true if and only if the argument is not null and it represents the same NetworkInterface as this object.

Two instances of NetworkInterface represent the same NetworkInterface if both name and addrs are the same for both.

Overrides:
equals in class Object
Parameters:
obj - the object to compare against.
Returns:
true if the objects are the same; false otherwise.

getByInetAddress

public static NetworkInterface getByInetAddress(InetAddress addr)
                                         throws SocketException
Convenience method to search for a network interface that has the specified Internet Protocol (IP) address bound to it.

If the specified IP address is bound to multiple network interfaces it is not defined which network interface is returned.

Parameters:
addr - The InetAddress to search with.
Returns:
A NetworkInterface or null if there is no network interface with the specified IP address.
Throws:
SocketException - If an I/O error occurs.

getByName

public static NetworkInterface getByName(String name)
                                  throws SocketException
Searches for the network interface with the specified name.

Parameters:
name - The name of the network interface.
Returns:
A NetworkInterface with the specified name, or null if there is no network interface with the specified name.
Throws:
SocketException - If an I/O error occurs.

getDisplayName

public String getDisplayName()
Get the display name of this network interface. A display name is a human readable String describing the network device.

Returns:
the display name of this network interface, or null if no display name is available.

getHardwareAddress

public byte[] getHardwareAddress()
                          throws SocketException
Returns the hardware address (usually MAC) of the interface if it has one and if it can be accessed given the current privileges.

Returns:
a byte array containing the address or null if the address doesn't exist or is not accessible.
Throws:
SocketException - if an I/O error occurs.

getInetAddresses

public Enumeration getInetAddresses()
Convenience method to return an Enumeration with all or a subset of the InetAddresses bound to this network interface.

If there is a security manager, its checkConnect method is called for each InetAddress. Only InetAddresses where the checkConnect doesn't throw a SecurityException will be returned in the Enumeration.

Returns:
an Enumeration object with all or a subset of the InetAddresses bound to this network interface

getInterfaceAddresses

public List getInterfaceAddresses()
Get a List of all or a subset of the InterfaceAddresses of this network interface.

If there is a security manager, its checkConnect method is called with the InetAddress for each InterfaceAddress. Only InterfaceAddresses where the checkConnect doesn't throw a SecurityException will be returned in the List.

Returns:
a List object with all or a subset of the InterfaceAddresss of this network interface

getMTU

public int getMTU()
           throws SocketException
Returns the Maximum Transmission Unit (MTU) of this interface.

Returns:
the value of the MTU for that interface.
Throws:
SocketException - if an I/O error occurs.

getName

public String getName()
Get the name of this network interface.

Returns:
the name of this network interface

getNetworkInterfaces

public static Enumeration getNetworkInterfaces()
                                        throws SocketException
Returns all the interfaces on this machine. Returns null if no network interfaces could be found on this machine. NOTE: can use getNetworkInterfaces()+getInetAddresses() to obtain all IP addresses for this node

Returns:
an Enumeration of NetworkInterfaces found on this machine
Throws:
SocketException - if an I/O error occurs.

getParent

public NetworkInterface getParent()
Returns the parent NetworkInterface of this interface if this is a subinterface, or null if it is a physical (non virtual) interface or has no parent.

Returns:
The NetworkInterface this interface is attached to.

getSubInterfaces

public Enumeration getSubInterfaces()
Get an Enumeration with all the subinterfaces (also known as virtual interfaces) attached to this network interface.

For instance eth0:1 will be a subinterface to eth0.

Returns:
an Enumeration object with all of the subinterfaces of this network interface

hashCode

public int hashCode()
Overrides:
hashCode in class Object

isLoopback

public boolean isLoopback()
                   throws SocketException
Returns whether a network interface is a loopback interface.

Returns:
true if the interface is a loopback interface.
Throws:
SocketException - if an I/O error occurs.

isPointToPoint

public boolean isPointToPoint()
                       throws SocketException
Returns whether a network interface is a point to point interface. A typical point to point interface would be a PPP connection through a modem.

Returns:
true if the interface is a point to point interface.
Throws:
SocketException - if an I/O error occurs.

isUp

public boolean isUp()
             throws SocketException
Returns whether a network interface is up and running.

Returns:
true if the interface is up and running.
Throws:
SocketException - if an I/O error occurs.

isVirtual

public boolean isVirtual()
Returns whether this interface is a virtual interface (also called subinterface). Virtual interfaces are, on some systems, interfaces created as a child of a physical interface and given different settings (like address or MTU). Usually the name of the interface will the name of the parent followed by a colon (:) and a number identifying the child since there can be several virtual interfaces attached to a single physical interface.

Returns:
true if this interface is a virtual interface.

supportsMulticast

public boolean supportsMulticast()
                          throws SocketException
Returns whether a network interface supports multicasting or not.

Returns:
true if the interface supports Multicasting.
Throws:
SocketException - if an I/O error occurs.

toString

public String toString()
Overrides:
toString in class Object


This documentation differs from the official API. Jadeite adds extra features to the API including: variable font sizes, constructions examples, placeholders for classes and methods, and auto-generated “See Also” links. Additionally it is missing some items found in standard Javadoc documentation, including: generics type information, “Deprecated” tags and comments, “See Also” links, along with other minor differences. Please send any questions or feedback to bam@cs.cmu.edu.
This page displays the Jadeite version of the documention, which is derived from the offical documentation that contains this copyright notice:
Copyright 2008 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
The official Sun™ documentation can be found here at http://java.sun.com/javase/6/docs/api/.