/home/gian/Progetti/falcon/core/include/falcon/uri.h

Go to the documentation of this file.

/*
   FALCON - The Falcon Programming Language.
   FILE: uri.h

   RFC 3986 - Uniform Resource Identifier
   -------------------------------------------------------------------
   Author: Giancarlo Niccolai
   Begin: Sun, 17 Feb 2008 12:23:28 +0100

   -------------------------------------------------------------------
   (C) Copyright 2004: the FALCON developers (see list in AUTHORS file)

   See LICENSE file for licensing details.
*/

#ifndef FALCON_URI_H
#define FALCON_URI_H

#include <falcon/setup.h>
#include <falcon/string.h>
#include <falcon/path.h>
#include <falcon/genericmap.h>

namespace Falcon
{

class FALCON_DYN_CLASS URI: public BaseAlloc
{
   String m_original;

   mutable String m_encoded;

   bool m_bValid;

   String m_scheme;

   // Authority ----------------------
   String m_userInfo;

   String m_host;

   String m_port;

   Path m_path;

   mutable String m_query;

   Map *m_queryMap;

   MapIterator m_queryIter;

   String m_fragment;

   void encode( const String &u );

   bool internal_parseQuery( const String &str, uint32 pos, bool parseQuery , bool bDecode );

   bool internal_parseFragment( uint32 pos );

   bool internal_parse( const String &newUri, bool parseQuery, bool decode = true );

   friend class Path;
   
public:

   URI();

   URI( const String &suri );

   URI( const URI &other );

   virtual ~URI();

   bool parse( const String &newUri, bool parseQuery = false, bool decode = true );

   bool parseQuery( bool decode = true );

   bool parseQuery( const String &q, bool decode = true )
   {
      query( q );
      return parseQuery( decode );
   }

   void query( const String &q, bool encode = false );

   const String &query() const { return m_query; }

   const String &makeQuery() const;

   const String &get( bool synthQuery = true ) const;

   //  A bit of parsing support.
   static bool isResDelim( uint32 chr );

   static bool isMainDelim( uint32 chr );

   static bool isGenDelim( uint32 chr );

   static bool isSubDelim( uint32 chr );

   //static void normalize( const String &part, String &result );

   const String &scheme() const { return m_scheme; }

   void scheme( const String &s );

   const String &userInfo() const { return m_userInfo; }

   void userInfo( const String &s );

   const String &host() const { return m_host; }

   void host( const String &h );

   const String &port() const { return m_port; }

   void port( const String &h );

   const String &path() const { return m_path.get(); }

   const Path &pathElement() const { return m_path; }
   
   Path &pathElement() { return m_path; }

   void path( const String &p );

   void path( const Path &p );

   bool hasField( const String &f ) const ;

   bool getField( const String &key, String &value ) const;

   void setField( const String &key, const String &value );

   bool removeField( const String &key );

   bool firstField( String &key, String &value );

   bool nextField( String &key, String &value );

   uint32 fieldCount();

   const String &fragment() const { return m_fragment; }

   void fragment( const String &s );

   void clear();

   bool isValid() const { return m_bValid; }

   static void URLEncode( const String &source, String &target );
   static String URLEncode( const String &source )
   {
      String t;
      URLEncode( source, t );
      return t;
   }

   static bool URLDecode( const String &source, String &target );
   static String URLDecode( const String &source )
   {
      String t;
      URLDecode( source, t );
      return t;
   }

   static unsigned char CharToHex( unsigned char ch )
   {
      return ch <= 9 ? '0' + ch : 'A' + (ch - 10);
   }

   static unsigned char HexToChar( unsigned char ch )
   {
      if ( ch >= '0' && ch <= '9' )
         return ch - '0';
      else if ( ch >= 'A' && ch <= 'F' )
         return ch - 'A'+ 10;
      else if ( ch >= 'a' && ch <= 'f' )
         return ch - 'a'+ 10;
      else
         return 0xFF;
   }
};

//==================================================
// Inline implementation
//

inline bool URI::isResDelim( uint32 chr )
{
   return isGenDelim( chr ) | isSubDelim( chr );
}

inline bool URI::isMainDelim( uint32 chr )
{
   return (chr == ':') | (chr == '?') | (chr == '#') | (chr == '@');
}

inline bool URI::isGenDelim( uint32 chr )
{
   return (chr == ':') | (chr == '/') | (chr == '?') |
          (chr == '#') | (chr == '[') | (chr == ']') |
          (chr == '@');
}

inline bool URI::isSubDelim( uint32 chr )
{
   return (chr == '!')  | (chr == '$') | (chr == '&') |
          (chr == '\'') | (chr == '(') | (chr == ')') |
          (chr == '*')  | (chr == '+') | (chr == ',') |
          (chr == ';')  | (chr == '=');
}

} // Falcon namespace

#endif

---