src/java.xml.ws/share/classes/javax/xml/ws/spi/http/HttpExchange.java

*** 257,267 ****
       *
       * @return decoded extra path information of web service.
       *         It is the path that comes
       *         after the web service path but before the query string in the
       *         request URI
!      *         <tt>null</tt> if there is no extra path in the request URI
       */
      public abstract String getPathInfo();
  
      /**
       * Returns the query string that is contained in the request URI
--- 257,267 ----
       *
       * @return decoded extra path information of web service.
       *         It is the path that comes
       *         after the web service path but before the query string in the
       *         request URI
!      *         {@code null} if there is no extra path in the request URI
       */
      public abstract String getPathInfo();
  
      /**
       * Returns the query string that is contained in the request URI
*** 269,279 ****
       *
       * <p>
       * This can be used for {@link MessageContext#QUERY_STRING}
       *
       * @return undecoded query string of request URI, or
!      *         <tt>null</tt> if the request URI doesn't have one
       */
      public abstract String getQueryString();
  
      /**
       * Returns an attribute that is associated with this
--- 269,279 ----
       *
       * <p>
       * This can be used for {@link MessageContext#QUERY_STRING}
       *
       * @return undecoded query string of request URI, or
!      *         {@code null} if the request URI doesn't have one
       */
      public abstract String getQueryString();
  
      /**
       * Returns an attribute that is associated with this
*** 290,300 ****
       * are {@link #REQUEST_CIPHER_SUITE}, and {@link #REQUEST_KEY_SIZE}.
       * If there is a SSL certificate associated with the request, it must
       * be exposed using {@link #REQUEST_X509CERTIFICATE}
       *
       * @param name attribute name
!      * @return the attribute value, or <tt>null</tt> if the attribute doesn't
       *         exist
       */
      public abstract Object getAttribute(String name);
  
      /**
--- 290,300 ----
       * are {@link #REQUEST_CIPHER_SUITE}, and {@link #REQUEST_KEY_SIZE}.
       * If there is a SSL certificate associated with the request, it must
       * be exposed using {@link #REQUEST_X509CERTIFICATE}
       *
       * @param name attribute name
!      * @return the attribute value, or {@code null} if the attribute doesn't
       *         exist
       */
      public abstract Object getAttribute(String name);
  
      /**
*** 309,328 ****
      /**
       * Returns the {@link Principal} that represents the authenticated
       * user for this {@code HttpExchange}.
       *
       * @return Principal for an authenticated user, or
!      *         <tt>null</tt> if not authenticated
       */
      public abstract Principal getUserPrincipal();
  
      /**
       * Indicates whether an authenticated user is included in the specified
       * logical "role".
       *
       * @param role specifies the name of the role
!      * @return <tt>true</tt> if the user making this request belongs to a
       *         given role
       */
      public abstract boolean isUserInRole(String role);
  
  }
--- 309,328 ----
      /**
       * Returns the {@link Principal} that represents the authenticated
       * user for this {@code HttpExchange}.
       *
       * @return Principal for an authenticated user, or
!      *         {@code null} if not authenticated
       */
      public abstract Principal getUserPrincipal();
  
      /**
       * Indicates whether an authenticated user is included in the specified
       * logical "role".
       *
       * @param role specifies the name of the role
!      * @return {@code true} if the user making this request belongs to a
       *         given role
       */
      public abstract boolean isUserInRole(String role);
  
  }