数据库连接池配置

配置文件的基本结构

NekoRay的配置文件通常以nekoray.properties为文件名，位于项目的根目录或配置目录下，配置文件的内容主要包括以下几个部分：

（1）数据库连接池配置

db.username = root
db.password = root
db.driver = com.mysql.jdbc.Driver
db.initializrPoolSize = 10
db.maxPoolSize = 50
db.minPoolSize = 5
db.maxWaitTime = 500

• db.url：数据库连接 URL，格式为 jdbc:mysql://host:port/database
• db.username 和 db.password：数据库用户名和密码
• db.driver：数据库驱动类路径
• db.initializrPoolSize：初始化连接池的大小
• db.maxPoolSize：连接池的最大连接数
• db.minPoolSize：连接池的最小连接数
• db.maxWaitTime：等待最长时间（ms）获取连接

（2）事务管理配置

# 事务管理配置
tx.managed = true
tx.factory = org.nekoday.tx.TxFactory
tx.isolationLevel = TRANSACTION_READ_UNCOMMITTED
tx.rollbackOnly = false
# 事务管理策略配置
tx.defaultLockMode = PESSIMISTIC_READ
tx.defaultTransactionType = TRANSACTION_NONE
tx.defaultIsolationLevel = TRANSACTION_READ_UNCOMMITTED

• tx.managed：是否启用NekoRay的事务管理，默认为true
• tx.factory：事务工厂类路径
• tx.isolationLevel：事务的隔离级别，默认为TRANSACTION_READ_UNCOMMITTED
• tx.rollbackOnly：事务仅在发生错误时回滚，默认为false

（3）主键生成策略

# 主键生成策略配置
pk.generateStrategy = IDENTITY
pk.defaultValue = 0
pk.column = id

• pk.generateStrategy：主键生成策略，支持IDENTITY（自动递增）、UUID（使用UUID生成器）或NONE（不生成主键）
• pk.defaultValue：主键的默认值
• pk.column：主键所在的数据库列名

（4）自定义实体映射

# 实体映射配置
entity.mapSuperclass = true
entity.lazyLoading = true
entity.eagerLoading = false

• entity.mapSuperclass：是否映射超级类，默认为true
• entity.lazyLoading：是否启用懒加载，默认为true
• entity.eagerLoading：是否启用急切加载，默认为false

（5）查询缓存配置

# 查询缓存配置
query.cacheEnabled = true
query.cacheDuration = 360
query.cacheSize = 100

• query.cacheEnabled：是否启用查询缓存，默认为true
• query.cacheDuration：查询缓存的有效时间（秒）
• query.cacheSize：查询缓存的最大大小（条目）

配置文件中的示例

以下是一个完整的NekoRay配置文件示例：

# NekoRay 的配置文件
db.url = jdbc:mysql://localhost:3306/mydb
db.username = admin
db.password = password
db.driver = com.mysql.jdbc.Driver
db.initializrPoolSize = 10
db.maxPoolSize = 100
db.minPoolSize = 5
db.maxWaitTime = 500
tx.managed = true
tx.factory = org.nekoday.tx.TxFactory
tx.defaultLockMode = PESSIMISTIC_READ
tx.defaultTransactionType = TRANSACTION_NONE
pk.generateStrategy = IDENTITY
pk.defaultValue = 0
pk.column = id
entity.mapSuperclass = true
entity.lazyLoading = true
entity.eagerLoading = false
query.cacheEnabled = true
query.cacheDuration = 360
query.cacheSize = 100

常见问题与注意事项

• 如果配置文件中没有定义数据库 URL，NekoRay 会使用默认数据库名称。
• 确保数据库存在,用户名和密码正确。
• 如果使用主键生成策略,请注意数据库支持的主键类型（如 InnoDB）。
• 如果需要自定义事务管理策略,可以在配置文件中修改相关参数。