Grails3.2项目配置

蔚落 2022-05-09 04:24 235阅读 0赞

# Grails3.2项目配置 #

### 1. 基本配置 ###

Grails中的配置通常分为两个方面：**构建配置**和**运行时配置**。  
**构建配置**通常通过Gradle和build.gradle文件完成。**运行时配置**默认在grails-app/conf/application.yml文件中的YAML中指定。

**application.yml** 是Grails 3.0中引入了配置任务的替代格式。

### 2. dataSource配置 ###

> driverClassName - JDBC驱动程序的类名称  
> username - 用于建立JDBC连接的用户名  
> password - 用于建立JDBC连接的密码  
> url - 数据库的JDBC URL  
> dbCreate - 是否从领域模型自动生成数据库 - “创建 - 删除”，“创建”，“更新”或“验证”  
> pooled - 是否使用连接池（默认为true）  
> logSql - 启用SQL日志记录到标准输出  
> formatSql - 格式化记录的SQL  
> dialect - 表示用于与数据库通信的Hibernate方言的字符串或类。有关可用方言，请参阅org.hibernate.dialect包。  
> readOnly- 如果true使DataSource为只读，这会导致setReadOnly(true)每个连接池都调用它Connection  
> transactional- 如果false将DataSource的transactionManager bean留在链式BE1PC事务管理器实现之外。这仅适用于其他数据源。  
> persistenceInterceptor - 默认数据源自动连接到持久性拦截器，其他数据源不会自动连接，除非设置为 true  
> properties - 在DataSource bean上设置的额外属性。请参阅Tomcat池文档。还有一个属性的Javadoc格式文档。  
> jmxExport- 如果false将禁用所有数据源的JMX MBean注册。默认情况下，JMX MBean通过jmxEnabled = true属性添加到DataSources 中。

### 3. properties 属性 ###

> jmxEnabled: true(注册池JMX)  
> initialSize: 5(初始化连接数)  
> maxActive: 50(连接池处于活动状态的数据库连接的最大数目，0表示不限制,表示最大并发)  
> minIdle: 5(连接池处于空闲状态的数据库连接的最小数目，低于此数值将会创建所欠缺的连接，设0无限制)  
> maxIdle: 25(连接池处于空闲状态的数据库连接的最大数目，取非正整数表示不受限制，超过此数值时多余的空闲连接将会被释放)  
> maxWait: 10000(连接池中连接用完时，新的请求的等待时间（即等待别的连接空闲），超时返回异常，毫秒)  
> maxAge: 600000()保持连接的最大毫秒数。当一个连接被归还时，连接池将检查是否满足：现在时间-连接时长>maxAge，如果条件满足，连接将被关闭而不是回到池中。默认值为0，标识禁用该功能)  
> timeBetweenEvictionRunsMillis: 5000(以毫秒表示空闲对象驱逐进程由休眠状态进入运行状态的数值，值为非正整时表示不运行任何空闲对象驱逐进程运行判断连接超时任务的时间间隔)  
> minEvictableIdleTimeMillis: 60000(以毫秒表示连接被空闲对象驱逐进程驱逐前在池中保持空闲状态的最小时间，连接的超时时间，默认为半小时)  
> validationQuery: SELECT 1(在连接返回给调用者前用于校验连接是否有效的SQL语句，如果指定了SQL语句，则必须为一个SELECT语句，且至少有一行结果)  
> validationQueryTimeout: 3  
> validationInterval: 15000(检查连接死活的时间间隔，单位：毫秒)  
> testOnBorrow: true(指定连接被调用时是否经过校验，如果校验未通过，则该连接被连接池断掉，并由连接池尝试调用另一个连接值为true,则validationQuery参数必须为一个非空字)  
> testWhileIdle: true(指定连接进入空闲状态时是否经过空闲对象驱逐进程的校验，如果校验未通过，则该连接被连接池断掉值为true,则validationQuery参数必须为一个非空字串)  
> testOnReturn: false(指定连接返回到池中是时是否经过校验值为true,则validationQuery参数必须为一个非空字串)  
> jdbcInterceptors: ConnectionState(设置 tomcat jdbc 连接池的拦截器。  
> 内置的拦截器： org.apache.tomcat.jdbc.pool.interceptor.ConnectionState  
> 追踪自动提交、只读状态、catalog和事务隔离等级等状态)  
> defaultTransactionIsolation: 2 (指定由连接池所创建的连接的事务级别——TransactionIsolation。可用值为下列之一：详情可见javadoc  
> NONE, READ\_COMMITTED, READ\_UNCOMMITTED, REPEATABLE\_READ, SERIALIZABLE)

### 例 ###

dataSource {
        pooled = true
        dbCreate = "update"
        url = "jdbc:mysql://localhost:3306/my_database"
        driverClassName = "com.mysql.jdbc.Driver"
        dialect = org.hibernate.dialect.MySQL5InnoDBDialect
        username = "username"
        password = "password"
        properties {
           // Documentation for Tomcat JDBC Pool
           // http://tomcat.apache.org/tomcat-7.0-doc/jdbc-pool.html#Common_Attributes
           // https://tomcat.apache.org/tomcat-7.0-doc/api/org/apache/tomcat/jdbc/pool/PoolConfiguration.html
           jmxEnabled = true
           initialSize = 5
           maxActive = 50
           minIdle = 5
           maxIdle = 25
           maxWait = 10000
           maxAge = 10 * 60000
           timeBetweenEvictionRunsMillis = 5000
           minEvictableIdleTimeMillis = 60000
           validationQuery = "SELECT 1"
           validationQueryTimeout = 3
           validationInterval = 15000
           testOnBorrow = true
           testWhileIdle = true
           testOnReturn = false
           ignoreExceptionOnPreLoad = true
           // http://tomcat.apache.org/tomcat-7.0-doc/jdbc-pool.html#JDBC_interceptors
           jdbcInterceptors = "ConnectionState;StatementCache(max=200)"
           defaultTransactionIsolation = java.sql.Connection.TRANSACTION_READ_COMMITTED // safe default
           // controls for leaked connections
           abandonWhenPercentageFull = 100 // settings are active only when pool is full
           removeAbandonedTimeout = 120
           removeAbandoned = true
           // use JMX console to change this setting at runtime
           logAbandoned = false // causes stacktrace recording overhead, use only for debugging
           // JDBC driver properties
           // Mysql as example
           dbProperties {
               // Mysql specific driver properties
               // http://dev.mysql.com/doc/connector-j/en/connector-j-reference-configuration-properties.html
               // let Tomcat JDBC Pool handle reconnecting
               autoReconnect=false
               // truncation behaviour
               jdbcCompliantTruncation=false
               // mysql 0-date conversion
               zeroDateTimeBehavior='convertToNull'
               // Tomcat JDBC Pool's StatementCache is used instead, so disable mysql driver's cache
               cachePrepStmts=false
               cacheCallableStmts=false
               // Tomcat JDBC Pool's StatementFinalizer keeps track
               dontTrackOpenResources=true
               // performance optimization: reduce number of SQLExceptions thrown in mysql driver code
               holdResultsOpenOverStatementClose=true
               // enable MySQL query cache - using server prep stmts will disable query caching
               useServerPrepStmts=false
               // metadata caching
               cacheServerConfiguration=true
               cacheResultSetMetadata=true
               metadataCacheSize=100
               // timeouts for TCP/IP
               connectTimeout=15000
               socketTimeout=120000
               // timer tuning (disable)
               maintainTimeStats=false
               enableQueryTimeouts=false
               // misc tuning
               noDatetimeStringSync=true
           }
        }
    }