sofia-sip/http_header.h

Go to the documentation of this file.

/*
 * This file is part of the Sofia-SIP package
 *
 * Copyright (C) 2005 Nokia Corporation.
 *
 * Contact: Pekka Pessi <pekka.pessi@nokia-email.address.hidden>
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public License
 * as published by the Free Software Foundation; either version 2.1 of
 * the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
 * 02110-1301 USA
 *
 */

#ifndef HTTP_HEADER_H

#define HTTP_HEADER_H

#ifndef SU_ALLOC_H
#include <sofia-sip/su_alloc.h>
#endif

#ifndef SU_TAG_H
#include <sofia-sip/su_tag.h>
#endif

#ifndef HTTP_H
#include <sofia-sip/http.h>
#endif

#ifndef MSG_HEADER_H
#include <sofia-sip/msg_header.h>
#endif

SOFIA_BEGIN_DECLS

/* ----------------------------------------------------------------------
 * 1) Macros
 */

#define HTTP_HEADER_INIT(h, http_class, size)                   \
  ((void)memset((h), 0, (size)),                                \
   (void)(((msg_common_t *)(h))->h_class = (http_class)),       \
   (h))

#define HTTP_METHOD_NAME(method, name) \
 ((method) == http_method_unknown ? (name) : http_method_name(method, name))

/* ----------------------------------------------------------------------
 * 2) Variables
 */

SOFIAPUBVAR char const http_method_name_get[];
SOFIAPUBVAR char const http_method_name_post[];
SOFIAPUBVAR char const http_method_name_head[];
SOFIAPUBVAR char const http_method_name_options[];
SOFIAPUBVAR char const http_method_name_put[];
SOFIAPUBVAR char const http_method_name_delete[];
SOFIAPUBVAR char const http_method_name_trace[];
SOFIAPUBVAR char const http_method_name_connect[];

SOFIAPUBVAR char const http_version_0_9[];

SOFIAPUBVAR char const http_version_1_0[];

SOFIAPUBVAR char const http_version_1_1[];

#define HTTP_VERSION_CURRENT http_version_1_1

/* ----------------------------------------------------------------------
 * 3) Prototypes
 */

SOFIAPUBFUN msg_mclass_t const *http_default_mclass(void);

SOFIAPUBFUN int http_request_complete(msg_t *msg);

SOFIAPUBFUN int http_message_complete(msg_t *msg, http_t *http);

SOFIAPUBFUN int http_add_dup(msg_t *, http_t *, http_header_t const *);

SOFIAPUBFUN int http_add_make(msg_t *msg, http_t *http,
                              msg_hclass_t *hc, char const *s);

SOFIAPUBFUN int http_add_format(msg_t *msg, http_t *http, msg_hclass_t *hc,
                                char const *fmt, ...);

SOFIAPUBFUN int http_add_tl(msg_t *msg, http_t *http,
                            tag_type_t tag, tag_value_t value, ...);

SOFIAPUBFUN int http_strip_hostport(url_t *url);

SOFIAPUBFUN int http_complete_response(msg_t *msg,
                                       int status, char const *phrase,
                                       http_t const *request);

SOFIAPUBFUN char const *http_method_name(http_method_t method,
                                         char const *name);

SOFIAPUBFUN http_method_t http_method_code(char const *name);

#if !SU_HAVE_INLINE
SOFIAPUBFUN http_t *http_object(msg_t *msg);
SOFIAPUBFUN int http_header_insert(msg_t *msg, http_t *http, http_header_t *h);
SOFIAPUBFUN int http_header_remove(msg_t *msg, http_t *http, http_header_t *h);
SOFIAPUBFUN char const *http_header_name(http_header_t const *h, int compact);
SOFIAPUBFUN void *http_header_data(http_header_t *h);
SOFIAPUBFUN http_content_length_t *http_content_length_create(su_home_t *home,
                                                              uint32_t n);
SOFIAPUBFUN http_payload_t *http_payload_create(su_home_t *home,
                                                void const *data, usize_t len);
SOFIAPUBFUN http_separator_t *http_separator_create(su_home_t *home);
#endif

SOFIAPUBFUN http_header_t *http_header_format(su_home_t *home, msg_hclass_t *,
                                              char const *fmt, ...);


SOFIAPUBFUN http_request_t *http_request_create(su_home_t *home,
                                                http_method_t method,
                                                const char *name,
                                                url_string_t const *url,
                                                char const *version);

SOFIAPUBFUN http_status_t *http_status_create(su_home_t *home,
                                              unsigned status,
                                              char const *phrase,
                                              char const *version);

SOFIAPUBFUN http_host_t *http_host_create(su_home_t *home,
                                          char const *host,
                                          char const *port);

SOFIAPUBFUN http_date_t *http_date_create(su_home_t *home, http_time_t t);

SOFIAPUBFUN http_expires_t *http_expires_create(su_home_t *home,
                                                http_time_t delta);

SOFIAPUBFUN int http_url_cmp(url_t const *a, url_t const *b);

SOFIAPUBFUN issize_t http_query_parse(char *query,
                                      /* char const *key, char **return_value, */
                                      ...);

/* ----------------------------------------------------------------------
 * 4) Inlined functions
 */

#if SU_HAVE_INLINE

su_inline
http_t *http_object(msg_t *msg)
{
  return (http_t *)msg_public(msg, HTTP_PROTOCOL_TAG);
}

su_inline
int http_header_insert(msg_t *msg, http_t *http, http_header_t *h)
{
  return msg_header_insert(msg, (msg_pub_t *)http, (msg_header_t *)h);
}

su_inline
int http_header_remove(msg_t *msg, http_t *http, http_header_t *h)
{
  return msg_header_remove(msg, (msg_pub_t *)http, (msg_header_t *)h);
}

su_inline
char const *http_header_name(http_header_t const *h, int compact)
{
  if (compact && h->sh_class->hc_short[0])
    return h->sh_class->hc_short;
  else
    return h->sh_class->hc_name;
}

su_inline
void *http_header_data(http_header_t *h)
{
  return h && h != HTTP_NONE ? h->sh_class->hc_size + (char *)h : NULL;
}

su_inline
http_content_length_t *http_content_length_create(su_home_t *home, uint32_t n)
{
  return msg_content_length_create(home, n);
}

su_inline
http_payload_t *http_payload_create(su_home_t *home, void const *data, isize_t len)
{
  return msg_payload_create(home, data, len);
}

su_inline
http_separator_t *http_separator_create(su_home_t *home)
{
  return msg_separator_create(home);
}
#endif

SOFIA_END_DECLS

#ifndef HTTP_PROTOS_H
#include <sofia-sip/http_protos.h>
#endif

#endif /* !defined(HTTP_HEADER_H) */