mirror of
https://github.com/cesanta/mongoose.git
synced 2024-12-27 06:51:04 +08:00
45f6612096
instead of always returning 'text/plain' To allow setting a different default mime-type the mg_get_mime_type() api has been extended to require an mg_server parameter. Note that using a static global as default mime type wouldn't have allowed us to control it via a configuration option because there is not global initialization phase and configuration options are provided (and specific) to each server instance. This means that different servers can be configured to use a different default mime-type (which is also a desired behaviour in many scenarios) when lookup fails.
120 lines
4.9 KiB
C
120 lines
4.9 KiB
C
// Copyright (c) 2004-2013 Sergey Lyubka <valenok@gmail.com>
|
|
// Copyright (c) 2013-2014 Cesanta Software Limited
|
|
// All rights reserved
|
|
//
|
|
// This library is dual-licensed: you can redistribute it and/or modify
|
|
// it under the terms of the GNU General Public License version 2 as
|
|
// published by the Free Software Foundation. For the terms of this
|
|
// license, see <http://www.gnu.org/licenses/>.
|
|
//
|
|
// You are free to use this library under the terms of the GNU General
|
|
// Public License, but WITHOUT ANY WARRANTY; without even the implied
|
|
// warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
// See the GNU General Public License for more details.
|
|
//
|
|
// Alternatively, you can license this library under a commercial
|
|
// license, as set out in <http://cesanta.com/>.
|
|
//
|
|
// NOTE: Detailed API documentation is at http://cesanta.com/#docs
|
|
|
|
#ifndef MONGOOSE_HEADER_INCLUDED
|
|
#define MONGOOSE_HEADER_INCLUDED
|
|
|
|
#define MONGOOSE_VERSION "5.2"
|
|
|
|
#include <stdio.h> // required for FILE
|
|
#include <stddef.h> // required for size_t
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif // __cplusplus
|
|
|
|
// This structure contains information about HTTP request.
|
|
struct mg_connection {
|
|
const char *request_method; // "GET", "POST", etc
|
|
const char *uri; // URL-decoded URI
|
|
const char *http_version; // E.g. "1.0", "1.1"
|
|
const char *query_string; // URL part after '?', not including '?', or NULL
|
|
|
|
char remote_ip[48]; // Max IPv6 string length is 45 characters
|
|
int remote_port; // Client's port
|
|
|
|
int num_headers; // Number of HTTP headers
|
|
struct mg_header {
|
|
const char *name; // HTTP header name
|
|
const char *value; // HTTP header value
|
|
} http_headers[30];
|
|
|
|
char *content; // POST (or websocket message) data, or NULL
|
|
size_t content_len; // content length
|
|
|
|
int is_websocket; // Connection is a websocket connection
|
|
int status_code; // HTTP status code for HTTP error handler
|
|
int wsbits; // First byte of the websocket frame
|
|
void *server_param; // Parameter passed to mg_add_uri_handler()
|
|
void *connection_param; // Placeholder for connection-specific data
|
|
};
|
|
|
|
struct mg_server; // Opaque structure describing server instance
|
|
typedef int (*mg_handler_t)(struct mg_connection *);
|
|
|
|
// Server management functions
|
|
struct mg_server *mg_create_server(void *server_param);
|
|
void mg_destroy_server(struct mg_server **);
|
|
const char *mg_set_option(struct mg_server *, const char *opt, const char *val);
|
|
unsigned int mg_poll_server(struct mg_server *, int milliseconds);
|
|
void mg_add_uri_handler(struct mg_server *, const char *uri, mg_handler_t);
|
|
void mg_set_http_error_handler(struct mg_server *, mg_handler_t);
|
|
const char **mg_get_valid_option_names(void);
|
|
const char *mg_get_option(const struct mg_server *server, const char *name);
|
|
void mg_set_listening_socket(struct mg_server *, int sock);
|
|
int mg_get_listening_socket(struct mg_server *);
|
|
void mg_iterate_over_connections(struct mg_server *, mg_handler_t, void *);
|
|
|
|
// Connection management functions
|
|
void mg_send_status(struct mg_connection *, int status_code);
|
|
void mg_send_header(struct mg_connection *, const char *name, const char *val);
|
|
void mg_send_data(struct mg_connection *, const void *data, int data_len);
|
|
void mg_printf_data(struct mg_connection *, const char *format, ...);
|
|
|
|
int mg_websocket_write(struct mg_connection *, int opcode,
|
|
const char *data, size_t data_len);
|
|
|
|
// Deprecated in favor of mg_send_* interface
|
|
int mg_write(struct mg_connection *, const void *buf, int len);
|
|
int mg_printf(struct mg_connection *conn, const char *fmt, ...);
|
|
|
|
|
|
const char *mg_get_header(const struct mg_connection *, const char *name);
|
|
const char *mg_get_mime_type(struct mg_server*, const char *file_name);
|
|
int mg_get_var(const struct mg_connection *conn, const char *var_name,
|
|
char *buf, size_t buf_len);
|
|
int mg_parse_header(const char *hdr, const char *var_name, char *buf, size_t);
|
|
int mg_parse_multipart(const char *buf, int buf_len,
|
|
char *var_name, int var_name_len,
|
|
char *file_name, int file_name_len,
|
|
const char **data, int *data_len);
|
|
|
|
// Utility functions
|
|
void *mg_start_thread(void *(*func)(void *), void *param);
|
|
char *mg_md5(char buf[33], ...);
|
|
int mg_authorize_digest(struct mg_connection *c, FILE *fp);
|
|
void mg_send_digest_auth_request(struct mg_connection *conn);
|
|
|
|
// Callback return codes
|
|
enum { MG_REPLY_TO_BE_CONTINUED, MG_REPLY_COMPLETED };
|
|
|
|
// HTTP client events
|
|
enum {
|
|
MG_CONNECT_SUCCESS, MG_CONNECT_FAILURE,
|
|
MG_DOWNLOAD_SUCCESS, MG_DOWNLOAD_FAILURE
|
|
};
|
|
int mg_connect(struct mg_server *, const char *host, int port, int use_ssl,
|
|
mg_handler_t handler, void *param);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif // __cplusplus
|
|
|
|
#endif // MONGOOSE_HEADER_INCLUDED
|