C++ Poco服务端框架中JSON的使用

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

---

前言

上面一篇文章教你学会了Poco开发服务端应用，这个教程教会你使用JSON。一般传JSON的时候都是POST请求，很少有人把JSON序列化放在GET请求里，不安全。

如果你不会开发服务端就先看下下面的文章，通俗易懂。我直接开门见山了，默认环境已经有了。

手把手教你使用Poco框架开发服务器应用

---

一、JSON是什么？

JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，设计上易于人类阅读和编写，同时也便于机器解析和生成。它源自 JavaScript 编程语言，但现在被广泛用于不同的编程环境中。

JSON 的特点
文本格式：JSON 是一种纯文本格式，由键值对和数组组成。
语言无关：虽然最初基于 JavaScript，但现在几乎所有编程语言都支持 JSON。
轻量级：结构简单，适用于数据交换，尤其是在 Web 应用程序中。

二、使用步骤

基于上面的代码在RequestHander里面先解析JSON，再写回JSON。

UpdateRequestHanler.cpp

//
// Created by anold on 2024-08-06.
//#ifndef POCO_HTTP_SERVER_UPDATEREQUESTHANDLER_H
#define POCO_HTTP_SERVER_UPDATEREQUESTHANDLER_H#include <iostream>
#include <Poco/Net/HTTPRequestHandler.h>
#include <Poco/Net/HTTPServerRequest.h>
#include <Poco/Net/HTTPServerResponse.h>
#include <Poco/JSON/Parser.h>
#include <Poco/JSON/Stringifier.h>
#include <Poco/Dynamic/Var.h>
#include <Poco/Data/RecordSet.h>
#include <Poco/Data/DataException.h>
#include <Poco/Data/MySQL/MySQLException.h>using namespace Poco::Net;class UpdateRequestHandler : public Poco::Net::HTTPRequestHandler {
public:void handleRequest(HTTPServerRequest &request, HTTPServerResponse &response) override {response.setStatus(Poco::Net::HTTPResponse::HTTP_OK);response.setContentType("application/json");auto &os = response.send();//root就是一会要response的JSON结构，因为就算出错了也要告诉请求人结果Poco::JSON::Object root;//JSON对象转换成字符串流std::stringstream ss;try {//JSON解析代码,可以直接把request.stream()传进去一次性解析出来Poco::JSON::Parser parser;Poco::Dynamic::Var result = parser.parse(request.stream());//object 就是最终解析的JSON对象，是个智能指针不需要手动回收内存，如果解析失败会触发异常Poco::JSON::Object::Ptr object = result.extract<Poco::JSON::Object::Ptr>();//JSON取值代码，这里没有对key是否存在和类型进行判断，二十借助了异常简化了代码实现//比如需要int类型，哪怕传个数字字符串也可以正常解析，会自动转换，如果是字母就抛异常auto id = object->getValue<int>("id");auto class_id = object->getValue<int>("class_id");//数据库会话池Session session(MySQLSessionPool::pool->get());if (!session.isGood()) {root.set("status", -400);root.set("message", "Error Connect To MySQL");//JSON对象写入字符串流然后序列化成字符串responsePoco::JSON::Stringifier::stringify(root, ss);os << ss.str();return;}//语句执行Statement statement(session);statement << "UPDATE student SET class_id=? WHERE id=?", use(class_id), use(id);auto rows = statement.execute();std::cout << "Effect Rows: " << rows << std::endl;if (statement.done() && rows == 1) {root.set("status", 200);root.set("message", "Success");Poco::JSON::Stringifier::stringify(root, ss);os << ss.str();} else {root.set("status", -500);root.set("message", "Error Execute Statement");Poco::JSON::Stringifier::stringify(root, ss);os << ss.str();return;}} catch (const Poco::Data::MySQL::MySQLException &e) {std::cout << "MySQL Exception: " << e.message() << std::endl;root.set("status", -600);root.set("message", "MySQL Exception: " + e.message());Poco::JSON::Stringifier::stringify(root, ss);os << ss.str();} catch (const Poco::Exception &e) {std::cout << "Poco Exception: " << e.message() << std::endl;root.set("status", -200);root.set("message", "Poco Exception: " + e.message());Poco::JSON::Stringifier::stringify(root, ss);os << ss.str();} catch (const std::exception &e) {std::cout << "Std Exception: " << e.what() << std::endl;root.set("status", -300);root.set("message", "Std Exception: " + std::string(e.what()));Poco::JSON::Stringifier::stringify(root, ss);os << ss.str();}}
};#endif //POCO_HTTP_SERVER_UPDATEREQUESTHANDLER_H

注：为什么用3个异常处理？

1、如果JSON格式出错理论上你需要对每个传进来的JSON值进行两步校验，即是否存在这个key和value是否是你需要的类型，否则一旦出错就会出现崩溃的风险，不要抱侥幸心理认为只要传值的人不犯错就没事，你是服务者，你要做的就是一定不能出错，至少不能崩溃，最差的情况哪怕HTTP请求超时也不是不能接受。

2、本身Poco框架就刻意简化了处理方式，比如Poco::Exception可以捕捉所有的JSON错误（不止JSON，可以看下源码类层次），哪怕传过来的是空字符串， e.message()可以获取具体的错误信息，将这个信息反回即可。哪怕你默认的请求是POST，别人给你传了GET，这段代码也是可以正常运行的，它会报错，但是美中不足的是报错的原因无法看出是Method的问题，这一点我觉得无关紧要，这肯定是请求者的问题，我不可能考虑的面面俱到。同样，Poco框架虽然提供了获取Method的方法，但是它没有过度区分到底是POST还是GET，而是把它归到了一起由开发者来决定处理方法，况且区分Method也是对请求人的硬性要求。

3、Poco::Data::MySQL::MySQLException捕捉数据库相关异常，但是注意：捕捉不了所有的CIUD结果，有些结果不触发异常，比如UPDATE语句，statement << "UPDATE student SET class_id=? WHERE id=?", use(class_id), use(id);这句的执行结果可能不成功，但是它可能不抛异常，可以通过返回影响行数来判断语句是否成功。std::exception能捕捉任何运行时异常，是最后的保命手段。不要担心异常会影响性能，异常对性能最大的影响是触发时的堆栈展开（stack unwinding），但是堆栈展开只有异常发生的时候才会触发，很多编译器对异常有优化，没有触发异常的语句可以获得近乎原生的性能，所以大胆地使用异常吧，但不要滥用。

---

总结

1、最后的总结才是最核心的部分，特别适合初学者，能少走很多弯路。