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

原文链接 译文链接 译者：JackWang

1 快速入门

1.1添加一个依赖

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

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

@Grab也支持简洁版：

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

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

1.2特定的仓库

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

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

1.3Maven分类器

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

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

1.4去除过渡依赖

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

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

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

1.5JDBC驱动

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

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

1.6从Groovy Shell中使用Grape

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

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

1.7代理设置

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

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

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

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),示例如下：

-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的artifact
  • version – 模块使用的版本号，要么是字符串 ‘1.1-RC3’，要么是Ivy的[2.2.1,）代表2.2.1或更高版本
  • classifier – 可选的分类器，比如jdk15

3 用法

3.1 注解

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

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

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

3.2 多个Grape注解

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

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

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

Cannot specify duplicate annotation on the same member

3.3 方法调用

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

import groovy.grape.Grape
// random maven library
Grape.grab(group:'com.jidesoft', module:'jide-oss', version:'[2.2.0,)')
Grape.grab([group:'org.apache.ivy', module:'ivy', version:'2.0.0-beta1', conf:['default', 'optional']],
     [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的artifactId
  • version:-也有可能是-使用的模块版本号，要么是字符串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缓存。

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

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

grape list

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

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

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

3.5 高级配置

3.5.1 仓库目录

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

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

3.5.2 自定义Ivy设置

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

3.6 更多示例

使用Apache Commons集合工具类

// create and use a primitive array list
import org.apache.commons.collections.primitives.ArrayIntList

@Grab(group='commons-primitives', module='commons-primitives', version='1.0')
def createEmptyInts() { new ArrayIntList() }

def ints = createEmptyInts()
ints.add(0, 42)
assert ints.size() == 1
assert ints.get(0) == 42

使用TagSoup

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

使用Google集合工具类

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

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

@Grapes([
    @Grab(group='org.eclipse.jetty.aggregate', module='jetty-server', version='8.1.7.v20120910'),
    @Grab(group='org.eclipse.jetty.aggregate', module='jetty-servlet', version='8.1.7.v20120910'),
    @Grab(group='javax.servlet', module='javax.servlet-api', version='3.0.1')])

import org.eclipse.jetty.server.Server
import org.eclipse.jetty.servlet.*
import groovy.servlet.*

def runServer(duration) {
    def server = new Server(8080)
    def context = new ServletContextHandler(server, "/", ServletContextHandler.SESSIONS);
    context.resourceBase = "."
    context.addServlet(TemplateServlet, "*.gsp")
    server.start()
    sleep duration
    server.stop()
}

runServer(10000)

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

时间： 2024-08-20 07:17:08

《Groovy官方教程》Grape依赖管理器的相关文章

script.js —— 异步的 JavaScript 加载和依赖管理

script.js 详细介绍script.js 是一个异步的 JavaScript 加载器和依赖管理器.支持的浏览器包括: IE 6+ Opera 10+ Safari 3+ Chrome 1+ Firefox 2+ 示例代码: // load jquery and plugin at the same time. name it 'bundle' $script(['jquery.js', 'my-jquery-plugin.js'], 'bundle') // load your usage

Node.js安装教程和NPM包管理器使用详解_node.js

2009年的JSCOnf大会上,一个叫Ryan Dahl的年轻程序员向人们展示了一个他正在做的项目,一个基于Google V8引擎的JavaScript运行平台,它提供了一套事件循环和低IO的应用程序编程接口(API).和其他的服务端平台不同, JavaScript天生就是事件驱动IO,而这个项目又大大降低了编写事件驱动应用程序的复杂度,因此它很快就以不可思议的速度的成长流行起来,并应用到实际项目中.(Jack:这段翻译的不太靠谱,原文:This project was not like oth

Node.js的npm包管理器基础使用教程_node.js

配置 npm set npm set init-author-name 'Your name' npm set init-author-email 'Your email' npm set init-author-url 'http://yourdomain.com' npm set init-license 'MIT' 上面命令等于为npm init设置了默认值,以后执行npm init的时候,package.json的作者姓名.邮件.主页.许可证字段就会自动写入预设的值.这些信息会存放在用户

利用excel视图管理器添加多个视图动画教程

<Excel2003入门动画教程29.利用视图管理器添加多个视图>. 演示动画 操作步骤 如果我们有一个保存了大量数据的Excel表格,根据使用对象的不同,常需要将其中不同部分的数据打印出来.通常的做法是,先将不需要打印的列隐藏起来,然后再打印.由于这样的"对象"众多,每次都要隐藏.打印.显示.再隐藏.再打印--非常麻烦.其实,我们可能用"视图管理器"来实现这种要求: 执行"视图→视图管理器"命令,打开"视图管理器"

Ubuntu15.04安装Enpass安全密码管理器教程

  Enpass 桌面版完全免费,如果要使用移动版本的话,会有相应的购买费用.默认情况下 Enpass 采用 256-bit AES 算法对用户数据进行加密存储,提供了从其它密码管理应用导入数据的导向功能,我们可以非常方便的垮平台进行数据导入.现在我们就来看看,如何在Ubuntu 15.04中安装Enpass安全密码管理器. Ubuntu 15.04安装Enpass 1使用如下命令添加 Enpass 安装源 echo "deb http://repo.sinew.in/ stable main&

Zend Framework 2.0事件管理器（The EventManager）入门教程_php实例

概述 EventManger是一个为以下使用情况设计的组件: 复制代码 代码如下: 实现简单的主题/观察者模式 实现面向切面的设计 实现事件驱动的架构 基本的架构允许你添加和解除指定事件的侦听器,无论是在一个实例基础还是一个共享的集合:触发事件:终止侦听器的执行. 快速入门 通常,你将会在一个类中创建一个EventManager. 复制代码 代码如下: use Zend\EventManager\EventManagerInterface; use Zend\EventManager\Event

三星S6智能管理器是什么?S6智能管理器使用教程

三星S6智能管理器是什么 • 识别过度耗电的应用程序并删除无用的文件.  • 删除不需要的文件,关闭在后台运行的应用程序.  • 扫描恶意软件和网络钓鱼袭击.    S6智能管理器使用教程   1.在待机页面下,点击[应用程序].    2.点击[智能管理器].    3.阅读"使用网络连接"的提示后,点击[确定].    4.点击[一键优化]即可自动优化设备.      5.点击[电池],可检查剩余电池电量和使用设备的时间,对于电池电量不足的设备,可通过启动省电功能,并关闭消耗电池电

在线密码管理器LastPass遭入侵 官方建议修改主密码

LastPass致用户:请更改你的主密码,并立即启用双因素身份验证! 作为当前全球最热门的密码保管服务之一,LastPass公司周一警告称,攻击者攻破了运行公司密码管理服务的设备,并盗取了用户的受保护密码及其他敏感的数据.这是在过去四年中该服务器第二次发生数据泄露情况. LastPass用户数据泄露 LastPass CEO Joe Siegrist在博客中写道:总之,未知的攻击者获得了用户哈希密码.加密加盐.密码提示以及电子邮箱地址.他强调没有证据显示攻击者能够进入存放用户纯文本密码的地方.因

完全解剖安全帐号管理器（SAM）结构_安全教程

安全设置不得不需要了解的东西一.摘要 分析安全帐号管理器结构是在一个多月前做的事情了,只零碎地记录下片段,没有发布过.不发布的主要原因是安全帐户管理器(SAM)是WIN系统帐户管理的核心,并且非常系统化,我也有很多地方仅仅是进行的推断和猜测,同时,SAM hack可能造成启动时lsass.exe加载帐户管理器出错,即便是安全模式也不能修复(启动时候必然加载SAM)使得整个系统启动崩溃(我通常需要依靠第二系统删除SAM文件来启动).至于现在发布出来,主要是因为Adam和叮叮的<克隆管理员帐号>种