QuickStart

Preparation

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

1. Install JDK 6.0+ and set the JAVA_HOME.
2. Install Maven 3.0.4 and set the PATH.

Contents

解压下载包后，会看到三个目录：

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

Run examples

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

首先进入modules目录，运行mvn install，将所有module编译打包安装到Maven的本地仓库。

然后进入examples目录，对你感兴趣的项目执行，先执行 mvn antrun:run -Prefresh-db 初始化数据, 再运行 mvn jetty:run 启动jetty。如果想同时运行多个项目，需要加上不同的端口定义，如 jetty:run -Djetty.port=8082。运行showcase时注意在MAVEN_OPTS中加大JVM PermGen的最大值，加上 -XX:MaxPermSize=128m，参照项目里的jetty.bat。

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启动项目。

Create new project base on SpringSide

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

And then?

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