# taos-datasource-springboot-starter

**Repository Path**: oleyang/taos-datasource-springboot-starter

## Basic Information

- **Project Name**: taos-datasource-springboot-starter
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2021-02-05
- **Last Updated**: 2021-04-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# taos-datasource-springboot-starter

###【功能】：

1. 内置驱动包（x64）, 客户端无需手动安装驱动包

2. 支持Http，为方便 Mac 端开发，实现了Http JDBC调用

3. 支持3种连接池：Druid、Hikari、Apache-common-pool2

4. 支持Mybatis

5. 基于多数据源设计

6. springboot应用中直接配置使用，方便快捷

7. 支持springboot JDBC actuator（DataSourceHealthIndicator）进行连接池的健康检查

###【配置使用】：

#### Maven 依赖：
```
<!--springboot-->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter</artifactId>
    <version>2.1.14.RELEASE</version>
</dependency>

<!--taos官方jdbcdriver-->
<dependency>
    <groupId>com.taosdata.jdbc</groupId>
    <artifactId>taos-jdbcdriver</artifactId>
    <version>2.0.3</version>
</dependency>

<!--taos-datasource依赖放到工程目录-->
<dependency>
    <groupId>net.ewent.taos</groupId>
    <artifactId>taos-datasource-springboot-starter</artifactId>
    <version>1.0.0-SNAPSHOT</version>
    <scope>system</scope>
    <systemPath>${basedir}/src/main/lib/taos-datasource-springboot-starter-1.0.0-SNAPSHOT.jar</systemPath>
</dependency>

<!--mybatis-->
<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>2.1.2</version>
</dependency>

<!-- 以下3个连接池选一个使用即可 -->
<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-pool2</artifactId>
    <version>2.8.0</version>
</dependency>
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid</artifactId>
    <version>1.1.22</version>
</dependency>
<dependency>
    <groupId>com.zaxxer</groupId>
    <artifactId>HikariCP</artifactId>
    <version>3.4.5</version>
</dependency>
```

#### application.yml配置：

> 配置前缀为：spring.datasource.taos

1、基础配置

```
spring.datasource.taos:
    jdbc-url: jdbc:TAOS://127.0.0.1:0/you_database?user=root&password=taosdata&enableMicrosecond=true
    use-http: false # 默认false, 不使用http JDBC
    mac-force-http: true # 默认true, 会自动检查系统环境，发现是Mac时直接使用http JDBC
    mapper-locations: # 与mybatis的mapperLocations配置作用一致，两者用其一即可
        - classpath*:sqlmap/*-mapper.xml
```

2、连接池配置

```
# Druid配置：
  spring.datasource.taos:
     druid:
        maxActive: 10 # maximum number of connection in the pool
        initialSize: 3 # initial number of connection
        maxWait: 10000 # maximum wait milliseconds for get connection from pool
        minIdle: 3 # minimum number of connection in the pool
        validationQuery: select server_status()
        # 更多配置请参看druid官方文档
        # https://github.com/alibaba/druid

# Hikari配置：
  spring.datasource.taos:
     hikari:
        minimumIdle: 3 # minimum number of idle connection
        maximumPoolSize: 10 # maximum number of connection in the pool
        connectionTimeout: 10000 # maximum wait milliseconds for get connection from pool
        connectionTestQuery: select server_status()
        # 更多配置请参看hikari官方文档
        # https://github.com/brettwooldridge/HikariCP

# Apache-common-pool2配置：
  spring.datasource.taos:
     pool2:
        maxTotal: 10
        maxIdle: 3
        testQuery: select server_status()
        # 更多配置请参看Apache-common-pool2官方文档
        # http://commons.apache.org/proper/commons-pool/index.html
```

3、Mybatis 集成
> 无需特别配置，常规使用就好

```
指定mapper扫描，如系统中没有其他SqlSessionFactory对象，sqlSessionFactoryRef配置可省略
@MapperScan(basePackages = "xxx.taos.mapper", sqlSessionFactoryRef = "taosSqlSessionFactoryBean")

@Mapper
public interface OrderMapper {
    ......
}

@Service
public class OrderServiceImpl implements OrderService {
    @Autowired
    OrderMapper orderMapper;
}
```

4、自定义驱动包

默认会优先加载系统lib中的驱动包，如果系统中没有安装驱动包，则加载jar包中的驱动使用

windows 下可以将 C:\TDengine\driver\taos.dll 拷贝到 C:\Windows\System32\ 目录下。
linux   下将建立如下软链 ln -s /usr/local/taos/driver/libtaos.so.x.x.x.x /usr/lib/libtaos.so 即可。

更多内容请查看taos官方文档：https://www.taosdata.com/cn/documentation20/connector/