diff --git a/src/UserGuide/Master/Table/Ecosystem-Integration/Mybatis-Generator.md b/src/UserGuide/Master/Table/Ecosystem-Integration/Mybatis-Generator.md new file mode 100644 index 000000000..d5b8158da --- /dev/null +++ b/src/UserGuide/Master/Table/Ecosystem-Integration/Mybatis-Generator.md @@ -0,0 +1,149 @@ + + +# Mybatis Generator + + +## 1. Overview + +MyBatis Generator is an automated code generation tool officially released by MyBatis for the persistence layer. By parsing database table structures, it automatically generates entity classes (POJOs), Mapper interfaces, and XML mapping files. This enables rapid construction of standardized CRUD operation logic and significantly reduces the development cost of foundational code. + +To simplify integration in time-series database scenarios, the IoTDB team has extended this tool to launch ​**​IoTDB MyBatis Generator​**​. Deeply adapted for IoTDB's time-series data model characteristics, it automatically generates entity classes, Mapper interfaces, and corresponding Mapper XML files that conform to time-series storage semantics. This provides a standardized and reusable engineering practice solution for efficient IoTDB integration. + +## 2. Usage Steps + +### 2.1 Version Requirements + +* `IoTDB`: >=2.0.2 + +* `mybatis-generator-plugin`: >=2.0.3 + +* `iotdb-jdbc`: >=2.0.3 + +### 2.2 Operating Procedure + +1. ​Install and start IoTDB, Refer to [IoTDB Quick Start](../QuickStart/QuickStart.md) + +2. Obtain the plugin​ + + * ​​Method 1​*: Directly reference the Maven dependency + + * ​​Method 2​​: Clone the plugin source code and install locally: + +```Bash +git clone https://github.com/apache/iotdb-extras.git +cd .\mybatis-generator\ +mvn clean install +``` + +3. Add dependency + + Add the following configuration to your project's `pom.xml`: + +```xml + + UTF-8 + + + + + + org.mybatis.generator + mybatis-generator-maven-plugin + 1.4.2 + + + org.apache.iotdb + mybatis-generator-plugin + {lastest_version} + + + + + true + true + src/main/resources/generatorConfig.xml + + + + +``` + +4. Configure generatorConfig.xml + +* Place the following configuration in `src/main/resources/generatorConfig.xml`: + +* Key customizable elements: `jdbcConnection`, `javaModelGenerator`, `sqlMapGenerator`, `javaClientGenerator`, `table` + +```xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+
+``` + +5. Execute code generation + +Run in terminal: + +```Shell +mvn mybatis-generator:generate +``` + +6. View generated code​ + +Find the generated files in your project: + +```Shell +# You can see the target file in your Project +org/apache/iotdb/mybatis/plugin/model/table1.java +org/apache/iotdb/mybatis/plugin/mapper/table1Mapper.java +org/apache/iotdb/mybatis/plugin/xml/table1Mapper.xml +``` + +## 3. Usage Example + +For detailed usage examples, refer to the source code: [examples/mybatis-generator](https://github.com/apache/iotdb-extras/tree/master/examples/mybatis-generator) \ No newline at end of file diff --git a/src/UserGuide/latest-Table/Ecosystem-Integration/Mybatis-Generator.md b/src/UserGuide/latest-Table/Ecosystem-Integration/Mybatis-Generator.md new file mode 100644 index 000000000..d5b8158da --- /dev/null +++ b/src/UserGuide/latest-Table/Ecosystem-Integration/Mybatis-Generator.md @@ -0,0 +1,149 @@ + + +# Mybatis Generator + + +## 1. Overview + +MyBatis Generator is an automated code generation tool officially released by MyBatis for the persistence layer. By parsing database table structures, it automatically generates entity classes (POJOs), Mapper interfaces, and XML mapping files. This enables rapid construction of standardized CRUD operation logic and significantly reduces the development cost of foundational code. + +To simplify integration in time-series database scenarios, the IoTDB team has extended this tool to launch ​**​IoTDB MyBatis Generator​**​. Deeply adapted for IoTDB's time-series data model characteristics, it automatically generates entity classes, Mapper interfaces, and corresponding Mapper XML files that conform to time-series storage semantics. This provides a standardized and reusable engineering practice solution for efficient IoTDB integration. + +## 2. Usage Steps + +### 2.1 Version Requirements + +* `IoTDB`: >=2.0.2 + +* `mybatis-generator-plugin`: >=2.0.3 + +* `iotdb-jdbc`: >=2.0.3 + +### 2.2 Operating Procedure + +1. ​Install and start IoTDB, Refer to [IoTDB Quick Start](../QuickStart/QuickStart.md) + +2. Obtain the plugin​ + + * ​​Method 1​*: Directly reference the Maven dependency + + * ​​Method 2​​: Clone the plugin source code and install locally: + +```Bash +git clone https://github.com/apache/iotdb-extras.git +cd .\mybatis-generator\ +mvn clean install +``` + +3. Add dependency + + Add the following configuration to your project's `pom.xml`: + +```xml + + UTF-8 + + + + + + org.mybatis.generator + mybatis-generator-maven-plugin + 1.4.2 + + + org.apache.iotdb + mybatis-generator-plugin + {lastest_version} + + + + + true + true + src/main/resources/generatorConfig.xml + + + + +``` + +4. Configure generatorConfig.xml + +* Place the following configuration in `src/main/resources/generatorConfig.xml`: + +* Key customizable elements: `jdbcConnection`, `javaModelGenerator`, `sqlMapGenerator`, `javaClientGenerator`, `table` + +```xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+
+``` + +5. Execute code generation + +Run in terminal: + +```Shell +mvn mybatis-generator:generate +``` + +6. View generated code​ + +Find the generated files in your project: + +```Shell +# You can see the target file in your Project +org/apache/iotdb/mybatis/plugin/model/table1.java +org/apache/iotdb/mybatis/plugin/mapper/table1Mapper.java +org/apache/iotdb/mybatis/plugin/xml/table1Mapper.xml +``` + +## 3. Usage Example + +For detailed usage examples, refer to the source code: [examples/mybatis-generator](https://github.com/apache/iotdb-extras/tree/master/examples/mybatis-generator) \ No newline at end of file diff --git a/src/zh/UserGuide/Master/Table/Ecosystem-Integration/Mybatis-Generator.md b/src/zh/UserGuide/Master/Table/Ecosystem-Integration/Mybatis-Generator.md new file mode 100644 index 000000000..99be2796f --- /dev/null +++ b/src/zh/UserGuide/Master/Table/Ecosystem-Integration/Mybatis-Generator.md @@ -0,0 +1,137 @@ + + +# Mybatis Generator + + +## 1. 概述 + +MyBatis Generator 是 MyBatis 官方推出的持久层代码自动化生成工具,通过解析数据库表结构自动生成实体类(POJO)、Mapper 接口及 XML 映射文件,可快速构建标准化 CRUD 操作逻辑,显著减少基础代码开发成本。为简化时序数据库场景下的集成流程,IoTDB 官方基于此工具扩展推出 `IoTDB-Mybatis-Generator`,针对 IoTDB 的时序数据模型特性进行深度适配,能够自动生成符合时序存储语义的实体类,mapper接口及对应的mapper.xml文件,为 IoTDB 的高效接入提供了标准化、可复用的工程实践方案。 + +## 2. 使用步骤 + +### 2.1 版本要求 + +* `IoTDB`: >=2.0.2 + +* `mybatis-generator-plugin`: >=2.0.3 + +* `iotdb-jdbc`: >=2.0.3 + +### 2.2 操作流程 + +1. 安装并启动 IoTDB , 可参考 [IoTDB 快速入门](../QuickStart/QuickStart.md) + +2. 获取插件 + + * 方式一:直接引用 Maven 依赖 + + * 方式二:通过克隆插件源码,进行本地依赖安装。 + +```Bash +git clone https://github.com/apache/iotdb-extras.git +cd .\mybatis-generator\ +mvn clean install +``` + +3. 在需要使用插件的项目 pom 文件中引用目标依赖 + +```xml + + UTF-8 + + + + + + org.mybatis.generator + mybatis-generator-maven-plugin + 1.4.2 + + + org.apache.iotdb + mybatis-generator-plugin + {lastest_version} + + + + + true + true + src/main/resources/generatorConfig.xml + + + + +``` + +4. 自定义配置文件`generatorConfig.xml`放到 `resources `目录下,`generatorConfig.xml`内容可参考如下模板,其中可维护项主要涉及`jdbcConnection`、`javaModelGenerator`、`sqlMapGenerator`、`javaClientGenerator`、`table`。 + +```xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+
+``` + +5. 执行如下命令,即可在配置的目标目录下生成目标代码。 + +```Shell +mvn mybatis-generator:generate +``` + +6. 查看目标代码 + +```Shell +# You can see the target file in your Project +org/apache/iotdb/mybatis/plugin/model/table1.java +org/apache/iotdb/mybatis/plugin/mapper/table1Mapper.java +org/apache/iotdb/mybatis/plugin/xml/table1Mapper.xml +``` + +## 3. 使用示例 + +详细的使用示例可参考源码 [examples/mybatis-generator](https://github.com/apache/iotdb-extras/tree/master/examples/mybatis-generator) \ No newline at end of file diff --git a/src/zh/UserGuide/latest-Table/Ecosystem-Integration/Mybatis-Generator.md b/src/zh/UserGuide/latest-Table/Ecosystem-Integration/Mybatis-Generator.md new file mode 100644 index 000000000..99be2796f --- /dev/null +++ b/src/zh/UserGuide/latest-Table/Ecosystem-Integration/Mybatis-Generator.md @@ -0,0 +1,137 @@ + + +# Mybatis Generator + + +## 1. 概述 + +MyBatis Generator 是 MyBatis 官方推出的持久层代码自动化生成工具,通过解析数据库表结构自动生成实体类(POJO)、Mapper 接口及 XML 映射文件,可快速构建标准化 CRUD 操作逻辑,显著减少基础代码开发成本。为简化时序数据库场景下的集成流程,IoTDB 官方基于此工具扩展推出 `IoTDB-Mybatis-Generator`,针对 IoTDB 的时序数据模型特性进行深度适配,能够自动生成符合时序存储语义的实体类,mapper接口及对应的mapper.xml文件,为 IoTDB 的高效接入提供了标准化、可复用的工程实践方案。 + +## 2. 使用步骤 + +### 2.1 版本要求 + +* `IoTDB`: >=2.0.2 + +* `mybatis-generator-plugin`: >=2.0.3 + +* `iotdb-jdbc`: >=2.0.3 + +### 2.2 操作流程 + +1. 安装并启动 IoTDB , 可参考 [IoTDB 快速入门](../QuickStart/QuickStart.md) + +2. 获取插件 + + * 方式一:直接引用 Maven 依赖 + + * 方式二:通过克隆插件源码,进行本地依赖安装。 + +```Bash +git clone https://github.com/apache/iotdb-extras.git +cd .\mybatis-generator\ +mvn clean install +``` + +3. 在需要使用插件的项目 pom 文件中引用目标依赖 + +```xml + + UTF-8 + + + + + + org.mybatis.generator + mybatis-generator-maven-plugin + 1.4.2 + + + org.apache.iotdb + mybatis-generator-plugin + {lastest_version} + + + + + true + true + src/main/resources/generatorConfig.xml + + + + +``` + +4. 自定义配置文件`generatorConfig.xml`放到 `resources `目录下,`generatorConfig.xml`内容可参考如下模板,其中可维护项主要涉及`jdbcConnection`、`javaModelGenerator`、`sqlMapGenerator`、`javaClientGenerator`、`table`。 + +```xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+
+``` + +5. 执行如下命令,即可在配置的目标目录下生成目标代码。 + +```Shell +mvn mybatis-generator:generate +``` + +6. 查看目标代码 + +```Shell +# You can see the target file in your Project +org/apache/iotdb/mybatis/plugin/model/table1.java +org/apache/iotdb/mybatis/plugin/mapper/table1Mapper.java +org/apache/iotdb/mybatis/plugin/xml/table1Mapper.xml +``` + +## 3. 使用示例 + +详细的使用示例可参考源码 [examples/mybatis-generator](https://github.com/apache/iotdb-extras/tree/master/examples/mybatis-generator) \ No newline at end of file