From 9708b97c42575620a2ff8760978a8a98c65667b0 Mon Sep 17 00:00:00 2001
From: czyrye <81145281+czyrye@users.noreply.github.com>
Date: Thu, 4 Jul 2024 23:28:55 +0100
Subject: [PATCH 1/6] add explain file

---
 src/dbtest/src/doc/StaticTest.md | 167 +++++++++++++++++++++++++++++++
 1 file changed, 167 insertions(+)
 create mode 100644 src/dbtest/src/doc/StaticTest.md

diff --git a/src/dbtest/src/doc/StaticTest.md b/src/dbtest/src/doc/StaticTest.md
new file mode 100644
index 00000000..9c0dc746
--- /dev/null
+++ b/src/dbtest/src/doc/StaticTest.md
@@ -0,0 +1,167 @@
+### 简介
+
+该文档负责三个文件的说明，包括了代码功能、整体结构、与其他文件的关系和在项目中的作用等。
+
+
+
+## case_cntl.cc 
+
+该文件负责解析和处理测试文件中的SQL语句和事务ID，帮助读取和解析输入文件中的命令和数据，并将结果输出。
+
+### 整体结构：
+
+头文件引入，名为`case_cntl.h`
+
+```c++
+#include "case_cntl.h"
+```
+
+
+
+全局对象：outputter`和`result_handler，分别用于输出和结果处理
+
+```c++
+Outputter outputter;
+ResultHandler result_handler;
+```
+
+
+
+### 函数声明和定义
+
+- `CaseReader`类
+
+   包含多个成员函数，用于处理SQL语句的执行和错误信息的获取。
+
+  - `TxnIdAndSql`：用于获取特定行的事务ID和SQL语句，解析输入行，提取执行顺序ID、交易事务ID和SQL语句。
+  - `SqlIdAndResult`：解析输入行，提取 SQL ID 及其预期结果
+  - `Isolation`：提取字符串行中的隔离级别。
+  - `InitTestSequenceAndTestResultSetList`：根据提供的测试路径和数据库类型，初始化测试序列和结果集(casecntl)。
+  - `TestSequenceAndTestResultSetFromFile`：解析提供的测试文件以提取测试序列及其相应的预期结果。
+
+- `ResulHandler`类
+
+  主要负责比较SQL查询结果，并确定它们是否符合预期结果。以下是该类中关键函数的声明和定义：
+
+  - `IsSqlExpectedResult`：用于将当前 SQL 结果与预期 SQL 结果进行比较。
+  - `IsTestExpectedResult`：用于将当前测试结果与一组预期测试结果进行比较。
+
+- `Outputter`类
+
+  主要负责将各种类型的输出写入文件，特别是与测试结果相关的输出。
+
+  - `WriteResultTotal`：该函数功能是将测试结果集的摘要信息写入指定的文件。它从每个 `TestResultSet` 对象中提取简化的测试结果，并将每个测试用例类型及其对应的结果写入到提供的输出文件中。
+  - `PrintAndWriteTxnSqlResult`：该函数功能是将当前 SQL 结果与一组预期结果进行比较，并将比较结果输出到控制台和文件。
+  - `WriteTestCaseTypeToFile`：该函数功能是将给定的结果类型附加写入到指定的文件中，并在结果类型前添加 "Test Result:" 前缀进行说明。
+
+### 项目中的作用
+
+该文件的整体结构和内容围绕SQL语句的解析和执行，提供了一系列工具函数和类方法来处理SQL相关的操作和测试结果的比较。通过详细的函数定义和类方法，实现了对SQL语句执行过程中的各种操作和错误处理。
+
+#### 	
+
+## sqltest.cc 
+
+该文件用于执行多线程SQL事务测试的，主要功能是通过多线程环境下执行多组SQL事务，并验证其结果。
+
+### 整体结构
+
+头文件和库引入
+
+```c++
+#include "gflags/gflags.h"
+#include "sqltest.h"
+#include <thread>
+#include <unistd.h>
+#include <mutex>
+#include <regex>
+```
+
+包括必要的头文件，`gflags/gflags.h`、`sqltest.h`、`thread`、`unistd.h`、`mutex`、`regex`。
+
+命令行参数定义，使用gflags库定义了一系列命令行参数，如数据库类型、用户名、密码、数据库名、连接池大小、事务隔离级别、测试用例目录、超时时间等。
+
+全局变量
+
+定义了一个全局的互斥锁向量`mutex_txn`，用于管理不同事务的锁。
+
+### 函数声明和定义
+
+- **`try_lock_wait`**：尝试在给定超时时间内获取指定的互斥锁，用于多线程锁机制。
+- **`MultiThreadExecution`**：在多线程环境下执行一组SQL事务。该函数使用 `DBConnector` 类来执行SQL语句，并在事务执行过程中进行锁操作和错误处理。
+- **`JobExecutor::ExecTestSequence`**：执行一系列数据库测试事务，并将结果写入指定文件。该函数通过调用`MultiThreadExecution`函数来实现多线程事务执行。
+
+### 项目中的作用
+
+**数据库类型的支持**：支持多种数据库类型（如MySQL、PostgreSQL、Oracle等）的事务测试。
+
+**多线程事务执行**：通过多线程机制执行事务，模拟高并发环境下的事务处理情况。
+
+**事务隔离级别测试**：支持不同的事务隔离级别，验证数据库在不同隔离级别下的行为。
+
+**结果验证与输出**：执行事务后，将测试结果写入指定的输出文件中，以供后续分析和验证。
+
+
+
+## sql_cntl.cc 
+
+该文件用于执行SQL语句并处理数据库连接。文件中定义了一些工具函数和一个主要的数据库连接器类`DBConnector`。
+
+### 整体结构
+
+头文件和库引入
+
+```c++
+#include "sql_cntl.h"
+#include <time.h>
+#include <chrono>
+#include <string>
+#include <regex>
+```
+
+工具函数的定义：用于时间获取、字符串替换和类型转换等。
+
+DBConnector类的定义：处理SQL语句执行、错误信息获取和结果集处理等。
+
+
+
+### 对象声明和定义
+
+- `DBConnector`类
+
+  包含多个成员函数，用于处理SQL语句的执行和错误信息的获取。
+
+  - `ErrInfoWithStmt`：用于获取特定句柄的错误信息。
+  - `SqlExecuteErr`：处理SQL执行的错误信息。
+  - `ExecWriteSql`：执行写入类型的SQL语句。
+  - `ExecReadSql2Int`：执行读取类型的SQL语句并处理结果。
+
+
+
+### 函数声明和定义
+
+- **`get_current_time`**：该函数用于获取当前时间。
+- **`replace`**：该函数用于进行字符串替换。
+- **`SQLCHARToStr`**：该函数用于将`SQLCHAR`类型转换为`std::string`类型。
+- **`DBConnector::ErrInfoWithStmt`**：该函数用于获取错误信息。
+- **`DBConnector::SqlExecuteErr`**：该函数用于处理SQL执行返回值。
+- **`DBConnector::ExecWriteSql`**：该函数用于执行写入SQL语句。
+- **`DBConnector::ExecReadSql2Int`**：该函数用于执行读取SQL语句并处理结果集。
+
+
+
+### 项目中的作用
+
+该文件在整个项目中主要负责与数据库的交互，执行SQL语句，并在执行过程中进行错误处理和日志记录。通过提供对数据库操作的封装和抽象，`DBConnector`类使得上层应用程序可以更简便地进行数据库操作，同时提供详细的错误信息以便于调试和维护。
+
+
+
+## 文件之间的关系
+
+1. `sql_cntl.cc` 和 `sqltest.cc` ：
+   - `sqltest.cc` 依赖于 `sql_cntl.cc` 中的 `DBConnector` 类来执行具体的SQL操作。`sqltest.txt` 使用 `DBConnector` 类的方法来执行SQL语句，并在多线程环境下进行事务测试。
+2. `sql_cntl.cc` 和 `case_cntl.cc` ：
+   - `case_cntl.cc` 中的解析结果（SQL语句和事务ID）会通过某种方式传递给 `sqltest.cc` 中的测试执行函数。而这些SQL操作实际是由 `sql_cntl.cc` 中的 `DBConnector` 类完成的。
+3. `sql_test.cc` 和 `case_cntl.cc` ：
+   - `case_cntl.cc` 负责读取和解析测试用例文件，提取出SQL语句和事务ID。
+   - 这些解析后的数据会被传递给 `sqltest.cc`，然后由 `sqltest.cc` 进行多线程的事务执行测试

From 89ff302b315a97ba972b500c3dc5286b1c61d0e5 Mon Sep 17 00:00:00 2001
From: czyrye <81145281+czyrye@users.noreply.github.com>
Date: Fri, 5 Jul 2024 00:18:10 +0100
Subject: [PATCH 2/6] add file

---
 src/dbtest/src/doc/StaticTest.md | 102 ++++++-------------------------
 1 file changed, 19 insertions(+), 83 deletions(-)

diff --git a/src/dbtest/src/doc/StaticTest.md b/src/dbtest/src/doc/StaticTest.md
index 9c0dc746..e05bcb75 100644
--- a/src/dbtest/src/doc/StaticTest.md
+++ b/src/dbtest/src/doc/StaticTest.md
@@ -10,53 +10,29 @@
 
 ### 整体结构：
 
-头文件引入，名为`case_cntl.h`
+首先引入头文件，接着定义全局对象：outputter`和`result_handler，分别用于输出和结果处理。再进行函数声明及定义，包括`CaseReader`类里处理SQL语句的执行和错误信息的获取函数，`ResulHandler`类里比较SQL查询结果多函数，`Outputter`类将与测试结果相关的输出写入指定的文件的函数。
 
-```c++
-#include "case_cntl.h"
-```
-
-
-
-全局对象：outputter`和`result_handler，分别用于输出和结果处理
-
-```c++
-Outputter outputter;
-ResultHandler result_handler;
-```
-
-
-
-### 函数声明和定义
+#### 函数声明和定义
 
 - `CaseReader`类
-
-   包含多个成员函数，用于处理SQL语句的执行和错误信息的获取。
-
   - `TxnIdAndSql`：用于获取特定行的事务ID和SQL语句，解析输入行，提取执行顺序ID、交易事务ID和SQL语句。
-  - `SqlIdAndResult`：解析输入行，提取 SQL ID 及其预期结果
+   - `SqlIdAndResult`：解析输入行，提取 SQL ID 及其预期结果
   - `Isolation`：提取字符串行中的隔离级别。
   - `InitTestSequenceAndTestResultSetList`：根据提供的测试路径和数据库类型，初始化测试序列和结果集(casecntl)。
   - `TestSequenceAndTestResultSetFromFile`：解析提供的测试文件以提取测试序列及其相应的预期结果。
-
+  
 - `ResulHandler`类
-
-  主要负责比较SQL查询结果，并确定它们是否符合预期结果。以下是该类中关键函数的声明和定义：
-
-  - `IsSqlExpectedResult`：用于将当前 SQL 结果与预期 SQL 结果进行比较。
+- `IsSqlExpectedResult`：用于将当前 SQL 结果与预期 SQL 结果进行比较。
   - `IsTestExpectedResult`：用于将当前测试结果与一组预期测试结果进行比较。
 
 - `Outputter`类
-
-  主要负责将各种类型的输出写入文件，特别是与测试结果相关的输出。
-
-  - `WriteResultTotal`：该函数功能是将测试结果集的摘要信息写入指定的文件。它从每个 `TestResultSet` 对象中提取简化的测试结果，并将每个测试用例类型及其对应的结果写入到提供的输出文件中。
-  - `PrintAndWriteTxnSqlResult`：该函数功能是将当前 SQL 结果与一组预期结果进行比较，并将比较结果输出到控制台和文件。
-  - `WriteTestCaseTypeToFile`：该函数功能是将给定的结果类型附加写入到指定的文件中，并在结果类型前添加 "Test Result:" 前缀进行说明。
+- `WriteResultTotal`：将测试结果集的摘要信息写入指定的文件。
+  - `PrintAndWriteTxnSqlResult`：将当前 SQL 结果与一组预期结果进行比较，并将比较结果输出到控制台和文件。
+- `WriteTestCaseTypeToFile`：将给定的结果类型附加写入到指定的文件中，并在结果类型前添加 "Test Result:" 前缀进行说明。
 
 ### 项目中的作用
 
-该文件的整体结构和内容围绕SQL语句的解析和执行，提供了一系列工具函数和类方法来处理SQL相关的操作和测试结果的比较。通过详细的函数定义和类方法，实现了对SQL语句执行过程中的各种操作和错误处理。
+该文件的整体结构和内容围绕SQL语句的解析和执行，提供了一系列工具函数和类方法来处理SQL相关的操作，比较测试结果。
 
 #### 	
 
@@ -66,26 +42,9 @@ ResultHandler result_handler;
 
 ### 整体结构
 
-头文件和库引入
+首先进行头文件和库引入，接着使用gflags库定义了一系列命令行参数，如数据库类型、用户名、密码、数据库名、连接池大小、事务隔离级别、测试用例目录、超时时间等。定义了一个全局的互斥锁向量`mutex_txn`，用于管理不同事务的锁。再定义函数。
 
-```c++
-#include "gflags/gflags.h"
-#include "sqltest.h"
-#include <thread>
-#include <unistd.h>
-#include <mutex>
-#include <regex>
-```
-
-包括必要的头文件，`gflags/gflags.h`、`sqltest.h`、`thread`、`unistd.h`、`mutex`、`regex`。
-
-命令行参数定义，使用gflags库定义了一系列命令行参数，如数据库类型、用户名、密码、数据库名、连接池大小、事务隔离级别、测试用例目录、超时时间等。
-
-全局变量
-
-定义了一个全局的互斥锁向量`mutex_txn`，用于管理不同事务的锁。
-
-### 函数声明和定义
+#### 函数声明和定义
 
 - **`try_lock_wait`**：尝试在给定超时时间内获取指定的互斥锁，用于多线程锁机制。
 - **`MultiThreadExecution`**：在多线程环境下执行一组SQL事务。该函数使用 `DBConnector` 类来执行SQL语句，并在事务执行过程中进行锁操作和错误处理。
@@ -99,56 +58,33 @@ ResultHandler result_handler;
 
 **事务隔离级别测试**：支持不同的事务隔离级别，验证数据库在不同隔离级别下的行为。
 
-**结果验证与输出**：执行事务后，将测试结果写入指定的输出文件中，以供后续分析和验证。
+**结果验证与输出**：执行事务后，将测试结果写入指定的输出文件中，以供后续分析验证。
 
 
 
 ## sql_cntl.cc 
 
-该文件用于执行SQL语句并处理数据库连接。文件中定义了一些工具函数和一个主要的数据库连接器类`DBConnector`。
+该文件用于执行SQL语句并处理数据库连接。
 
 ### 整体结构
 
-头文件和库引入
-
-```c++
-#include "sql_cntl.h"
-#include <time.h>
-#include <chrono>
-#include <string>
-#include <regex>
-```
-
-工具函数的定义：用于时间获取、字符串替换和类型转换等。
+首先定义头文件和库引入，接着定义工具函数，用于时间获取、字符串替换和类型转换等。再进行函数声明及定义，包括`DBConnector`类处理SQL语句的执行的函数，获取时间，替换字符串等功能的函数。
 
-DBConnector类的定义：处理SQL语句执行、错误信息获取和结果集处理等。
-
-
-
-### 对象声明和定义
+#### 函数声明和定义
 
 - `DBConnector`类
-
-  包含多个成员函数，用于处理SQL语句的执行和错误信息的获取。
-
   - `ErrInfoWithStmt`：用于获取特定句柄的错误信息。
   - `SqlExecuteErr`：处理SQL执行的错误信息。
   - `ExecWriteSql`：执行写入类型的SQL语句。
   - `ExecReadSql2Int`：执行读取类型的SQL语句并处理结果。
 
+- **`get_current_time`**：用于获取当前时间。
 
+- **`replace`**：进行字符串替换。
 
-### 函数声明和定义
-
-- **`get_current_time`**：该函数用于获取当前时间。
-- **`replace`**：该函数用于进行字符串替换。
-- **`SQLCHARToStr`**：该函数用于将`SQLCHAR`类型转换为`std::string`类型。
-- **`DBConnector::ErrInfoWithStmt`**：该函数用于获取错误信息。
-- **`DBConnector::SqlExecuteErr`**：该函数用于处理SQL执行返回值。
-- **`DBConnector::ExecWriteSql`**：该函数用于执行写入SQL语句。
-- **`DBConnector::ExecReadSql2Int`**：该函数用于执行读取SQL语句并处理结果集。
-
+- **`SQLCHARToStr`**：用于将`SQLCHAR`类型转换为`std::string`类型。
 
+  
 
 ### 项目中的作用
 

From 20de8111929dac862f140c045cf1da6700102941 Mon Sep 17 00:00:00 2001
From: czyrye <81145281+czyrye@users.noreply.github.com>
Date: Fri, 5 Jul 2024 01:15:56 +0100
Subject: [PATCH 3/6] add file

---
 src/dbtest/src/doc/StaticTest.md | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/src/dbtest/src/doc/StaticTest.md b/src/dbtest/src/doc/StaticTest.md
index e05bcb75..729b3737 100644
--- a/src/dbtest/src/doc/StaticTest.md
+++ b/src/dbtest/src/doc/StaticTest.md
@@ -88,16 +88,15 @@
 
 ### 项目中的作用
 
-该文件在整个项目中主要负责与数据库的交互，执行SQL语句，并在执行过程中进行错误处理和日志记录。通过提供对数据库操作的封装和抽象，`DBConnector`类使得上层应用程序可以更简便地进行数据库操作，同时提供详细的错误信息以便于调试和维护。
+该文件在整个项目中主要负责与数据库的交互，执行SQL语句，并在执行过程中进行错误处理和日志记录。
 
 
 
 ## 文件之间的关系
 
 1. `sql_cntl.cc` 和 `sqltest.cc` ：
-   - `sqltest.cc` 依赖于 `sql_cntl.cc` 中的 `DBConnector` 类来执行具体的SQL操作。`sqltest.txt` 使用 `DBConnector` 类的方法来执行SQL语句，并在多线程环境下进行事务测试。
+   - `sqltest.cc` 依赖于 `sql_cntl.cc` 中的工具和辅助函数来执行具体的SQL操作，`sqltest.cc`利用 `sql_cntl.cc` 定义的结果处理和输出函数来验证正确性，并报告结果。`sqlcntl.txt`负责具体的SQL执行逻辑，为`sqltest.txt`提供支持。
 2. `sql_cntl.cc` 和 `case_cntl.cc` ：
-   - `case_cntl.cc` 中的解析结果（SQL语句和事务ID）会通过某种方式传递给 `sqltest.cc` 中的测试执行函数。而这些SQL操作实际是由 `sql_cntl.cc` 中的 `DBConnector` 类完成的。
+   - `case_cntl.cc` 的函数和类读取测试用例、解析预期结果以及将实际结果与这些预期进行比较。 `sqltest.cc` 负责执行SQL语句的逻辑，并调用这些比较函数。
 3. `sql_test.cc` 和 `case_cntl.cc` ：
-   - `case_cntl.cc` 负责读取和解析测试用例文件，提取出SQL语句和事务ID。
-   - 这些解析后的数据会被传递给 `sqltest.cc`，然后由 `sqltest.cc` 进行多线程的事务执行测试
+   - `case_cntl.cc` 负责读取和解析测试用例文件，和预期结果预期结果。这些解析后的数据会被传递给 `sqltest.cc`，然后由 `sqltest.cc` 进行多线程的事务执行测试。

From fe47caee934488683abbf5630758626e681555e3 Mon Sep 17 00:00:00 2001
From: czy <81145281+czyrye@users.noreply.github.com>
Date: Wed, 24 Jul 2024 21:46:52 +0100
Subject: [PATCH 4/6] translate to english

---
 StaticTest.md | 166 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 166 insertions(+)
 create mode 100644 StaticTest.md

diff --git a/StaticTest.md b/StaticTest.md
new file mode 100644
index 00000000..8e2c606a
--- /dev/null
+++ b/StaticTest.md
@@ -0,0 +1,166 @@
+### 简介
+
+该文档负责三个文件的说明，包括了代码功能、整体结构、与其他文件的关系和在项目中的作用等。
+
+
+
+## case_cntl.cc 
+
+该文件负责解析和处理测试文件中的SQL语句和事务ID，帮助读取和解析输入文件中的命令和数据，并将结果输出。
+
+### 整体结构：
+
+头文件引入，名为`case_cntl.h`
+
+```c++
+#include "case_cntl.h"
+```
+
+
+
+全局对象：outputter`和`result_handler，分别用于输出和结果处理
+
+```c++
+Outputter outputter;
+ResultHandler result_handler;
+```
+
+
+
+### 函数声明和定义
+
+- `CaseReader`类
+
+   包含多个成员函数，用于处理SQL语句的执行和错误信息的获取。
+
+  - `TxnIdAndSql`：用于获取特定行的事务ID和SQL语句，解析输入行，提取执行顺序ID、交易事务ID和SQL语句。
+  - `SqlIdAndResult`：解析输入行，提取 SQL ID 及其预期结果
+  - `Isolation`：提取字符串行中的隔离级别。
+  - `InitTestSequenceAndTestResultSetList`：根据提供的测试路径和数据库类型，初始化测试序列和结果集(casecntl)。
+  - `TestSequenceAndTestResultSetFromFile`：解析提供的测试文件以提取测试序列及其相应的预期结果。
+
+- `ResulHandler`类
+
+  主要负责比较SQL查询结果，并确定它们是否符合预期结果。以下是该类中关键函数的声明和定义：
+
+  - `IsSqlExpectedResult`：用于将当前 SQL 结果与预期 SQL 结果进行比较。
+  - `IsTestExpectedResult`：用于将当前测试结果与一组预期测试结果进行比较。
+
+- `Outputter`类
+
+  主要负责将各种类型的输出写入文件，特别是与测试结果相关的输出。
+
+  - `WriteResultTotal`：该函数功能是将测试结果集的摘要信息写入指定的文件。它从每个 `TestResultSet` 对象中提取简化的测试结果，并将每个测试用例类型及其对应的结果写入到提供的输出文件中。
+  - `PrintAndWriteTxnSqlResult`：该函数功能是将当前 SQL 结果与一组预期结果进行比较，并将比较结果输出到控制台和文件。
+  - `WriteTestCaseTypeToFile`：该函数功能是将给定的结果类型附加写入到指定的文件中，并在结果类型前添加 "Test Result:" 前缀进行说明。
+
+### 项目中的作用
+
+该文件的整体结构和内容围绕SQL语句的解析和执行，提供了一系列工具函数和类方法来处理SQL相关的操作和测试结果的比较。通过详细的函数定义和类方法，实现了对SQL语句执行过程中的各种操作和错误处理。
+
+#### 	
+
+## sqltest.cc 
+
+该文件用于执行多线程SQL事务测试的，主要功能是通过多线程环境下执行多组SQL事务，并验证其结果。
+
+### 整体结构
+
+头文件和库引入
+
+```c++
+#include "gflags/gflags.h"
+#include "sqltest.h"
+#include <thread>
+#include <unistd.h>
+#include <mutex>
+#include <regex>
+```
+
+包括必要的头文件，`gflags/gflags.h`、`sqltest.h`、`thread`、`unistd.h`、`mutex`、`regex`。
+
+命令行参数定义，使用gflags库定义了一系列命令行参数，如数据库类型、用户名、密码、数据库名、连接池大小、事务隔离级别、测试用例目录、超时时间等。
+
+全局变量
+
+定义了一个全局的互斥锁向量`mutex_txn`，用于管理不同事务的锁。
+
+### 函数声明和定义
+
+- **`try_lock_wait`**：尝试在给定超时时间内获取指定的互斥锁，用于多线程锁机制。
+- **`MultiThreadExecution`**：在多线程环境下执行一组SQL事务。该函数使用 `DBConnector` 类来执行SQL语句，并在事务执行过程中进行锁操作和错误处理。
+- **`JobExecutor::ExecTestSequence`**：执行一系列数据库测试事务，并将结果写入指定文件。该函数通过调用`MultiThreadExecution`函数来实现多线程事务执行。
+
+### 项目中的作用
+
+**数据库类型的支持**：支持多种数据库类型（如MySQL、PostgreSQL、Oracle等）的事务测试。
+
+**多线程事务执行**：通过多线程机制执行事务，模拟高并发环境下的事务处理情况。
+
+**事务隔离级别测试**：支持不同的事务隔离级别，验证数据库在不同隔离级别下的行为。
+
+**结果验证与输出**：执行事务后，将测试结果写入指定的输出文件中，以供后续分析和验证。
+
+
+
+## sql_cntl.cc 
+
+该文件用于执行SQL语句并处理数据库连接。文件中定义了一些工具函数和一个主要的数据库连接器类`DBConnector`。
+
+### 整体结构
+
+头文件和库引入
+
+```c++
+#include "sql_cntl.h"
+#include <time.h>
+#include <chrono>
+#include <string>
+#include <regex>
+```
+
+工具函数的定义：用于时间获取、字符串替换和类型转换等。
+
+DBConnector类的定义：处理SQL语句执行、错误信息获取和结果集处理等。
+
+
+
+### 对象声明和定义
+
+- `DBConnector`类
+
+  包含多个成员函数，用于处理SQL语句的执行和错误信息的获取。
+
+  - `ErrInfoWithStmt`：用于获取特定句柄的错误信息。
+  - `SqlExecuteErr`：处理SQL执行的错误信息。
+  - `ExecWriteSql`：执行写入类型的SQL语句。
+  - `ExecReadSql2Int`：执行读取类型的SQL语句并处理结果。
+
+
+
+### 函数声明和定义
+
+- **`get_current_time`**：该函数用于获取当前时间。
+- **`replace`**：该函数用于进行字符串替换。
+- **`SQLCHARToStr`**：该函数用于将`SQLCHAR`类型转换为`std::string`类型。
+- **`DBConnector::ErrInfoWithStmt`**：该函数用于获取错误信息。
+- **`DBConnector::SqlExecuteErr`**：该函数用于处理SQL执行返回值。
+- **`DBConnector::ExecWriteSql`**：该函数用于执行写入SQL语句。
+- **`DBConnector::ExecReadSql2Int`**：该函数用于执行读取SQL语句并处理结果集。
+
+
+
+### 项目中的作用
+
+该文件在整个项目中主要负责与数据库的交互，执行SQL语句，并在执行过程中进行错误处理和日志记录。
+
+
+
+## 文件之间的关系
+
+1. `sql_cntl.cc` 和 `sqltest.cc` ：
+   - `sqltest.cc` 依赖于 `sql_cntl.cc` 中的工具和辅助函数来执行具体的SQL操作，`sqltest.cc`利用 `sql_cntl.cc` 定义的结果处理和输出函数来验证正确性，并报告结果。`sqlcntl.txt`负责具体的SQL执行逻辑，为`sqltest.txt`提供支持。
+2. `sql_cntl.cc` 和 `case_cntl.cc` ：
+   - `case_cntl.cc` 的函数和类读取测试用例、解析预期结果以及将实际结果与这些预期进行比较。 `sqltest.cc` 负责执行SQL语句的逻辑，并调用这些比较函数。
+3. `sql_test.cc` 和 `case_cntl.cc` ：
+   - `case_cntl.cc` 负责读取和解析测试用例文件，和预期结果预期结果。这些解析后的数据会被传递给 `sqltest.cc`，然后由 `sqltest.cc` 进行多线程的事务执行测试。

From 2ccc54597caabe01ba77a39e8049347c77246bd7 Mon Sep 17 00:00:00 2001
From: czy <81145281+czyrye@users.noreply.github.com>
Date: Wed, 24 Jul 2024 22:06:44 +0100
Subject: [PATCH 5/6] translate to english

---
 StaticTest.md | 166 --------------------------------------------------
 1 file changed, 166 deletions(-)
 delete mode 100644 StaticTest.md

diff --git a/StaticTest.md b/StaticTest.md
deleted file mode 100644
index 8e2c606a..00000000
--- a/StaticTest.md
+++ /dev/null
@@ -1,166 +0,0 @@
-### 简介
-
-该文档负责三个文件的说明，包括了代码功能、整体结构、与其他文件的关系和在项目中的作用等。
-
-
-
-## case_cntl.cc 
-
-该文件负责解析和处理测试文件中的SQL语句和事务ID，帮助读取和解析输入文件中的命令和数据，并将结果输出。
-
-### 整体结构：
-
-头文件引入，名为`case_cntl.h`
-
-```c++
-#include "case_cntl.h"
-```
-
-
-
-全局对象：outputter`和`result_handler，分别用于输出和结果处理
-
-```c++
-Outputter outputter;
-ResultHandler result_handler;
-```
-
-
-
-### 函数声明和定义
-
-- `CaseReader`类
-
-   包含多个成员函数，用于处理SQL语句的执行和错误信息的获取。
-
-  - `TxnIdAndSql`：用于获取特定行的事务ID和SQL语句，解析输入行，提取执行顺序ID、交易事务ID和SQL语句。
-  - `SqlIdAndResult`：解析输入行，提取 SQL ID 及其预期结果
-  - `Isolation`：提取字符串行中的隔离级别。
-  - `InitTestSequenceAndTestResultSetList`：根据提供的测试路径和数据库类型，初始化测试序列和结果集(casecntl)。
-  - `TestSequenceAndTestResultSetFromFile`：解析提供的测试文件以提取测试序列及其相应的预期结果。
-
-- `ResulHandler`类
-
-  主要负责比较SQL查询结果，并确定它们是否符合预期结果。以下是该类中关键函数的声明和定义：
-
-  - `IsSqlExpectedResult`：用于将当前 SQL 结果与预期 SQL 结果进行比较。
-  - `IsTestExpectedResult`：用于将当前测试结果与一组预期测试结果进行比较。
-
-- `Outputter`类
-
-  主要负责将各种类型的输出写入文件，特别是与测试结果相关的输出。
-
-  - `WriteResultTotal`：该函数功能是将测试结果集的摘要信息写入指定的文件。它从每个 `TestResultSet` 对象中提取简化的测试结果，并将每个测试用例类型及其对应的结果写入到提供的输出文件中。
-  - `PrintAndWriteTxnSqlResult`：该函数功能是将当前 SQL 结果与一组预期结果进行比较，并将比较结果输出到控制台和文件。
-  - `WriteTestCaseTypeToFile`：该函数功能是将给定的结果类型附加写入到指定的文件中，并在结果类型前添加 "Test Result:" 前缀进行说明。
-
-### 项目中的作用
-
-该文件的整体结构和内容围绕SQL语句的解析和执行，提供了一系列工具函数和类方法来处理SQL相关的操作和测试结果的比较。通过详细的函数定义和类方法，实现了对SQL语句执行过程中的各种操作和错误处理。
-
-#### 	
-
-## sqltest.cc 
-
-该文件用于执行多线程SQL事务测试的，主要功能是通过多线程环境下执行多组SQL事务，并验证其结果。
-
-### 整体结构
-
-头文件和库引入
-
-```c++
-#include "gflags/gflags.h"
-#include "sqltest.h"
-#include <thread>
-#include <unistd.h>
-#include <mutex>
-#include <regex>
-```
-
-包括必要的头文件，`gflags/gflags.h`、`sqltest.h`、`thread`、`unistd.h`、`mutex`、`regex`。
-
-命令行参数定义，使用gflags库定义了一系列命令行参数，如数据库类型、用户名、密码、数据库名、连接池大小、事务隔离级别、测试用例目录、超时时间等。
-
-全局变量
-
-定义了一个全局的互斥锁向量`mutex_txn`，用于管理不同事务的锁。
-
-### 函数声明和定义
-
-- **`try_lock_wait`**：尝试在给定超时时间内获取指定的互斥锁，用于多线程锁机制。
-- **`MultiThreadExecution`**：在多线程环境下执行一组SQL事务。该函数使用 `DBConnector` 类来执行SQL语句，并在事务执行过程中进行锁操作和错误处理。
-- **`JobExecutor::ExecTestSequence`**：执行一系列数据库测试事务，并将结果写入指定文件。该函数通过调用`MultiThreadExecution`函数来实现多线程事务执行。
-
-### 项目中的作用
-
-**数据库类型的支持**：支持多种数据库类型（如MySQL、PostgreSQL、Oracle等）的事务测试。
-
-**多线程事务执行**：通过多线程机制执行事务，模拟高并发环境下的事务处理情况。
-
-**事务隔离级别测试**：支持不同的事务隔离级别，验证数据库在不同隔离级别下的行为。
-
-**结果验证与输出**：执行事务后，将测试结果写入指定的输出文件中，以供后续分析和验证。
-
-
-
-## sql_cntl.cc 
-
-该文件用于执行SQL语句并处理数据库连接。文件中定义了一些工具函数和一个主要的数据库连接器类`DBConnector`。
-
-### 整体结构
-
-头文件和库引入
-
-```c++
-#include "sql_cntl.h"
-#include <time.h>
-#include <chrono>
-#include <string>
-#include <regex>
-```
-
-工具函数的定义：用于时间获取、字符串替换和类型转换等。
-
-DBConnector类的定义：处理SQL语句执行、错误信息获取和结果集处理等。
-
-
-
-### 对象声明和定义
-
-- `DBConnector`类
-
-  包含多个成员函数，用于处理SQL语句的执行和错误信息的获取。
-
-  - `ErrInfoWithStmt`：用于获取特定句柄的错误信息。
-  - `SqlExecuteErr`：处理SQL执行的错误信息。
-  - `ExecWriteSql`：执行写入类型的SQL语句。
-  - `ExecReadSql2Int`：执行读取类型的SQL语句并处理结果。
-
-
-
-### 函数声明和定义
-
-- **`get_current_time`**：该函数用于获取当前时间。
-- **`replace`**：该函数用于进行字符串替换。
-- **`SQLCHARToStr`**：该函数用于将`SQLCHAR`类型转换为`std::string`类型。
-- **`DBConnector::ErrInfoWithStmt`**：该函数用于获取错误信息。
-- **`DBConnector::SqlExecuteErr`**：该函数用于处理SQL执行返回值。
-- **`DBConnector::ExecWriteSql`**：该函数用于执行写入SQL语句。
-- **`DBConnector::ExecReadSql2Int`**：该函数用于执行读取SQL语句并处理结果集。
-
-
-
-### 项目中的作用
-
-该文件在整个项目中主要负责与数据库的交互，执行SQL语句，并在执行过程中进行错误处理和日志记录。
-
-
-
-## 文件之间的关系
-
-1. `sql_cntl.cc` 和 `sqltest.cc` ：
-   - `sqltest.cc` 依赖于 `sql_cntl.cc` 中的工具和辅助函数来执行具体的SQL操作，`sqltest.cc`利用 `sql_cntl.cc` 定义的结果处理和输出函数来验证正确性，并报告结果。`sqlcntl.txt`负责具体的SQL执行逻辑，为`sqltest.txt`提供支持。
-2. `sql_cntl.cc` 和 `case_cntl.cc` ：
-   - `case_cntl.cc` 的函数和类读取测试用例、解析预期结果以及将实际结果与这些预期进行比较。 `sqltest.cc` 负责执行SQL语句的逻辑，并调用这些比较函数。
-3. `sql_test.cc` 和 `case_cntl.cc` ：
-   - `case_cntl.cc` 负责读取和解析测试用例文件，和预期结果预期结果。这些解析后的数据会被传递给 `sqltest.cc`，然后由 `sqltest.cc` 进行多线程的事务执行测试。

From edd361d1c75bac30eb7d7f2668f8605dc2461285 Mon Sep 17 00:00:00 2001
From: czyrye <81145281+czyrye@users.noreply.github.com>
Date: Wed, 24 Jul 2024 22:17:04 +0100
Subject: [PATCH 6/6] translate to english

---
 src/dbtest/src/doc/StaticTest.md | 114 +++++++++++++++----------------
 1 file changed, 57 insertions(+), 57 deletions(-)

diff --git a/src/dbtest/src/doc/StaticTest.md b/src/dbtest/src/doc/StaticTest.md
index 729b3737..e0d6cfaa 100644
--- a/src/dbtest/src/doc/StaticTest.md
+++ b/src/dbtest/src/doc/StaticTest.md
@@ -1,102 +1,102 @@
-### 简介
+### Introduction
 
-该文档负责三个文件的说明，包括了代码功能、整体结构、与其他文件的关系和在项目中的作用等。
+This document is for the description of three files, including code functionality, overall structure, relationships with other files, and their roles in the project.
 
 
 
 ## case_cntl.cc 
 
-该文件负责解析和处理测试文件中的SQL语句和事务ID，帮助读取和解析输入文件中的命令和数据，并将结果输出。
+This file is for parsing and handling SQL statements and transaction IDs in test files, assisting in reading and parsing commands and data from input files, and outputting results.
 
-### 整体结构：
+### Overall Structure:
 
-首先引入头文件，接着定义全局对象：outputter`和`result_handler，分别用于输出和结果处理。再进行函数声明及定义，包括`CaseReader`类里处理SQL语句的执行和错误信息的获取函数，`ResulHandler`类里比较SQL查询结果多函数，`Outputter`类将与测试结果相关的输出写入指定的文件的函数。
+First, header files are included, followed by the definition of global objects: `outputter` and `result_handler`, which are used for outputting and result handling, respectively. Then, function declarations and definitions are provided, including functions in the `CaseReader` class for handling SQL statement execution and error information retrieval, functions in the `ResultHandler` class for comparing SQL query results, and functions in the `Outputter` class for writing outputs related to test results to specified files.
 
-#### 函数声明和定义
+#### Function Declarations and Definitions
 
-- `CaseReader`类
-  - `TxnIdAndSql`：用于获取特定行的事务ID和SQL语句，解析输入行，提取执行顺序ID、交易事务ID和SQL语句。
-   - `SqlIdAndResult`：解析输入行，提取 SQL ID 及其预期结果
-  - `Isolation`：提取字符串行中的隔离级别。
-  - `InitTestSequenceAndTestResultSetList`：根据提供的测试路径和数据库类型，初始化测试序列和结果集(casecntl)。
-  - `TestSequenceAndTestResultSetFromFile`：解析提供的测试文件以提取测试序列及其相应的预期结果。
-  
-- `ResulHandler`类
-- `IsSqlExpectedResult`：用于将当前 SQL 结果与预期 SQL 结果进行比较。
-  - `IsTestExpectedResult`：用于将当前测试结果与一组预期测试结果进行比较。
+- **`CaseReader`** Class
+  - `TxnIdAndSql`: Used to get the transaction ID and SQL statement of a specific line, parse the input line, and extract the execution order ID, transaction ID, and SQL statement.
+  - `SqlIdAndResult`: Parses the input line and extracts the SQL ID and its expected result.
+  - `Isolation`: Extracts the isolation level from a string line.
+  - `InitTestSequenceAndTestResultSetList`: Initializes the test sequence and result set (casecntl) based on the provided test path and database type.
+  - `TestSequenceAndTestResultSetFromFile`: Parses the provided test file to extract the test sequence and their corresponding expected results.
 
-- `Outputter`类
-- `WriteResultTotal`：将测试结果集的摘要信息写入指定的文件。
-  - `PrintAndWriteTxnSqlResult`：将当前 SQL 结果与一组预期结果进行比较，并将比较结果输出到控制台和文件。
-- `WriteTestCaseTypeToFile`：将给定的结果类型附加写入到指定的文件中，并在结果类型前添加 "Test Result:" 前缀进行说明。
+- **`ResultHandler`** Class
+  - `IsSqlExpectedResult`: Used to compare the current SQL result with the expected SQL result.
+  - `IsTestExpectedResult`: Used to compare the current test result with a set of expected test results.
 
-### 项目中的作用
+- **`Outputter`** Class
+  - `WriteResultTotal`: Writes the summary information of the test result set to a specified file.
+  - `PrintAndWriteTxnSqlResult`: Compares the current SQL result with a set of expected results and outputs the comparison result to the console and file.
+  - `WriteTestCaseTypeToFile`: Appends the given result type to a specified file, with the prefix "Test Result:" for explanation.
+
+### Role in the Project
+
+The overall structure and content of this file revolve around the parsing and execution of SQL statements, providing a series of utility functions and class methods to handle SQL-related operations and compare test results.
 
-该文件的整体结构和内容围绕SQL语句的解析和执行，提供了一系列工具函数和类方法来处理SQL相关的操作，比较测试结果。
 
-#### 	
 
 ## sqltest.cc 
 
-该文件用于执行多线程SQL事务测试的，主要功能是通过多线程环境下执行多组SQL事务，并验证其结果。
+This file is for executing multi-threaded SQL transaction tests, primarily through executing multiple sets of SQL transactions in a multi-threaded environment and verifying their results.
 
-### 整体结构
+### Overall Structure
 
-首先进行头文件和库引入，接着使用gflags库定义了一系列命令行参数，如数据库类型、用户名、密码、数据库名、连接池大小、事务隔离级别、测试用例目录、超时时间等。定义了一个全局的互斥锁向量`mutex_txn`，用于管理不同事务的锁。再定义函数。
+First, header files and libraries are included, followed by the definition of a series of command-line parameters using the gflags library, such as database type, username, password, database name, connection pool size, transaction isolation level, test case directory, timeout, etc. A global mutex vector `mutex_txn` is defined to manage locks for different transactions. Then, functions are defined.
 
-#### 函数声明和定义
+#### Function Declarations and Definitions
 
-- **`try_lock_wait`**：尝试在给定超时时间内获取指定的互斥锁，用于多线程锁机制。
-- **`MultiThreadExecution`**：在多线程环境下执行一组SQL事务。该函数使用 `DBConnector` 类来执行SQL语句，并在事务执行过程中进行锁操作和错误处理。
-- **`JobExecutor::ExecTestSequence`**：执行一系列数据库测试事务，并将结果写入指定文件。该函数通过调用`MultiThreadExecution`函数来实现多线程事务执行。
+- **`try_lock_wait`**: Attempts to acquire the specified mutex within a given timeout, used for multi-threaded lock mechanisms.
+- **`MultiThreadExecution`**: Executes a set of SQL transactions in a multi-threaded environment. This function uses the `DBConnector` class to execute SQL statements, and performs lock operations and error handling during transaction execution.
+- **`JobExecutor::ExecTestSequence`**: Executes a series of database test transactions and writes the results to a specified file. This function implements multi-threaded transaction execution by calling the `MultiThreadExecution` function.
 
-### 项目中的作用
+### Role in the Project
 
-**数据库类型的支持**：支持多种数据库类型（如MySQL、PostgreSQL、Oracle等）的事务测试。
+**Support for Multiple Database Types**: Supports transaction testing for multiple database types (such as MySQL, PostgreSQL, Oracle, etc.).
 
-**多线程事务执行**：通过多线程机制执行事务，模拟高并发环境下的事务处理情况。
+**Multi-threaded Transaction Execution**: Executes transactions through a multi-threaded mechanism, simulating transaction processing in a high-concurrency environment.
 
-**事务隔离级别测试**：支持不同的事务隔离级别，验证数据库在不同隔离级别下的行为。
+**Transaction Isolation Level Testing**: Supports different transaction isolation levels, verifying the database's behavior under different isolation levels.
 
-**结果验证与输出**：执行事务后，将测试结果写入指定的输出文件中，以供后续分析验证。
+**Result Verification and Output**: After executing transactions, writes the test results to a specified output file for subsequent analysis and verification.
 
 
 
 ## sql_cntl.cc 
 
-该文件用于执行SQL语句并处理数据库连接。
+This file is for executing SQL statements and handling database connections.
+
+### Overall Structure
 
-### 整体结构
+First, header files and libraries are defined, followed by the definition of utility functions for time retrieval, string replacement, type conversion, etc. Then, function declarations and definitions are provided, including functions in the `DBConnector` class for handling SQL statement execution, time retrieval, string replacement, and type conversion.
 
-首先定义头文件和库引入，接着定义工具函数，用于时间获取、字符串替换和类型转换等。再进行函数声明及定义，包括`DBConnector`类处理SQL语句的执行的函数，获取时间，替换字符串等功能的函数。
+#### Function Declarations and Definitions
 
-#### 函数声明和定义
+- **`DBConnector`** Class
+  - `ErrInfoWithStmt`: Used to get error information for a specific handle.
+  - `SqlExecuteErr`: Handles error information for SQL execution.
+  - `ExecWriteSql`: Executes write-type SQL statements.
+  - `ExecReadSql2Int`: Executes read-type SQL statements and handles results.
 
-- `DBConnector`类
-  - `ErrInfoWithStmt`：用于获取特定句柄的错误信息。
-  - `SqlExecuteErr`：处理SQL执行的错误信息。
-  - `ExecWriteSql`：执行写入类型的SQL语句。
-  - `ExecReadSql2Int`：执行读取类型的SQL语句并处理结果。
+- **`get_current_time`**: Used to get the current time.
 
-- **`get_current_time`**：用于获取当前时间。
+- **`replace`**: Performs string replacement.
 
-- **`replace`**：进行字符串替换。
+- **`SQLCHARToStr`**: Converts `SQLCHAR` type to `std::string` type.
 
-- **`SQLCHARToStr`**：用于将`SQLCHAR`类型转换为`std::string`类型。
+### Role in the Project
 
-  
+This file is for interacting with the database, executing SQL statements, and handling errors and logging during execution.
 
-### 项目中的作用
 
-该文件在整个项目中主要负责与数据库的交互，执行SQL语句，并在执行过程中进行错误处理和日志记录。
 
+## Relationship Between Files
 
+1. `sql_cntl.cc` and `sqltest.cc`:
+   - `sqltest.cc` relies on the tools and helper functions in `sql_cntl.cc` to execute specific SQL operations. `sqltest.cc` uses the result handling and output functions defined in `sql_cntl.cc` to verify correctness and report results. `sql_cntl.cc` is responsible for the specific SQL execution logic, providing support for `sqltest.cc`.
 
-## 文件之间的关系
+2. `sql_cntl.cc` and `case_cntl.cc`:
+   - The functions and classes in `case_cntl.cc` read test cases, parse expected results, and compare actual results with these expectations. `sqltest.cc` handles the logic of executing SQL statements and calls these comparison functions.
 
-1. `sql_cntl.cc` 和 `sqltest.cc` ：
-   - `sqltest.cc` 依赖于 `sql_cntl.cc` 中的工具和辅助函数来执行具体的SQL操作，`sqltest.cc`利用 `sql_cntl.cc` 定义的结果处理和输出函数来验证正确性，并报告结果。`sqlcntl.txt`负责具体的SQL执行逻辑，为`sqltest.txt`提供支持。
-2. `sql_cntl.cc` 和 `case_cntl.cc` ：
-   - `case_cntl.cc` 的函数和类读取测试用例、解析预期结果以及将实际结果与这些预期进行比较。 `sqltest.cc` 负责执行SQL语句的逻辑，并调用这些比较函数。
-3. `sql_test.cc` 和 `case_cntl.cc` ：
-   - `case_cntl.cc` 负责读取和解析测试用例文件，和预期结果预期结果。这些解析后的数据会被传递给 `sqltest.cc`，然后由 `sqltest.cc` 进行多线程的事务执行测试。
+3. `sql_test.cc` and `case_cntl.cc`:
+   - `case_cntl.cc` is responsible for reading and parsing test case files and expected results. This parsed data is passed to `sqltest.cc`, which then performs multi-threaded transaction execution tests.