您的位置：首页 > 其它

Gradle 1.12用户指南翻译——第二十六章. War 插件

2015-05-05 09:06 525 查看

其他章节的翻译请参见：
http://blog.csdn.net/column/details/gradle-translation.html
翻译项目请关注Github上的地址：
https://github.com/msdx/gradledoc/tree/1.12。
直接浏览双语版的文档请访问：
http://gradledoc.qiniudn.com/1.12/userguide/userguide.html。
另外，Android 手机用户可通过我写的一个程序浏览文档，带缓存功能的，目前0.2版本兼容2.1以上（5.0没试过）的Android系统，地址如下：
http://www.wandoujia.com/apps/com.githang.gradledoc
翻译不易，转载请注明本文在CSDN博客上的出处：
http://blog.csdn.net/maosidiaoxian/article/details/45498125
关于我对Gradle的翻译，以Github上的项目及http://gradledoc.qiniudn.com 上的文档为准。如有发现翻译有误的地方，将首先在以上两个地方更新。因时间精力问题，博客中发表的译文基本不会同步修改。

第二十六章. War 插件

War 的插件继承自 Java 插件并添加了对组装 web 应用程序的 WAR 文件的支持。它禁用了 Java 插件生成默认的 JAR archive，并添加了一个默认的 WAR archive 任务。

26.1. 用法

要使用 War 的插件，请在构建脚本中包含以下语句：

示例 26.1. 使用War 插件

build.gradle

apply plugin: 'war'

26.2. 任务

War 插件向project 中添加了以下任务。

表 26.1. War 插件 - 任务


任务名称	依赖于	类型	描述
war	compile	War	组装应用程序 WAR 文件。

War 插件向 Java 插件所加入的 tasks 添加了以下的依赖。

表 26.2. War 插件 - 额外的task 依赖


任务名称	依赖于
assemble	war

图 26.1. War 插件 - tasks

26.3. 项目布局

表 26.3. War 插件 - 项目布局


目录	意义
from <s1>'src/main/webapp'</s1>	Web 应用程序源代码

26.4. 依赖管理

War 插件添加了两个依赖配置：

providedCompile

和

providedRuntime

。虽然它们有各自的

compile

和

runtime

配置，但这些配置有相同的作用域，只是它们不会添加到
WAR 文件中。要特别注意，这些

provided

配置的传递使用。假设你添加

commons-httpclient:commons-httpclient:3.0

依赖到任何一个provided配置。这个依赖又依赖于

commons-codec

。这意味着

httpclient

和

commons-codec

都不会添加到你的
WAR 中，即使

commons-codec

是

compile

配置上的一个显示依赖。如果你不想要这种传递行为，只是把

provided

依赖声明成和

commons-httpclient:commons-httpclient:3.0@jar

一样。

26.5. 公约属性

表26.4. War插件 - 目录属性


属性名称	类型	默认值	描述
webAppDirName	String	from <s1>'src/main/webapp'</s1>	web 应用程序源目录的名称，是一个相对于项目目录的目录名称。
webAppDir	File (read-only)	`projectDir` `/webAppDirName`	Web 应用程序的源目录。

这些属性由一个

WarPluginConvention

公约对象提供。

26.6. War

War task 的默认行为是将

src/main/webapp

的内容复制到archive
的根目录下。你的

webapp

目录自然可能包含一个

WEB-INF

web.xml

文件。已编译的类被编译进

WEB-INF/classes

。所有

runtime

[13]配置的依赖被复制到

WEB-INF/lib

。

另请参阅

War

。

26.7.
自定义

下面是一个示例，展示了最重要的自定义选项：

示例 26.2. war 插件的自定义

build.gradle

configurations {
moreLibs
}

repositories {
flatDir { dirs "lib" }
mavenCentral()
}

dependencies {
compile module(":compile:1.0") {
dependency ":compile-transitive-1.0@jar"
dependency ":providedCompile-transitive:1.0@jar"
}
providedCompile "javax.servlet:servlet-api:2.5"
providedCompile module(":providedCompile:1.0") {
dependency ":providedCompile-transitive:1.0@jar"
}
runtime ":runtime:1.0"
providedRuntime ":providedRuntime:1.0@jar"
testCompile 'junit:junit:4.11'
}
moreLibs ":otherLib:1.0"
}

war {
from 'src/rootContent' // adds a file-set to the root of the archive
webInf { from 'src/additionalWebInf' } // adds a file-set to the WEB-INF dir.
classpath fileTree('additionalLibs') // adds a file-set to the WEB-INF/lib dir.
classpath configurations.moreLibs // adds a configuration to the WEB-INF/lib dir.
webXml = file('src/someWeb.xml') // copies a file to WEB-INF/web.xml
}

当然，你可以用一个定义了excludes 和 includes 的闭包来配置不同的文件集。

[13]

runtime

配置继承自

compile

配置。

内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理

标签：

相关文章推荐

新的分享

章节导航