KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > javax > resource > NotSupportedException


1 /*
2  * The contents of this file are subject to the terms
3  * of the Common Development and Distribution License
4  * (the License). You may not use this file except in
5  * compliance with the License.
6  *
7  * You can obtain a copy of the license at
8  * https://glassfish.dev.java.net/public/CDDLv1.0.html or
9  * glassfish/bootstrap/legal/CDDLv1.0.txt.
10  * See the License for the specific language governing
11  * permissions and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL
14  * Header Notice in each file and include the License file
15  * at glassfish/bootstrap/legal/CDDLv1.0.txt.
16  * If applicable, add the following below the CDDL Header,
17  * with the fields enclosed by brackets [] replaced by
18  * you own identifying information:
19  * "Portions Copyrighted [year] [name of copyright owner]"
20  *
21  * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
22  */
23
24 package javax.resource;
25
26 /**
27  * A <code>NotSupportedException</code> is thrown to indicate that
28  * callee (resource adapter
29  * or application server for system contracts) cannot execute an operation
30  * because the operation is not a supported feature. For example, if the
31  * transaction support level for a resource adapter is
32  * <code>NO_TRANSACTION</code>, an invocation of <code>getXAResource</code>
33  * method on a <code>ManagedConnection</code> object should throw a
34  * <code>NotSupportedException</code> exception.
35  *
36  * @version 1.0
37  * @author Rahul Sharma
38  * @author Ram Jeyaraman
39  */
40
41 public class NotSupportedException extends javax.resource.ResourceException JavaDoc {
42     
43     /**
44      * Constructs a new instance with null as its detail message.
45      */
46     public NotSupportedException() { super(); }
47
48     /**
49      * Constructs a new instance with the specified detail message.
50      *
51      * @param message the detail message.
52      */
53     public NotSupportedException(String JavaDoc message) {
54     super(message);
55     }
56
57     /**
58      * Constructs a new throwable with the specified cause.
59      *
60      * @param cause a chained exception of type <code>Throwable</code>.
61      */
62     public NotSupportedException(Throwable JavaDoc cause) {
63     super(cause);
64     }
65
66     /**
67      * Constructs a new throwable with the specified detail message and cause.
68      *
69      * @param message the detail message.
70      *
71      * @param cause a chained exception of type <code>Throwable</code>.
72      */
73     public NotSupportedException(String JavaDoc message, Throwable JavaDoc cause) {
74     super(message, cause);
75     }
76
77     /**
78      * Constructs a new throwable with the specified detail message and
79      * error code.
80      *
81      * @param message a description of the exception.
82      * @param errorCode a string specifying the vendor specific error code.
83      */
84     public NotSupportedException(String JavaDoc message, String JavaDoc errorCode) {
85     super(message, errorCode);
86     }
87 }
88
Popular Tags