更新时间:2024-11-28 GMT+08:00
SpringBoot项目接入MAS-DB-SDK
- 引入MAS-DB-SDK组件坐标,下面version版本为最新版本,依赖组件版本参考如何选择组件版本。
<dependency> <groupId>com.huaweicloud.devspore</groupId> <artifactId>spring-cloud-starter-huawei-devspore-datasource</artifactId> <version>1.2.1-RELEASE</version> </dependency>
- 根据本项目配置项选其中一个数据连接池坐标。
<dependency> <groupId>com.zaxxer</groupId> <artifactId>HikariCP</artifactId> <version>4.0.3</version> </dependency> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-dbcp2</artifactId> <version>2.8.0</version> </dependency> <dependency> <groupId>com.alibaba</groupId> <artifactId>druid</artifactId> <version>1.2.6</version> </dependency>
- 项目配置文件application.yaml或者application.properties中加入MAS-DB-SDK配置项。
- 下文中配置项的格式为yaml文件,如果配置文件为properties格式,需自行修改格式。
- MAS-DB-SDK配置项分为4部分:props配置、etcd配置、sources数据源配置、router路由配置。
- 如果使用MAS服务,props配置、etcd配置则必须要配置,sources数据源配置需要与MAS服务中连接池中的命名一致。如果不对接MAS服务,props配置、etcd配置无需配置,sources数据源配置本地所用数据库即可。
- 下列场景中的配置都包含了props、etcd的配置,配置项的具体值含义参考配置项详细信息列表。
- MAS-DB-SDK配置示例,这里的配置只作为一个格式的展示,具体场景的具体配置参考章节配置说明。
devspore: datasource: props: version: v1 appId: xxx monitorId: xxx databaseName: xxx decipherClassName: xxx.xxx.xxx region: az0 etcd: address: 127.0.0.2:2379,127.0.0.2:2379,127.0.0.2:2379 apiVersion: v3 username: etcduser password: etcdpwd httpsEnable: false sources: ds1: driverClassName: com.mysql.jdbc.Driver jdbcUrl: jdbc:mysql://127.0.0.1:3306/ds0 username: datasourceuser password: datasourcepwd type: com.zaxxer.hikari.HikariDataSource props: connectionTimeout: 30000 maximumPoolSize: 200 ds1-slave0: driverClassName: com.mysql.jdbc.Driver jdbcUrl: jdbc:mysql://127.0.0.1:3306/ds0_slave0 username: datasourceuser password: datasourcepwd type: com.zaxxer.hikari.HikariDataSource props: connectionTimeout: 30000 maximumPoolSize: 200 ds1-slave1: driverClassName: com.mysql.jdbc.Driver jdbcUrl: jdbc:mysql://127.0.0.1:3306/ds0_slave1 username: datasourceuser password: datasourcepwd type: com.zaxxer.hikari.HikariDataSource props: connectionTimeout: 30000 maximumPoolSize: 200 ds2: driverClassName: com.mysql.jdbc.Driver jdbcUrl: jdbc:mysql://127.0.0.1:3306/ds1 username: datasourceuser password: datasourcepwd type: com.zaxxer.hikari.HikariDataSource props: connectionTimeout: 30000 maximumPoolSize: 200 ds2-slave0: driverClassName: com.mysql.jdbc.Driver jdbcUrl: jdbc:mysql://127.0.0.1:3306/ds1_slave0 username: datasourceuser password: datasourcepwd type: com.zaxxer.hikari.HikariDataSource props: connectionTimeout: 30000 maximumPoolSize: 200 ds2-slave1: driverClassName: com.mysql.jdbc.Driver jdbcUrl: jdbc:mysql://127.0.0.1:3306/ds1_slave1 username: datasourceuser password: datasourcepwd type: com.zaxxer.hikari.HikariDataSource props: connectionTimeout: 30000 maximumPoolSize: 200 router: active: dc1 routeAlgorithm: single-read-write nodes: dc1: master: ds1 loadBalance: ROUND_ROBIN slaves: - ds1-slave0 - ds1-slave1 dc2: master: ds1 loadBalance: ROUND_ROBIN slaves: - ds2-slave0 - ds2-slave1
- 使用MAS-DB-SDK提供注解在类级别、方法级别指定数据源。
- 此步骤为可选步骤,如果在本项目中使用不到,忽略此步骤即可。
- 如果不指定数据源,默认使用application.yaml、application.properties中router下配置的active节点。
- 类级别指定数据源示例:
- 方法级别指定数据源示例:
父主题: 接入指南