C++实现客户端与服务器的通信(一)：利用Mongoose搭建一个http服务器

项目需求：将本地摄像头的数据发送到远程服务器上，经过服务器上的算法处理后，将结果返回本地并显示出来。然而，远程服务器是无法直接调用本地摄像头的数据的，要实现这一功能，只好在远程搭建一个http服务端，与本地的客户端通过curl进行通信。

在实现这一功能之前，首先来实现一个相对简单的功能：在客户端以1s为间隔向服务端发送"Hello World!"并接收服务器的应答。

一、服务端程序

1. Mongoose的安装与配置

Mongoose是一个轻量化的web服务器，通过提供一个web接口给它，它可以嵌入到现有的工程当中。Mongoose的整个代码只有一个c文件和一个h文件，使用起来非常方便。

开源项目主页：http://code.google.com/p/mongoose/

github源码地址：https://github.com/cesanta/mongoose

到2018年7月，github上的Mongoose版本更新到了6.11，但是，考虑到新版本对接口函数做了不少修改，我还是使用更早的5.1版本。到项目主页上下载源码包mongoose-5.1.tgz并解压，里面的文件中只有mongoose.h和mongoose.c是我们需要的，无论在哪里搭建mongoose服务器，只需要将这两个文件和工程一起编译就可以使用mongoose的接口了。

2. 编写测试程序test.cpp

#include <stdio.h>
#include <string.h>
#include <time.h>
#include <iostream>

#include "mongoose.h"

using namespace std;

int env_handler(struct mg_connection *conn);

int main(int argc, char *argv[])
{
  struct mg_server* server;
  server = mg_create_server(NULL);                  // 初始化一个mongoose server
  mg_set_option(server, "listening_port", "8003");  // 设置端口号为8003
  mg_add_uri_handler(server, "/", env_handler);     // 设置回调函数
  printf("Starting on port %s ...\n", mg_get_option(server, "listening_port"));
  while (1) {
    mg_poll_server(server, 100);  // 超时时间（ms）
  }
  mg_destroy_server(&server);
  
  return 0;
}

int env_handler(struct mg_connection *conn) 
{
  static int counter = 0;
  counter++;
  printf("counter: %d\n", counter);

  const char * str_data = conn->content;  // 服务端收到的消息
  int str_len = conn->content_len;        // 服务端收到的消息长度
  string str(str_data, str_len);
  mg_printf(conn, "Received: %s, %d", str.c_str(), counter);
  
  return 0;
}

这段程序表示服务器在收到消息后，向客户端返回一个应答字符串的过程。

3. 运行这段代码，不出意外的话，会看到如下输出：

Starting on port 8003 ...

这表明端口已经打开了，地址为http://$(your server ip):8003，其中$(your server ip)为你的服务器ip地址，接下来就可以通过向这一端口发送数据来进行通信了。

 

二、客户端程序

1. libcurl的安装与配置

(1). 在github上下载curl源码：https://github.com/curl/curl

(2). 安装依赖项

sudo apt-get install autoconf
sudo apt-get install automake
sudo apt-get install libtool

(3). 依次执行

./buildconf
./configure
make
sudo make install

不出意外的话，就可以安装完成了，默认安装路径为/usr/local。

2. libcurl库的使用

关于libcurl库的使用可以参考这个博客：https://www.cnblogs.com/fnlingnzb-learner/p/5835411.html

我这里将一些常用的功能封装到了CurlHttp类中，代码如下：

http.h：

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>

#include <curl/curl.h>
#include <curl/easy.h>
#include <string>
using namespace std;

class CurlHttp
{
  public:
    CurlHttp()
    {
      curl_global_init(CURL_GLOBAL_ALL);  
      curl = curl_easy_init();
    }

    ~CurlHttp()
    {
      curl_easy_cleanup(curl);
    }

    static int write_data(void *ptr, size_t size, size_t nmemb, string& data)  
    {
      data = string((char *)ptr);
      return 0;
    }

    int http_get(const char* url, string* result)
    {
      curl_easy_setopt(curl, CURLOPT_URL, url);  
      curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_data);
      curl_easy_setopt(curl, CURLOPT_WRITEDATA, result);  
      return curl_easy_perform(curl);
    }

    int http_post(const char* url, const char* post_data, string* result)
    {
      curl_easy_setopt(curl, CURLOPT_URL, url);  
      curl_easy_setopt(curl, CURLOPT_POSTFIELDS, post_data);
      curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_data);  
      curl_easy_setopt(curl, CURLOPT_WRITEDATA, result);  
      return curl_easy_perform(curl);
    }

  private:
    CURL *curl;
};

3. 编写测试程序test.cpp

#include <stdio.h>
#include <string.h>
#include <time.h>
#include <iostream>

#include "http.h"

using namespace std;

int main(int argc, char *argv[])
{
  CurlHttp curl_http;
  string str_url = "http://192.168.1.125:8003";  // 地址、端口号
  string str_test = "Hello World!";

  while (1) {
    cout << "Post data ...\n";
    
    string result;
    int res = curl_http.http_post(str_url.c_str(), str_test.c_str(), &result);
    cout << "[Response]: " << result << '\n';
    
    sleep(1);
  }
  
  return 0;
}

程序调用了curl_http.http_post函数将str_test中的数据发送到服务器，然后将服务器返回的数据保存到result中。编译这段代码，生成可执行文件，依次运行服务端和客户端程序，注意修改str_url为正确的ip地址和端口号。

4. 我们应该能够在客户端看到这样的输出：

Post data ...
[Response]: Received: Hello World!, 1
Post data ...
[Response]: Received: Hello World!, 2
Post data ...
[Response]: Received: Hello World!, 3
Post data ...
[Response]: Received: Hello World!, 4
Post data ...
[Response]: Received: Hello World!, 5
Post data ...
[Response]: Received: Hello World!, 6
Post data ...
[Response]: Received: Hello World!, 7
Post data ...
[Response]: Received: Hello World!, 8
Post data ...
[Response]: Received: Hello World!, 9
Post data ...
[Response]: Received: Hello World!, 10

在服务端看到这样的输出：

Starting on port 8003 ...
counter: 1
counter: 2
counter: 3
counter: 4
counter: 5
counter: 6
counter: 7
counter: 8
counter: 9
counter: 10

服务端每调用一次回调函数就会输出一个counter，我们设置客户端每秒向服务端发送一次数据，因此，我们也会在服务端看到每秒一次的输出。

这样就实现了在客户端和服务端之间传递字符串的功能。那么，要如何传递图片类型的数据呢，下一篇继续说。