src/lib-http/http-url.h

	http-url.h revision 0dffa25d211be541ee3c953b23566a1a990789df
#ifndef HTTP_URL_H
#define HTTP_URL_H

#include "net.h"
#include "uri-util.h"

struct http_request_target;

struct http_url {
    /* server */
    struct uri_host host;
    in_port_t port;

    /* userinfo (not parsed by default) */
    const char *user;
    const char *password;

    /* path */
    const char *path;

    /* ?query (still encoded) */
    const char *enc_query;

    /* #fragment (still encoded) */
    const char *enc_fragment;

    bool have_ssl:1;
};

/*
 * HTTP URL parsing
 */

enum http_url_parse_flags {
    /* Scheme part 'http:' is already parsed externally. This implies that
       this is an absolute HTTP URL. */
    HTTP_URL_PARSE_SCHEME_EXTERNAL  = 0x01,
    /* Allow '#fragment' part in HTTP URL */
    HTTP_URL_ALLOW_FRAGMENT_PART = 0x02,
    /* Allow 'user:password@' part in HTTP URL */
    HTTP_URL_ALLOW_USERINFO_PART = 0x04
};

int http_url_parse(const char *url, struct http_url *base,
           enum http_url_parse_flags flags, pool_t pool,
           struct http_url **url_r, const char **error_r);

int http_url_request_target_parse(const char *request_target,
    const char *host_header, pool_t pool,
    struct http_request_target *target, const char **error_r);

/*
 * HTTP URL manipulation
 */

void http_url_copy_authority(pool_t pool, struct http_url *dest,
    const struct http_url *src);
struct http_url *http_url_clone_authority(pool_t pool,
    const struct http_url *src);

void http_url_copy(pool_t pool, struct http_url *dest,
    const struct http_url *src);
void http_url_copy_with_userinfo(pool_t pool, struct http_url *dest,
    const struct http_url *src);

struct http_url *http_url_clone(pool_t pool,const struct http_url *src);
struct http_url *http_url_clone_with_userinfo(pool_t pool,
    const struct http_url *src);

/*
 * HTTP URL construction
 */

const char *http_url_create(const struct http_url *url);

const char *http_url_create_host(const struct http_url *url);
const char *http_url_create_authority(const struct http_url *url);
const char *http_url_create_target(const struct http_url *url);

void http_url_escape_path(string_t *out, const char *data);
void http_url_escape_param(string_t *out, const char *data);

#endif