src/afb-hreq.h

   1 /*
   2  * Copyright (C) 2016 "IoT.bzh"
   3  * Author: José Bollo <jose.bollo@iot.bzh>
   4  *
   5  * Licensed under the Apache License, Version 2.0 (the "License");
   6  * you may not use this file except in compliance with the License.
   7  * You may obtain a copy of the License at
   8  *
   9  *   http://www.apache.org/licenses/LICENSE-2.0
  10  *
  11  * Unless required by applicable law or agreed to in writing, software
  12  * distributed under the License is distributed on an "AS IS" BASIS,
  13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14  * See the License for the specific language governing permissions and
  15  * limitations under the License.
  16  */
  17
  18 #pragma once
  19
  20 struct AFB_clientCtx;
  21 struct json_object;
  22 struct hreq_data;
  23 struct afb_hsrv;
  24 struct afb_req_itf;
  25
  26 extern const struct afb_req_itf afb_hreq_req_itf;
  27
  28 struct afb_hreq {
  29         /*
  30          * CAUTION: 'context' field should be the first because there
  31          * is an implicit convertion to struct afb_context
  32          */
  33         struct afb_context context;
  34         int refcount;
  35         struct afb_hsrv *hsrv;
  36         const char *cacheTimeout;
  37         struct MHD_Connection *connection;
  38         int method;
  39         int reqid;
  40         int scanned;
  41         int suspended;
  42         int replied;
  43         const char *version;
  44         const char *lang;
  45         const char *url;
  46         size_t lenurl;
  47         const char *tail;
  48         size_t lentail;
  49         struct MHD_PostProcessor *postform;
  50         struct hreq_data *data;
  51         struct json_object *json;
  52         int upgrade;
  53 };
  54
  55 extern int afb_hreq_unprefix(struct afb_hreq *request, const char *prefix, size_t length);
  56
  57 extern int afb_hreq_valid_tail(struct afb_hreq *request);
  58
  59 extern void afb_hreq_reply_error(struct afb_hreq *request, unsigned int status);
  60
  61 extern int afb_hreq_reply_file_if_exist(struct afb_hreq *request, int dirfd, const char *filename);
  62
  63 extern int afb_hreq_reply_file(struct afb_hreq *request, int dirfd, const char *filename);
  64
  65 extern void afb_hreq_redirect_to(struct afb_hreq *request, const char *url, int add_query_part);
  66
  67 extern int afb_hreq_redirect_to_ending_slash_if_needed(struct afb_hreq *hreq);
  68
  69 extern const char *afb_hreq_get_cookie(struct afb_hreq *hreq, const char *name);
  70
  71 extern const char *afb_hreq_get_header(struct afb_hreq *hreq, const char *name);
  72
  73 extern const char *afb_hreq_get_argument(struct afb_hreq *hreq, const char *name);
  74
  75 extern int afb_hreq_post_add_file(struct afb_hreq *hreq, const char *name, const char *file, const char *data, size_t size);
  76
  77 extern int afb_hreq_post_add(struct afb_hreq *hreq, const char *name, const char *data, size_t size);
  78
  79 extern struct afb_req afb_hreq_to_req(struct afb_hreq *hreq);
  80
  81 extern int afb_hreq_init_context(struct afb_hreq *hreq);
  82
  83 extern int afb_hreq_init_cookie(int port, const char *path, int maxage);
  84
  85 extern void afb_hreq_reply_static(struct afb_hreq *hreq, unsigned status, size_t size, const char *buffer, ...);
  86
  87 extern void afb_hreq_reply_copy(struct afb_hreq *hreq, unsigned status, size_t size, const char *buffer, ...);
  88
  89 extern void afb_hreq_reply_free(struct afb_hreq *hreq, unsigned status, size_t size, char *buffer, ...);
  90
  91 extern void afb_hreq_reply_empty(struct afb_hreq *hreq, unsigned status, ...);
  92
  93 extern int afb_hreq_init_download_path(const char *directory);
  94
  95 extern void afb_hreq_addref(struct afb_hreq *hreq);
  96
  97 extern void afb_hreq_unref(struct afb_hreq *hreq);
  98