[网络协议]WIFI学习二（HTTP介绍）

简介

????????HTTP是Hypertext Transfer Protocol（超文本传输协议）的缩写。超文本传输协议是一种用于分布式、协作式和超媒体信息系统的应用层协议，是因特网上应用最为广泛的一种网络传输协议，所有的 WWW 文件都必须遵守这个标准。

????????HTTP 是为客户端与服务器之间的通信而设计的，但也可以用于其他目的。

????????HTTP 是一个基于 TCP/IP 通信协议来传递数据的（HTML 文件、图片文件、查询结果等）。

HTTP协议的请求及响应方式设计如下：

????????从图中可以看出，服务器端响应客户端请求后立刻断开连接，连接不会维持很久，即使同一个客户端再次发送请求，服务端也无法辨认出是否是原先的那个客户端发出的请求，会以相同的方式处理新的请求。

HTTP三点注意事项：

????????HTTP是无连接：无连接的含义是限制每次连接只处理一个请求。服务器处理完客户的请求，并收到客户的应答后，即断开连接。采用这种方式可以节省传输时间。

????????HTTP是媒体独立的：这意味着，只要客户端和服务器知道如何处理的数据内容，任何类型的数据都可以通过HTTP发送。客户端以及服务器指定使用适合的MIME-type内容类型。

????????HTTP是无状态：HTTP协议是无状态协议。无状态是指协议对于事务处理没有记忆能力。缺少状态意味着如果后续处理需要前面的信息，则它必须重传，这样可能导致每次连接传送的数据量增大。另一方面，在服务器不需要先前信息时它的应答就较快。

HTTP请求

????????HTTP请求是客户端向服务端发送请求消息，请求消息可以分为请求行(request line)、消息头(header)、消息体(message)三个部分.

?

????????请求行由请求方法字段、URL字段和HTTP协议版本字段3个字段组成，它们用空格分隔。例如，GET /index.html HTTP/1.1。

????????根据HTTP标准，HTTP请求可以使用多种请求方法。

HTTP1.0定义了三种请求方法： GET, POST 和 HEAD方法。

HTTP1.1新增了五种请求方法：OPTIONS, PUT, DELETE, TRACE 和 CONNECT 方法。

目前大部分只支持GET和POST方法。GET用于请求数据，POST主要用于传输数据；

?消息头包括一些访问的域名、用户代理、Cookie等信息；

?

????????消息体就是请求的数据，仅在POST方式请求时候输入。

HTTP响应

????????HTTP响应是指服务端根据客户端发送的请求中的动作要求做出具体的动作，然后将结果返回给客户端。 HTTP响应消息可以分为状态行、头信息、消息体三个部分；状态行含有请求的状态信息，这是其与请求消息相比最大的区别。

?

?响应的头信息包括如下：

相关函数介绍

http_get() 从服务器中读取数据

GET方法要求服务器将URL定位的资源放在响应报文的数据部分，回送给客户端。

函数原型

HTTPCLIENT_RESULT httpclient_get(httpclient_t *client, char *url, httpclient_data_t *client_data);

参数：

Client：

指向http_client的指针

typedef struct {

    int socket;                     /**< Socket ID. */

    int remote_port;                /**< HTTP or HTTPS port. */

    int response_code;              /**< Response code. */

    char *header;                   /**< Request custom header. */

    char *auth_user;                /**< Username for basic authentication. */

    char *auth_password;            /**< Password for basic authentication. */

    bool is_http;                   /**< Http connection? if 1, http; if 0, https. */

#ifdef MTK_HTTPCLIENT_SSL_ENABLE

    const char *server_cert;        /**< Server certification. */

    const char *client_cert;        /**< Client certification. */

    const char *client_pk;          /**< Client private key. */

    int server_cert_len;            /**< Server certification lenght, server_cert buffer size. */

    int client_cert_len;            /**< Client certification lenght, client_cert buffer size. */

    int client_pk_len;              /**< Client private key lenght, client_pk buffer size. */

    void *ssl;                      /**< Ssl content. */

#endif

#ifdef HTTPCLIENT_REDIRECT

    int redirect_times;             /**< Current redirection times. */

#endif

} httpclient_t;

Url:

就是平时所说的“网址”

client_data：

/** @brief   This structure defines the HTTP data structure.  */

typedef struct {

    bool is_more;                /**< Indicates if more data needs to be retrieved. */

    bool is_chunked;             /**< Response data is encoded in portions/chunks.*/

    int retrieve_len;            /**< Content length to be retrieved. */

    int response_content_len;    /**< Response content length. */

    int content_block_len;       /**< The content length of one block. */

    int post_buf_len;            /**< Post data length. */

    int response_buf_len;        /**< Response body buffer length. */

    int header_buf_len;          /**< Response head buffer lehgth. */

    char *post_content_type;     /**< Content type of the post data. */

    char *post_buf;              /**< User data to be posted. */

    char *response_buf;          /**< Buffer to store the response body data. */

    char *header_buf;            /**< Buffer to store the response head data. */

    // Range Feature

    int range_enable;            /**< Indicates use range request or not. */

    int range_begin;             /**< The source begin if range_enable is 1. */

    int range_end;               /**< The source end if range_enable is 1. */

    int range_len;               /**< The source length if range_enable is 1. */

} httpclient_data_t;

????????该参数中需要关注的是response_buf和response_buf_len参数。因为需要获取Http数据，所以参数需要有接受数据的缓冲区以及长度。

返回值：

/** @brief   This enumeration defines the API return type.  */

typedef enum {

    HTTPCLIENT_ERROR_PARSE = -6,           /**< A URL parse error occurred. */

    HTTPCLIENT_UNRESOLVED_DNS = -5,        /**< Could not resolve the hostname. */

    HTTPCLIENT_ERROR_PRTCL = -4,           /**< A protocol error occurred. */

    HTTPCLIENT_ERROR = -3,                 /**< An unknown error occurred. */

    HTTPCLIENT_CLOSED = -2,                /**< Connection was closed by a remote host. */

    HTTPCLIENT_ERROR_CONN = -1,            /**< Connection failed. */

    HTTPCLIENT_OK = 0,                     /**< The operation was successful. */

    HTTPCLIENT_RETRIEVE_MORE_DATA = 1      /**< More data needs to be retrieved. */

} HTTPCLIENT_RESULT;

实例：

char *url = "https://www.baidu.com/";

httpclient_t client = {0};

httpclient_data_t client_data = {0};

char *buf = NULL;

buf = pvPortMalloc(BUF_SIZE);

if (buf == NULL) {

    printf("Malloc failed.\r\n");

     return;

}

memset(buf, 0, sizeof(buf));

client_data.response_buf = buf;  //Sets a buffer to store the result.

client_data.response_buf_len = BUF_SIZE;  //Sets the buffer size.

httpclient_get(&client, url, &client_data);

printf("Data received: %s\r\n", client_data.response_buf);

http_post() 推送数据到服务器

该函数向指定资源提交数据进行处理。

函数原型：

HTTPCLIENT_RESULT httpclient_post(httpclient_t *client, char *url, httpclient_data_t *client_data);

参数：

Client：

同上

Url：

网址

client_data：

这里需要注意char *post_content_type参数

Content-type的类型

常见的媒体格式类型：

        text/html ： HTML格式

        text/plain ：纯文本格式      

        text/xml ：  XML格式

        image/gif ：gif图片格式    

        image/jpeg ：jpg图片格式

        image/png：png图片格式

以applicaton开头的媒体类型：

    application/json    ： JSON数据格式

    application/xhtml+xml ：XHTML格式

    application/xml     ： XML数据格式

    application/atom+xml  ：Atom XML聚合格式    

    application/pdf       ：pdf格式  

    application/javascript ：js格式

    application/msword  ： Word文档格式

    application/octet-stream ： 二进制流数据（如常见的文件下载）

    application/x-www-form-urlencoded ：form表单默认的数据格式类型，form表单数据被编码为key/value格式发送到服务器。

返回值：

/** @brief   This enumeration defines the API return type.  */

typedef enum {

    HTTPCLIENT_ERROR_PARSE = -6,           /**< A URL parse error occurred. */

    HTTPCLIENT_UNRESOLVED_DNS = -5,        /**< Could not resolve the hostname. */

    HTTPCLIENT_ERROR_PRTCL = -4,           /**< A protocol error occurred. */

    HTTPCLIENT_ERROR = -3,                 /**< An unknown error occurred. */

    HTTPCLIENT_CLOSED = -2,                /**< Connection was closed by a remote host. */

    HTTPCLIENT_ERROR_CONN = -1,            /**< Connection failed. */

    HTTPCLIENT_OK = 0,                     /**< The operation was successful. */

    HTTPCLIENT_RETRIEVE_MORE_DATA = 1      /**< More data needs to be retrieved. */

} HTTPCLIENT_RESULT;

实例：

char *url = "https://api.mediatek.com/mcs/v2/devices/D0n2yhrl/datapoints.csv";

char *header = "deviceKey:FZoo0S07CpwUHcrt\r\n";

char *content_type = "text/csv";

char *post_data = "1,,I am string!";

httpclient_t client = {0};

httpclient_data_t client_data = {0};

char *buf = NULL;

buf = pvPortMalloc(BUF_SIZE);

if (buf == NULL) {

printf("Malloc failed.\r\n");

    return;

}

memset(buf, 0, sizeof(buf));

client_data.response_buf = buf;  //Sets a buffer to store the result.

client_data.response_buf_len = BUF_SIZE;  //Sets the buffer size.

httpclient_set_custom_header(&client, header);  //Sets the custom header if needed.

client_data.post_buf = post_data;  //Sets the user data to be posted.

client_data.post_buf_len = strlen(post_data);  //Sets the post data length.

client_data.post_content_type = content_type;  //Sets the content type.

httpclient_post(&client, url, &client_data);

printf("Data received: %s\r\n", client_data.response_buf);

????????这里httpclient_set_custom_header(&client, header)函数是配置请求头，通常用于http的请求和鉴权。

????????注：POST的安全性要比GET的安全性高。注意：这里所说的安全性和上面GET提到的“安全”不是同个概念。上面“安全”的含义仅仅是不作数据修改，而这里安全的含义是真正的Security的含义，比如：通过GET提交数据，用户名和密码将明文出现在URL上，因为(1)登录页面有可能被浏览器缓存， (2)其他人查看浏览器的历史纪录，那么别人就可以拿到你的账号和密码了。而通过POST提交数据是经过加密的。

?

?

超强干货来袭

云风专访：近40年码龄，通宵达旦的技术人生