/* * File : webclient.h * COPYRIGHT (C) 2012-2013, Shanghai Real-Thread Technology Co., Ltd * * Change Logs: * Date Author Notes * 2013-05-05 Bernard the first version * 2015-11-14 aozima add content_length_remainder. */ #ifndef __WEBCLIENT_H__ #define __WEBCLIENT_H__ #include #include #define WEBCLIENT_HEADER_BUFSZ 4096 #define WEBCLIENT_RESPONSE_BUFSZ 4096 //typedef unsigned int size_t; enum WEBCLIENT_STATUS { WEBCLIENT_OK, WEBCLIENT_NOMEM, WEBCLIENT_NOSOCKET, WEBCLIENT_NOBUFFER, WEBCLIENT_CONNECT_FAILED, WEBCLIENT_DISCONNECT, WEBCLIENT_FILE_ERROR, WEBCLIENT_TIMEOUT, }; enum WEBCLIENT_METHOD { WEBCLIENT_USER_METHOD, WEBCLIENT_GET, WEBCLIENT_POST, }; struct webclient_session { /* the session socket */ int socket; /* the response code of HTTP request */ int response; /* transfer encoding */ char *transfer_encoding; int chunk_sz; int chunk_offset; /* content_type of HTTP response */ char* content_type; /* content_length of HTTP response */ int content_length; /* last modified timestamp of resource */ char* last_modified; /* location */ char* location; /* server host */ char* host; /* HTTP request */ char* request; /* private for webclient session. */ /* position of reading */ unsigned int position; /* remainder of content reading */ size_t content_length_remainder; }; struct webclient_session* webclient_open(const char* URI); struct webclient_session* webclient_open_position(const char* URI, int position); struct webclient_session* webclient_open_header(const char* URI, int method, const char* header, size_t header_sz); int webclient_close(struct webclient_session* session); int webclient_set_timeout(struct webclient_session* session, int millisecond); int webclient_read (struct webclient_session* session, unsigned char *buffer, size_t size); int webclient_write(struct webclient_session* session, const unsigned char *buffer, size_t size); int webclient_send_header(struct webclient_session* session, int method, const char *header, size_t header_sz); int webclient_connect(struct webclient_session* session, const char *URI); int webclient_handle_response(struct webclient_session* session); /* hight level APIs for HTTP client */ int webclient_response(struct webclient_session* session, void **response); struct webclient_session* webclient_open_custom(const char* URI, int method, const char* header, size_t header_sz, const char* data, size_t data_sz); int webclient_transfer(const char* URI, const char* header, size_t header_sz, const char* data, size_t data_sz, char *result, size_t result_sz); #ifdef RT_USING_DFS int webclient_get_file(const char* URI, const char* filename); int webclient_post_file(const char* URI, const char* filename, const char* form_data); #endif #endif