Skip to content

QuickStart

springside edited this page Sep 5, 2012 · 35 revisions

Preparation

那种一点都不环保的100多M的傻瓜安装包不会再有了。你首先需要的是下载依赖包时的一点点耐心.

  1. Install JDK 6.0+ and set the JAVA_HOME.
  2. Install Maven 3.0.4 and set the PATH. (如果机器不能直接上网, 请参照Maven章节设置代理或私服)

Contents

解压下载包后,会看到三个目录:

  • Modules -- SpringSide封装的代码. Core是一些使用率最高的核心代码, Extension是不一定会用上的扩展如Memcached Client, Test 则是测试用的封装。
  • Examples -- QuickStart 与 Showcase 一小一大两个示例项目。
  • Support -- 其他杂项内容, 如H2的Console启动命令, Maven的常用命令, Sonar的规则等等。

Run examples

有个醒目的quick-start.bat可以运行,但都是标准的maven命令,自己敲一下键盘也可以:

  1. 将所有module编译打包安装到Maven的本地仓库: 在modules目录运行mvn install
  2. 为示例项目初始化数据库: 在你感兴趣的示例项目, 运行mvn antrun:run -Prefresh-db
  3. 启动示例项目: 在项目目录运行 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技术大杂烩大派对,对应左边一溜菜单:

  • 帐号管理, 将众多技术压缩在一起的综合演示
  • 独立演示, 几个可以在界面上看到效果的演示
  • 演示说明, 一些没法在界面上独立演示的技术,以纯文字说明了它所在的代码

View code

依然是标准的Maven命令,在感兴趣的项目执行 mvn eclipse:eclipse 生成Eclipse项目文件,然后在Eclipse中import项目。

第一次用Maven,还要在Eclipse里设置Maven本地仓库的路径,在Preference->Java->Build Path->Classpath Variables中,new一个M2_REPO的变量,指向诸如C:\Users\your name\.m2\repository的路径。

要在Eclipse里运行项目的话,推荐的做法是运行src/test/functional目录里面那个XXXServer.java,用嵌入式的Jetty启动项目。
要保证Eclipse使用的是JDK而不是JRE(Preference->Java->Install JREs)。
如果出现“java.lang.NoClassDefFoundError: org/springside/examples/quickstart/functional/QuickStartServer”的错误,点一下Project->Clean,希望上帝知道是什么原因。

Create new project base on SpringSide

因为Maven的Archetype要到正式版才会提供,暂时需要大家自己Copy&Paste Quickstart的项目,再手工改八改八。

And then?

然后,可以先看一下设计与选型文档, 然后参考CRUD页面教程开始编写自己的管理界面。