《Groovy官方教程》Grape依赖管理器

1 快速入门

1.1添加一个依赖

Grape是一个内嵌在Groovy里的Jar包依赖管理器。Grape让你可以快速添加maven仓库依赖到你的classpath里，使脚本运行更加简单。最简单的一种用法是只需要在你的脚本里添加一个注解：

1 @Grab(group='org.springframework', module='spring-orm', version='3.2.5.RELEASE') 2 import org.springframework.jdbc.core.JdbcTemplate

@Grab也支持简洁版：

1 @Grab('org.springframework:spring-orm:3.2.5.RELEASE') 2 import org.springframework.jdbc.core.JdbcTemplate

注意，这里我们用到了import，这是推荐的做法。当然你也可以在mvnrepository.com搜索到依赖包然后使用@Grab注解形式加到pom.xml实体里。

1.2特定的仓库

不是所有的依赖都在maven中心仓库里，你可以像下面这样添加新的仓库:

1 @GrabResolver(name='restlet', root='http://maven.restlet.org/') 2 @Grab(group='org.restlet', module='org.restlet', version='1.1.6')

1.3Maven分类器

有些maven依赖需要分类器才能解析，你可以这样处理：

1 @Grab(group='net.sf.json-lib', module='json-lib', version='2.2.3', classifier='jdk15')

1.4去除过渡依赖

有时你用到了一些过渡版本的依赖，它们可能和正式稳点版本有一点点差别，这时你想要将过渡依赖排除掉，你可以这样写：

1 @Grab('net.sourceforge.htmlunit:htmlunit:2.8') 2 @GrabExclude('xml-apis:xml-apis')

（译者注：原文标题是Excluding Transitive Dependencies，译者翻译为过渡依赖。译者理解为那些非稳定版本的依赖，如果读者有更好的理解或翻译请留言，谢谢）

1.5JDBC驱动

你可能需要加载JDBC驱动，因此你需要将JDBC驱动依赖添加到系统类加载器中，示例如下：

1@GrabConfig(systemClassLoader=true) 2 @Grab(group='mysql', module='mysql-connector-java', version='5.1.6')

1.6从Groovy Shell中使用Grape

通过groovysh使用grape需要调用一个变量:

1 groovy.grape.Grape.grab(group:'org.springframework', module:'spring', version:'2.5.6')

1.7代理设置

如果因为防火墙，你可能需要一个代理服务器才能使用Groovy/Grape，你可以将代理服务器设置通过http.proxyHost和http.proxyPort系统属性在命令行来设置：

1 groovy -Dhttp.proxyHost=yourproxy -Dhttp.proxyPort=8080 yourscript.groovy

或者你也可以将其添加到JAVA_OPTS环境变量里：

1 JAVA_OPTS = -Dhttp.proxyHost=yourproxy -Dhttp.proxyPort=8080

1.8日志

如果你想查看Grape的运行时状态，可以通过设置系统属性groovy.grape.report.downloads为true（比如说将-Dgroovy.grape.report.downloads=true添加JAVA_OPTS或调用它）,Grape将会打印下面的一些系统信息：

开始解析依赖开始下载工件(原文为artifact，工件的意思)重新下载工件现在工件的时间和大小

如果要更加详细的日志，可以通过提高日志级别(默认为-1),示例如下：

1 -Divy.message.logger.level=4

2 详细

Grape（The Groovy Adaptable Packaging Engine or Groovy Advanced Packaging Engine)）是Groovy里内嵌的一个基础组件，通过grab()方法调用，一些类可以使用Ivy来打包成仓库给Groovy用。这就支持开发者通过写一段脚本来实现一些核心库的需求。装载这段脚本，Grape将会在运行时下载并链接所有依赖的库。即便这些库存在于Jcenter，Ibiblio和java.net

Grape遵从Ivy对模块版本标识和命名转换。

group – 模块属于一个模块组。对应Maven的groupId或者一个Ivy组织。任何匹配/groovy[x][\..*]^/的组都是被保留的，对于Groovy是有特定意义的。module – 加载的模块名字，对应Mavne的artifactId或Ivy的artifactversion – 模块使用的版本号，要么是字符串 ‘1.1-RC3’，要么是Ivy的[2.2.1,）代表2.2.1或更高版本classifier – 可选的分类器，比如jdk15

3 用法

3.1 注解

可以在任何可以放注解的地方放一个或多个groovy.lang.Grab注解来告诉编译器这段代码依赖于特定的类库。这个和添加类库到Groovy编译器的效果是一样的。这个注解将会在任何其他类脚本的运行前被执行，也就是说类的导入可以通过添加@Grab注解来实现：

1 import com.jidesoft.swing.JideSplitButton 2 @Grab(group='com.jidesoft', module='jide-oss', version='[2.2.1,2.3.0)') 3 public class TestClassAnnotation { 4     public static String testMethod () { 5         return JideSplitButton.class.name 6     } 7}

一个合适的grab(…)调用将会加在包含这个注解类的静态初始化函数上(或者脚本元素)

3.2 多个Grape注解

如果需要在同一个节点使用一个注解多次可以使用@Grapes注解，比如说：

1@Grapes([ 2    @Grab(group='commons-primitives', module='commons-primitives', version='1.0'), 3    @Grab(group='org.ccil.cowan.tagsoup', module='tagsoup', version='0.9.7')]) 4 class Example { 5// ... 6}

如果不这样用的话，将会报这样的错：

1Cannot specify duplicate annotation on the same member

3.3 方法调用

一般地grab调用会在一个类或脚本初始化的时候进行。这可以确保groovy代码依赖的库在运行时都被类加载器加载进去。一种典型的调用如下：

1 import groovy.grape.Grape 2// random maven library 3 Grape.grab(group:'com.jidesoft', module:'jide-oss', version:'[2.2.0,)') 4 Grape.grab([group:'org.apache.ivy', module:'ivy', version:'2.0.0-beta1', conf:['default', 'optional']], 5      [group:'org.apache.ant', module:'ant', version:'1.7.0']) 在同一个地方使用相同的参数多次调用grab是等价的，但是如果使用不同的类加载器可能需要重新运行如果参数列表传到grab调用有一个noExceptions参数，那么将不会抛出参数grab需要一个rootLoader或GroovyClassLoader，也可以是调用类的类加载器链。默认情况下列的情形将会失败并且抛出异常 通过classLoader传递的类加载器：参数和它的父类加载器对象的加载器作为引用对象传入，参数和它的父类加载器类的类加载器调用grab

3.3.1 grab(HashMap)参数

group: – – 模块所属的模块组，对应Maven的groupId，任何匹配/groovy(|\..|x|x\..)/的组都是保留的，在Groovy模块中有特殊用途module:– 要加载的模块名，对应Maven的artifactIdversion:-也有可能是-使用的模块版本号，要么是字符串1.1-RC3要么是Ivy Range [2.2.1,)表示2.2.1版本或更高版本classifier:–Maven解析的分类器conf:-，默认default’ – The configuration or scope of the module to download. The default conf is `default:映射到maven的runtime和master范围force-默认是true，用于冲突时的修复，依赖于冲突管理器changing：-，默认是false，是否工件可以修改而不管版本的改变transitive:-,默认是true，是否解析其他依赖

grab有两个基本变量，一个单个的map一个是带一个map和多个依赖的map。调用单个map的grab和将一个相同的map传入两次调用是一样的，因此grab参数和依赖可以混合在一个map里，grab可以当成一个具有命名好参数的方法调用。 下面的参数每组都是相同的意思，如果传入多余一个将是一个运行时错误

group:, groupId:, organisation:, organization:, org:module:, artifactId:, artifact:version:, revision:, rev:conf:, scope:, configuration:

3.3.2 参数列表

classLoader: – 或-解析jar包的类加载器refObject:–最近的父类加载器，可以作为加载器参数被传递validate:-,默认是false,是否验证poms或ivy文件，或者是否直接信任缓存信息(默认false)noExceptions:-,默认是false，如果类加载器或参考查询失败，是否应该抛出异常或吞并异常（默认情况）

3.4 命令行工具

Grape增加了一个命令行来执行grape,可以用来检视和管理本地grape缓存。

1grape install <groupId> <artifactId> [<version>]

这条命令会安装特定的groovy模块或maven工件，如果指定了版本，那么将安装特定的的版本，否则安装最新的版本（类似我们传递 * 参数）

1grape list

列出本地安装的模块（如果是groovy模块，会显示完整的maven名字）和版本

1grape resolve (<groupId> <artifactId> <version>)+

返回安装的模块或工件的文件位置，并且会返回传递依赖模块的位置。你可以传入可选参数-ant,-dos,-shell中来得到ant脚本，windows批处理或unix shell脚本格式文件，-ivy将会得到类ivy格式的依赖

3.5 高级配置

3.5.1 仓库目录

如果你需要改变下载库的grape目录，可以使用grape.root系统属性来改变默认值（默认值是~/.groovy/grape）

1groovy -Dgrape.root=/repo/grape yourscript.groovy

3.5.2 自定义Ivy设置

你可以自定义ivy的是指，通过创建一个~/.groovy/grapeConfig.xml文件，如果没有这个文件，Grape会使用默认配置，详细参考这里。需要查找更多关于自定义设置的文档，可以参考Ivy文档。

3.6 更多示例

使用Apache Commons集合工具类

01// create and use a primitive array list 02 import org.apache.commons.collections.primitives.ArrayIntList 03  04 @Grab(group='commons-primitives', module='commons-primitives', version='1.0') 05 def createEmptyInts() { new ArrayIntList() } 06  07 def ints = createEmptyInts() 08 ints.add(0, 42) 09 assert ints.size() == 1 10 assert ints.get(0) == 42

使用TagSoup

1// find the PDF links of the Java specifications 2 @Grab(group='org.ccil.cowan.tagsoup', module='tagsoup', version='1.2.1') 3 def getHtml() { 4     def parser = new XmlParser(new org.ccil.cowan.tagsoup.Parser()) 5     parser.parse("https://docs.oracle.com/javase/specs/") 6} 7 html.body.'**'.a.@href.grep(~/.*\.pdf/).each{ println it }

使用Google集合工具类

1 import com.google.common.collect.HashBiMap 2 @Grab(group='com.google.code.google-collections', module='google-collect', version='snapshot-20080530') 3 def getFruit() { [grape:'purple', lemon:'yellow', orange:'orange'] as HashBiMap } 4 assert fruit.lemon == 'yellow' 5 assert fruit.inverse().yellow == 'lemon'

启动Jetty服务器来运行Groovy模块

01@Grapes([ 02     @Grab(group='org.eclipse.jetty.aggregate', module='jetty-server', version='8.1.7.v20120910'), 03     @Grab(group='org.eclipse.jetty.aggregate', module='jetty-servlet', version='8.1.7.v20120910'), 04     @Grab(group='javax.servlet', module='javax.servlet-api', version='3.0.1')]) 05  06 import org.eclipse.jetty.server.Server 07 import org.eclipse.jetty.servlet.* 08 import groovy.servlet.* 09  10 def runServer(duration) { 11     def server = new Server(8080) 12     def context = new ServletContextHandler(server, "/", ServletContextHandler.SESSIONS); 13     context.resourceBase = "." 14     context.addServlet(TemplateServlet, "*.gsp") 15     server.start() 16     sleep duration 17     server.stop() 18} 19  20 runServer(10000)

第一次启动这个脚本的时候Grape会下载Jetty和它的依赖，并且会缓存它们。我们在8080端口创建了一个Jetty服务，并且将Groovy的TemplateServlet最为根服务。Groovy有自己强大的模板引擎机制。我们启动这个服务并且运行一段时间。每次有人访问http://localhost:8080/somepage.gsp的时候，它会显示somepage.gsp给用户，这些模板页是放在一个相同的目录下座位服务器脚本。

转载自 并发编程网 - ifeve.com 相关资源：敏捷开发V1.0.pptx