java.lang.Object | |
↳ | java.net.NetworkInterface |
This class is used to represent a network interface of the local device. An interface is defined by its address and a platform dependent name. The class provides methods to get all information about the available interfaces of the system or to identify the local interface of a joined multicast group.
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Compares the specified object to this
NetworkInterface and
returns whether they are equal or not. | |||||||||||
Gets the specific network interface according to the given address.
| |||||||||||
Gets the specific network interface according to a given name.
| |||||||||||
Gets the human-readable name associated with this network interface.
| |||||||||||
Returns the hardware address of the interface, if it has one, and the
user has the necessary privileges to access the address.
| |||||||||||
Gets a list of addresses bound to this network interface.
| |||||||||||
Returns a List the InterfaceAddresses for this network interface.
| |||||||||||
Returns the Maximum Transmission Unit (MTU) of this interface.
| |||||||||||
Gets the name associated with this network interface.
| |||||||||||
Gets a list of all network interfaces available on the local system or
null if no interface is available. | |||||||||||
Returns the parent NetworkInterface of this interface if this is a
sub-interface, or null if it's a physical (non virtual) interface.
| |||||||||||
Returns an
Enumeration of all the sub-interfaces of this network interface. | |||||||||||
Returns the hash code for this
NetworkInterface . | |||||||||||
Returns true if this network interface is a loopback interface.
| |||||||||||
Returns true if this network interface is a point-to-point interface.
| |||||||||||
Returns true if this network interface is up.
| |||||||||||
Returns true if this interface is a virtual interface (also called
a sub-interface).
| |||||||||||
Returns true if this network interface supports multicast.
| |||||||||||
Gets a string containing a concise, human-readable description of this
network interface.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class java.lang.Object
|
Compares the specified object to this NetworkInterface
and
returns whether they are equal or not. The object must be an instance of
NetworkInterface
with the same name, displayName
and list
of network interfaces to be equal.
obj | the object to compare with this instance. |
---|
true
if the specified object is equal to this NetworkInterface
, false
otherwise.Gets the specific network interface according to the given address.
address | the address to identify the searched network interface. |
---|
null
otherwise.SocketException | if an error occurs while getting the network interface information. |
---|---|
NullPointerException | if the given interface address is invalid. |
Gets the specific network interface according to a given name.
interfaceName | the name to identify the searched network interface. |
---|
null
otherwise.SocketException | if an error occurs while getting the network interface information. |
---|---|
NullPointerException | if the given interface's name is null .
|
Gets the human-readable name associated with this network interface.
Returns the hardware address of the interface, if it has one, and the user has the necessary privileges to access the address.
SocketException | if an I/O error occurs. |
---|
Gets a list of addresses bound to this network interface.
Returns a List the InterfaceAddresses for 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.
Returns the Maximum Transmission Unit (MTU) of this interface.
SocketException | if an I/O error occurs. |
---|
Gets the name associated with this network interface.
NetworkInterface
instance.
Gets a list of all network interfaces available on the local system or
null
if no interface is available.
NetworkInterface
instances representing the
available interfaces.SocketException | if an error occurs while getting the network interface information. |
---|
Returns the parent NetworkInterface of this interface if this is a sub-interface, or null if it's a physical (non virtual) interface.
Returns an Enumeration
of all the sub-interfaces of this network interface.
Sub-interfaces are also known as virtual interfaces.
For example, eth0:1
would be a sub-interface of eth0
.
Returns the hash code for this NetworkInterface
. Since the
name should be unique for each network interface the hash code is
generated using this name.
Returns true if this network interface is a loopback interface.
SocketException | if an I/O error occurs. |
---|
Returns true if this network interface is a point-to-point interface. (For example, a PPP connection using a modem.)
SocketException | if an I/O error occurs. |
---|
Returns true if this network interface is up.
SocketException | if an I/O error occurs. |
---|
Returns true if this interface is a virtual interface (also called a sub-interface). 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 network interface supports multicast.
SocketException | if an I/O error occurs. |
---|
Gets a string containing a concise, human-readable description of this network interface.