/* * File : webclient.h * COPYRIGHT (C) 2011-2018, Shanghai Real-Thread Technology Co., Ltd * * Change Logs: * Date Author Notes * 2013-05-05 Bernard the first version * 2013-06-10 Bernard fix the slow speed issue when download file. * 2015-11-14 aozima add content_length_remainder. * 2017-12-23 aozima update gethostbyname to getaddrinfo. * 2018-01-04 aozima add ipv6 address support. */ #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