手册

概述

框架核心（Core）

核心概述包类的自动扫描（AutoScan）依赖注入（IoC）方法拦截（AOP）记录类属性状态 (PropertyState) 事件服务（Event）模块（Module）国际化（I18N） Lang

配置体系(Configuration

配置体系概述配置体系目录结构及配置示例一：解析XML配置示例二：解析Properties配置配置体系模块更多操作

日志(log)

日志概述日志模块配置使用示例

持久化(Persistence)

JDBC持久化概述及模块配置数据源（DataSource）数据实体（Entity）自动生成实体类（方式一）自动生成实体类（方式二）事务（Transaction）会话（Session）数据实体操作结果集（ResultSet）查询（Query）存储器（Repository）高级特性—多表查询及自定义结果集数据处理高级特性—存储过程调用与结果集数据处理高级特性—数据库锁操作

插件（Plugin）

插件概述插件工厂自定义插件工厂插件结构插件的实现及使用

服务(Serv)

服务概述服务端（Server）示例客户端（Client）示例客户端和服务端对象的使用

验证（Validation）

验证概述默认验证器及参数说明默认国际化资源文件内容验证框架使用示例自定义验证器

缓存（Cache）

缓存概述缓存模块配置缓存模块使用示例

WebMVC

WebMVC概述模块初始化及配置说明控制器（Controller）控制器参数（Parameter）环境上下文对象（WebContext）文件上传（Upload）视图（View）验证（Validation）缓存（Cache）拦截器（Intercept） Cookies操作国际化（I18N）约定模式（Convention Mode）高级特性—控制器请求处理器高级特性—异常错误处理器

首页后端开发 Java YMP在线手册

JDBC持久化概述及模块配置

阅读11905

更新时间2022-04-11

数据源（DataSource）

JDBC持久化模块针对关系型数据库(RDBMS)数据存取的一套简单解决方案，主要关注数据存取的效率、易用性和透明，其具备以下功能特征：

基于JDBC框架API进行轻量封装，结构简单、便于开发、调试和维护；
优化批量数据更新、标准化结果集、预编译SQL语句处理；
支持单实体ORM操作，无需编写SQL语句；
提供脚手架工具，快速生成数据实体类，支持链式调用；
支持通过存储器注解自定义SQL语句或从配置文件中加载SQL并自动执行；
支持结果集与值对象的自动装配，支持自定义装配规则；
支持多数据源，默认支持C3P0、DBCP、JNDI连接池配置，支持数据源扩展；
支持多种数据库(如:Oracle、MySQL、SQLServer等)；
支持面向对象的数据库查询封装，有助于减少或降低程序编译期错误；
支持数据库事务嵌套；
支持数据库存储过程*；

Maven包依赖


    net.ymate.platform
    ymate-platform-persistence-jdbc
    2.0-SNAPSHOT

注：在项目的pom.xml中添加上述配置，该模块已经默认引入核心包及持久化基础包依赖，无需重复配置。

模块初始化配置

#-------------------------------------
# JDBC持久化模块初始化参数
#-------------------------------------

# 默认数据源名称，默认值为default
ymp.configs.persistence.jdbc.ds_default_name=

# 数据源列表，多个数据源名称间用'|'分隔，默认为default
ymp.configs.persistence.jdbc.ds_name_list=

# 是否显示执行的SQL语句，默认为false
ymp.configs.persistence.jdbc.ds.default.show_sql=

# 数据库表前缀名称，默认为空
ymp.configs.persistence.jdbc.ds.default.table_prefix=

# 数据源适配器，可选值为已知适配器名称或自定义适配置类名称，默认为default，目前支持已知适配器[default|dbcp|c3p0|jndi|...]
ymp.configs.persistence.jdbc.ds.default.adapter_class=

# 数据库类型，可选参数，默认值将通过连接字符串分析获得，目前支持[mysql|oracle|sqlserver|db2|sqlite|postgresql|hsqldb|h2]
ymp.configs.persistence.jdbc.ds.default.type=

# 数据库方言，可选参数，自定义方言将覆盖默认配置
ymp.configs.persistence.jdbc.ds.default.dialect_class=

# 数据库连接驱动，可选参数，框架默认将根据数据库类型进行自动匹配
ymp.configs.persistence.jdbc.ds.default.driver_class=

# 数据库连接字符串，必填参数
ymp.configs.persistence.jdbc.ds.default.connection_url=

# 数据库访问用户名称，必填参数
ymp.configs.persistence.jdbc.ds.default.username=

# 数据库访问密码，可选参数，经过默认密码处理器加密后的admin字符串为wRI2rASW58E
ymp.configs.persistence.jdbc.ds.default.password=

# 数据库访问密码是否已加密，默认为false
ymp.configs.persistence.jdbc.ds.default.password_encrypted=

# 数据库密码处理器，可选参数，用于对已加密数据库访问密码进行解密，默认为空
ymp.configs.persistence.jdbc.ds.default.password_class=

配置参数补充说明：

数据源的数据库连接字符串和用户名是必填项，其它均为可选参数，最简配置如下：
ymp.configs.persistence.jdbc.ds.default.connection_url=jdbc:mysql://localhost:3306/mydb
ymp.configs.persistence.jdbc.ds.default.username=root
为了避免明文密码出现在配置文件中，YMP框架提供了默认的数据库密码处理器，或者通过IPasswordProcessor接口自行实现；
net.ymate.platform.core.support.impl.DefaultPasswordProcessor

数据源（DataSource）