KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > javax > xml > ws > ProtocolException


1 /*
2  * Copyright 2007 Sun Microsystems, Inc. All rights reserved.
3  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
4  */
5
6 package javax.xml.ws;
7
8 /** The <code>ProtocolException</code> class is a
9  * base class for exceptions related to a specific protocol binding. Subclasses
10  * are used to communicate protocol level fault information to clients and may
11  * be used on the server to control the protocol specific fault representation.
12  *
13  * @since JAX-WS 2.0
14 **/
15 public class ProtocolException extends WebServiceException {
16     /**
17      * Constructs a new protocol exception with <code>null</code> as its detail message. The
18      * cause is not initialized, and may subsequently be initialized by a call
19      * to <code>Throwable.initCause(java.lang.Throwable)</code>.
20      */
21     public ProtocolException() {
22         super();
23     }
24
25     /**
26      * Constructs a new protocol exception with the specified detail message.
27      * The cause is not initialized, and may subsequently be initialized by a
28      * call to <code>Throwable.initCause(java.lang.Throwable)</code>.
29      *
30      * @param message the detail message. The detail message is saved for later
31      * retrieval by the Throwable.getMessage() method.
32      */
33     public ProtocolException(String JavaDoc message) {
34         super(message);
35     }
36
37     /**
38      * Constructs a new runtime exception with the specified detail message and
39      * cause.
40      *
41      * Note that the detail message associated with cause is not automatically
42      * incorporated in this runtime exception's detail message.
43      *
44      * @param message the detail message (which is saved for later retrieval by
45      * the Throwable.getMessage() method).
46      * @param cause the cause (which is saved for later retrieval by the
47      * <code>Throwable.getCause()</code> method). (A <code>null</code> value is permitted, and indicates
48      * that the cause is nonexistent or unknown.)
49      */
50     public ProtocolException(String JavaDoc message, Throwable JavaDoc cause) {
51         super(message, cause);
52     }
53
54     /**
55      * Constructs a new runtime exception with the specified cause and a detail
56      * message of <code>(cause==null ? null : cause.toString())</code> (which typically
57      * contains the class and detail message of cause). This constructor is
58      * useful for runtime exceptions that are little more than wrappers for
59      * other throwables.
60      *
61      * @param cause the cause (which is saved for later retrieval by the
62      * <code>Throwable.getCause()</code> method). (A <code>null</code> value is permitted, and indicates
63      * that the cause is nonexistent or unknown.)
64      */
65     public ProtocolException(Throwable JavaDoc cause) {
66         super(cause);
67     }
68 }
69
Popular Tags