src/java.xml.crypto/share/classes/javax/xml/crypto/URIReferenceException.java

*** 33,44 ****
  
  /**
   * Indicates an exceptional condition thrown while dereferencing a
   * {@link URIReference}.
   *
!  * <p>A <code>URIReferenceException</code> can contain a cause: another
!  * throwable that caused this <code>URIReferenceException</code> to get thrown.
   *
   * @author Sean Mullan
   * @author JSR 105 Expert Group
   * @since 1.6
   * @see URIDereferencer#dereference(URIReference, XMLCryptoContext)
--- 33,44 ----
  
  /**
   * Indicates an exceptional condition thrown while dereferencing a
   * {@link URIReference}.
   *
!  * <p>A {@code URIReferenceException} can contain a cause: another
!  * throwable that caused this {@code URIReferenceException} to get thrown.
   *
   * @author Sean Mullan
   * @author JSR 105 Expert Group
   * @since 1.6
   * @see URIDereferencer#dereference(URIReference, XMLCryptoContext)
*** 58,114 ****
      private Throwable cause;
  
      private URIReference uriReference;
  
      /**
!      * Constructs a new <code>URIReferenceException</code> with
!      * <code>null</code> as its detail message.
       */
      public URIReferenceException() {
          super();
      }
  
      /**
!      * Constructs a new <code>URIReferenceException</code> with the specified
       * detail message.
       *
       * @param message the detail message
       */
      public URIReferenceException(String message) {
          super(message);
      }
  
      /**
!      * Constructs a new <code>URIReferenceException</code> with the
       * specified detail message and cause.
       * <p>Note that the detail message associated with
!      * <code>cause</code> is <i>not</i> automatically incorporated in
       * this exception's detail message.
       *
       * @param message the detail message
!      * @param cause the cause (A <tt>null</tt> value is permitted, and
       *        indicates that the cause is nonexistent or unknown.)
       */
      public URIReferenceException(String message, Throwable cause) {
          super(message);
          this.cause = cause;
      }
  
      /**
!      * Constructs a new <code>URIReferenceException</code> with the
!      * specified detail message, cause and <code>URIReference</code>.
       * <p>Note that the detail message associated with
!      * <code>cause</code> is <i>not</i> automatically incorporated in
       * this exception's detail message.
       *
       * @param message the detail message
!      * @param cause the cause (A <tt>null</tt> value is permitted, and
       *        indicates that the cause is nonexistent or unknown.)
!      * @param uriReference the <code>URIReference</code> that was being
       *    dereferenced when the error was encountered
!      * @throws NullPointerException if <code>uriReference</code> is
!      *    <code>null</code>
       */
      public URIReferenceException(String message, Throwable cause,
          URIReference uriReference) {
          this(message, cause);
          if (uriReference == null) {
--- 58,114 ----
      private Throwable cause;
  
      private URIReference uriReference;
  
      /**
!      * Constructs a new {@code URIReferenceException} with
!      * {@code null} as its detail message.
       */
      public URIReferenceException() {
          super();
      }
  
      /**
!      * Constructs a new {@code URIReferenceException} with the specified
       * detail message.
       *
       * @param message the detail message
       */
      public URIReferenceException(String message) {
          super(message);
      }
  
      /**
!      * Constructs a new {@code URIReferenceException} with the
       * specified detail message and cause.
       * <p>Note that the detail message associated with
!      * {@code cause} is <i>not</i> automatically incorporated in
       * this exception's detail message.
       *
       * @param message the detail message
!      * @param cause the cause (A {@code null} value is permitted, and
       *        indicates that the cause is nonexistent or unknown.)
       */
      public URIReferenceException(String message, Throwable cause) {
          super(message);
          this.cause = cause;
      }
  
      /**
!      * Constructs a new {@code URIReferenceException} with the
!      * specified detail message, cause and {@code URIReference}.
       * <p>Note that the detail message associated with
!      * {@code cause} is <i>not</i> automatically incorporated in
       * this exception's detail message.
       *
       * @param message the detail message
!      * @param cause the cause (A {@code null} value is permitted, and
       *        indicates that the cause is nonexistent or unknown.)
!      * @param uriReference the {@code URIReference} that was being
       *    dereferenced when the error was encountered
!      * @throws NullPointerException if {@code uriReference} is
!      *    {@code null}
       */
      public URIReferenceException(String message, Throwable cause,
          URIReference uriReference) {
          this(message, cause);
          if (uriReference == null) {
*** 116,187 ****
          }
          this.uriReference = uriReference;
      }
  
      /**
!      * Constructs a new <code>URIReferenceException</code> with the specified
!      * cause and a detail message of <code>(cause==null ? null :
!      * cause.toString())</code> (which typically contains the class and detail
!      * message of <code>cause</code>).
       *
!      * @param cause the cause (A <tt>null</tt> value is permitted, and
       *        indicates that the cause is nonexistent or unknown.)
       */
      public URIReferenceException(Throwable cause) {
          super(cause==null ? null : cause.toString());
          this.cause = cause;
      }
  
      /**
!      * Returns the <code>URIReference</code> that was being dereferenced
       * when the exception was thrown.
       *
!      * @return the <code>URIReference</code> that was being dereferenced
!      * when the exception was thrown, or <code>null</code> if not specified
       */
      public URIReference getURIReference() {
          return uriReference;
      }
  
      /**
!      * Returns the cause of this <code>URIReferenceException</code> or
!      * <code>null</code> if the cause is nonexistent or unknown.  (The
       * cause is the throwable that caused this
!      * <code>URIReferenceException</code> to get thrown.)
       *
!      * @return the cause of this <code>URIReferenceException</code> or
!      *    <code>null</code> if the cause is nonexistent or unknown.
       */
      public Throwable getCause() {
          return cause;
      }
  
      /**
!      * Prints this <code>URIReferenceException</code>, its backtrace and
       * the cause's backtrace to the standard error stream.
       */
      public void printStackTrace() {
          super.printStackTrace();
          //XXX print backtrace of cause
      }
  
      /**
!      * Prints this <code>URIReferenceException</code>, its backtrace and
       * the cause's backtrace to the specified print stream.
       *
!      * @param s <code>PrintStream</code> to use for output
       */
      public void printStackTrace(PrintStream s) {
          super.printStackTrace(s);
          //XXX print backtrace of cause
      }
  
      /**
!      * Prints this <code>URIReferenceException</code>, its backtrace and
       * the cause's backtrace to the specified print writer.
       *
!      * @param s <code>PrintWriter</code> to use for output
       */
      public void printStackTrace(PrintWriter s) {
          super.printStackTrace(s);
          //XXX print backtrace of cause
      }
--- 116,187 ----
          }
          this.uriReference = uriReference;
      }
  
      /**
!      * Constructs a new {@code URIReferenceException} with the specified
!      * cause and a detail message of {@code (cause==null ? null :
!      * cause.toString())} (which typically contains the class and detail
!      * message of {@code cause}).
       *
!      * @param cause the cause (A {@code null} value is permitted, and
       *        indicates that the cause is nonexistent or unknown.)
       */
      public URIReferenceException(Throwable cause) {
          super(cause==null ? null : cause.toString());
          this.cause = cause;
      }
  
      /**
!      * Returns the {@code URIReference} that was being dereferenced
       * when the exception was thrown.
       *
!      * @return the {@code URIReference} that was being dereferenced
!      * when the exception was thrown, or {@code null} if not specified
       */
      public URIReference getURIReference() {
          return uriReference;
      }
  
      /**
!      * Returns the cause of this {@code URIReferenceException} or
!      * {@code null} if the cause is nonexistent or unknown.  (The
       * cause is the throwable that caused this
!      * {@code URIReferenceException} to get thrown.)
       *
!      * @return the cause of this {@code URIReferenceException} or
!      *    {@code null} if the cause is nonexistent or unknown.
       */
      public Throwable getCause() {
          return cause;
      }
  
      /**
!      * Prints this {@code URIReferenceException}, its backtrace and
       * the cause's backtrace to the standard error stream.
       */
      public void printStackTrace() {
          super.printStackTrace();
          //XXX print backtrace of cause
      }
  
      /**
!      * Prints this {@code URIReferenceException}, its backtrace and
       * the cause's backtrace to the specified print stream.
       *
!      * @param s {@code PrintStream} to use for output
       */
      public void printStackTrace(PrintStream s) {
          super.printStackTrace(s);
          //XXX print backtrace of cause
      }
  
      /**
!      * Prints this {@code URIReferenceException}, its backtrace and
       * the cause's backtrace to the specified print writer.
       *
!      * @param s {@code PrintWriter} to use for output
       */
      public void printStackTrace(PrintWriter s) {
          super.printStackTrace(s);
          //XXX print backtrace of cause
      }