+/*\r
+ Copyright (c) 2008, Adobe Systems Incorporated\r
+ All rights reserved.\r
+\r
+ Redistribution and use in source and binary forms, with or without \r
+ modification, are permitted provided that the following conditions are\r
+ met:\r
+\r
+ * Redistributions of source code must retain the above copyright notice, \r
+ this list of conditions and the following disclaimer.\r
+ \r
+ * Redistributions in binary form must reproduce the above copyright\r
+ notice, this list of conditions and the following disclaimer in the \r
+ documentation and/or other materials provided with the distribution.\r
+ \r
+ * Neither the name of Adobe Systems Incorporated nor the names of its \r
+ contributors may be used to endorse or promote products derived from \r
+ this software without specific prior written permission.\r
+\r
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS\r
+ IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,\r
+ THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR\r
+ PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR \r
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,\r
+ EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,\r
+ PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR\r
+ PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF\r
+ LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING\r
+ NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS\r
+ SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\r
+*/\r
+\r
+package com.adobe.net\r
+{\r
+ /**\r
+ * The URI class cannot know about DNS aliases, virtual hosts, or\r
+ * symbolic links that may be involved. The application can provide\r
+ * an implementation of this interface to resolve the URI before the\r
+ * URI class makes any comparisons. For example, a web host has\r
+ * two aliases:\r
+ * \r
+ * <p><code>\r
+ * http://www.site.com/\r
+ * http://www.site.net/\r
+ * </code></p>\r
+ * \r
+ * <p>The application can provide an implementation that automatically\r
+ * resolves site.net to site.com before URI compares two URI objects.\r
+ * Only the application can know and understand the context in which\r
+ * the URI's are being used.</p>\r
+ * \r
+ * <p>Use the URI.resolver accessor to assign a custom resolver to\r
+ * the URI class. Any resolver specified is global to all instances\r
+ * of URI.</p>\r
+ * \r
+ * <p>URI will call this before performing URI comparisons in the\r
+ * URI.getRelation() and URI.getCommonParent() functions.\r
+ * \r
+ * @see URI.getRelation\r
+ * @see URI.getCommonParent\r
+ * \r
+ * @langversion ActionScript 3.0\r
+ * @playerversion Flash 9.0\r
+ */\r
+ public interface IURIResolver\r
+ {\r
+ /**\r
+ * Implement this method to provide custom URI resolution for\r
+ * your application.\r
+ * \r
+ * @langversion ActionScript 3.0\r
+ * @playerversion Flash 9.0\r
+ */\r
+ function resolve(uri:URI) : URI;\r
+ }\r
+}
\ No newline at end of file