GitHub/libevent
1
0
Fork 0
mirror of https://github.com/libevent/libevent.git synced 2025-01-31 09:12:55 +08:00
Code Issues Packages Projects Releases Wiki Activity

document chunked replies plus fix doxygen warnings

Browse Source 
svn:r815
This commit is contained in:
Niels Provos 2008-05-13 03:42:47 +00:00
parent 0cafdeb6f5
commit ef0221cc39
2 changed files with 54 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
event.h
View File

@ -144,7 +144,7 @@
evdns.h evdns.h
Asynchronous DNS resolution Asynchronous DNS resolution
evhttp.h event2/http.h
An embedded libevent-based HTTP server An embedded libevent-based HTTP server
evrpc.h evrpc.h

58
include/event2/http.h
View File

@ -45,7 +45,7 @@ extern "C" {
struct evbuffer; struct evbuffer;
struct event_base; struct event_base;
/** @file evhttp.h /** @file http.h
* *
* Basic support for HTTP serving. * Basic support for HTTP serving.
* *
@ -198,6 +198,11 @@ void evhttp_send_error(struct evhttp_request *req, int error,
/** /**
* Send an HTML reply to the client. * Send an HTML reply to the client.
* *
* The body of the reply consists of the data in databuf. After calling
* evhttp_send_reply() databuf will be empty, but the buffer is still
* owned by the caller and needs to be deallocated by the caller if
* necessary.
*
* @param req a request object * @param req a request object
* @param code the HTTP response code to send * @param code the HTTP response code to send
* @param reason a brief message to send with the response code * @param reason a brief message to send with the response code
@ -207,15 +212,58 @@ void evhttp_send_reply(struct evhttp_request *req, int code,
const char *reason, struct evbuffer *databuf); const char *reason, struct evbuffer *databuf);
/* Low-level response interface, for streaming/chunked replies */ /* Low-level response interface, for streaming/chunked replies */
void evhttp_send_reply_start(struct evhttp_request *, int, const char *);
void evhttp_send_reply_chunk(struct evhttp_request *, struct evbuffer *); /**
void evhttp_send_reply_end(struct evhttp_request *); Initiate a reply that uses Transfer-Encoding chunked.
This allows the caller to stream the reply back to the client and is
useful when either not all of the reply data is immediately available
or when sending very large replies.
The caller needs to supply data chunks with evhttp_send_reply_chunk()
and complete the reply by calling evhttp_send_reply_end().
@param req a request object
@param code the HTTP response code to send
@param reason a brief message to send with the response code
*/
void evhttp_send_reply_start(struct evhttp_request *req, int code,
const char *reason);
/**
Send another data chunk as part of an ongoing chunked reply.
The reply chunk consists of the data in databuf. After calling
evhttp_send_reply_chunk() databuf will be empty, but the buffer is
still owned by the caller and needs to be deallocated by the caller
if necessary.
@param req a request object
@param databuf the data chunk to send as part of the reply.
*/
void evhttp_send_reply_chunk(struct evhttp_request *req,
struct evbuffer *databuf);
/**
Complete a chunked reply.
@param req a request object
*/
void evhttp_send_reply_end(struct evhttp_request *req);
/* /*
* Interfaces for making requests * Interfaces for making requests
*/ */
enum evhttp_cmd_type { EVHTTP_REQ_GET, EVHTTP_REQ_POST, EVHTTP_REQ_HEAD, EVHTTP_REQ_PUT, EVHTTP_REQ_DELETE };
/** the different request types supported by evhttp */
enum evhttp_cmd_type {
EVHTTP_REQ_GET,
EVHTTP_REQ_POST,
EVHTTP_REQ_HEAD,
EVHTTP_REQ_PUT,
EVHTTP_REQ_DELETE
};
/** a request object can represent either a request or a reply */
enum evhttp_request_kind { EVHTTP_REQUEST, EVHTTP_RESPONSE }; enum evhttp_request_kind { EVHTTP_REQUEST, EVHTTP_RESPONSE };
/** /**