MyBatis 传递多个参数一般有以下几种方法:

• 使用 Map
• 把参数封装成 Bean，传递 Bean 的对象
• 使用 @Param
• 编译时使用 -parameters 参数 (推荐使用)

下面以用户名和密码作为参数查询用户为例进行介绍。

布局管理器 QHBoxLayout、QVBoxLayout、QGridLayout 相信大家都很熟悉了，对于常用的功能就不一一列举，这里将介绍一下几个不常用，在复杂的自定义界面时又可能会用到的功能:

• QGridLayout 中多个 Widget 放在同一个位置
• 把一个 Widget 替换为另一个 Widget
• QHBoxLayout、QVBoxLayout 中插入 Widget
• 从 Layout 中删除 Widget

Qt 的默认窗口使用系统风格，不能修改标题栏和边框，满足不了高度自定义的窗口设计，这时只能把窗口的默认标题栏和边框隐藏起来，替换上我们自定义的标题栏和边框，下面就以实现自定义标题栏无边框阴影窗口为例进行介绍。

技术要点:

• 隐藏系统标题栏和边框: QWidget::setWindowFlags(Qt::FramelessWindowHint)
• 窗口透明隐藏默认背景: QWidget::setAttribute(Qt::WA_TranslucentBackground)
• QWidget::paintEvent(QPaintEvent *event) 里绘制任意形状的自定义背景
• 拖拽移动窗口
• 缩放窗口

圆形头像大家应该都见过不少软件里用过吧，例如 QQ 的好友列表，网页里的人物头像，有没有想过在 Qt 里怎么做到呢？

这一节中就来介绍怎么实现下图中的圆形 QLabel，然后扩展到给 QLabel 添加阴影效果、模糊效果以及加上边框:

圆形 Label

最核心的就是圆形 QLabel 的实现，有很多种方法能够做到，这里使用 QSS 来实现: Border Image + Border Radius，也就是几行代码的事:

• 圆形: 先设置 QLabel 的大小为固定大小，这样当窗口大小变化时不会影响 QLabel 的大小，并且设置 border-radius 为 QLabel 高度的一半
  • 必须正好是一半出来的效果才能是正圆
  • 大于一半 border-radius 就失去了效果，出来的是矩形，这应该是 QSS 的 Bug，CSS 里就不这样
  • 小于一半的效果是圆角矩形
• 背景: 为了让背景图缩放填满 QLabel，需要使用 border-image 并且设置 QLabel 边框的宽度为 0

1
2
3
4
5
6
7
8
9
10

QQLabel {
    min-width:  100px;
    max-width:  100px;
    min-height: 100px;
    max-height: 100px;

    border-radius: 50px;
    border-width: 0 0 0 0;
    border-image: url(/Users/Biao/Desktop/estas.jpg) 0 0 0 0 stretch strectch;
}

上面的 QSS 就能得到左边第一个圆形 QLabel 的效果。

MongoDB 的结构是：数据库 > 集合 (collection) > 文档 (document) > 属性 (field)

MySQL 的结构是: 数据库 > 表 (table) > 记录 (record or row) > 属性 (field or column)

下载安装

不同的系统安装 MongoDB 差别挺大的:

• Mac: 使用 brew install mongodb

• Linux: 参考 http://qtdebug.com/mac-centos7/#安装-MongoDB

• Windows: 下载然后安装，安装的时候不要选择安装 MongoDB Compass，因为需要联网下载，国内有可能很久都装不好, 或者下载压缩版解压直接用:

  在 bin 目录中创建文件 mongod.conf, 内容如下:

  1 2 3 4 5 6 7 8

  systemLog: destination: file path: D:\MongoDB\logs\mongodb.log #日志输出文件路径 logAppend: true storage: dbPath: D:\MongoDB\data #数据库路径 net: bindIp: 0.0.0.0 #允许其他电脑访问

  然后创建 path 和 dbPath 指向的文件夹 (文件夹不存在则会导致启动失败)

启动访问

• 启动 MongoDB:
  • mongod
  • mongod --config C:/etc/mongod.conf
  • mongod --auth --config C:/etc/mongod.conf
• 访问 MongoDB:
  • mongo
  • mongo --host IP
  • 使用 IDEA 的插件 Mongo Plugin
  • 漂亮的免费客户端 dbKoda
  • 智能的免费客户端 NoSQLBooster for MongoDB (推荐使用)
• 删除 MongoDB:
  • CentOS
    • 关闭 MongoDB 服务: kill -9 pid
    • 查看有 MongoDB 哪些包: rpm -qa | less | grep mongo
    • 删除 MongoDB 的包: yum erase $(rpm -qa | grep mongodb-org)
    • 删除 MongoDB 的目录: rm -rf /var/log/mongodb ; rm -rf /var/lib/mongo

访问 https://cloud.baidu.com/product/ocr/general 可以先体验一下百度的 OCR 文字识别，在功能演示处上传一个含有文字的图片就可以看到识别效果，还是挺不错的，接下来就介绍使用 OCR 服务的编程实现:

1. 点击立即使用

2. 点击创建应用 (需要登陆)

3. 得到应用 API Key 和 Secret Key (在程序中需要使用，对应程序中的 APP_ID 和 APP_KEY)

4. 使用 API Key 和 Secret Key 换取 access_token，请参考鉴权认证机制

5. 使用 OCR 服务识别图片中的文字，请参考通用文字识别

   • 把图片进行 Base64 编码成为字符串

     文档中说所有图片均需要 Base64 编码后再进行 urlencode，这里容易造成困扰，其实 Base64 后就够了，因为 Base64 包含的 64 个字符为 a-z, A-Z, 0-9, /, + 以及填充字符 = 都包含在了 urlencode 不需要进行编码的字符内。

   • 去掉图片头，如 data:image/jpg;base64,

   • 传给百度，然后就能得到识别的 JSON 结果

相信很多人在 Qt 项目中使用 OpenCV 都遇到过麻烦，Windows 开发者软件推荐 一文中介绍过使用 Vcpkg 来管理第三方库，这里就使用 Vcpkg 安装 OpenCV 然后在 MSVC 的 Qt 项目中使用(因为 Vcpkg 使用的是 MSVC 编译器，OpenCV 是 C++ 库，不能够跨编译器，所以 MinGW 的项目不能使用):

1. 安装 Vcpkg 就不用多说了，安装到 C 盘根目录下吧

2. 安装 OpenCV: vcpkg install opencv

3. Qt Creator 中 创建 Qt 项目

4. 修改项目的 .pro 文件，主要是下面 2 句引入 OpenCV

   1 2	INCLUDEPATH += C:/vcpkg/installed/x86-windows/include LIBS += C:/vcpkg/installed/x86-windows/lib/opencv_*.lib

   使用 opencv_*.lib 引入所有 opencv_ 开头的 lib 文件，这样就不需要一个一个的引入 lib 了。

   引入 dll 的时候也可以使用 * 来匹配一次引入多个，例如 tiff*.dll。

5. main.cpp

   1 2 3 4 5 6 7 8 9 10

   #include <opencv2/opencv.hpp> using namespace cv; int main() { Mat img = imread("D:/Wallpaper/desktop.jpg"); imshow("TEST", img); waitKey(6000); return 0; }

6. 把 OpenCV 相关的 DLL 从 C:/vcpkg/installed/x86-windows/bin 目录复制到编译出的 exe 所在目录

7. 运行程序，然后就看到打开一个窗口，图片显示在窗口中

包管理器 Chocolatey

Chocolatey 是一款专为 Windows 系统开发的、基于 NuGet 的包管理器工具，类似于

• Node 的 npm
• MacOS 的 brew
• Ubuntu 的 apt-get
• CentOS 的 yml

Chocolatey 的设计目标是成为一个去中心化的框架，便于开发者按需快速安装应用程序和工具，官网为 https://chocolatey.org，安装很简单，根据说明安装即可。

常用命令

• 搜索: choco search something

• 列出: choco list -lo

• 安装: choco install cmake

  可访问 https://chocolatey.org/packages 查看已有的包和说明

• 卸载: choco uninstall cmake

• 升级: choco upgrade cmake

• 固定包的版本，防止包被升级: choco pin windirstat

MyBatis 中一对多的关系使用 collection 进行映射，但是怎么确定哪些行是同一个对象的数据呢？关键是使用 <id> 来归类数据(MyBatis 的文档只提到是为了提高效率)，下面介绍使用 <id> 和 <result> 的区别。

数据表

Xml Mapper

查找所有用户

1

SELECT name, email, country, province, street FROM user

映射文件如下

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

<mapper namespace="com.xtuer.mapper.UserMapper">
    <select id="users" resultMap="userResultMap">
        SELECT name, email, country, province, street FROM user
    </select>

    <resultMap id="userResultMap" type="User">
        <id property="name" column="name"/> <!-- 关注这里 -->
        <result property="email" column="email"/>
        <collection property="addresses" resultMap="addressResultMap"/>
    </resultMap>

    <resultMap id="addressResultMap" type="Address">
        <result property="country" column="country"/>
        <result property="province" column="province"/>
        <result property="street" column="street"/>
    </resultMap>
</mapper>

Java 中按照拼音序对字符串排序，只需要使用 CHINA 的 Collator 即可

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

import java.text.Collator;
import java.util.LinkedList;
import java.util.List;
import java.util.Locale;

public class Test {
    public static void main(String[] args) {
        List<String> tokens = new LinkedList<>();
        tokens.add("黄"); // h
        tokens.add("慌"); // h
        tokens.add("晃"); // h
        tokens.add("欢"); // h
        tokens.add("中"); // z
        tokens.add("这"); // z
        tokens.add("国"); // g
        tokens.add("古"); // g
        tokens.add("安"); // a

        Collator collator = Collator.getInstance(Locale.CHINA);
        tokens.sort((a, b) -> collator.compare(a, b));

        System.out.println(tokens);
    }
}

MySQL 中定义数据字段的类型对你数据库的优化是非常重要的，支持多种类型，大致可以分为三类：数值、日期/时间和字符串(字符)类型。

数值类型

MySQL支持所有标准 SQL 数值数据类型，这些类型包括严格数值数据类型(INTEGER、SMALLINT、DECIMAL 和 NUMERIC)，以及近似数值数据类型(FLOAT、REAL 和 DOUBLE)。

关键字 INT 是 INTEGER 的同义词，关键字 DEC 是 DECIMAL 的同义词。
BIT 数据类型保存位字段值，并且支持 MyISAM、MEMORY、InnoDB 和 BDB 表。
作为 SQL 标准的扩展，MySQL 也支持整数类型 TINYINT、MEDIUMINT 和 BIGINT。

现在 Java 开发项目编码一般都是 UTF-8，Windows 下 JDK 的默认编码是 GB2312，可把其默认值设置为 UTF-8:

1. 右键点击计算机 > 属性 > 高级系统设置 > 高级 > 环境变量 > 系统变量: 设置 JAVA_TOOL_OPTIONS 的值为 -Dfile.encoding=UTF-8
2. 命令行显示 UTF-8 字符: 执行 chcp 65001，设置命令行的属性，选择字体 Lucida Console(不要选择点阵字体)。如果要换回 GBK 执行 chcp 936 ，再把字体改成点阵字体即可。

导出 XML

1

bcp "select * from tableName FOR XML AUTO, ROOT('Root')" queryout C:/x.xml -S(local) -T -r -c

• -w: 使用 UTF-16 编码，小端
• -c: 使用 GBK 编码
• -c -C6501: 使用 UTF-8 编码，但是有的计算机上不支持
• -T: 本机使用 -T 表示可信连接，如果是访问其他机器使用 -U user -P pwd 输入用户名和密码

注意：

• 如果不使用 -r，则导出的 XML 每行最多有 2033 个字符，会破坏 XML，用了 -r 后就没有换行符了，整个 XML 的内容在同一行。
• 内容中的 & 等特殊字符不会被转义就直接放到属性值里了，此时用 XML 库解析会出错。

导出 CSV

1

sqlcmd -S localhost -d dbName -E -o "csvFile.csv" -Q "set nocount on; select * from tableName" -W -w 999 -s ","

• -W: remove trailing spaces from each individual field
• -s",": sets the column seperator to the comma (,)
• -w 999: sets the row width to 999 chars(this will need to be as wide as the longest row or it will wrap to the next line)
• -U: username
• -P: password
• -h-1: removes column name headers from the result
• set nocount on: 输出时不显示 XXX 行受到影响的统计信息

注意：sqlcmd 导出为 CSV 文件时，如果列中有逗号，那么导出的 CSV 文件会被破坏，还没找到好办法。

参考 How to export data as CSV format from SQL Server using sqlcmd?

使用 ssh 远程登录时:

1. 输入 ssh root@host-ip
2. 输入密码

每次都重复这样的操作，不仅麻烦，还要记忆好多东西，为了解决这个问题，借助 iTerm2 Profile 可以实现 ssh 自动登录:

1. 编写 expect 脚本
2. 使用此脚本创建 Profile
3. 使用此 Profile 打开新标签页

创建数据库

1

CREATE DATABASE IF NOT EXISTS databaseName DEFAULT CHARSET utf8 COLLATE utf8_general_ci;

导入 SQL 文件

MySQL 可以使用 GUI 客户端导入 SQL 文件，此外在命令行下有常用下面 2 种方式导入 SQL 文件(先要创建好数据库)

• 使用 mysql 导入
  • 命令中不带密码
    1. ./mysql -uroot -p 数据库名 < 导入的文件名.sql
    2. 输入密码
  • 命令中带密码: ./mysql -uroot -p$password 数据库名 < 导入的文件名.sql
• 使用 source 导入
  1. ./mysql -uroot -p
  2. 输入密码
  3. use databaseName
  4. source 导入的文件名.sql

导出 SQL 文件

导出有 2 种: 导出数据库(包含建表语句和表中的数据)，导出表结构(只有建表语句)

• 导出数据库: mysqldump -uusername -p 数据库名 > 导出的文件名.sql
• 导出表结构: mysqldump -uusername -p -d 数据库名 > 导出的文件名.sql

相信很多同学继承如 QWidget，QPushButton 等实现自定义的控件后，发现在此控件上 QSS 不生效了，这不行啊，设置背景、边框、字体等如果没有 QSS 那就太麻烦了。其实在自定义控件上启用 QSS 非常简单，只要调用一下 setAttribute(Qt::WA_StyledBackground) 即可，就像下面这样

1
2
3
4

Widget::Widget(QWidget *parent) : QWidget(parent) {
    this->setAttribute(Qt::WA_StyledBackground); // 启用 QSS
    this->setStyleSheet("border: 2px solid red; background: pink; border-radius: 10px;"); // 设置 QSS
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

#include <QApplication>
#include "Widget.h"

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    QWidget window;

    Widget customWidget(&window);
    customWidget.setGeometry(20, 20, 100, 100);

    window.resize(300, 300);
    window.show();

    return app.exec();
}

如上在 main() 函数中使用自定义控件 Widget，QSS 生效了，去掉 this->setAttribute(Qt::WA_StyledBackground) 后 QSS 就没效果了:

QWidget 已经实现了在标题栏按下鼠标移动窗口的功能，但是当实现无边框窗口时，因为没有了标题栏，移动窗口的功能就需要我们自己实现了，不过也不复杂，主要是处理鼠标的按下、移动、松开三个事件:

• 按下鼠标：记录此时鼠标的全局坐标和窗口左上角的坐标，并且设置鼠标为按下状态
• 移动鼠标：鼠标按下时移动鼠标，计算此时鼠标和鼠标按下时的位移差，加上按下鼠标时窗口左上角的坐标得到窗口新的坐标，移动窗口到此坐标
• 松开鼠标：设置鼠标为未按下状态

经常看到有同学问：如何实现用鼠标拖拽出一个矩形区域的效果，类似 QQ 截图的那个矩形区域？

很简单的一个问题，主要是处理鼠标的按下、移动、松开三个事件:

• 按下鼠标：用一个变量标记要开始拖拽出矩形了，并记录按下的位置作为矩形的左上角顶点
• 移动鼠标：按下时移动鼠标，鼠标的当前位置作为矩形新的右下角的顶点，每次移动事件发生时都要重新画一次矩形，因为矩形变了
• 松开鼠标：清除拖拽矩形的标志，松开鼠标后，移动鼠标时就不要再改变矩形了

工欲善其事，必先利其器，顺手的开发工具，能够让我们事半功倍，Qt 开发，推荐使用 Qt Creator，因为在 Qt Creator 中集成了很多实用的功能，不需要切换到其他软件就能使用

• 编写代码(废话)
• 使用 UI Designer 进行可视化的布局界面
• 搜索帮助文档
• 学习自带的例子
• Ctrl + K 快速搜索、定位

接下来就简单的介绍下我个人觉得 Qt Creator 使用中比较重要的地方。

创建线程需要向系统申请资源，线程切换时操作系统会切换线程上下文，可能会从用户态切换到内核态，当有很多线程时，频繁地切换线程会导致消耗大量的 CPU 以及内核资源，真正用于计算的资源就减少了，反而会降低程序的效率。线程并不是越多越好，线程池的作用是管理、复用、回收一组线程，控制线程的数量，避免频繁的创建和销毁线程而浪费资源。

Qt 中的线程池类为 QThreadPool，每一个 Qt 程序都有一个全局的线程池，调用 QThreadPool::globalInstance() 得到，它默认最多创建 8 个线程，如果想改变最大线程数则调用 setMaxThreadCount() 进行修改，调用 activeThreadCount() 查看线程池中当前活跃的线程数。

使用线程池挺简单的，定一个任务类例如叫 Task，继承 QRunnable 并实现虚函数 run()，Task 的对象作为 QThreadPool::start() 的参数就可以了，线程池会自动的在线程中调用 Task 的 run() 函数，异步执行。线程池中的 QRunnable 对象太多时并不会为立即为每一个 QRunnable 对象创建一个线程，而是让它们排队执行，同时最多有 maxThreadCount() 个线程并行执行。

提交给线程池的 QRunnable 对象在它的 run() 函数执行完后会被自动 delete 掉，如果不想线程池删除它，在调用线程池的 start() 前调用 setAutoDelete(false) 即可。

想一想大多数时候我们的项目是不是所有代码都会放在同一个工程中？人少的时候问题不大，但当项目越来越大，开发人员越来越多，会发觉开发、管理能让人窒息，大家都绞在一起，出问题时互相推诿责任，各自有理，这时如果按照功能模块进行分组各自开发，以库的形式提供给其他人使用，就能够最大限度的并行开发，提高工作效率，而且项目的模块也很清晰，责任一目了然，此外使用动态链接库后还能够按模块升级，编译的速度也更快。下面就介绍怎么在工程中创建和使用动态链接库。

Windows 中叫动态链接库 (Dynamic Link Library: .dll)，Linux 中叫共享库 (Shared Library: .so)，Mac 下后缀为 .dylib，这几种叫法实际指的是一种类型的库，这里都统称为动态链接库吧。

理解动态链接库需要理解符号的概念，符号包含函数、变量或者类，分为公有符号和私有符号:

• 公有符号: 在其他程序或者库使用的符号，需要根据用途使用宏进行标记:

  • Q_DECL_EXPORT: 编译为动态链接库时符号要标记为 Q_DECL_EXPORT，表明是导出的符号
  • Q_DECL_IMPORT: 在调用动态链接库时符号要标记为 Q_DECL_IMPORT，表明是导入的符号

• 私有符号: 除了公有符号外的其他符号，在此库之外不应该被访问，不需要进行标记

  建议: 不要在头文件中声明私有符号。

符号上的标记 Q_DECL_EXPORT 和 Q_DECL_IMPORT 不能同时存在，为了在导出和导入时使用同一个头文件， 头文件中包含下面的宏，编译时根据条件使用不同的宏就可以了:

1
2
3
4
5
6
7
8
9
10
11
12
13

#include <QtCore/qglobal.h>

// 根据条件定义 LIB 为不同的宏
#if defined(BUILD_LIB)
#   define LIB Q_DECL_EXPORT
#else
#   define LIB Q_DECL_IMPORT
#endif

// 使用 LIB 修饰符号，编译时会根据编译条件替换为 Q_DECL_EXPORT 或者 Q_DECL_IMPORT
class LIB Calculator {
    ...
};

为了达到了在导出和导入时使用同一个头文件的目的:

• 生成动态链接库工程的 pro 文件中添加 DEFINES += BUILD_LIB，在编译的时候 LIB 就会被替换为 Q_DECL_EXPORT
• 使用动态链接库工程的 pro 文件中千万不要加 DEFINES += BUILD_LIB，编译的时候发现没有定义 BUILD_LIB，则 LIB 就会被替换为 Q_DECL_IMPORT

Widget 的效率怎么样，来进行一个简单的测试，添加 1千，1万，2万个，……，10万个 QPushButton(修改程序中的 buttonsCount 即可)，看看程序的创建好按钮，点击按钮执行槽函数，程序退出效果怎么样。

添加 1千个，1万个按钮的时候窗口显示的速度非常快。
添加 2万个的时候就需要几秒窗口才显示出来。
添加的越多窗口显示需要的时间越长，添加 10万个需要等很久。
按钮越多，程序退出的时间就越长，不过即使是 10万个按钮，退出也就是多了几秒，因为释放的内存多，这倒是没什么。
当窗口显示出来后，不管添加了多少个按钮，点击按钮，它的槽函数都是瞬间就被执行。
在实际应用中，添加上百个 widgets 在窗口上的见过，但有谁会添加上万个 widgets 到窗口上？不担心被产品经理揍的可以试试！

Qt 说 Graphics View Framework 效率很高，到底有多高呢？来进行一个简单的测试，向 scene 中添加 10万，50万，100万个 items(修改程序中的 rowCount 和 colCount 即可)，进行缩放、旋转看看效率怎么样。

在可视区域内的 items 少的话，不管 scene 里有多少个 items，10万个和 100万个的区别不大，效率都是非常高的，但可视区内 items 越多的话，越多效率越低。Qt 使用 Binary-Space-Partitioning 算法管理 items，能够快速的找出可视区内的 items 进行绘制(100万个 items 中可能只需要绘制 100 个 items)，不会绘制所有的 items，绘制操作是非常耗时的，这也就是为什么影响效率最大的因素是可视区内的 items。

实际项目中添加 10万个 items 的效率和此处测试的 10万个 items 的效率是有些微区别的，绘制的消耗由其 paint() 函数决定。

全局快捷键: 按下快捷键后，不管程序是否当前正在使用的程序，它都能得到此快捷键的事件通知，例如 Windows 里按下 Ctrl + Shift + A 就可以使用 QQ 截图一样。

Qt SDK 没有自带设置全局快捷键的功能，需要自己实现，在 Github 上也有人开源了全局快捷键的库，例如 QHotKey，可以直接在项目中使用。

QHotkey 有很多特点，能够满足绝大多数的需求:

• Works on Windows, Mac and X11
• Easy to use, can use QKeySequence for easy shortcut input
• Supports almost all common keys (Depends on OS & Keyboard-Layout)
• Allows direct input of Key/Modifier-Combinations
• Supports multiple QHotkey-instances for the same shortcut (with optimisations)
• Thread-Safe - Can be used on all threads (See section Thread safety)
• Allows usage of native keycodes and modifiers, if needed

下面就写个 HelloWorld 级别的程序，定义全局快捷键 Alt+P 唤出程序:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

#include <QHotkey>
#include <QApplication>

Widget::Widget(QWidget *parent) : QWidget(parent), ui(new Ui::Widget) {
    ui->setupUi(this);

    QHotkey *hotkey = new QHotkey(QKeySequence("Alt+P"), true); // Alt 和 P 之间不能有空格
    qDebug() << "Is Registered: " << hotkey->isRegistered();

    connect(hotkey, &QHotkey::activated, [this](){
        this->show();
        this->raise();
        this->activateWindow();
        this->raise();
        QApplication::setActiveWindow(this);
        this->raise();
    });
}

Qt 中使用多线程，最简单直观的方法就是继承 QThread，重写 run() 方法，需要使用多线程执行的代码放在 run() 函数中，调用 start() 函数启动线程，线程正在运行时 isRunning() 返回 true，结束运行后发出信号 finished()。

实现线程

仍以读取文本显示到 QTextEdit 为例，类 ReadingThread 继承 QThread，在 run() 方法中读取文件并添加到 QTextEdit。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

// 文件名: ReadingThread.h

#ifndef READINGTHREAD_H
#define READINGTHREAD_H

#include <QThread>

class QTextEdit;

class ReadingThread : public QThread {
public:
    ReadingThread(QTextEdit *textEdit, QObject *parent = NULL);

protected:
    void run() Q_DECL_OVERRIDE;

private:
    QTextEdit *textEdit;
};

#endif // READINGTHREAD_H

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

// 文件名: ReadingThread.cpp

#include "ReadingThread.h"
#include <QFile>
#include <QTextStream>
#include <QTextEdit>
#include <QMetaObject>

ReadingThread::ReadingThread(QTextEdit *textEdit, QObject *parent) : QThread(parent), textEdit(textEdit) {

}

void ReadingThread::run() {
    QFile file("/Users/Biao/Desktop/data.txt");

    if (!file.open(QIODevice::Text | QIODevice::ReadOnly)) {
        return;
    }

    QTextStream in(&file);
    while (!in.atEnd()) {
        QString line = in.readLine();
        textEdit->append(line);
    }
}

读取文件显示到 text edit 中，一个非常简单的需求，啥也不说了，撸起袖子，打开 Qt Creator 开干。

先设计 UI 如下，中间是 QTextEdit，底部是按钮 QPushButton:

点击按钮，按行读取文件，然后添加到 QTextEdit，对我们来说也是分分钟的事(Lambda Lambda Lambda):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

ReadingWidget::ReadingWidget(QWidget *parent) : QWidget(parent), ui(new Ui::ReadingWidget) {
    ui->setupUi(this);

    // 点击按钮，按行读取文件，添加到 text edit 中显示出来
    connect(ui->pushButton, &QPushButton::clicked, [this] {
        QFile file("/Users/Biao/Desktop/data.txt"); // 文件路径自己修改一下啊

        if (!file.open(QIODevice::Text | QIODevice::ReadOnly)) {
            return;
        }

        QTextStream in(&file);
        while (!in.atEnd()) {
            QString line = in.readLine(); // 读取一行
            ui->textEdit->append(line); // 添加到 text edit
        }
    });
}

分布式系统中，有一些需要使用全局唯一 ID 的场景，这种时候为了防止 ID 冲突可以使用 36 个字符的 UUID，但是 UUID 有一些缺点，首先他相对比较长，另外 UUID 一般是无序的字符串。

有些时候我们希望能使用简单一些的 ID，并且希望 ID 能够按照时间有序生成，为了解决这个问题，Twitter 发明了 SnowFlake 算法，不依赖第三方介质例如 Redis、数据库，本地程序生成分布式自增 ID，这个 ID 只能保证在工作组中的机器生成的 ID 唯一，不能像 UUID 那样保证时空唯一。

Snowflake 把时间戳、工作组 ID、工作机器 ID、自增序列号组合在一起，生成一个 64bits 的整数 ID，能够使用 70 年，每台机器每秒可产生约 400 万个 ID (2^12*1000，每毫秒理论最多生成 2^12 个 ID)。

Snowflake 也有自己的缺点，虽然不同 workId 的机器生成的 ID 永远不会相同，但是同一台机器当把时间往后回拨后，生成的 ID 就会重复，所以需要保持时间是网络同步的。

Snowflake 生成的 ID 的 bit 结构如下:

Qt 使用 curl 一文中介绍了怎么编译 curl 并且在 Qt 项目中使用，那么在 VS 项目中应该怎么使用 curl 的 dll 呢？

动态库的使用分为隐式链接和显示链接两种方式:

• 显示链接: 只需要 .dll 动态库文件，代码中使用 LoadLibrary + GetProcAddress 加载函数后需要自己进行函数类型转换：

  1 2 3 4 5 6 7 8 9

  // 函数类型定义 typedef void (*DLLFunc)(int); // 加载 dll 中的函数 HINSTANCE hInstLibrary = LoadLibrary("DLLSample.dll"); DLLFunc dllFunc = (DLLFunc)GetProcAddress(hInstLibrary, "TestDLL"); // 执行函数 dllFunc(123);

• 隐式链接: 需要 .h 头文件、.lib 库导入文件和 .dll 动态库文件，代码中直接使用库的函数即可

  推荐使用隐式链接，更省事，可参考 LIB 和 DLL 的区别与使用。

VS2013 中隐式链接使用 dll 一般有两种方法:

• 使用 #pragma 引入 lib

• 设置 项目属性 引入 lib

Qt 已经提供了 QNetworkAccessManager 用于 Http 访问，Qt 访问网络的 HttpClient 对其进行了简单封装，如下就可以进行 GET 请求:

1
2
3

HttpClient("http://localhost:8080/device").get([](const QString &response) {
    qDebug() << response;
});

但是，在非 Qt 项目中就不能使用 QNetworkAccessManager 了，还有就是因为 curl 成熟、强大、跨平台，可能有些项目更希望使用 curl，所以在此以 Windows MinGW 的 Qt 项目为例，介绍 curl 的集成使用。

对于想学习 Qt 的同学来说，下载、安装 Qt 还真不是一件容易的事，但这也是学习 Qt 的基石，否则连个 Qt Hello World 都不能在电脑上编写，还玩什么呢？

下载

下载 Qt，首先想到的是到官网 https://www.qt.io 下载，悲催的是，别说对于新手，就算对于我这种业余爱好 Qt 好多年的伪骨灰，进去后都是懵逼状态，别说还要注册、登录，估计连找下载的地方都困难，大多数人在这估计就有放弃的想法了，不能从大门进，还不能直捣黄龙么，访问 http://download.qt.io/archive/qt/ 就可以无障碍的挑选想要的 Qt 版本了。

QPainter 提供了绘制线段、矩形、椭圆、圆、圆弧、路径等的函数，如果想绘制正弦 (y=sin(x))、余弦 (y=cos(x)) 的曲线，QPainter 没有提供相应的绘制函数，应该怎么办呢？

李小龙的武术哲学: 以无法为有法，以无限为有限。

数学曲线是连续的，计算机的世界却是离散的，离散的世界使用极限的方式就可以模拟出连续的效果。可以把曲线想象成是一条一条线段连起来形成的图形，这些线段越短，连成的图形就越逼近曲线，这种方法就是线段拟合曲线，学过微积分的同学是不是感觉这个方法很熟悉？

下面以绘制正弦 (y=sin(x)) 曲线为例进行介绍:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

void FittingCurveWidget::paintEvent(QPaintEvent *) {
    QPainter painter(this);
    painter.setRenderHint(QPainter::Antialiasing);
    painter.translate(10, 150);

    // 绘制坐标轴
    painter.setPen(QPen(Qt::gray, 1, Qt::DashLine));
    painter.drawLine(0, 0, 700, 0);
    painter.drawLine(0, -200, 0, 200);
    painter.setPen(QPen(Qt::black, 1));

    // 计算正弦的坐标点，绘制线段
    qreal prex = 0, prey = 0;

    // [0, 314] 归一为 [0, PI]
    for (int i = 0; i <= 628; ++i) {
        qreal x = i;
        qreal y = qSin(i/314.0*M_PI) * 100;

        painter.drawLine(prex, prey, x, y);

        prex = x;
        prey = y;
    }
}

为了提高效率，常把 Nginx 作为静态文件服务器，把视频文件，JS，CSS 等放到 Nginx 上。例如我们要开发一个视频网站，免费视频不需要访问权限验证，收费视频就需要对用户的权限进行验证，验证通过了才能够继续访问，Nginx 可以借助 Lua 来实现访问验证，用户信息使用 token 表示

• 计算 token: md5(appId+appKey)
• 请求的链接从应用服务器上动态获取，请求参数带上 appId 和 token: http://localhost/private/tih.mp4?appId=app_1&token=1409dc951714a8226032e0b0fb60bdb0
• Nginx 接收到请求的时候，根据 appId 找到 appKey，然后 token2 = ngx.md5(appId+appKey)，token2 和请求中的 token 比较，如果相等则验证通过放行访问，否则禁止访问

Nginx 简单的验证代码如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

location ~ /private/.+\.mp4$ {
    root html;

    access_by_lua '
        -- 应用的 ID 和 key，和应用服务器上的一致
        local appIdKeys = {["app_1"] = "key_1", ["app_2"] = "key_2"};

        local args   = ngx.req.get_uri_args();
        local appId  = args["appId"];
        local appKey = appIdKeys[appId];

        local token1 = args["token"]; -- 参数中 token
        local token2 = ngx.md5(appId .. appKey); -- 用应用的 ID 找到对应的 key，然后根据算法计算 token

        -- 如果参数中的 token 和计算得到的 token 不相等，则说明访问非法，禁止访问，否则放行访问
        if token1 ~= token2 then
            ngx.exit(ngx.HTTP_FORBIDDEN);
        end
    ';
}

Nginx 和应用服务器上同时存储 appId 和 appKey，这样就能根据参数中的 appId 查找到对应的 appKey。至于使用 Lua 的变量存储，或者使用数据库，还是文件，根据具体的情况而定(Nginx 中 Lua 能够访问数据、Redis 等)。

上面的验证规则比较简单，如果其他人得到了 token，就可以无限制的访问了，为了增强安全性，可以使用更多的参数生成 token，例如用户 id，限制 URL 期限的时间戳等。

Nginx 默认没有安装 Lua 模块，需要自己安装，可参考 http://qtdebug.com/mac-nginx-lua

Nginx 支持 Lua 需要安装 lua-nginx-module 模块，一般常用有 2 种方法:

• 编译 Nginx 的时候带上 lua-nginx-module 模块一起编译

• 使用 OpenResty: Nginx + 一些模块，默认启用了 Lua 支持(推荐使用此方式)

  OpenResty is just an enhanced version of Nginx by means of addon modules anyway. You can take advantage of all the exisitng goodies in the Nginx world.

  ​

  OpenResty® 是一个基于 Nginx 与 Lua 的高性能 Web 平台，其内部集成了大量精良的 Lua 库、第三方模块以及大多数的依赖项。用于方便地搭建能够处理超高并发、扩展性极高的动态 Web 应用、Web 服务和动态网关。

  OpenResty® 通过汇聚各种设计精良的 Nginx 模块（主要由 OpenResty 团队自主开发），从而将 Nginx 有效地变成一个强大的通用 Web 应用平台。这样，Web 开发人员和系统工程师可以使用 Lua 脚本语言调动 Nginx 支持的各种 C 以及 Lua 模块，快速构造出足以胜任 10K 乃至 1000K 以上单机并发连接的高性能 Web 应用系统。

  OpenResty® 的目标是让你的Web服务直接跑在 Nginx 服务内部，充分利用 Nginx 的非阻塞 I/O 模型，不仅仅对 HTTP 客户端请求,甚至于对远程后端诸如 MySQL、PostgreSQL、Memcached 以及 Redis 等都进行一致的高性能响应。

HTML5 中也能使用 MQTT：

1. ActiveMQ 启用 MQTT，可参考 http://qtdebug.com/misc-activemq/

2. 启动 ActiveMQ: activemq start

3. 使用 MQTT 的 HTML 如下:

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27

   <html> <head> <title>Test Ws mqtt.js</title> </head> <body> <script src="./browserMqtt.js"></script> <script> // 虽然使用的是 MQTT，但底层还是使用 WebSocket 实现的，所以这里的端口需要使用 ActiveMQ 里 WS 的端口 61614，而不是 MQTT 的端口 1883 var client = mqtt.connect('ws://127.0.0.1:61614'); // you add a ws:// url here client.subscribe('foo'); // 订阅 Topic client.on('message', function(topic, payload) { console.log([payload].join('')); // 提取消息需要使用 [].join() }) client.publish('foo', 'Hello World!'); // 发送消息 // 不停的发送消息进行测试 setInterval(function() { client.publish('foo', 'Time: ' + new Date().getTime()); }, 1000); </script> </body> </html>

4. 写一个 Java 的 MQTT 发布和订阅的程序一起测试，可参考 http://qtdebug.com/misc-mqtt/

下载 browserMqtt.js，也可以自己编译(新版本好像有问题，只能发消息，不能订阅消息)，详细文档请参考 https://github.com/mqttjs/MQTT.js

前后端分离，如果前端需要等到服务器端接口开发完成后才能继续的话，效率太低，使用 Mock 工具能够更好的使得前后端分离各自开发，RestServerMock 一个是简单的静态 Web 服务器的 Mock 工具:

A Simple REST HTTP server that serves the configured JSON responses rest-server-mock.

Currently it servers JSON responses with status code 200. Future versions will support more options including : status codes, headers, encodings, etc.

注入 Enum 可以使用字符串直接注入，或者借助 org.springframework.beans.factory.config.FieldRetrievingFactoryBean，下面以注入 FastJson 的 SerializerFeature 和自定义 enum 为例.

1
2
3
4
5
6
7
8
9
10

package com.alibaba.fastjson.serializer;

public enum SerializerFeature {
    QuoteFieldNames,
    UseSingleQuotes,
    WriteMapNullValue,
    WriteEnumUsingToString,
    WriteEnumUsingName,
    ...
}

1
2
3

public enum Color {
    RED, GREEN, BLUE
}

热更新在开发中对于提高效率是非常重要的，SpringBoot 的 org.springframework.boot:spring-boot-devtools 可以用来实现热加载

• 引入 devtools:

  1	implementation 'org.springframework.boot:spring-boot-devtools'

• 终端进入项目目录，执行 gradle -t classes 启动一个监听任务，当发现项目中的 Java 类发生变化时进行自动编译，模版文件变化时自动复制到 build 对应的目录中

  也可以使用 IDEA 的自动编译功能而不是这个命令: Compiler -> Build project automatically

• 终端进入项目目录，执行 gradle bootRun 启动项目

• 修改 Java 文件和模版文件等看看效果

Devtools 的热加载比较慢，不如 Springloaded 好用，但是在 SpringBoot 2 中不能用了，可以考虑 JRebel。

SpringBoot 2 默认使用 Thymeleaf 3，需要引入下面的依赖:

1

implementation('org.springframework.boot:spring-boot-starter-thymeleaf')

在 application.properties 中配置 Thymeleaf:

1
2
3
4
5

spring.thymeleaf.mode=HTML5
spring.thymeleaf.cache=false
spring.thymeleaf.suffix=.html
spring.thymeleaf.encoding=UTF-8
spring.thymeleaf.content-type=text/html

Controller:

1
2
3
4
5
6
7
8
9
10
11
12
13
14

package com.xtuer;

import org.springframework.stereotype.Controller;
import org.springframework.ui.ModelMap;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class XController {
    @GetMapping("/hello")
    public String hello(ModelMap model) {
        model.put("username", "Alice");
        return "hello.html";
    }
}

在 resources/templates 目录中创建文件 hello.html:

1
2
3
4
5
6
7
8
9
10
11
12

<!DOCTYPE html>
<html>

<head>
    <meta charset="utf-8"/>
</head>

<body>
    <span th:text="${username}">Thymeleaf</span>
</body>

</html>

访问 http://localhost:8080/hello 就可以看到页面了

SpringBoot 中使用 Redis 非常简单:

1. 引入依赖

   1	compile('org.springframework.boot:spring-boot-starter-data-redis')

2. 在 application.properties 中配置 Redis

   1 2 3 4 5 6 7 8 9

   spring.redis.host=localhost spring.redis.port=6379 spring.redis.password= spring.redis.database=0 spring.redis.pool.max-active=8 spring.redis.pool.max-wait=-1 spring.redis.pool.max-idle=8 spring.redis.pool.min-idle=0 spring.redis.timeout=0

3. 使用 StringRedisTemplate 访问 Redis

   1 2 3 4 5 6 7 8 9 10

   @RestController public class HelloController { @Autowired private StringRedisTemplate redisTemplate; @GetMapping("/redis") public String redis() { return redisTemplate.opsForValue().get("user"); } }

SpringBoot 使用 MyBatis 主要为以下 4 步:

1. 引入依赖

   1 2	implementation 'org.mybatis.spring.boot:mybatis-spring-boot-starter:2.0.0' runtime('mysql:mysql-connector-java:5.1.46')

2. 配置数据源: 配置 application.properties

   1 2 3 4

   spring.datasource.username=root spring.datasource.password=root spring.datasource.url=jdbc:mysql://localhost:3306/test spring.datasource.driver-class-name=com.mysql.jdbc.Driver

3. 编写 Mapper: 使用注解 @Mapper 自动生成 Mapper 对象

   1 2 3 4 5 6 7 8 9 10 11 12

   package com.xtuer.mapper; import org.apache.ibatis.annotations.Mapper; import org.apache.ibatis.annotations.Select; import java.util.Map; @Mapper public interface UserMapper { @Select("SELECT * FROM user WHERE username=#{username}") Map findUserByUsername(String username); }

4. 使用 Mapper: 使用 @Autowired 装配 mapper

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

   package com.xtuer.controller; import com.xtuer.mapper.UserMapper; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RestController; import java.util.Map; @RestController public class HelloController { @Autowired private UserMapper userMapper; @GetMapping("/hello") public Map hello(@RequestParam String username) { return userMapper.findUserByUsername(username); } }

Hexo 博客中所见文章都是经由渲染的静态网页，而静态网页的样式都直接由 Hexo 的主题控制，所以 Hexo 博客大部分都呈现出一种高度的统一化与规范化。不过 Hexo 提供了跳过渲染功能，使得我们可以直接在博客中放入自定义网页: 在 _config.yml 配置中配置 skip_render:

如果要跳过 source 文件夹下的test.html，可以这样配置：

1

skip_render: test.html

注意，千万不要加上个/写成/test.html，这里只能填相对于 source 文件夹的相对路径。

如果要忽略 source 下的 test 文件夹下所有文件，可以这样配置：

1

skip_render: test/*

如果要忽略 source 下的 test 文件夹下.html文件，可以这样配置：

1

skip_render: test/*.html

如果要忽略 source 下的 test 文件夹内所有文件包括子文件夹以及子文件夹内的文件，可以这样配置：

1

skip_render: test/**

如果要忽略多个路径的文件或目录，可以这样配置：

1
2
3

skip_render:
    - test.html
    - test/*

参考:

• Hexo 博客中跳过渲染，创建自定义网页
• Hexo 跳过指定文件的渲染

很多时候都会使用图片作为 widget 的背景，如果图片和 widget 一样大的话那就没什么好说的，背景效果和图片的效果看上去一样，可更多的时候我们会面临图片和 widget 不一样大，如果把图片简单的缩放到和 widget 一样大作为背景的话，背景常常会变形、有锯齿等，如下面的背景图大小为 128 x 108，要作为 300 x 200 大小的背景，直接缩放绘制的效果很不好，如若使用接下来将要介绍的九宫格绘图技术来绘制背景的话，效果正是我们期望的:

• 左边是直接缩放绘制的效果，背景发虚，有锯齿，圆角被放大
• 右边是九宫格技术绘制的效果，圆角和背景的圆角一样

Spring Security 中实现 QQ 登陆，可以在 FORM_LOGIN_FILTER 前插入一个 filter 用于拦截 QQ 登陆成功后的回调，进行身份认证。

开发前需要准备一个 QQ 互联账号和修改 hosts，按照下面的说明操作即可。

要点: Spring Security 中身份认证成功的标志很简单，只要用用户信息创建一个 Authentication 对象，保存到 SecurityContextHolder 就可以了。

Spring Security 发现 SecurityContextHolder 中有 Authentication 后，就认为用户已经通过了身份认证，对访问的资源进行权限验证时调用 Authentication.getAuthorities() 获取用户的权限进行验证。

注册 QQ 互联账号

1. 在开发前，需要在 QQ 互联 注册一个开发者账号: https://connect.qq.com
2. 然后点击 应用管理: https://connect.qq.com/manage.html
3. 创建 网站应用，里面有开发需要的 APP ID 和 APP Key

修改 hosts

例如我们在 QQ 互联中填写的回调 URL 为 http://open.qtdebug.com:8080/oauth/qq/callback，很显然 QQ 服务器是不能访问这个地址的，因为这个地址不存在，为了在 QQ 登陆成功后 QQ 服务器能访问这个地址，需要在系统的 hosts 文件里添加 127.0.0.1 open.qtdebug.com。

还有另一种方式是使用如 Ngrok 把本地映射为外网可访问。

Spring Boot 创建入门级 RESTful Web 项目简单到令人发指，下面就来看看怎么用吧(如果想知道 Spring Boot 是啥，搜索即可):

1. 创建项目的骨架
2. 添加 RestController
3. 启动项目: gradle bootRun
4. 打包项目: gradle build

创建项目的骨架

1. 访问 http://start.spring.io
2. 选择 Gradle 项目，Spring Boot 2.x
3. 填写 Group (项目的包名，例如 com.xtuer) 和 Artifact (可不填)
4. Search for dependencies 输入 web
5. 点击 Generate Project，会自动下载项目骨架 demo.zip
6. 解压，如果不需要里面的 gradlew，删除即可

在 Spring Security Session + Token 认证 中介绍了 Token 相关的身份验证，但是怎么验证 token 和使用 token 获取用户信息没有进行介绍，可以把 token 存储到 Redis、数据库等，下面介绍另一种 token 实现方法 JWT(Json Web Token)，这种 token 不需要存储到服务器，自身就能进行验证。

JWT 中存储了 token 的签名，用户信息，还可以存储 token 的签发时间用于服务器验证 token 的有效期，并且这些信息如果被篡改了的话就会导致 token 失效，JWT 的理论请参考 http://www.jianshu.com/p/576dbf44b2ae。

为了在 Spring Security 中使用 JWT，需要修改下面 3 个类:

• TokenAuthenticationFilter
• TokenService
• JwtUtils

如下面层级结构的权限:

1
2
3

ROLE_ADMIN > ROLE_STAFF
ROLE_STAFF > ROLE_USER
ROLE_USER  > ROLE_GUEST

A user who is authenticated with ROLE_ADMIN, will behave as if they have all four roles, as well the user will have the authorities ROLE_USER and ROLE_GUEST who is authenticated with ROLE_USER，请参考帮助文档。

Spring Security 里通过 RoleHierarchyVoter 实现权限继承(只需要配置，不需要写代码)。

注意:

<http> 需要设置 use-expressions 为 false，禁用 SpEL 表达式进行权限判断，因为它为 true 时 Spring Security 使用 WebExpressionConfigAttribute，它的 getAttribute() 总是返回 null，导致 RoleVoter.supports() 总是返回 false，于是权限校验失败，为 false 时使用的是 SecurityConfig，这时就没问题了，可以在 RoleVoter.vote() 中打断点进行验证。

坑爹的是，Spring Security 的帮助文档里没说这个，走了不少弯路。

微信企业号主要是为了链接组织和内部员工的，通过提供通讯录、组织新闻公告、活动、投票、调研、论坛 BBS、意见建议墙、招聘、考勤、流程审批、任务管理等一系列功能和服务，提高组织运作效率。微信企业号是微信为企业客户提供的移动服务，旨在提供企业移动应用入口。

微信企业号，有以下一些特点：

• 关注更安全

  只有企业通讯录的成员才能关注企业号，分级管理员、保密消息等各种特性确保企业内部信息的安全

• 应用可配置

  企业可自行在企业号中配置多个服务号，可以连接不同的企业应用系统，只有授权的企业成员才能使用相应的服务号

• 消息无限制

  发送消息无限制，并提供完善的管理接口及微信原生能力，以适应企业复杂、个性化的应用场景

• 使用更便捷

  企业号在微信中有统一的消息入口，用户可以更方便地管理企业号消息。微信通讯录也可以直接访问企业号中的应用

前面通过表单进行登陆，会为用户创建一个 session 保存在服务器端，session id 保存在 cookie 中，每次访问服务器的时候服务器端从 cookie 中读取 session id 然后找到用户的 session，就能知道当前用户的信息。但是对于移动端来说，传递 cookie 不是很方便，一般都会使用 token 来进行验证。

Token 就是一个字符串(可以使用 uuid)，验证时使用的 token 可以理解为和 session id 的功能差不多:

1. 用户申请 token 时，可以把 token 作为 key，用户信息的对象作为 value 保存到 Redis 中，把 token 返回给移动端
2. 移动端保存 token，有很多种方式，例如保存到文件中，sqlite 里都可以
3. 每次访问的时候把 token 放到请求的 header 中
4. 服务器端从 header 中读取 token，然后用 token 作为 key 去 Redis 中去读用户数据
5. 如果读取到的用户数据有效，则说明用户是合法的，认证通过，继续访问，否则返回错误，终止请求

使用纯 token 验证，不支持 session，这样的应用一般都是用来提供纯数据服务(应用中没有网页，很多微服务就是这样的)，以下叫 DSA(Data Service Application)，但是数据也是需要后台功能来管理的，大多都会使用 Web 应用，叫 DMA(Data Management Application)，Web 应用需要使用 session，也就是说 DSA 和 DMA 是独立的 2 个应用，不能共存，因为 DSA 中不支持 session，而 DMA 中需要 session。这种设计的好处是 DSA 很轻量级，只关心数据服务，能够降低开发的复杂度，还有其它比如每个服务都很简单，只关注于一个业务功能，每个微服务可以由不同的团队独立开发，微服务是松散耦合的等等。但是也有缺点，比如有可能对资源的访问需要重复实现，例如一个电子图书馆程序，读取图书信息的 API /api/books/{bookId} 在 DSA 中需要实现，在 DMA 中也要提供实现，因为 DMA 中也需要读取图书信息进行管理，就算用分布式服务使用 dubbo 负责服务治理，由 DMA 提供访问数据的逻辑，但是 DSA 和 DMA 里都至少也要各自有个 Controller 来处理这个 URL 吧。

本文的目的，是要实现一个 Web 应用即支持 session，同时又能支持使用 token 进行身份验证时不生成 session:

• 浏览器访问 /api/books/{bookId} 时，从 cookie 中读取 session id 找到对应的 session，获取当前用户，如果没有登陆则跳转到登陆页面进行登陆，登陆成功会创建 session
• 移动端访问 /api/books/{bookId} 时，从 header 中读取 token 找到对应的用户，如果没有 token 或者 token 过期、用户信息无效则返回错误提示未登陆认证(token 可以事先请求保存起来)，整个过程不会产生 session

程序在开发工具例如 Qt Creator 中运行没有问题，不少同学开发好后就直接把 xxx.exe 给用户使用，用户双击 xxx.exe 后提示错误，打开程序失败。很是奇怪: 程序在我的电脑里打开好好的，为什么到其他电脑上就不行了呢，是不是他的电脑有问题？不知道此同学有没有在自己电脑上双击过这个程序！

例如双击下面的 Gui.exe，提示找不到 libgcc_s_dw2-1.dll，那是因为 Qt 的程序运行的时候除了需要可执行程序本身外，还需要依赖一些其他的 dll，需要把这些 dll 一起打包给用户才行:

Qt 程序打包一般有 2 种方式，纯手动打包和半自动打包，下面以 Windows 中打包 Qt 程序 Gui.exe 为例进行介绍，环境如下:

• 安装 MinGW 的 Qt 5.9.1 到 F 盘
• DLL 目录: F:\Qt\Qt5.9.1\5.9.1\mingw53_32\bin
• Qt 的插件目录: F:\Qt\Qt5.9.1\5.9.1\mingw53_32\plugins

GitBook 是一个使用 Markdown 文件，用来写书、说明文档等的工具，它的官网已经有 5 万多本使用 GitBook 写的书了，现在不少公司都开始用 GitBook 来写项目文档、使用手册等。下面就简要的介绍怎么使用 GitBook，首先需要安装下面这些软件:

1. 安装 Git
2. 安装 Nodejs
3. 安装 GitBook: npm install gitbook -g
4. 安装 GitBook-Cli: npm install gitbook-cli -g

本地搭建 GitBook

本地搭建 GitBook 的好处是我们可以自己管理文件的存储，例如可以放到公司的 Git 私服上:

1. 创建目录例如 Pandora 用于存放书的文件，进入目录

2. 创建文件 README.md 和 SUMMARY.md，它们是 GitBook 最重要的 2 个文件，README.md 对书进行介绍，在 SUMMARY.md 中描述书的目录结构，其内容可参考如下:

   README.md:

   1	本书用于介绍 Pandora 项目的使用说明

   SUMMARY.md:

   1 2 3 4 5 6 7 8 9 10

   # Summary * [简介](README.md) * [第一章](chapter1/README.md) * [第一节](chapter1/section1.md) * [第二节](chapter1/section2.md) * [第二章](chapter2/README.md) * [第一节](chapter2/section1.md) * [第二节](chapter2/section2.md) * [结束](end/README.md)

3. 执行 gitbook init:

   会自动创建 SUMMARY.md 中描述的目录结构对应的文件夹和文件，每次执行这个命令都会创建还没有还不存在的文件和文件夹，但是不会影响已经创建的，所以不用担心多次执行 gitbook init 导致数据丢失

4. 编辑书的 Markdown 文件，例如 section1.md 等

5. 安装插件 gitbook install

6. 执行 gitbook serve，在浏览器里访问 http://localhost:4000 就可以看到上面写的书了，以后常用的也是这个命令，当文件变化后可以在网页中及时看到新的变化

   Bug: Windows 中 gitbook serve 运行后，当文件发生变化时不是自动更新网页而是退出，可以使用下面的脚本来运行 gitbook serve 解决这个问题：

   1 2 3 4

   @Echo off :Start call gitbook serve goto Start

   把上面的文件保存为 gs.bat 放到 GitBook 目录中，运行 gs.bat 就可以了。