一直以来，java/spring开发被认为是笨重的代表，无法快速生成项目原型和骨架。所以，spring推出了spring roo这个项目，帮助我们快速生成项目原型。本文参考自spring roo的官方文档，如果熟悉英文的话可以直接看原文档，内容更加丰富。
安装命令行工具
spring roo是一套命令行工具，如果你使用的是eclipse/sts，还可以使用eclipse对应的插件。
首先先来下载命令行工具。到下载页面，选择对应版本下载。这里我选择的是最新的2.0.0.rc1 ，毕竟我有更新强迫症。下载完成之后解压，会得到一个文件夹，其中bin目录下就是spring roo的可执行文件了。可以看到它有bat和sh两种格式，可以在不同系统上运行。为了方便以后在终端窗口运行，我建议同时将这个文件夹添加到环境变量中。
安装好之后，打开命令提示符或者其他终端窗口，输入roo命令，就可以启动roo了。值得提一点，roo会在命令提示符对应的文件夹位置创建项目，所以如果需要在特定位置创建项目，先在命令提示符中切换到该文件夹，然后再启动roo。
安装eclipse插件
打开你的eclipse/sts，然后遵循以下步骤：
点击菜单栏 help ▸ install new software
点击 available software sites
点击 import 按钮
找到 “$roo_home/conf/sts-sites-bookmarks.xml” 并确定，这里$roo_home是你安装roo的目录
根据需要选择对应的版本
在过滤栏输入roo
选中功能 spring ide roo support
然后一路确定并允许条款
最后重启ide即可
下面是官方文档的图，如果有疑问照着这张图来就行了。
到这一步还没完，插件是安装好了，但是还没有配置。其实要配置的也很简单，告诉插件你的roo工具安装到哪里就行了。点击 window ▸ preferences ▸ spring ▸ roo support ，打开设置，然后照着官方文档截图设置好你的工具路径即可。
这样插件就设置完毕了。其实这个插件也没啥作用，就是在eclipse中开了一个窗口，能运行roo命令，和直接在命令提示符中运行其实是一样的。
使用roo
运行roo脚本
$roo_home\samples文件夹下有三个示例项目脚本，使用roo运行它们可以快速创建相应的项目。如果没有耐心，可以直接从这里开始。
比如说，我要运行clinic实例项目，就可以输入以下命令：
|
1
|
roo> script --file clinic.roo |
稍等片刻，程序就会创建完毕。
最后创建出的是一个基于maven的spring boot程序。在idea下是这么一个样子。可以看到项目中有一个名字叫log.roo的日志文件，它记录了这个roo脚本执行的内容。另外不知道为什么程序在idea下会有一点报错，不过不影响编译和运行。
这个petclinic示例程序使用了spring security来保护页面。我查阅了一下，spring boot下spring security默认的用户名是user，密码则在程序启动的时候随机输出到控制台中。最后运行截图如下，大家可以自己运行和测试一下这个程序。
脚本解释
下面来解释一下petclinic这个程序的roo脚本，让我们来看看roo是如何工作的。这里只做一下简单解释，如果需要详细资料的话可以参考官方文档的附录，完整介绍了roo的各种命令和参数以及用法。
首先是创建项目并指定顶级包名，这样会创建一个基于maven的spring boot项目。
|
1
|
project setup --toplevelpackage org.springframework.roo.petclinic |
然后是指定jpa存储类型，这里用的是hibernate，数据库是存储在内存的hsqldb。当然也可以使用其它数据库，不过相应地需要增加用户名等其他参数。
|
1
|
jpa setup --provider hibernate --database hypersonic_in_memory |
然后是几个枚举类，将会在实体类中用到，这里的~指代前面设置的顶级包名。
|
1
2
3
4
5
6
7
8
9
|
enum type --class ~.domain.reference.pettypeenum constant --name dogenum constant --name catenum constant --name birdenum type --class ~.domain.reference.specialtyenum constant --name cardiologyenum constant --name dentistryenum constant --name nutrition |
然后是项目中的几个实体类。
|
1
2
3
4
5
|
entity jpa --class ~.domain.pet --sequencename pet_seq --entityformatexpression "#{name} (#{type})"entity jpa --class ~.domain.visit --sequencename visit_seq --entityformatmessage visit_formatentity jpa --class ~.domain.abstractperson --abstractentity jpa --class ~.domain.vet --extends ~.domain.abstractperson --entityformatexpression "#{lastname} (#{specialty})"entity jpa --class ~.domain.owner --extends ~.domain.abstractperson --entityformatexpression "#{lastname} (#{city})" |
之后的叫本详细设置了每个实体类的属性以及对应关系，由于比较多所以我只挑选了几个典型的。在设置实体类之前，需要使用focus命令指定要设置的实体类。
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
focus --class ~.domain.petfield boolean --fieldname sendreminders --notnull --primitivefield string --fieldname name --notnull --sizemin 1field number --fieldname weight --type java.lang.float --notnull --min 0field enum --fieldname type --type ~.domain.reference.pettype --notnullfield set --fieldname visits --type ~.domain.visitfocus --class ~.domain.abstractpersonfield string --fieldname firstname --sizemin 3 --sizemax 30field string --fieldname lastname --notnull --sizemin 3 --sizemax 30field string --fieldname address --notnull --sizemax 50 --sizemin 1field string --fieldname city --notnull --sizemax 30field string --fieldname telephone --notnullfield string --fieldname homepage --sizemax 30field string --fieldname email --sizemax 30 --sizemin 6field date --fieldname birthday --type java.util.date --notnull |
然后设置实体类之间的投影关系并设置jpa repository。
|
1
2
3
4
5
|
entity projection --class ~.domain.vetinfo --entity ~.domain.vet --fields id,firstname,lastname,specialty --entityformatexpression "#{firstname} #{lastname}"repository jpa --entity ~.domain.vet --interface ~.repository.vetrepository --defaultreturntype ~.domain.vetinforepository jpa --all --package ~.repositoryservice --all --apipackage ~.service.api --implpackage ~.service.impl |
然后是设置dto（数据传输对象），它和页面中的表单等信息对应，然后在后台转换为相应的实体类。在这里还可以指定finder，也就是查询条件，查询条件的规则请参考spring data jpa的相关内容。
|
1
2
3
4
|
dto --class ~.domain.petnameandweightformbeanfield string --fieldname namefield number --fieldname weight --type java.lang.floatfinder add --entity ~.domain.pet --name findbynameandweight --formbean ~.domain.petnameandweightformbean |
然后是设置spring web mvc，这里指定thymeleaf作为视图层，并为所有控制器生成json和thymeleaf视图。
|
1
2
3
4
|
web mvc setupweb mvc view setup --type thymeleafweb mvc controller --all --responsetype jsonweb mvc controller --all --responsetype thymeleaf |
然后是生成查询和详情页面。这里针对前面设置的所有查询条件生成相应的查询页面，然后生成指定实体类的详情页面。最后指定了页面语言，目前好像只支持英语和西班牙语。
|
1
2
3
4
5
6
7
8
|
// publishing findersweb mvc finder --all --responsetype thymeleaf// adding detailsweb mvc detail --entity ~.domain.owner --field pets --views list,show,findbycitylike --responsetype thymeleafweb mvc detail --all --views list,show --responsetype thymeleafweb mvc language --code es |
然后使用了spring security保护了一下程序。第一行的是使用spring security的默认配置，用户名是user，密码是打印在控制台的随机字符串。第二行配置了一下用户权限，只有管理员角色的用户才能执行删除操作。
|
1
2
3
|
security setup --provider defaultsecurity authorize --class ~.service.impl.ownerserviceimpl --method delete.* --roles admin |
然后启用了审计功能，程序会自动记录相应实体类的编辑时间和编辑者。
|
1
2
3
4
5
|
jpa audit setupjpa audit add --entity ~.domain.petjpa audit add --entity ~.domain.ownerjpa audit add --entity ~.domain.visitjpa audit add --entity ~.domain.vet |
然后启用了web服务端点功能，这些端点可以在/servicesurl下查看。
|
1
2
|
ws endpoint --service ~.service.api.ownerservice --sei ~.ws.api.ownerwebservice --class ~.ws.endpoint.ownerwebserviceendpoint --config ~.config.wsendpointsconfigurationws endpoint --service ~.service.api.petservice --sei ~.ws.api.petwebservice --class ~.ws.endpoint.petwebserviceendpoint --config ~.config.wsendpointsconfiguration |
最后自动为这些实体类和服务生成单元测试和集成测试。
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
// generating unitary tests for all entitiestest unit --class ~.domain.ownertest unit --class ~.domain.pettest unit --class ~.domain.vettest unit --class ~.domain.visit// repository integration teststest integration --class ~.repository.vetrepositorytest integration --class ~.repository.ownerrepositorytest integration --class ~.repository.visitrepositorytest integration --class ~.repository.petrepository// controller integration teststest integration --class ~.web.ownerscollectionjsoncontrollertest integration --class ~.web.petsitemjsoncontrollertest integration --class ~.web.vetscollectionthymeleafcontrollertest integration --class ~.web.visitsitemthymeleafcontroller |
总结
以上就是本文关于spring roo安装使用简介的全部内容，希望对大家有所帮助。感兴趣的朋友可以继续参阅本站其他相关专题，如有不足之处，欢迎留言指出。感谢朋友们对本站的支持！
原文链接：http://blog.csdn.net/u011054333/article/details/75949728
