{"id":16241737,"url":"https://github.com/sanshengshui/multitenant","last_synced_at":"2025-04-06T00:09:41.115Z","repository":{"id":106436269,"uuid":"145544367","full_name":"sanshengshui/multiTenant","owner":"sanshengshui","description":"多租户技术","archived":false,"fork":false,"pushed_at":"2023-12-17T15:47:30.000Z","size":1123,"stargazers_count":329,"open_issues_count":3,"forks_count":127,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-03-29T23:08:59.147Z","etag":null,"topics":["multi-tenant","mybatis3","mycat","mysql","saas","spring-boot"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sanshengshui.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-08-21T09:57:08.000Z","updated_at":"2025-01-08T03:10:20.000Z","dependencies_parsed_at":null,"dependency_job_id":"b8e7e302-9055-4d93-8308-a55f60d898b1","html_url":"https://github.com/sanshengshui/multiTenant","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sanshengshui%2FmultiTenant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sanshengshui%2FmultiTenant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sanshengshui%2FmultiTenant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sanshengshui%2FmultiTenant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sanshengshui","download_url":"https://codeload.github.com/sanshengshui/multiTenant/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247415967,"owners_count":20935387,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["multi-tenant","mybatis3","mycat","mysql","saas","spring-boot"],"created_at":"2024-10-10T14:08:28.970Z","updated_at":"2025-04-06T00:09:41.096Z","avatar_url":"https://github.com/sanshengshui.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\ntitle: 多租户技术\ndate: 2018-08-18 17:42:03\ntags:\n- MyBatis\n- Mycat\n- tenant\ncategories: 后端\ncopyright: true\n---\n\n\n\n![SaaS_banner](https://github.com/sanshengshui/multiTenant/blob/master/doc/SaaS_banner.jpg)\n\n\n\n## 前言\n\n\n\n### SaaS模式是什么?\n\n\n\n传统的软件模式是在开发出软件产品后，需要去客户现场进行实施，通常部署在局域网，这样开发、部署及维护的成本都是比较高的。\n\n现在随着云服务技术的蓬勃发展，就出现了SaaS模式。\n\n所谓SaaS模式即是把产品部署在云服务器上，从前的客户变成了“租户”，我们按照功能和租用时间对租户进行收费。\n\n这样的好处是，用户可以按自己的需求来购买功能和时间，同时自己不需要维护服务器，而我们作为SaaS提供商也免去了跑到客户现场实施的麻烦，运维的风险则主要由IaaS提供商来承担。\n\n![SaaS](https://github.com/sanshengshui/multiTenant/blob/master/doc/SaaS.jpg)\n\n\n\n\u003c!-- more --\u003e\n\n### SaaS多租户数据库方案\n\n多租户技术或称多重租赁技术，是一种软件架构技术，\n\n是实现如何在多用户环境下共用相同的系统或程序组件，并且可确保各用户间数据的隔离性。\n\n在当下云计算时代，多租户技术在共用的数据中心以单一系统架构与服务提供多数客户端相同甚至可定制化的服务，并且仍可以保障客户的数据隔离。\n\n目前各种各样的云计算服务就是这类技术范畴，例如阿里云数据库服务（RDS）、阿里云服务器等等。\n\n多租户在数据存储上存在三种主要的方案，分别是：\n\n#### 独立数据库\n\n这是第一种方案，即一个租户一个数据库，这种方案的用户数据隔离级别最高，安全性最好，但成本较高。 \n优点： \n为不同的租户提供独立的数据库，有助于简化数据模型的扩展设计，满足不同租户的独特需求；如果出现故障，恢复数据比较简单。 \n缺点： \n增多了数据库的安装数量，随之带来维护成本和购置成本的增加。 \n这种方案与传统的一个客户、一套数据、一套部署类似，差别只在于软件统一部署在运营商那里。如果面对的是银行、医院等需要非常高数据隔离级别的租户，可以选择这种模式，提高租用的定价。如果定价较低，产品走低价路线，这种方案一般对运营商来说是无法承受的。\n\n#### 共享数据库，隔离数据架构 \n\n这是第二种方案，即多个或所有租户共享Database，但是每个租户一个Schema（也可叫做一个user）。 \n优点： \n为安全性要求较高的租户提供了一定程度的逻辑数据隔离，并不是完全隔离；每个数据库可支持更多的租户数量。 \n缺点： \n如果出现故障，数据恢复比较困难，因为恢复数据库将牵涉到其他租户的数据； \n如果需要跨租户统计数据，存在一定困难。\n\n#### 共享数据库，共享数据架构 \n\n这是第三种方案，即租户共享同一个Database、同一个Schema，但在表中增加TenantID多租户的数据字段。这是共享程度最高、隔离级别最低的模式。 \n优点： \n三种方案比较，第三种方案的维护和购置成本最低，允许每个数据库支持的租户数量最多。 \n缺点： \n隔离级别最低，安全性最低，需要在设计开发时加大对安全的开发量； \n数据备份和恢复最困难，需要逐表逐条备份和还原。 \n如果希望以最少的服务器为最多的租户提供服务，并且租户接受牺牲隔离级别换取降低成本，这种方案最适合。\n\n***选择合理的实现模式*** \n衡量三种模式主要考虑的因素是隔离还是共享。\n\n*成本角度因素* \n隔离性越好，设计和实现的难度和成本越高，初始成本越高。共享性越好，同一运营成本 \n下支持的用户越多，运营成本越低。\n\n*安全因素* \n要考虑业务和客户的安全方面的要求。安全性要求越高，越要倾向于隔离。\n\n*从租户数量上考虑* \n主要考虑下面一些因素 \n系统要支持多少租户？上百？上千还是上万？可能的租户越多，越倾向于共享。 \n平均每个租户要存储数据需要的空间大小。存贮的数据越多，越倾向于隔离。 \n每个租户的同时访问系统的最终用户数量。需要支持的越多，越倾向于隔离。 \n是否想针对每一租户提供附加的服务，例如数据的备份和恢复等。这方面的需求越多， 越倾向于隔离\n\n![Multi-Tenant](https://github.com/sanshengshui/multiTenant/blob/master/doc/Multi-Tenant.jpg)\n\n\n\n------\n\n\n\n## 多租户方案之共享数据库，隔离数据架构\n\n\n\n### 技术选型\n\n- **Mycat中间件(社区活跃，完全开源的分布式数据库架构)**\n\n- **MyBatis**\n\n\n### 简要描述\n\n多租户方案采用的是MyBatis+MyCat。DEMO是基于Spring MVC的web项目。\n\n在用户操作过程中获取用户的id信息，利用MyCat强大的注解功能，根据用户id将SQL语句路由到对应该用户的schema或者database去执行。\n\n对SQL加注解的实现则交由MyBatis的插件功能完成，通过自定义MyBatis的Interceptor类，拦截要执行的sql语句加上对应注解。这样就实现了数据库的多租户改造。下面分几个部分来说明。\n\n\n\n### MyCat 与MySQL设置\n\n\n\nMyCat是一个开源的分布式数据库系统，是一个实现了MySQL协议的服务器，\n\n前端用户可以把它看作是一个数据库代理，用MySQL客户端工具和命令行访问，而其后端可以用MySQL原生协议与多个MySQL服务器通信，\n\n也可以用JDBC协议与大多数主流数据库服务器通信，其核心功能是分表分库，即将一个大表水平分割为N个小表，存储在后端MySQL服务器里或者其他数据库里。\n\nMyCat相当于一个逻辑上的大数据库，又N多个物理数据库组成，可以通过各种分库分表规则(rule）将数据存到规则对应的数据库或schema或表中。\n\n MyCat对自身不支持的Sql语句提供了一种解决方案——在要执行的SQL语句前添加额外的一段由注解SQL组织的代码，这样Sql就能正确执行，这段代码称之为“注解”。\n\n注解的使用相当于对mycat不支持的sql语句做了一层透明代理转发，直接交给目标的数据节点进行sql语句执行，其中注解SQL用于确定最终执行SQL的数据节点。\n\n\n\n注解使用方式如下：\n\n```html\n\u003ccode class=\"language-html\"\u003e/*!mycat: schema=node1*/真正执行Sql\u003c/code\u003e  \n```\n\n 由于这个项目是根据MyCat的SQL注解来选择在哪个schema或者database上执行的，所以不需要设置rule.xml。\n\n\n\n#### 数据库设置\n\n```mysql\ncreate database db01;  \n CREATE TABLE `bom`  (\n  `cate_id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '物料编码',\n  `parent_id` bigint(20) NULL DEFAULT NULL COMMENT '父物料ID，一级物料为0',\n  `cate_code` varchar(50) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '物料编码',\n  `name` varchar(50) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '物料名称',\n  `unit` varchar(20) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '计量单位',\n  `used_count` double(32, 4) NULL DEFAULT NULL,\n  `specify` varchar(50) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '规格',\n  `property` tinyint(4) NULL DEFAULT NULL COMMENT '2=自制件,1=采购件',\n  `status` tinyint(4) NULL DEFAULT NULL COMMENT '状态(0:开启 1：禁用)',\n  `description` varchar(100) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '描述',\n  PRIMARY KEY (`cate_id`) USING BTREE\n) ENGINE = InnoDB AUTO_INCREMENT = 101 CHARACTER SET = utf8 COLLATE = utf8_general_ci COMMENT = '物料表' ROW_FORMAT = Dynamic;\n\ncreate database db02;  \nCREATE TABLE `bom`  (\n  `cate_id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '物料编码',\n  `parent_id` bigint(20) NULL DEFAULT NULL COMMENT '父物料ID，一级物料为0',\n  `cate_code` varchar(50) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '物料编码',\n  `name` varchar(50) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '物料名称',\n  `unit` varchar(20) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '计量单位',\n  `used_count` double(32, 4) NULL DEFAULT NULL,\n  `specify` varchar(50) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '规格',\n  `property` tinyint(4) NULL DEFAULT NULL COMMENT '2=自制件,1=采购件',\n  `status` tinyint(4) NULL DEFAULT NULL COMMENT '状态(0:开启 1：禁用)',\n  `description` varchar(100) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '描述',\n  PRIMARY KEY (`cate_id`) USING BTREE\n) ENGINE = InnoDB AUTO_INCREMENT = 101 CHARACTER SET = utf8 COLLATE = utf8_general_ci COMMENT = '物料表' ROW_FORMAT = Dynamic;\n\n```\n\n\n\n设置两个数据库分表为db01,db02，两个库中都有bom。\n\n#### MyCat的配置\n\nserver.xml\n\n```xml\n\u003c?xml version=\"1.0\" encoding=\"UTF-8\"?\u003e\n\u003c!DOCTYPE mycat:server SYSTEM \"server.dtd\"\u003e\n\u003cmycat:server xmlns:mycat=\"http://io.mycat/\"\u003e\n\t\u003csystem\u003e\n\t\u003cproperty name=\"useSqlStat\"\u003e0\u003c/property\u003e \n\t\u003cproperty name=\"useGlobleTableCheck\"\u003e0\u003c/property\u003e  \n\t\u003cproperty name=\"sequnceHandlerType\"\u003e2\u003c/property\u003e\n    \u003cproperty name=\"handleDistributedTransactions\"\u003e0\u003c/property\u003e\n\t\u003cproperty name=\"useOffHeapForMerge\"\u003e1\u003c/property\u003e\n\t\t\u003cproperty name=\"memoryPageSize\"\u003e1m\u003c/property\u003e\n\t\t\u003cproperty name=\"spillsFileBufferSize\"\u003e1k\u003c/property\u003e\n\t\t\u003cproperty name=\"useStreamOutput\"\u003e0\u003c/property\u003e\n\t\t\u003cproperty name=\"systemReserveMemorySize\"\u003e384m\u003c/property\u003e\n\t\t\u003cproperty name=\"useZKSwitch\"\u003etrue\u003c/property\u003e\n\t\u003c/system\u003e\n\t\n\t\u003cuser name=\"root\"\u003e\n\t\t\u003cproperty name=\"password\"\u003ejames\u003c/property\u003e\n\t\t\u003cproperty name=\"schemas\"\u003ejames\u003c/property\u003e\n\t\u003c/user\u003e\n\n\u003c/mycat:server\u003e\n\n```\n\n\n\nserver.xml主要是设置登录用户名密码，登录端口之类的信息。\n\n\n\n重头戏是schema.xml的设置\n\n```xml\n\u003c?xml version=\"1.0\"?\u003e\n\u003c!DOCTYPE mycat:schema SYSTEM \"schema.dtd\"\u003e\n\u003cmycat:schema xmlns:mycat=\"http://io.mycat/\"\u003e\n\n\t\u003cschema name=\"james\" checkSQLschema=\"false\" sqlMaxLimit=\"100\"\u003e\n\t\t\u003ctable name=\"bom\" dataNode=\"dn1,dn2\" /\u003e\n\t\u003c/schema\u003e\n\t\u003cdataNode name=\"dn1\" dataHost=\"localhost1\" database=\"db01\" /\u003e\n\t\u003cdataNode name=\"dn2\" dataHost=\"localhost1\" database=\"db02\" /\u003e\n\t\u003cdataHost name=\"localhost1\" maxCon=\"1000\" minCon=\"10\" balance=\"0\"\n\t\t\t  writeType=\"0\" dbType=\"mysql\" dbDriver=\"native\" switchType=\"1\"  slaveThreshold=\"100\"\u003e\n\t\t\u003cheartbeat\u003eselect user()\u003c/heartbeat\u003e\n\t\t\u003cwriteHost host=\"hostS1\" url=\"localhost:3306\" user=\"root\"\n\t\t\t\t   password=\"jamesmsw\" /\u003e\n\t\u003c/dataHost\u003e\n\t\n\u003c/mycat:schema\u003e\n```\n\n这里配置好两个数据库节点dn1,dn2对应的就是这前面建立的数据库db02,db03.\n\n这样数据库和Mycat就设置好了，我们可以测试一下，向两个库中插入一些数据：\n\n![db01](https://github.com/sanshengshui/multiTenant/blob/master/doc/db01.png)\n\n这是db01的数据,共40条.\n\n![db02](https://github.com/sanshengshui/multiTenant/blob/master/doc/db02.png)\n\n这是db02中的数据,共8条.\n\n![mycat](https://github.com/sanshengshui/multiTenant/blob/master/doc/mycat.png)\n\n这是mycat的逻辑库james中的数据，可以看到，包含了所有的db01和db02的数据。\n\n\n\n再来试试MyCat的注解：\n\n在mycat的逻辑库TESTDB中分别执行以下语句：\n\n```sql\nmysql\u003e select count(*) from bom;\n/*!mycat: datanode=dn1*/select count(*) from bom;\n/*!mycat: datanode=dn2*/select count(*) from bom;\n```\n\n![explain](https://github.com/sanshengshui/multiTenant/blob/master/doc/explain.png)\n\n可以看到，注解实实在在地把SQL语句路由到对应的数据库中去执行了，而不加注解的SQL则在整个逻辑库上执行。\n\n\n\n#### MyBatis设置插件拦截器\n\nMyBatis要使用MyCat很方便，SpringBoot下，只需要将对应的url改成MyCat的端口就行了。\n\n```xml\nspring.thymeleaf.mode=LEGACYHTML5\nspring.datasource.url=jdbc:mysql://localhost:8066/james?serverTimezone=GMT\nspring.datasource.username=root\nspring.datasource.password=james\nspring.datasource.driver-class-name=com.mysql.jdbc.Driver\nmybatis.config-location=classpath:mybatis.xml\n```\n\nMyBatis 允许你在已映射语句执行过程中的某一点进行拦截调用。\n\n默认情况下，MyBatis 允许使用插件来拦截的方法调用包括：\n\n- Executor (update, query, flushStatements, commit, rollback, \n  getTransaction, close, isClosed)\n- ParameterHandler (getParameterObject, setParameters)\n- ResultSetHandler (handleResultSets, handleOutputParameters)\n- StatementHandler (prepare, parameterize, batch, update, query)\n\n\n\n\n\n这些类中方法的细节可以通过查看每个方法的签名来发现，或者直接查看 MyBatis 的发行包中的源代码。 \n\n假设你想做的不仅仅是监控方法的调用，那么你应该很好的了解正在重写的方法的行为。 \n\n因为如果在试图修改或重写已有方法的行为的时候，你很可能在破坏 MyBatis 的核心模块。 这些都是更低层的类和方法，所以使用插件的时候要特别当心。\n\n通过 MyBatis 提供的强大机制，使用插件是非常简单的，只需实现 Interceptor 接口，并指定了想要拦截的方法签名即可。\n\n在这里为了实现SQL的改造增加注解，Executor通过调度StatementHandler来完成查询的过程，通过调度它的prepare方法预编译SQL，因此我们可以拦截StatementHandler的prepare方法，在此之前完成SQL的重新编写。\n\n```java\npackage org.apache.ibatis.executor.statement;\n \nimport java.sql.Connection;\nimport java.sql.SQLException;\nimport java.sql.Statement;\nimport java.util.List;\nimport org.apache.ibatis.cursor.Cursor;\nimport org.apache.ibatis.executor.parameter.ParameterHandler;\nimport org.apache.ibatis.mapping.BoundSql;\nimport org.apache.ibatis.session.ResultHandler;\n \npublic interface StatementHandler {\n    Statement prepare(Connection var1, Integer var2) throws SQLException;\n \n    void parameterize(Statement var1) throws SQLException;\n \n    void batch(Statement var1) throws SQLException;\n \n    int update(Statement var1) throws SQLException;\n \n    \u003cE\u003e List\u003cE\u003e query(Statement var1, ResultHandler var2) throws SQLException;\n \n    \u003cE\u003e Cursor\u003cE\u003e queryCursor(Statement var1) throws SQLException;\n \n    BoundSql getBoundSql();\n \n    ParameterHandler getParameterHandler();\n}\n\n```\n\n以上的任何方法都可以拦截。从接口定义而言，Prepare方法有一个参数Connection对象，因此按如下代码设计拦截器：\n\n```java\npackage com.sanshengshui.multitenant.interceptor;\n\nimport com.sanshengshui.multitenant.utils.SessionUtil;\nimport org.apache.ibatis.executor.statement.StatementHandler;\nimport org.apache.ibatis.plugin.*;\nimport org.apache.ibatis.reflection.MetaObject;\nimport org.apache.ibatis.reflection.SystemMetaObject;\n\nimport java.sql.Connection;\nimport java.util.Properties;\n\n@Intercepts(value = {\n        @Signature(type = StatementHandler.class,\n                method = \"prepare\",\n                args = {Connection.class,Integer.class})})\npublic class MyInterceptor implements Interceptor {\n    private static final String preState=\"/*!mycat:datanode=\";\n    private static final String afterState=\"*/\";\n\n    @Override\n    public Object intercept(Invocation invocation) throws Throwable {\n        StatementHandler statementHandler=(StatementHandler)invocation.getTarget();\n        MetaObject metaStatementHandler=SystemMetaObject.forObject(statementHandler);\n        Object object=null;\n        //分离代理对象链\n        while(metaStatementHandler.hasGetter(\"h\")){\n            object=metaStatementHandler.getValue(\"h\");\n            metaStatementHandler=SystemMetaObject.forObject(object);\n        }\n        statementHandler=(StatementHandler)object;\n        String sql=(String)metaStatementHandler.getValue(\"delegate.boundSql.sql\");\n        /*\n        String node=(String)TestController.threadLocal.get();\n        */\n        String node=(String) SessionUtil.getSession().getAttribute(\"corp\");\n        if(node!=null) {\n            sql = preState + node + afterState + sql;\n        }\n\n        System.out.println(\"sql is \"+sql);\n        metaStatementHandler.setValue(\"delegate.boundSql.sql\",sql);\n        Object result = invocation.proceed();\n        System.out.println(\"Invocation.proceed()\");\n        return result;\n    }\n\n    @Override\n    public Object plugin(Object target) {\n\n        return Plugin.wrap(target, this);\n    }\n\n    @Override\n    public void setProperties(Properties properties) {\n        String prop1 = properties.getProperty(\"prop1\");\n        String prop2 = properties.getProperty(\"prop2\");\n        System.out.println(prop1 + \"------\" + prop2);\n    }\n}\n\n```\n\n简单说明一下：\n\n intercept 真个是插件真正运行的方法，它将直接覆盖掉你真实拦截对象的方法。里面有一个Invocation对象，利用它可以调用你原本要拦截的对象的方法\n\nplugin    它是一个生成动态代理对象的方法，\n\nsetProperties 它是允许你在使用插件的时候设置参数值。\n\n\n\n```\n@Intercepts(value = {\n        @Signature(type = StatementHandler.class,\n                method = \"prepare\",\n                args = {Connection.class,Integer.class})})\n```\n\n\n\n这段说明了要拦截的目标类和方法以及参数。\n\nStatementHandler是一个借口，真实的对象是RoutingStatementHandler,但它不是真实的服务对象，里面的delegate是StatementHandler中真实的StatementHandler实现的类，有多种，它里面的boundSql中存储着SQL语句。具体的可以参考MyBatis的源码。\n\nMetaObject是一个工具类，由于MyBatis四大对象提供的public设置参数的方法很少，难以通过自身得到相关属性信息，但是有个MetaObject这个工具类就可以通过其他的技术手段来读取和修改这些重要对象的属性。\n\nSessionUtil的getSession方法是用来获取之前用户登录时获得的记录在session中的corp信息，根据这个信息拼装SQL注解达到多租户的目的。\n\nInterceptor写好后，写入到mybatis.xml的plugin中\n\n```\n\u003c?xml version=\"1.0\" encoding=\"UTF-8\"?\u003e\n\u003c!DOCTYPE configuration\n        PUBLIC \"-//mybatis.org//DTD Config 3.0//EN\"\n        \"http://mybatis.org/dtd/mybatis-3-config.dtd\"\u003e\n\n\u003cconfiguration\u003e\n    \u003csettings\u003e\n        \u003c!-- 打印查询语句 --\u003e\n        \u003csetting name=\"logImpl\" value=\"STDOUT_LOGGING\" /\u003e\n    \u003c/settings\u003e\n\n    \u003ctypeAliases\u003e\n        \u003ctypeAlias alias=\"BomDO\" type=\"com.sanshengshui.multitenant.pojo.BomDO\"/\u003e\n\n    \u003c/typeAliases\u003e\n\n    \u003cplugins\u003e\n        \u003cplugin interceptor=\"com.sanshengshui.multitenant.interceptor.MyInterceptor\"\u003e\n        \u003c/plugin\u003e\n    \u003c/plugins\u003e\n\u003c/configuration\u003e\n```\n\n\n\n#### 实际运行\n\n\n\n写一个实体类.\n\n```\npackage com.sanshengshui.multitenant.pojo;\n\nimport lombok.Data;\n\nimport java.io.Serializable;\n\n@Data\npublic class BomDO implements Serializable {\n    private static final long serialVersionUID = 1L;\n    //物料编码\n    private Long cateId;\n    //父物料ID，一级物料为0\n    private Long parentId;\n    //物料编码\n    private String cateCode;\n    //物料名称\n    private String name;\n    //计量单位\n    private String unit;\n    //规格\n    private String specify;\n    //状态(0:开启 1：禁用)\n    private Integer status;\n    //使用数量\n    private Double usedCount;\n    //描述\n    private String description;\n    //2=自制件,1=采购件\n    private Integer property;\n\n    public Long getCateId() {\n        return cateId;\n    }\n\n    public void setCateId(Long cateId) {\n        this.cateId = cateId;\n    }\n\n    public Long getParentId() {\n        return parentId;\n    }\n\n    public void setParentId(Long parentId) {\n        this.parentId = parentId;\n    }\n\n    public String getCateCode() {\n        return cateCode;\n    }\n\n    public void setCateCode(String cateCode) {\n        this.cateCode = cateCode;\n    }\n\n    public String getName() {\n        return name;\n    }\n\n    public void setName(String name) {\n        this.name = name;\n    }\n\n    public String getUnit() {\n        return unit;\n    }\n\n    public void setUnit(String unit) {\n        this.unit = unit;\n    }\n\n    public String getSpecify() {\n        return specify;\n    }\n\n    public void setSpecify(String specify) {\n        this.specify = specify;\n    }\n\n    public Integer getStatus() {\n        return status;\n    }\n\n    public void setStatus(Integer status) {\n        this.status = status;\n    }\n\n    public Double getUsedCount() {\n        return usedCount;\n    }\n\n    public void setUsedCount(Double usedCount) {\n        this.usedCount = usedCount;\n    }\n\n    public String getDescription() {\n        return description;\n    }\n\n    public void setDescription(String description) {\n        this.description = description;\n    }\n\n    public Integer getProperty() {\n        return property;\n    }\n\n    public void setProperty(Integer property) {\n        this.property = property;\n    }\n}\n\n```\n\n写一个mapper\n\n```\npackage com.sanshengshui.multitenant.mapper;\n\nimport com.sanshengshui.multitenant.pojo.BomDO;\nimport org.apache.ibatis.annotations.Mapper;\n\nimport java.util.List;\nimport java.util.Map;\n\n@Mapper\npublic interface BomMapper {\n\n    List\u003cBomDO\u003e list(Map\u003cString, Object\u003e map);\n\n    int count(Map\u003cString, Object\u003e map);\n    \n}package com.sanshengshui.multitenant.mapper;\n\nimport com.sanshengshui.multitenant.pojo.BomDO;\nimport org.apache.ibatis.annotations.Mapper;\n\nimport java.util.List;\nimport java.util.Map;\n\n@Mapper\npublic interface BomMapper {\n\n    List\u003cBomDO\u003e list(Map\u003cString, Object\u003e map);\n\n    int count(Map\u003cString, Object\u003e map);\n    \n}\n\n```\n\n以及对应的BomMapper.xml，配置好sql语句。\n\n```\n\u003c?xml version=\"1.0\" encoding=\"UTF-8\"?\u003e\n\u003c!DOCTYPE mapper PUBLIC \"-//mybatis.org//DTD Mapper 3.0//EN\" \"http://mybatis.org/dtd/mybatis-3-mapper.dtd\"\u003e\n\n\u003cmapper namespace=\"com.sanshengshui.multitenant.mapper.BomMapper\"\u003e\n\n\t\u003cselect id=\"get\" resultType=\"com.sanshengshui.multitenant.pojo.BomDO\"\u003e\n\t\tselect `cate_id`,`parent_id`,`cate_code`,`name`,`unit`,`used_count`,`specify`,`property`,`status`,`description` from bom where cate_id = #{value}\n\t\u003c/select\u003e\n\t\n\t\u003cselect id=\"list\" resultType=\"com.sanshengshui.multitenant.pojo.BomDO\"\u003e\n\t\tselect `cate_id`,`parent_id`,`cate_code`,`name`,`unit`,`used_count`,`specify`,`property`,`status`,`description` from bom\n        \u003cwhere\u003e  \n\t\t  \t\t  \u003cif test=\"cateId != null and cateId != ''\"\u003e and cate_id = #{cateId} \u003c/if\u003e\n\t\t  \t\t  \u003cif test=\"parentId != null and parentId != ''\"\u003e and parent_id = #{parentId} \u003c/if\u003e\n\t\t  \t\t  \u003cif test=\"cateCode != null and cateCode != ''\"\u003e and cate_code = #{cateCode} \u003c/if\u003e\n\t\t  \t\t  \u003cif test=\"name != null and name != ''\"\u003e and name = #{name} \u003c/if\u003e\n\t\t  \t\t  \u003cif test=\"unit != null and unit != ''\"\u003e and unit = #{unit} \u003c/if\u003e\n\t\t  \t\t  \u003cif test=\"usedCount != null and usedCount != ''\"\u003e and used_count = #{usedCount} \u003c/if\u003e\n\t\t  \t\t  \u003cif test=\"specify != null and specify != ''\"\u003e and specify = #{specify} \u003c/if\u003e\n\t\t  \t\t  \u003cif test=\"property != null and property != ''\"\u003e and property = #{property} \u003c/if\u003e\n\t\t  \t\t  \u003cif test=\"status != null and status != ''\"\u003e and status = #{status} \u003c/if\u003e\n\t\t  \t\t  \u003cif test=\"description != null and description != ''\"\u003e and description = #{description} \u003c/if\u003e\n\t\t  \t\t\u003c/where\u003e\n        \u003cchoose\u003e\n            \u003cwhen test=\"sort != null and sort.trim() != ''\"\u003e\n                order by ${sort} ${order}\n            \u003c/when\u003e\n\t\t\t\u003cotherwise\u003e\n                order by cate_id desc\n\t\t\t\u003c/otherwise\u003e\n        \u003c/choose\u003e\n\t\t\u003cif test=\"offset != null and limit != null\"\u003e\n\t\t\tlimit #{offset}, #{limit}\n\t\t\u003c/if\u003e\n\t\u003c/select\u003e\n\t\u003c!-- 为了保证mycat分库的操作会进行，同一查询会重新执行而不是在sqlSession中查找，需要加上flushCache=\"true\"--\u003e\n \t\u003cselect id=\"count\" flushCache=\"true\" resultType=\"int\"\u003e\n\t\tselect count(*) from bom\n\t\t \u003cwhere\u003e  \n\t\t  \t\t  \u003cif test=\"cateId != null and cateId != ''\"\u003e and cate_id = #{cateId} \u003c/if\u003e\n\t\t  \t\t  \u003cif test=\"parentId != null and parentId != ''\"\u003e and parent_id = #{parentId} \u003c/if\u003e\n\t\t  \t\t  \u003cif test=\"cateCode != null and cateCode != ''\"\u003e and cate_code = #{cateCode} \u003c/if\u003e\n\t\t  \t\t  \u003cif test=\"name != null and name != ''\"\u003e and name = #{name} \u003c/if\u003e\n\t\t  \t\t  \u003cif test=\"unit != null and unit != ''\"\u003e and unit = #{unit} \u003c/if\u003e\n\t\t  \t\t  \u003cif test=\"usedCount != null and usedCount != ''\"\u003e and used_count = #{usedCount} \u003c/if\u003e\n\t\t  \t\t  \u003cif test=\"specify != null and specify != ''\"\u003e and specify = #{specify} \u003c/if\u003e\n\t\t  \t\t  \u003cif test=\"property != null and property != ''\"\u003e and property = #{property} \u003c/if\u003e\n\t\t  \t\t  \u003cif test=\"status != null and status != ''\"\u003e and status = #{status} \u003c/if\u003e\n\t\t  \t\t  \u003cif test=\"description != null and description != ''\"\u003e and description = #{description} \u003c/if\u003e\n\t\t  \t\t\u003c/where\u003e\n\t\u003c/select\u003e\n\t \n\t\u003cinsert id=\"save\" parameterType=\"com.sanshengshui.multitenant.pojo.BomDO\" useGeneratedKeys=\"true\" keyProperty=\"cateId\"\u003e\n\t\tinsert into bom\n\t\t(\n\t\t\t`parent_id`, \n\t\t\t`cate_code`, \n\t\t\t`name`, \n\t\t\t`unit`, \n\t\t\t`used_count`, \n\t\t\t`specify`, \n\t\t\t`property`, \n\t\t\t`status`, \n\t\t\t`description`\n\t\t)\n\t\tvalues\n\t\t(\n\t\t\t#{parentId}, \n\t\t\t#{cateCode}, \n\t\t\t#{name}, \n\t\t\t#{unit}, \n\t\t\t#{usedCount}, \n\t\t\t#{specify}, \n\t\t\t#{property}, \n\t\t\t#{status}, \n\t\t\t#{description}\n\t\t)\n\t\u003c/insert\u003e\n\n\u003c/mapper\u003e\n```\n\n这里还是来测试count方法。\n\n写一个controller\n\n```\npackage com.sanshengshui.multitenant.controller;\n\nimport com.sanshengshui.multitenant.mapper.BomMapper;\nimport com.sanshengshui.multitenant.pojo.BomDO;\nimport com.sanshengshui.multitenant.utils.SessionUtil;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.stereotype.Controller;\nimport org.springframework.web.bind.annotation.GetMapping;\nimport org.springframework.web.bind.annotation.PathVariable;\nimport org.springframework.web.bind.annotation.ResponseBody;\n\nimport javax.servlet.http.HttpSession;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Map;\n\n@Controller\npublic class TestController {\n\n    @Autowired\n    BomMapper bomMapper;\n\n    //简化，直接通过这里设置session\n    @GetMapping(\"/set/{sess}\")\n    @ResponseBody\n    public Object setSession(@PathVariable(\"sess\") String sess){\n        HttpSession httpSession= SessionUtil.getSession();\n        httpSession.setAttribute(\"corp\",sess);\n        return \"ok\";\n    }\n\n    @ResponseBody\n    @GetMapping(\"/list\")\n    public List\u003cBomDO\u003e list(){\n        Map\u003cString, Object\u003e query = new HashMap\u003c\u003e(16);\n        List\u003cBomDO\u003e bomList = bomMapper.list(query);\n        return bomList;\n    }\n    \n    @GetMapping(\"/count\")\n    @ResponseBody\n    public Object getCount(){\n        //要测试的方法\n        Map\u003cString, Object\u003e map = new HashMap\u003cString, Object\u003e();\n        return bomMapper.count(map);\n    }   \n}\n```\n\n首先通过localhost:8080/set/{sess}设置session，假设session设置为dn1.\n\n浏览器中输入localhost:8080/set/dn1.\n\n之后，输入localhost:8080/count.\n\n结果如下：\n\n![dn1](https://github.com/sanshengshui/multiTenant/blob/master/doc/dn1.png)\n\n来看下打印的sql语句：\n\n![dn1-sql](https://github.com/sanshengshui/multiTenant/blob/master/doc/dn1-sql.png)\n\n可以看到，SQL注解已经成功添加进去了。\n\n在设置session为dn2\n\n![dn2](https://github.com/sanshengshui/multiTenant/blob/master/doc/dn2.png)\n\n结果如下。\n\n打印的sql语句：\n\n![dn2-sql](https://github.com/sanshengshui/multiTenant/blob/master/doc/dn2-sql.png)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsanshengshui%2Fmultitenant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsanshengshui%2Fmultitenant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsanshengshui%2Fmultitenant/lists"}