Skip to content

Commit

Permalink
commit：first commit
Browse files Browse the repository at this point in the history
  • Loading branch information
sudohuang committed Jun 10, 2020
1 parent d6bdbd0 commit e0d8c1f
Show file tree
Hide file tree
Showing 33 changed files with 4,303 additions and 0 deletions.
11 changes: 11 additions & 0 deletions .gitignore
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
target/
.mvn/

### IntelliJ IDEA ###
.idea
*.iws
*.iml
*.ipr

# dumps #
dumps/state_*
144 changes: 144 additions & 0 deletions README.md
View file
Original file line number Diff line number Diff line change
@@ -1 +1,145 @@
# taos-datasource-springboot-starter

###【功能】：

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

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

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

4. 支持Mybatis

5. 基于多数据源设计

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

###【配置使用】：

#### 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>1.0.3</version>
</dependency>
<!--taos-datasource依赖放到工程目录-->
<dependency>
<groupId>net.ewent.taos</groupId>
<artifactId>taos-datasource-springboot-starter</artifactId>
<version>1.0.0</version>
<scope>system</scope>
<systemPath>${basedir}/src/main/lib/taos-datasource-springboot-starter-1.0.0.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/documentation/connector/

98 changes: 98 additions & 0 deletions pom.xml
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,98 @@
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>

<groupId>net.ewent.taos</groupId>
<artifactId>taos-datasource-springboot-starter</artifactId>
<version>1.0.0-SNAPSHOT</version>

<properties>
<java.version>1.8</java.version>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<skipTests>true</skipTests>
</properties>

<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
<version>2.1.14.RELEASE</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-pool2</artifactId>
<version>2.8.0</version>
<scope>compile</scope>
<optional>true</optional>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.1.22</version>
<scope>compile</scope>
<optional>true</optional>
</dependency>
<dependency>
<groupId>com.zaxxer</groupId>
<artifactId>HikariCP</artifactId>
<version>3.4.5</version>
<scope>compile</scope>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.1.2</version>
<scope>compile</scope>
<optional>true</optional>
</dependency>
<dependency>
<groupId>com.taosdata.jdbc</groupId>
<artifactId>taos-jdbcdriver</artifactId>
<version>1.0.3</version>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.2.70</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.25</version>
</dependency>
</dependencies>

<build>
<plugins>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>${java.version}</source>
<target>${java.version}</target>
</configuration>
</plugin>
</plugins>
<resources>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.so</include>
<include>**/*.dll</include>
<include>**/*.dylib</include>
<include>**/*.jnilib</include>
</includes>
</resource>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/**</include>
</includes>
</resource>
</resources>
</build>
</project>
Loading

0 comments on commit e0d8c1f

Please sign in to comment.