1 Star 2 Fork 2

Lockdown / dk-foundation

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
README.md 3.11 KB
一键复制 编辑 原始数据 按行查看 历史
Lockdown 提交于 2018-08-03 09:57 . 更新 README.md

dk-foundation

项目介绍

spring 快速开发工具包,自动集成了mybatis,sharding-jdbc,redis等

使用说明

  1. dk-foundation-common模块为一些基础工具
  2. dk-foundation-engine-sharding-jdbc是一个集成了sharding-jdbc的快速开发包
  3. dk-foundation-engine-declare-datasource是一个可以通过配置com.dk.foundation.engine.DynamicDataSourcePlugin和@DataSource来决定数据源(@DataSource声明优先级比DynamicDataSourcePlugin优先级高,事务优先级最高)的快速开发包。使用此开发包可以很方便地支持多数据源,方便地开发读写分离的软件服务。

ps:如果你的项目涉及到分库分表,可使用sharding-jdbc包,或选用其它数据库中间件。

基于约定大于配置的理念,项目的module应该命名为com.dk.*.worker,星号自己命名,这样spring会自动扫描相对于的package注入bean,实现项目初始能力的赋予。

@ComponentScan(basePackages = "com.dk.foundation.common,com.dk.foundation.engine,com.dk.*.mapper,com.dk.*.service,com.dk.*.worker")
public class EngineConfig {
}

快速开发

添加项目依赖

<dependency>
    <groupId>com.dk.foundation</groupId>
    <artifactId>dk-foundation-engine-declare-datasource</artifactId>
    <version>1.0-SNAPSHOT</version>
</dependency>

在项目的启动文件添加@EnableEngineStart即可赋予项目一些初始能力,像是按下汽车一键启动键,如下所示

@MapperScan("com.dk.test.*.mapper")
@EnableEngineStart
public class Startup {

    public static void main(String[] args) throws Exception {
        SpringApplication.run(Startup.class, args);
    }
}

方式一:DynamicDataSourcePlugin

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTDConfig 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <plugins>
        <plugin interceptor="com.dk.foundation.engine.DynamicDataSourcePlugin" />
    </plugins>
</configuration>

插件检测到你的sql脚本是插入、更新、删除的语句,自动选择主数据源;如果是查询语句,则随机选择一个读数据源;开启了事务会根据事务选择数据源。

方式二:@DataSource注解方式

@DataSource(name="master")
public List<User> selectListBySQL()
{
     List<User> users = userMapper.selectListBySQL();
     return users;
}

在使用DynamicDataSourcePlugin同时使用@DataSource注解的时候,会选择注解指定的数据源。

@Transactional
@DataSource(name="db_slave_0")
public void insert()
{
    List<User> users = userMapper.selectListBySQL();
    for (User user:users
         ) {
        user.setName(user.getName()+"_testInsert");
        userMapper.insert(user);
    }
}

在使用DynamicDataSourcePlugin并使用@DataSource注解的同时,开启了事务,如上代码所示,对于userMapper.selectListBySQL(),DynamicDataSourcePlugin和@DataSource都会选择从数据源,对于userMapper.insert(user),DynamicDataSourcePlugin选择主数据源,但实际上却都走了主数据源,这是因为开启了事务,事务优先级最高。

Java
1
https://gitee.com/dugukuangshao/dk-foundation.git
git@gitee.com:dugukuangshao/dk-foundation.git
dugukuangshao
dk-foundation
dk-foundation
master

搜索帮助