makes a function to ensure trailing slash
[src/app-framework-binder.git] / 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 *url;
45         size_t lenurl;
46         const char *tail;
47         size_t lentail;
48         struct MHD_PostProcessor *postform;
49         struct hreq_data *data;
50         struct json_object *json;
51         int upgrade;
52 };
53
54 extern int afb_hreq_unprefix(struct afb_hreq *request, const char *prefix, size_t length);
55
56 extern int afb_hreq_valid_tail(struct afb_hreq *request);
57
58 extern void afb_hreq_reply_error(struct afb_hreq *request, unsigned int status);
59
60 extern int afb_hreq_reply_file_if_exist(struct afb_hreq *request, int dirfd, const char *filename);
61
62 extern int afb_hreq_reply_file(struct afb_hreq *request, int dirfd, const char *filename);
63
64 extern void afb_hreq_redirect_to(struct afb_hreq *request, const char *url, int add_query_part);
65
66 extern int afb_hreq_redirect_to_ending_slash_if_needed(struct afb_hreq *hreq);
67
68 extern const char *afb_hreq_get_cookie(struct afb_hreq *hreq, const char *name);
69
70 extern const char *afb_hreq_get_header(struct afb_hreq *hreq, const char *name);
71
72 extern const char *afb_hreq_get_argument(struct afb_hreq *hreq, const char *name);
73
74 extern int afb_hreq_post_add_file(struct afb_hreq *hreq, const char *name, const char *file, const char *data, size_t size);
75
76 extern int afb_hreq_post_add(struct afb_hreq *hreq, const char *name, const char *data, size_t size);
77
78 extern struct afb_req afb_hreq_to_req(struct afb_hreq *hreq);
79
80 extern int afb_hreq_init_context(struct afb_hreq *hreq);
81
82 extern int afb_hreq_init_cookie(int port, const char *path, int maxage);
83
84 extern void afb_hreq_reply_static(struct afb_hreq *hreq, unsigned status, size_t size, const char *buffer, ...);
85
86 extern void afb_hreq_reply_copy(struct afb_hreq *hreq, unsigned status, size_t size, const char *buffer, ...);
87
88 extern void afb_hreq_reply_free(struct afb_hreq *hreq, unsigned status, size_t size, char *buffer, ...);
89
90 extern void afb_hreq_reply_empty(struct afb_hreq *hreq, unsigned status, ...);
91
92 extern int afb_hreq_init_download_path(const char *directory);
93
94 extern void afb_hreq_addref(struct afb_hreq *hreq);
95
96 extern void afb_hreq_unref(struct afb_hreq *hreq);
97