UrlUtils.hpp

Go to the documentation of this file.

/*---------------------------------------------------------------------\
|                                                                      |
|                     _     _   _   _     __     _                     |
|                    | |   | | | \_/ |   /  \   | |                    |
|                    | |   | | | |_| |  / /\ \  | |                    |
|                    | |__ | | | | | | / ____ \ | |__                  |
|                    |____||_| |_| |_|/ /    \ \|____|                 |
|                                                                      |
|                             core library                             |
|                                                                      |
|                                         (C) SUSE Linux Products GmbH |
\----------------------------------------------------------------------/

  File:       UrlUtils.hpp

  Author:     Marius Tomaschewski
  Maintainer: Marius Tomaschewski

/-*/
#ifndef   CA_MGM_URLUTILS_HPP
#define   CA_MGM_URLUTILS_HPP

#include <ca-mgm/config.h>
#include <ca-mgm/ByteBuffer.hpp>
#include <ca-mgm/Exception.hpp>
#include <ca-mgm/String.hpp>

#include <map>
#include <vector>

// -------------------------------------------------------------------
namespace CA_MGM_NAMESPACE
{
namespace url
{

// -------------------------------------------------------------------
CA_MGM_DECLARE_EXCEPTION (Url);


// -------------------------------------------------------------------
CA_MGM_DECLARE_EXCEPTION2(UrlParsing,      UrlException);


// -------------------------------------------------------------------
CA_MGM_DECLARE_EXCEPTION2(UrlDecoding,     UrlException);


// -------------------------------------------------------------------
CA_MGM_DECLARE_EXCEPTION2(UrlBadComponent, UrlException);


// -------------------------------------------------------------------
CA_MGM_DECLARE_EXCEPTION2(UrlNotAllowed,   UrlException);


// -------------------------------------------------------------------
CA_MGM_DECLARE_EXCEPTION2(UrlNotSupported, UrlException);


// -------------------------------------------------------------------
typedef std::map<std::string,std::string>       ParamMap;


// -------------------------------------------------------------------
struct UrlComponents
{
        std::string  scheme;
        std::string  authority;
        std::string     pathdata;
        std::string  querystr;
        std::string  fragment;
        bool            has_scheme;
        bool            has_authority;
        bool            has_querystr;
        bool            has_fragment;
};


// -------------------------------------------------------------------
struct UrlAuthority
{
        std::string  user;
        std::string  pass;
        std::string  host;
        std::string  port;
        bool            has_user;
        bool            has_pass;
        bool            has_port;
};


// -------------------------------------------------------------------
typedef enum {
    E_ENCODED, 
    E_DECODED  
} EEncoding;


// -------------------------------------------------------------------
std::string
encode(const std::string    &str,
       const std::string    &safe = "",
       ca_mgm::url::EEncoding   eflag = E_DECODED);


// -------------------------------------------------------------------
std::string
encode_buf(const ca_mgm::ByteBuffer &buf,
           const std::string    &safe = "",
           ca_mgm::url::EEncoding   eflag = E_DECODED);


// -------------------------------------------------------------------
std::string
decode(const std::string &str);


// -------------------------------------------------------------------
ca_mgm::ByteBuffer
decode_buf(const std::string &str, bool allowNUL);


// -------------------------------------------------------------------
std::string
encode_octet(const unsigned char c);


// -------------------------------------------------------------------
int
decode_octet(const char *hex);


// -------------------------------------------------------------------
std::vector<std::string>
split(const std::string &pstr,
      const std::string &psep);


// -------------------------------------------------------------------
ca_mgm::url::ParamMap
split(const std::string &pstr,
      const std::string &psep,
      const std::string &vsep,
      EEncoding            eflag = E_ENCODED);


// -------------------------------------------------------------------
std::string
join(const std::vector<std::string> &parr,
     const std::string      &psep);


// -------------------------------------------------------------------
std::string
join(const ca_mgm::url::ParamMap &pmap,
     const std::string       &psep,
     const std::string       &vsep,
     const std::string       &safe);


// -------------------------------------------------------------------
/*
 * Parse the @p url string by common URL separator characters
 * and return an url main component structure.
 * @returns An url components structure.
 */
UrlComponents
parse_url_string(const std::string &url);


// -------------------------------------------------------------------
/*
 * Parse the @p authority string and return the URL authority
 * components structure.
 * @returns An string array containing authority components.
 */
UrlAuthority
parse_url_authority(const std::string &authority);


// -------------------------------------------------------------------
}      // End url namespace
}      // End of CA_MGM_NAMESPACE
#endif // CA_MGM_URLUTILS_HPP
// vim: set ts=8 sts=8 sw=8 ai noet: