01: /*
02: * Copyright 2006 Google Inc.
03: *
04: * Licensed under the Apache License, Version 2.0 (the "License"); you may not
05: * use this file except in compliance with the License. You may obtain a copy of
06: * the License at
07: *
08: * http://www.apache.org/licenses/LICENSE-2.0
09: *
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 {
46:
47: /**
48: * Constructs an exception with the given description.
49: *
50: * @param s the exception's description.
51: */
52: public InvocationException(String 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 s, Throwable cause) {
63: super(s, cause);
64: }
65: }
|