it_bus/url.h

#ifndef _IT_BUS_URL_H_
#define _IT_BUS_URL_H_

// @Copyright 2004 IONA Technologies, Plc. All Rights Reserved.
//

#include <it_bus/types.h>
#include <it_dsa/hash_map.h>
#include <it_dsa/string_builder.h>

#ifndef IT_IOSTREAMS_FREE
#include <it_cal/iostream.h>
#endif

namespace IT_Bus
{
    class URLImpl;

    class IT_AFC_API MalformedURLException :
        public Exception
    {
      public:
        MalformedURLException(
            String message
        );

        virtual Exception*
        clone() const;
    
        virtual void
        rethrow() const;
    };
    
    class IT_AFC_API URL
    {
      public:
        URL();
        
        URL(
            const URL&      rhs
        );

        URL(
            const String&   url
        ) throw((MalformedURLException));

        URL(
            const URL&      context,
            const String&   location
        ) throw((MalformedURLException));

        URL(
            const String&   protocol,
            const String&   protocol_data
        ) throw((MalformedURLException));

        /*
         *  Constructor from protocol and data for use by internet URL only
         *
         *  URL("protocol", "host", port, "path")
         *  path must begin with a forward slash
         */
        URL(
            const String&   protocol,
            const String&   host,
            unsigned int    port,
            const String&   path
        ) throw((MalformedURLException));

        ~URL();

        URL& 
        operator=(
            const URL&      rhs
        ) throw(());

        Boolean operator==(
            const URL&      rhs
        ) const throw(());

        Boolean operator!=(
            const URL&      rhs
        ) const throw(());

        String
        get_host() const;

        String
        get_path() const;

        int
        get_port() const;

        String
        get_protocol() const;

        String
        get_protocol_data() const;

        String
        to_string() const;

        size_t hash() const;

        bool
        is_file() const;

      private:
        URLImpl*    m_impl;
    };


    struct IT_AFC_API URLHash
    {
        size_t
        operator()(
            const URL& to_hash
        )
        {
            return to_hash.hash();
        }
    };


    struct IT_AFC_API URLEq
    {
        Boolean
        operator()(
            const URL& a,
            const URL& b
        ) 
        {
            return a == b;
        }
    };

    template <class T>
    class URLMap : public IT_HashMap<URL, T, URLHash, URLEq>
    {
        // Complete.
    };
}

#ifndef IT_IOSTREAMS_FREE
inline IT_ostream&
operator<< (
    IT_ostream&         os,
    const IT_Bus::URL&  url
)
{
    return os << (const IT_String&)url.to_string();
}
#endif

inline IT_StringBuilder&
operator<< (
    IT_StringBuilder&   s,
    const IT_Bus::URL&  url
)
{
    return s << (const IT_String&)url.to_string();
}

#endif  

---