Class UriUtil


  • public final class UriUtil
    extends Object
    Utility class for operations on URIs.
    • Method Detail

      • createUri

        public static URI createUri​(String scheme,
                                    String host,
                                    int port)
        Creates a URI by parsing the given components.

        This convenience factory method works as if by invoking the URI(String, String, String, int, String, String, String) constructor; any URISyntaxException thrown by the constructor is caught and wrapped in a new IllegalArgumentException object, which is then thrown.

        This method is provided for use in situations where it is known that the given components results in a legal URI, for example for URI constants declared within a program, and so it would be considered a programming error for the given components not to parse as such. The constructors, which throw URISyntaxException directly, should be used in situations where a URI is being constructed from user input or from some other source that may be prone to errors.

        Parameters:
        scheme - Scheme name The scheme to be parsed into a URL
        host - Host name The host to be parsed into a URL
        port - Port number The port to be parsed into a URL
        Returns:
        The new URI
        Throws:
        IllegalArgumentException - If the URI constructed from the given components violates RFC 2396
      • createUri

        public static URI createUri​(String scheme,
                                    String userInfo,
                                    String host,
                                    int port,
                                    String path,
                                    String query)
        Creates a URI by parsing the given components.

        This convenience factory method works as if by invoking the URI(String, String, String, int, String, String, String) constructor; any URISyntaxException thrown by the constructor is caught and wrapped in a new IllegalArgumentException object, which is then thrown.

        This method is provided for use in situations where it is known that the given components results in a legal URI, for example for URI constants declared within a program, and so it would be considered a programming error for the given components not to parse as such. The constructors, which throw URISyntaxException directly, should be used in situations where a URI is being constructed from user input or from some other source that may be prone to errors.

        Parameters:
        scheme - Scheme name The scheme to be parsed into a URL
        userInfo - User name and authorization information
        host - Host name The host to be parsed into a URL
        port - Port number The port to be parsed into a URL
        path - Path
        query - Query
        Returns:
        The new URI
        Throws:
        IllegalArgumentException - If the URI constructed from the given components violates RFC 2396