infernap12/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2026-03-14 18:03:44 +00:00
Code Issues Packages Projects Releases Wiki Activity

8356395: Spec needs to be clarified for InterfaceAddress class level API documentation and getBroadcast() method

Browse Source 
Reviewed-by: dfuchs
This commit is contained in:
kieran-farrell 2025-05-16 07:33:17 +00:00 committed by Daniel Fuchs
parent f6b0f016f6
commit a8d8ffa8ad
1 changed files with 7 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
src/java.base/share/classes/java/net/InterfaceAddress.java
View File

@ -28,10 +28,10 @@ package java.net;
import java.util.Objects;
/**
* This class represents a Network Interface address. In short it's an
* IP address, a subnet mask and a broadcast address when the address is
* an IPv4 one. An IP address and a network prefix length in the case
* of IPv6 address.
* This class represents a Network Interface address. In the case of
* IPv4, this comprises the IP address, a subnet mask, and a broadcast
* address if the interface supports broadcast. In the case of IPv6,
* it comprises the IP address and a network prefix length.
*
* @see java.net.NetworkInterface
* @since 1.6
@ -62,6 +62,9 @@ public final class InterfaceAddress {
* <p>
* Only IPv4 networks have broadcast address therefore, in the case
* of an IPv6 network, {@code null} will be returned.
* <p>
* Certain network interfaces, such as the loopback interface, do not support
* broadcasting and will also return {@code null}.
*
* @return the {@code InetAddress} representing the broadcast
* address or {@code null} if there is no broadcast address.