IPv6Utils (Apache Tomcat 10.1.54 API Documentation)
Description: declaration: package: org.apache.tomcat.util.net, class: IPv6Utils

# Class IPv6Utils

java.lang.Object
org.apache.tomcat.util.net.IPv6Utils

public class IPv6Utils extends Object

IPv6 utilities.

For the moment, it only contains function to canonicalize IPv6 address into RFC 5952 form.

- ## Constructor Summary

  Constructors
  Constructor
  Description
  `IPv6Utils()`

- ## Method Summary

  Modifier and Type
  Method
  Description
  `static String`
  `canonize(String ipv6Address)`
  Convert IPv6 address into RFC 5952 form.

  ### Methods inherited from class Object

  `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- ## Constructor Details

  - ### IPv6Utils

    public IPv6Utils()

- ## Method Details

  - ### canonize

    public static String canonize(String ipv6Address) throws IllegalArgumentException

    Convert IPv6 address into RFC 5952 form. E.g. 2001:db8:0:1:0:0:0:1 -> 2001:db8:0:1::1

    Method is null safe, and if IPv4 address or host name is passed to the method it is returned without any processing.

    Method also supports IPv4 in IPv6 (e.g. 0:0:0:0:0:ffff:192.0.2.1 -> ::ffff:192.0.2.1), and zone ID (e.g. fe80:0:0:0:f0f0:c0c0:1919:1234%4 -> fe80::f0f0:c0c0:1919:1234%4).

    The behaviour of this method is undefined if an invalid IPv6 address is passed in as input.

    Parameters:
      `ipv6Address` - String representing valid IPv6 address.
    Returns:
      String representing IPv6 in canonical form.
    Throws:
      `IllegalArgumentException` - if IPv6 format is unacceptable.