colonymech / docs / www / colonyscout / internal / includes / uploadify / com / adobe / net / IURIResolver.as @ f59acf11
History | View | Annotate | Download (2.83 KB)
1 |
/* |
---|---|
2 |
Copyright (c) 2008, Adobe Systems Incorporated |
3 |
All rights reserved. |
4 |
|
5 |
Redistribution and use in source and binary forms, with or without |
6 |
modification, are permitted provided that the following conditions are |
7 |
met: |
8 |
|
9 |
* Redistributions of source code must retain the above copyright notice, |
10 |
this list of conditions and the following disclaimer. |
11 |
|
12 |
* Redistributions in binary form must reproduce the above copyright |
13 |
notice, this list of conditions and the following disclaimer in the |
14 |
documentation and/or other materials provided with the distribution. |
15 |
|
16 |
* Neither the name of Adobe Systems Incorporated nor the names of its |
17 |
contributors may be used to endorse or promote products derived from |
18 |
this software without specific prior written permission. |
19 |
|
20 |
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS |
21 |
IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, |
22 |
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR |
23 |
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR |
24 |
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, |
25 |
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, |
26 |
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR |
27 |
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF |
28 |
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING |
29 |
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS |
30 |
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
31 |
*/ |
32 |
|
33 |
package com.adobe.net |
34 |
{ |
35 |
/** |
36 |
* The URI class cannot know about DNS aliases, virtual hosts, or |
37 |
* symbolic links that may be involved. The application can provide |
38 |
* an implementation of this interface to resolve the URI before the |
39 |
* URI class makes any comparisons. For example, a web host has |
40 |
* two aliases: |
41 |
* |
42 |
* <p><code> |
43 |
* http://www.site.com/ |
44 |
* http://www.site.net/ |
45 |
* </code></p> |
46 |
* |
47 |
* <p>The application can provide an implementation that automatically |
48 |
* resolves site.net to site.com before URI compares two URI objects. |
49 |
* Only the application can know and understand the context in which |
50 |
* the URI's are being used.</p> |
51 |
* |
52 |
* <p>Use the URI.resolver accessor to assign a custom resolver to |
53 |
* the URI class. Any resolver specified is global to all instances |
54 |
* of URI.</p> |
55 |
* |
56 |
* <p>URI will call this before performing URI comparisons in the |
57 |
* URI.getRelation() and URI.getCommonParent() functions. |
58 |
* |
59 |
* @see URI.getRelation |
60 |
* @see URI.getCommonParent |
61 |
* |
62 |
* @langversion ActionScript 3.0 |
63 |
* @playerversion Flash 9.0 |
64 |
*/ |
65 |
public interface IURIResolver |
66 |
{ |
67 |
/** |
68 |
* Implement this method to provide custom URI resolution for |
69 |
* your application. |
70 |
* |
71 |
* @langversion ActionScript 3.0 |
72 |
* @playerversion Flash 9.0 |
73 |
*/ |
74 |
function resolve(uri:URI) : URI; |
75 |
} |
76 |
} |