KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > com > google > gwt > user > client > rpc > InvocationException


1 /*
2  * Copyright 2006 Google Inc.
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License"); you may not
5  * use this file except in compliance with the License. You may obtain a copy of
6  * the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
12  * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
13  * License for the specific language governing permissions and limitations under
14  * the License.
15  */
16 package com.google.gwt.user.client.rpc;
17
18 /**
19  * Occurs when a service invocation did not complete cleanly.
20  * <p>
21  * A service invocation completes cleanly if
22  * <ol>
23  * <li>A response is returned from the service, or</li>
24  * <li>An exception generated within the service is successfully received and
25  * re-thrown in the client.</li>
26  * </ol>
27  * </p>
28  *
29  * <p>
30  * A service invocation can fail to complete cleanly for many reasons, including
31  * <ol>
32  * <li>The network connection to the server is unavailable</li>
33  * <li>The host web server is not available</li>
34  * <li>The server is not available</li>
35  * </ol>
36  * </p>
37  *
38  * <p>
39  * Note that it <em>is</em> possible for this exception to be thrown even if
40  * the service was invoked successfully on the server. This could be the case,
41  * for example, if a network failure happened after the invocation request was
42  * sent but before the response was received.
43  * </p>
44  */
45 public class InvocationException extends RuntimeException JavaDoc {
46
47   /**
48    * Constructs an exception with the given description.
49    *
50    * @param s the exception's description.
51    */
52   public InvocationException(String JavaDoc s) {
53     super(s, null);
54   }
55
56   /**
57    * Constructs an exception with the given description and cause.
58    *
59    * @param s the exception's description.
60    * @param cause the exception's cause.
61    */
62   public InvocationException(String JavaDoc s, Throwable JavaDoc cause) {
63     super(s, cause);
64   }
65 }
66
Popular Tags