--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/tango/tango/net/model/UriView.d	Fri Jan 11 17:57:40 2008 +0100
@@ -0,0 +1,137 @@
+/*******************************************************************************
+
+        copyright:      Copyright (c) 2004 Kris Bell. All rights reserved
+
+        license:        BSD style: $(LICENSE)
+        
+        version:        Initial release: April 2004      
+        
+        author:         Kris
+
+*******************************************************************************/
+
+module tango.net.model.UriView;
+
+/*******************************************************************************
+
+        Implements an RFC 2396 compliant URI specification. See 
+        <A HREF="http://ftp.ics.uci.edu/pub/ietf/uri/rfc2396.txt">this page</A>
+        for more information. 
+
+        The implementation fails the spec on two counts: it doesn't insist
+        on a scheme being present in the UriView, and it doesn't implement the
+        "Relative References" support noted in section 5.2. 
+        
+        Note that IRI support can be implied by assuming each of userinfo, path, 
+        query, and fragment are UTF-8 encoded 
+        (see <A HREF="http://www.w3.org/2001/Talks/0912-IUC-IRI/paper.html">
+        this page</A> for further details).
+
+        Use a Uri instead where you need to alter specific uri attributes. 
+
+*******************************************************************************/
+
+abstract class UriView
+{
+        public enum {InvalidPort = -1}
+
+        /***********************************************************************
+        
+                Return the default port for the given scheme. InvalidPort
+                is returned if the scheme is unknown, or does not accept
+                a port.
+
+        ***********************************************************************/
+
+        abstract int getDefaultPort (char[] scheme);
+
+        /***********************************************************************
+        
+                Return the parsed scheme, or null if the scheme was not
+                specified
+
+        ***********************************************************************/
+
+        abstract char[] getScheme();
+
+        /***********************************************************************
+        
+                Return the parsed host, or null if the host was not
+                specified
+
+        ***********************************************************************/
+
+        abstract char[] getHost();
+
+        /***********************************************************************
+        
+                Return the parsed port number, or InvalidPort if the port
+                was not provided.
+
+        ***********************************************************************/
+
+        abstract int getPort();
+
+        /***********************************************************************
+        
+                Return a valid port number by performing a lookup on the 
+                known schemes if the port was not explicitly specified.
+
+        ***********************************************************************/
+
+        abstract int getValidPort();
+
+        /***********************************************************************
+        
+                Return the parsed userinfo, or null if userinfo was not 
+                provided.
+
+        ***********************************************************************/
+
+        abstract char[] getUserInfo();
+
+        /***********************************************************************
+        
+                Return the parsed path, or null if the path was not 
+                provided.
+
+        ***********************************************************************/
+
+        abstract char[] getPath();
+
+        /***********************************************************************
+        
+                Return the parsed query, or null if a query was not 
+                provided.
+
+        ***********************************************************************/
+
+        abstract char[] getQuery();
+
+        /***********************************************************************
+        
+                Return the parsed fragment, or null if a fragment was not 
+                provided.
+
+        ***********************************************************************/
+
+        abstract char[] getFragment();
+
+        /***********************************************************************
+        
+                Return whether or not the UriView scheme is considered generic.
+
+        ***********************************************************************/
+
+        abstract bool isGeneric ();
+
+        /***********************************************************************
+        
+                Emit the content of this UriView. Output is constructed per
+                RFC 2396.
+
+        ***********************************************************************/
+
+        abstract char[] toString ();
+}
+