Grails3

流程参考 grails.boot.GrailsApp

Grails 3 中 Bean 的初始化流程

  1. 调用 grails-app/init 目录下 Application.groovy 的 main() 方法
  2. 调用 GrailsApp#createApplicationContext()，并通过反射，设置使用 OptimizedAutowireCapableBeanFactory 作为Sping上下文的 beanFactory

  3. 通过 GrailsApp 调用 AbstractApplicationContext#refresh()：

    1. 调用 GrailsApplicationPostProcessor#postProcessBeanDefinitionRegistry() ：

      1. 通过 GrailsPluginManager 调用Grails插件（比如 SpringSecurityCoreGrailsPlugin）的 doWithSpring 设置。
      2. 依次加载 classpath:spring/resources.groovy, classpath:spring/resources.xml
      3. 调用 Application.groovy 中的 doWithSpring 。
      4. 注意：上述都是通过Grails BeanBuilder 创建的 Bean定义（尚未初始化），且Grails提供的接口 RuntimeSpringConfiguration 并未 提供删除Bean定义的方法。因此，如果要override（插件默认中）的bean定义，只能在上述后两者中声明覆盖， 而无法通过 @Service 或 @Bean 的方式来覆盖（使用Spring注解的方式时，一旦发现有同名的bean，就不会再初始化该注解所标识的类、方法的）

    2. 自调用 finishBeanFactoryInitialization 方法，初始化所有的bean，包含：

      1. Grails插件的 doWithSpring，resources.[groovy|xml]、Application.groovy 的 doWithSpring 中声明的bean
      2. @ComponentScan + @Component/@Service/@Controller/@Repository 注解标识要生成的bean。
      3. @Configuration + @Bean 标识的方法
    3. 自调用 finishRefresh() 方法并发送 ContextRefreshedEvent：
      1. 调用 Grails 插件(比如SpringSecurityCoreGrailsPlugin)的 doDynamicMethods, doPostProcessing, onStartup
      2. 调用 Grails 应用(Application.groovy)的 doWithDynamicMethods, doWithApplicationContext, onStartup
      3. 执行 grails-app/init/BootStrap.groovy 中的回调方法。

使 IEDA 下载源代码

前提：Grails配置为使用Maven管理依赖，而非早期使用的Ivy。

  1. 在命令行下，Grails工程的主目录下执行以下命令

     grails refresh-dependencies --include-source

  2. 在 IDEA Intellij 中 同步Grails配置

    IDEA : Grails View : 项目名称 上鼠标右键 : Grails : Synchronize Grails settings

  3. 检查一下，现在你就可以在IDEA 中看到依赖Jar包的源码了，而不是IDEA反编译后的代码了。

安装

sudo mkdir /usr/local/grails
sudo unzip ~/Downloads/grails-2.3.11.zip -d /usr/local/grails

vi /etc/profile.d/xxx.sh
export GRAILS_HOME=/usr/local/grails/grails-2.3.11
export PATH=$GRAILS_HOME/bin:$PATH

grails --version

分割 resources.groovy

参考 这里

移除事务、数据源

  1. 修改 BuildConfig.groovy

     grails.project.dependency.resolution = {
     inherits("global") {
         excludes 'grails-plugin-datasource'
 }
  2. 删除 DataSource.groovy

GORM Gotchas part 1、part 2、 part 3

参考这里 grails 从 2.4 开始，默认是的flush mode 从 FlushMode.MANUAL 改为了 FlushMode.AUTO。 controller 中默认的事务是readonly，readonly事务的FlushMode是Manual。 修改 Config.groovy，设置 grails.gorm.autoFlush = true 可以在调用 save() 方法时，都 flush=true.

  • 解决不合理的传递依赖，否则 run-app 会很慢

      grails.project.dependency.resolution = {
      plugins {
          compile(":spring-security-cas:2.0-RC1") {
              transitive = false
          }
      }
  }

  • run-app 没有 auto reload ，需要明确在命令行指定参数

     grails --stacktrace -Dserver.port=30010 run-app -reloading  # 注意 -reloading 需要放到 run-app 后面

  • 在 /WEB-INF/applicationContext.xml 中使用 placeHolder :

      <!-- applicationContext.xml -->
  <bean id="placeholderConfigurer"
        class="org.codehaus.groovy.grails.commons.cfg.GrailsPlaceholderConfigurer">
      <constructor-arg ref="grailsApplication"/>
  </bean>

  • 在 BuildConfig.groovy 中设置系统属性：

      // 相当于grails命令行参数 -Dserver.port=30018
  if (!System.getProperty("server.port")) {
      System.setProperty("server.port", "30010")
  }

  // 非 fork 模式 run-app 时，可以与自签名的其他 https 网站对接
  System.setProperty("javax.net.ssl.trustStore", "${basedir}/test/lizi.jks")
  System.setProperty("javax.net.ssl.trustStorePassword", "123456")

GRAILS_OPTS

export GRAILS_OPTS="-server -Xms1G -Xmx2G -XX:PermSize=512m -XX:MaxPermSize=512m -XX:-UseConcMarkSweepGC"

常用命令


grails list-plugins
grails create-app my-test
cd my-test
# grails install-templates
# grails generate-all helloworld.Book
grails create-domain-class Book
grails run-app

groovy-jdk vs. api vs. gapi

see this:

  1. api 是在所有Java文件上运行Javadoc之后的结果
  2. gapi 是在所有Java文件和Groovy文件上运行groovydoc之后的结果。（最初只是groovy文件，但是现在则包含两者）
  3. groovy-jdk 运行结果是对JDK进行增强的部分。

惯例优先原则（convention over configuration）

参考

Grails命令的查找方式

参考：4. The Command Line

Grails 使用Gant作为构建工具，它是对Grails的AntBuilder进行了一个简单封装。

Ant task列表

Gant 脚本是一个Groovy文件，并调用预定义的一个AntBuilder和其他对象。其中两个主要的对象就是 includeTargets 和 includeTool。

配置文件

Grails读取配置文件是Groovy文件。使用的 ConfigSlurper、 API 读取配置文件。

配置文件中也定义特定名称闭包，用以初始化特定的环境。

log4j

参考、 API

输出日志时logger名称前缀

Type path Logger prefix description
Controller ${APP_HOME}/grails-app/controllers grails.app.controllers
Service ${APP_HOME}/grails-app/services grails.app.services
Taglib ${APP_HOME}/grails-app/taglib grails.app.taglib
Job ${APP_HOME}/grails-app/jobs grails.app.jobs 需要grails quartz 插件

dataSource

GrailsDataSource

environments

Dependency Resolution

IvyDomainSpecificLanguageEvaluator

GORM

Database Mapping

HibernateMappingBuilder、 Mapping

Domain Classes

HibernateCriteriaBuilder、 NamedCriteriaProxy

Constraints

[validation(http://grails.org/doc/1.3.7/api/index.html?org/codehaus/groovy/grails/validation/package-summary.html)

生成递归的XML文件


// A recursive XML demo
import groovy.xml.MarkupBuilder

def builder = new MarkupBuilder();

// define recursive method with parameter
builder.metaClass.test = { n ->
    span {
        "l${n}" ("level" + n){
            if( n < 3 ){
                test n+1
            }
        }
    }
}

builder.div(style:"myStyle", "before text"){
    test 1
    mkp.yield "end text"
}

/*
<div style='myStyle'>before text
  <span>
    <l1>level1
      <span>
        <l2>level2
          <span>
            <l3>level3</l3>
          </span>
        </l2>
      </span>
    </l1>
  </span>end text
</div>
*/

输入sql语句

see this

Config.groovy

log4j {
    trace 'org.hibernate.SQL'
    trace 'org.hibernate.type'
}

DataSource.groovy

dataSource {
   logSql = true
   ...
}

Grails 1.3.7 升级至 2.4.0

  • 修改 application.properties ，

    • 升级grails版本号

        app.grails.version=2.4.0

      • 将所有的插件依赖移至 BuildConfig.groovy 中

        grails.project.dependency.resolution {
    plugins {
         compile ':tomcat:7.0.53'
    }
}
      • 升级插件的版本号

  • application.xml *移除bean 'grailsResourceLoader'、'grailsResourceHolder' 的定义及引用

  • java

a b
org.codehaus.groovy.grails.commons.Holders grails.util.Holders
org.codehaus.groovy.grails.commons.ConfigurationHolder grails.util.Holders
org.codehaus.groovy.grails.plugins.springsecurity.SpringSecurityUtils grails.plugin.springsecurity.SpringSecurityUtils
org.codehaus.groovy.grails.plugins.springsecurity.GrailsUser grails.plugin.springsecurity.userdetails.GrailsUser
  • spring security core buildConfig.groovy
# spring security core 升级至 2.0
# grails.plugins.springsecurity.* -> grails.plugin.springsecurity.*

Maven

grails create-pom me.test 生成pom.xml 就可以使用GGTS以Maven工程的方式导入Grails工程。只不过刚开始容易造成找不到 GroovyObject 类。可以 工程上右键-> Groovy -> Add Groovy Library 解决。

以Maven形式创建Grails工程

mvn archetype:generate -DarchetypeGroupId=org.grails -DarchetypeArtifactId=grails-maven-archetype -DarchetypeVersion=2.4.3 -DgroupId=me.test -DartifactId=my-mvn

创建目录树

.
├── grails-app
│   ├── conf
│   │   └── spring
│   ├── controllers
│   ├── domain
│   ├── i18n
│   ├── services
│   ├── taglib
│   ├── utils
│   └── views
├── pom.xml
├── src
│   ├── groovy
│   └── java
├── target
│   └── eclipseclasses
└── test
    ├── integration
    └── unit

创建pom.xml

<?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/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>me.test</groupId>
    <artifactId>my-mvn-grails</artifactId>
    <packaging>grails-app</packaging>
    <version>0.1</version>

    <name>my-mvn-grails</name>
    <description>my-mvn-grails</description>

    <properties>
        <grails.version>2.3.11</grails.version>
        <h2.version>1.3.170</h2.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.grails</groupId>
            <artifactId>grails-plugin-async</artifactId>
            <version>${grails.version}</version>
        </dependency>

        <dependency>
            <groupId>org.grails</groupId>
            <artifactId>grails-plugin-rest</artifactId>
            <version>${grails.version}</version>
        </dependency>

        <dependency>
            <groupId>org.grails</groupId>
            <artifactId>grails-plugin-services</artifactId>
            <version>${grails.version}</version>
        </dependency>

        <dependency>
            <groupId>org.grails</groupId>
            <artifactId>grails-plugin-i18n</artifactId>
            <version>${grails.version}</version>
        </dependency>

        <dependency>
            <groupId>org.grails</groupId>
            <artifactId>grails-plugin-databinding</artifactId>
            <version>${grails.version}</version>
        </dependency>

        <dependency>
            <groupId>org.grails</groupId>
            <artifactId>grails-plugin-filters</artifactId>
            <version>${grails.version}</version>
        </dependency>

        <dependency>
            <groupId>org.grails</groupId>
            <artifactId>grails-plugin-gsp</artifactId>
            <version>${grails.version}</version>
        </dependency>

        <dependency>
            <groupId>org.grails</groupId>
            <artifactId>grails-plugin-log4j</artifactId>
            <version>${grails.version}</version>
        </dependency>

        <dependency>
            <groupId>org.grails</groupId>
            <artifactId>grails-plugin-servlets</artifactId>
            <version>${grails.version}</version>
        </dependency>

        <dependency>
            <groupId>org.grails</groupId>
            <artifactId>grails-plugin-url-mappings</artifactId>
            <version>${grails.version}</version>
        </dependency>

        <dependency>
            <groupId>org.grails</groupId>
            <artifactId>grails-resources</artifactId>
            <version>${grails.version}</version>
            <scope>runtime</scope>
        </dependency>

        <dependency>
            <groupId>org.grails</groupId>
            <artifactId>grails-test</artifactId>
            <version>${grails.version}</version>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>org.grails</groupId>
            <artifactId>grails-plugin-testing</artifactId>
            <version>${grails.version}</version>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>com.h2database</groupId>
            <artifactId>h2</artifactId>
            <version>${h2.version}</version>
            <scope>runtime</scope>
        </dependency>


        <dependency>
            <groupId>org.grails</groupId>
            <artifactId>grails-datastore-test-support</artifactId>
            <version>1.0-grails-2.3</version>
            <scope>test</scope>


        </dependency>


        <dependency>
            <groupId>org.grails.plugins</groupId>
            <artifactId>scaffolding</artifactId>
            <version>2.0.3</version>
            <scope>compile</scope>

            <type>zip</type>

        </dependency>

        <dependency>
            <groupId>org.grails.plugins</groupId>
            <artifactId>cache</artifactId>
            <version>1.1.7</version>
            <scope>compile</scope>

            <type>zip</type>

        </dependency>

        <dependency>
            <groupId>org.grails.plugins</groupId>
            <artifactId>hibernate</artifactId>
            <version>3.6.10.16</version>
            <scope>runtime</scope>

            <type>zip</type>

        </dependency>

        <dependency>
            <groupId>org.grails.plugins</groupId>
            <artifactId>database-migration</artifactId>
            <version>1.4.0</version>
            <scope>runtime</scope>

            <type>zip</type>

        </dependency>

        <dependency>
            <groupId>org.grails.plugins</groupId>
            <artifactId>jquery</artifactId>
            <version>1.11.1</version>
            <scope>runtime</scope>

            <type>zip</type>

        </dependency>

        <dependency>
            <groupId>org.grails.plugins</groupId>
            <artifactId>resources</artifactId>
            <version>1.2.8</version>
            <scope>runtime</scope>

            <type>zip</type>

        </dependency>

        <dependency>
            <groupId>org.grails.plugins</groupId>
            <artifactId>tomcat</artifactId>
            <version>7.0.54</version>
            <scope>provided</scope>

            <type>zip</type>

        </dependency>

    </dependencies>

    <build>
        <pluginManagement />

        <plugins>
            <!-- Disables the Maven surefire plugin for Grails applications, as we
                have our own test runner -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <configuration>
                    <skip>true</skip>
                </configuration>
                <executions>
                    <execution>
                        <id>surefire-it</id>
                        <phase>integration-test</phase>
                        <goals>
                            <goal>test</goal>
                        </goals>
                        <configuration>
                            <skip>false</skip>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-clean-plugin</artifactId>
                <version>2.4.0</version>
                <configuration>
                    <filesets>
                        <fileset>
                            <directory>plugins</directory>
                            <includes>
                                <include>**/*</include>
                            </includes>
                            <followSymlinks>false</followSymlinks>
                        </fileset>
                    </filesets>
                </configuration>
            </plugin>

            <plugin>
                <groupId>org.grails</groupId>
                <artifactId>grails-maven-plugin</artifactId>
                <version>2.4.2</version>
                <configuration>
                    <grailsVersion>${grails.version}</grailsVersion>
                </configuration>
                <extensions>true</extensions>
            </plugin>
        </plugins>
    </build>

    <repositories>
        <repository>
            <id>grails</id>
            <name>grails</name>
            <url>http://repo.grails.org/grails/core</url>
        </repository>
        <repository>
            <id>grails-plugins</id>
            <name>grails-plugins</name>
            <url>http://repo.grails.org/grails/plugins</url>
        </repository>
    </repositories>

    <profiles>
        <profile>
            <id>tools</id>
            <activation>
                <property>
                    <name>java.vendor</name>
                    <value>Sun Microsystems Inc.</value>
                </property>
            </activation>
            <dependencies>
                <dependency>
                    <groupId>com.sun</groupId>
                    <artifactId>tools</artifactId>
                    <version>${java.version}</version>
                    <scope>system</scope>
                    <systemPath>${java.home}/../lib/tools.jar</systemPath>
                </dependency>
            </dependencies>
        </profile>
    </profiles>
</project>

http://grails.github.io/grails-howtos/en/performanceTuning.html