You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
111 lines
3.0 KiB
C
111 lines
3.0 KiB
C
8 years ago
|
/*
|
||
|
|
* 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 <stddef.h>
|
||
|
|
|
||
|
|
#include <rtthread.h>
|
||
|
|
|
||
|
|
#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
|