01: /*
02: * Copyright 2007 Sun Microsystems, Inc. All rights reserved.
03: * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
04: */
05:
06: package javax.xml.ws;
07:
08: /** The <code>ProtocolException</code> class is a
09: * 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 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 message, Throwable 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 cause) {
66: super(cause);
67: }
68: }
|