94 lines
3.1 KiB
C
94 lines
3.1 KiB
C
/*-
|
|
* Copyright 2012 Matthew Endsley
|
|
* All rights reserved
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted providing that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
|
|
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
|
* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
|
|
* IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
#ifndef HTTP_HTTP_H
|
|
#define HTTP_HTTP_H
|
|
|
|
#if defined(__cplusplus)
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* Callbacks for handling response data.
|
|
* realloc_scratch - reallocate memory, cannot fail. There will only
|
|
* be one scratch buffer. Implemnentation may take
|
|
* advantage of this fact.
|
|
* body - handle HTTP response body data
|
|
* header - handle an HTTP header key/value pair
|
|
* code - handle the HTTP status code for the response
|
|
*/
|
|
struct http_funcs {
|
|
void* (*realloc_scratch)(void* opaque, void* ptr, int size);
|
|
void (*body)(void* opaque, const char* data, int size);
|
|
void (*header)(void* opaque, const char* key, int nkey, const char* value, int nvalue);
|
|
void (*code)(void* opqaue, int code);
|
|
};
|
|
|
|
struct http_roundtripper {
|
|
struct http_funcs funcs;
|
|
void *opaque;
|
|
char *scratch;
|
|
int code;
|
|
int parsestate;
|
|
int contentlength;
|
|
int state;
|
|
int nscratch;
|
|
int nkey;
|
|
int nvalue;
|
|
int chunked;
|
|
};
|
|
|
|
/**
|
|
* Initializes a rountripper with the specified response functions. This must
|
|
* be called before the rt object is used.
|
|
*/
|
|
void http_init(struct http_roundtripper* rt, struct http_funcs, void* opaque);
|
|
|
|
/**
|
|
* Frees any scratch memory allocated during parsing.
|
|
*/
|
|
void http_free(struct http_roundtripper* rt);
|
|
|
|
/**
|
|
* Parses a block of HTTP response data. Returns zero if the parser reached the
|
|
* end of the response, or an error was encountered. Use http_iserror to check
|
|
* for the presence of an error. Returns non-zero if more data is required for
|
|
* the response.
|
|
*/
|
|
int http_data(struct http_roundtripper* rt, const char* data, int size, int* read);
|
|
|
|
/**
|
|
* Returns non-zero if a completed parser encounted an error. If http_data did
|
|
* not return non-zero, the results of this function are undefined.
|
|
*/
|
|
int http_iserror(struct http_roundtripper* rt);
|
|
|
|
#if defined(__cplusplus)
|
|
}
|
|
#endif
|
|
|
|
#endif
|