Nested Class Summary

Method Summary

Method Details

• lookupByName

  Stream<InetAddress> lookupByName(String host,InetAddressResolver.LookupPolicy lookupPolicy) throwsUnknownHostException

  Given the name of a host, returns a stream of IP addresses of the requested address family associated with a provided hostname.

  host should be a machine name, such as "www.example.com", not a textual representation of its IP address. No validation is performed on the givenhost name: if a textual representation is supplied, the name resolution is likely to fail andUnknownHostException may be thrown.

  The address family type and addresses order are specified by theLookupPolicy instance. Lookup operation characteristics could be acquired withInetAddressResolver.LookupPolicy.characteristics(). IfInetAddressResolver.LookupPolicy.IPV4 andInetAddressResolver.LookupPolicy.IPV6 characteristics provided then this method returns addresses of both IPV4 and IPV6 families.

  Parameters:

  host - the specified hostname

  lookupPolicy - the address lookup policy

  Returns:

  a stream of IP addresses for the requested host

  Throws:

  NullPointerException - if either parameter isnull

  UnknownHostException - if no IP address for thehost could be found

  See Also:

  • InetAddressResolver.LookupPolicy

• lookupByAddress

  String lookupByAddress(byte[] addr) throwsUnknownHostException

  Lookup the host name corresponding to the raw IP address provided.

  addr argument is in network byte order: the highest order byte of the address is inaddr[0].

  IPv4 address byte array must be 4 bytes long and IPv6 byte array must be 16 bytes long.

  Parameters:

  addr - byte array representing a raw IP address

  Returns:

  String representing the host name mapping

  Throws:

  UnknownHostException - if no host name is found for the specified IP address

  IllegalArgumentException - if the length of the provided byte array doesn't correspond to a valid IP address length

  NullPointerException - if addr isnull