Quick Start
优质
小牛编辑
132浏览
2023-12-01
Preparation
那种一点都不环保的100多M的傻瓜安装包不会再有了。你首先需要的是下载依赖包时的一点点耐心。
- Install JDK 6.0+ and set the JAVA_HOME.
- Install Maven 3.0.3+ and set the PATH. (如果机器不能直接上网, 请参照https://www.xnip.cn/shouce/596/44968.html章节设置代理或私服)
运行maven时,enforcer插件会对两者的版本进行强制检查。
Contents
解压下载包后,会看到三个目录:
- Modules -- SpringSide封装的代码: Parent是公共的pom.xml文件, Core是一些使用率最高的核心代码, Extension是不一定会用上的扩展如Memcached/Redis Client封装, Test 则是测试用的封装.
- Examples -- QuickStart 与 Showcase 一小一大两个示例项目.
- Support -- 其他杂项内容, 如H2的Console启动命令, https://www.xnip.cn/doc/odsuk8sj 的常用命令, 生成新项目的模板,Sonar的规则等等.
Run examples
有个醒目的quick-start.bat可以全自动运行,但都是标准的maven命令,自己敲一下键盘也可以:
- 将所有module编译打包安装到 https://www.xnip.cn/doc/odsuk8sj 的本地仓库: 可在modules目录运行mvn install
- 为示例项目初始化数据库: 可在你感兴趣的示例项目目录, 运行mvn antrun:run -Prefresh-db
- 启动示例项目: 可在示例项目目录, 运行 mvn jetty:run
如果同时运行多个项目,需要加上不同的端口定义, 如 jetty:run -Djetty.port=8082
运行showcase时注意在MAVEN_OPTS中设置-XX:MaxPermSize=128m, 参照项目里的jetty.bat.
User Story
QuickStart
一个迷你的TodoList应用,任务管理是一个典型的CRUD场景,为了赶潮流还提供了任务管理的Restful API。 而用户注册、用户资料修改,管理员后台用户管理可以作为很多项目的初始骨架。
Showcase
一个五花八门的JavaEE技术大杂烩大派对,对应左边一溜菜单:
- 帐号管理, 将众多技术压缩在一起的综合演示
- 独立演示, 几个可以在界面上看到效果的演示
- 演示说明, 一些没法在界面上独立演示的技术,以纯文字说明了它所在的代码
Eclipse
Eclipse需要安装最新版的M2Eclipse插件,点击File->Import->https://www.xnip.cn/doc/odsuk8sj->Existing https://www.xnip.cn/doc/odsuk8sj Projects, 选择SpringSide的根目录,选择底层的7个子项目。
要在Eclipse里运行项目的话,推荐的做法是运行src/test/functional目录里面那个XXXServer.java,用嵌入式的Jetty启动项目。
要保证Eclipse使用的是JDK而不是JRE(Preference->Java->Install JREs)。
Production server and database
用package.bat生成war部署到服务器即可, 已在Tomcat7与JBoss7中测试通过。
如果希望使用Oracle或者Mysql作为生产环境数据库,详见https://www.xnip.cn/shouce/596/44929.html章节。