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.http.client;
17:
18: /**
19: * Exception thrown when the {@link RequestBuilder} attempts to make a request
20: * to a URL which violates the <a
21: * href="http://en.wikipedia.org/wiki/Same_origin_policy">Same-Origin Security
22: * Policy</a>.
23: *
24: * <h3>Required Module</h3>
25: * Modules that use this class should inherit
26: * <code>com.google.gwt.http.HTTP</code>.
27: *
28: * {@gwt.include com/google/gwt/examples/http/InheritsExample.gwt.xml}
29: *
30: */
31: public class RequestPermissionException extends RequestException {
32:
33: /**
34: * URL which caused this exception to be thrown.
35: */
36: private final String url;
37:
38: /**
39: * Constructs an instance of this class for the given URL.
40: *
41: * @param url the URL which can not be accessed
42: */
43: public RequestPermissionException(String url) {
44: super (
45: "The URL "
46: + url
47: + " is invalid or violates the same-origin security restriction");
48:
49: this .url = url;
50: }
51:
52: /**
53: * Returns the URL which we can not access.
54: *
55: * @return the URL which we cannot access.
56: */
57: public String getURL() {
58: return url;
59: }
60: }
|