jaxws/src/java.xml.ws/share/classes/com/sun/xml/internal/messaging/saaj/util/JaxmURI.java

*** 1,7 ****
  /*
!  * Copyright (c) 1997, 2012, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
--- 1,7 ----
  /*
!  * Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
*** 37,48 ****
  * is designed to handle the parsing of URIs and provide access to
  * the various components (scheme, host, port, userinfo, path, query
  * string and fragment) that may constitute a URI.
  * <p>
  * Parsing of a URI specification is done according to the URI
! * syntax described in <a href="http://www.ietf.org/rfc/rfc2396.txt?number=2396">RFC 2396</a>.
! * Every URI consists of a scheme, followed by a colon (':'), followed by a scheme-specific
  * part. For URIs that follow the "generic URI" syntax, the scheme-
  * specific part begins with two slashes ("//") and may be followed
  * by an authority segment (comprised of user information, host, and
  * port), path segment, query segment and fragment. Note that RFC 2396
  * no longer specifies the use of the parameters segment and excludes
--- 37,49 ----
  * is designed to handle the parsing of URIs and provide access to
  * the various components (scheme, host, port, userinfo, path, query
  * string and fragment) that may constitute a URI.
  * <p>
  * Parsing of a URI specification is done according to the URI
! * syntax described in <a href="http://www.ietf.org/rfc/rfc2396.txt?number=2396">
! * RFC 2396</a>. Every URI consists
! * of a scheme, followed by a colon (':'), followed by a scheme-specific
  * part. For URIs that follow the "generic URI" syntax, the scheme-
  * specific part begins with two slashes ("//") and may be followed
  * by an authority segment (comprised of user information, host, and
  * port), path segment, query segment and fragment. Note that RFC 2396
  * no longer specifies the use of the parameters segment and excludes
*** 58,69 ****
  * any built-in network access functionality nor does it provide any
  * scheme-specific functionality (for example, it does not know a
  * default port for a specific scheme). Rather, it only knows the
  * grammar and basic set of operations that can be applied to a URI.
  *
- * @version
- *
  **********************************************************************/
   public class JaxmURI implements Serializable {
  
    /*******************************************************************
    * MalformedURIExceptions are thrown in the process of building a URI
--- 59,68 ----
*** 1104,1113 ****
--- 1103,1113 ----
    * @param p_test the Object to test for equality.
    *
    * @return true if p_test is a URI with all values equal to this
    *         URI, false otherwise
    */
+   @Override
    public boolean equals(Object p_test) {
      if (p_test instanceof JaxmURI) {
        JaxmURI testURI = (JaxmURI) p_test;
        if (((m_scheme == null && testURI.m_scheme == null) ||
             (m_scheme != null && testURI.m_scheme != null &&
*** 1132,1151 ****
--- 1132,1153 ----
        }
      }
      return false;
    }
  
+   @Override
    public int hashCode() {
            // No members safe to use, just default to a constant.
            return 153214;
    }
  
   /**
    * Get the URI as a string specification. See RFC 2396 Section 5.2.
    *
    * @return the URI string specification
    */
+   @Override
    public String toString() {
      StringBuilder uriSpecString = new StringBuilder();
  
      if (m_scheme != null) {
        uriSpecString.append(m_scheme);
*** 1171,1180 ****
--- 1173,1184 ----
   /**
    * Determine whether a scheme conforms to the rules for a scheme name.
    * A scheme is conformant if it starts with an alphanumeric, and
    * contains only alphanumerics, '+','-' and '.'.
    *
+   * @param p_scheme scheme name
+   *
    * @return true if the scheme is conformant, false otherwise
    */
    public static boolean isConformantSchemeName(String p_scheme) {
      if (p_scheme == null || p_scheme.trim().length() == 0) {
        return false;
*** 1200,1210 ****
    * Determine whether a string is syntactically capable of representing
    * a valid IPv4 address or the domain name of a network host. A valid
    * IPv4 address consists of four decimal digit groups separated by a
    * '.'. A hostname consists of domain labels (each of which must
    * begin and end with an alphanumeric but may contain '-') separated
!   & by a '.'. See RFC 2396 Section 3.2.2.
    *
    * @return true if the string is a syntactically valid IPv4 address
    *              or hostname
    */
    public static boolean isWellFormedAddress(String p_address) {
--- 1204,1216 ----
    * Determine whether a string is syntactically capable of representing
    * a valid IPv4 address or the domain name of a network host. A valid
    * IPv4 address consists of four decimal digit groups separated by a
    * '.'. A hostname consists of domain labels (each of which must
    * begin and end with an alphanumeric but may contain '-') separated
!   * by a '.'. See RFC 2396 Section 3.2.2.
!   *
!   * @param p_address address
    *
    * @return true if the string is a syntactically valid IPv4 address
    *              or hostname
    */
    public static boolean isWellFormedAddress(String p_address) {