PLAY框架手册 17.PLAY模块和模块仓库.pdfVIP

17.Play模块和模块仓库 Play应用程序可以由多个应用模块装配而成。这就允许你重用应用组件到多个 应用程序中去，或把一个大的应用程序分散到多个小的应用程序里。 什么是模块? 模块就是另一个play应用程序，一个模块在加载时会同时加载分散到各个地方 的资源：  模板不能有conf/application.conf文件  模板可以有conf/routes文件，但这些路由不会被自动加载  在主程序路径下的所有文件都会被首先检索到，然后再检索所有要加载的 模块  模板可以包含原始的java代码，前提是以jar文件形式打包到 module/lib 目录下  模块可以包含文档页面  每个模块都是可选的 使用play new-module命令可以创建自己的模块。 如何从一个应用程序里加载模块 位于应用程序/modules 目录下的模块是被自动加载，也可使用dependency management system来自动管理你的应用程序模块。 从模块加载默认的routes 模块可以提供一个默认的routes文件。使用如下的声明，可以把它加载到主应 用程序的routes文件里: # Import the default CRUD routes GET /admin module:crud 下面的声明将加载所有的可用的模块： GET / module:* 为模块增加文档说明 1 简单为模块添加documentation/manual/home.textile ，可以为模块增加一个 文档页面。play的文档使用的就是相同的Textile语法，见： ${play.path}/documentation/manual/ 如果你正在运行一个play应用程序，并且使用了多个带有文档的模块，那么本 地的play文档 （http://localhost:9000/@documentation）将包含这些模块的 文档页面链接，具体位置是侧边栏的Installed Modules 。 使用模块仓库 module repository 定义了所有的通用分布式模块。一个模块可以拥有多个版 本。你必须检查模块的文档，以确定哪个版本适用于你的框架版本。 使用play list-modules 命令可以浏览模块仓库里的所有模块： gbo-mac:~ guillaume$ play list-modules ~ _ _ ~ _ __ | |__ _ _ _| | ~ |_ \| |/ _ | || |_| ~ | __/|_|\____|\__ (_) ~ |_| |__/ ~ ~ play! 1.2, ~ ~ You can also browse this list online at /modules ~ ~ [bespin] ~ Bespin online editor ~ /modules/bespin ~ Versions: 1.0, 1.0.1 ~ ~ [cobertura] ~ Cobertura ~ /modules/cobertura ~ Versions: 1.0 ... 在本地使用 play install {module}-{version}命令可以在本地安装模块。在本 地安装模块后就可以模块用于不同的应用程序，而且不需要为每个应用程序复制 备份。这对于大型模块来讲非常有用，这与框架扩展非常相似。 比如，在框架里安装Scala支持： 2 play install scala-head 我们约定head版本就模块的不稳定版本。你也可通过省略版本信息安装默认的 模块版本，如： play install scala 通过这种方式安装的模块将会直接下载模块到你的框架安装目录下的/modules 文件夹里。 使用—path选项可以更改默认安装路径： play install gwt --path my-project 贡献新模块到模块仓库里 先决条件 要注册一个新模块，以下步骤是必须的： 1. 一个Google帐号，用于向Google Group传送内容 2. 一个开发者log-in OpenID (使用Goog