Add Network-specific host name resolution API.

Change-Id: I932f73158a8f6e3ccc36c319d138180dff2aa070
This commit is contained in:
Paul Jensen
2014-05-13 19:05:13 -04:00
parent 2d3cabca36
commit d4d7a2e361

View File

@@ -19,6 +19,8 @@ package android.net;
import android.os.Parcelable;
import android.os.Parcel;
import java.net.InetAddress;
import java.net.UnknownHostException;
/**
* Identifies the Network.
@@ -36,6 +38,32 @@ public class Network implements Parcelable {
this.netId = that.netId;
}
/**
* Operates the same as {@code InetAddress.getAllByName} except that host
* resolution is done on this network.
*
* @param host the hostname or literal IP string to be resolved.
* @return the array of addresses associated with the specified host.
* @throws UnknownHostException if the address lookup fails.
*/
public InetAddress[] getAllByName(String host) throws UnknownHostException {
return InetAddress.getAllByNameOnNet(host, netId);
}
/**
* Operates the same as {@code InetAddress.getByName} except that host
* resolution is done on this network.
*
* @param host
* the hostName to be resolved to an address or {@code null}.
* @return the {@code InetAddress} instance representing the host.
* @throws UnknownHostException
* if the address lookup fails.
*/
public InetAddress getByName(String host) throws UnknownHostException {
return InetAddress.getByNameOnNet(host, netId);
}
// implement the Parcelable interface
public int describeContents() {
return 0;