3.3.3.2. Groovy 脚本的结构

Groovy 更新脚本的结构如下：

  • 主要(main) 部分，包含要在应用程序上下文启动之前执行的代码。在这一部分，可以使用任何 Java、Groovy 和 Middleware 应用程序块(block)中的类。但要注意，这时尚未实例化 bean、基础设施接口和其它应用程序对象，所以无法使用它们。

    这部分主要用于更新数据库 schema，通常使用普通的 SQL 脚本。

  • PostUpdate 部分 - 一组闭包（Groovy 中的概念），将在应用程序上下文启动后和更新过程完成后执行。在这些闭包中，可以使用任何中间件对象。

    在脚本的这一部分中，可以比较方便地执行数据导入，因为可以使用Persistence接口和数据模型对象。

执行机制将以下变量传递给 Groovy 脚本：

  • ds – 用于应用程序数据库的 javax.sql.DataSource 实例;

  • log – org.apache.commons.logging.Log 实例，用于在服务端日志中输出信息;

  • postUpdate – 包含 add(Closure closure) 方法的对象，用于添加上述 PostUpdate 闭包。

Groovy 脚本仅由执行数据库脚本的服务端机制执行。

Groovy 更新脚本的示例:

import com.haulmont.cuba.core.Persistence
import com.haulmont.cuba.core.global.AppBeans
import com.haulmont.refapp.core.entity.Colour
import groovy.sql.Sql

log.info('Executing actions in update phase')

Sql sql = new Sql(ds)
sql.execute """ alter table MY_COLOR add DESCRIPTION varchar(100); """

// Add post update action
postUpdate.add({
    log.info('Executing post update action using fully functioning server')

    def p = AppBeans.get(Persistence.class)
    def tr = p.createTransaction()
    try {
        def em = p.getEntityManager()

        Colour c = new Colour()
        c.name = 'yellow'
        c.description = 'a description'

        em.persist(c)
        tr.commit()
    } finally {
        tr.end()
    }
})