QuickStart - SpringSide3 Wiki

1. 开场前十分钟

安装JDK5.0任意版本或 JDK6.0.4以上版本，设置环境变量JAVA_HOME.
阅读SpringSide的简介，项目列表与目录结构说明，了解SpringSide的概貌.

2. 一站式快速安装

又见springsdide2.0式的傻瓜式快速安装。下载SpringSide-All-in-one版，在tools目录已预置了所有的软件，双击 bin/quickstart-all-in-one.bat，将step by step的自动执行：

启动预置的Nexus Maven私服(包含所有依赖JAR)。
启动预置的Tomcat 6服务器。
启动预置的Derby示例数据库。
使用预置的maven执行后面的命令。
将springside-core.jar和两个Archetypes项目骨架安装到本地目仓库 C:/Document and Setting/用户名/.m2/repository
执行mini-web项目中的sql脚本初始化示例数据库。
为mini-web 、 mini-service、extreme-web 下载依赖的Jar，编译、测试、打包并最后部署到Tomcat中。
自动打开IE浏览器，显示这三个项目。

如果已经是SpringSide的老用户，那就不必每个版本都下载较大的all in one版，下个小的源码版就足够了。
源码版与all in one版的唯一区别在于tools目录里没有那么多软件，需要自行下载或使用all in one 版附带的。

下载Maven 2.0.9，设置环境变量PATH指向它的bin目录。
下载Tomcat 6.0 以上，复制tools/configures/tomcat/conf中的内容到Tomcat 6.0目录(用以配置Tomcat maven插件需要使用的用户)，并在8080端口启动Tomcat。

双击bin/quickstart.bat，maven会执行与All in One版同样的任务。
注意如果没有配置Nexus私服，依赖的JAR会从Maven官方网站下载。如果设置代理服务器才能上网的话，修改maven目录的conf/setting.xml文件，修改其<Proxies>节点。

3. 在Eclipse中....

如果你是坚定的版权意识者，这时候使用的应该是Eclipse 3.4.1 for Java EE Developers了，SpringSide的项目文件也是基于它之上。如果你使用的是其他IDE如MyEclipse，可跳到下一节。

Maven依赖Jar，推荐使用m2eclipse 插件来自动管理。(只安装Maven Embedder，Maven Intergration for Eclipse，Maven POM Editor，Maven POM XML Editor，Maven Intergration for WTP 五个模块。)

如果你或者你的团队成员实在很烦maven，则执行每个项目的bin目录中的copy-jar.bat，会为你将maven依赖jar复制到/lib 和 webapp/WEB-INF/lib目录，从此就不用和maven打交道了。

3.1 浏览源码

打开Eclipse，选择file->import，选择General->Existing Projects into Workspace，选择下载的SpringsideSide3根目录，钩选mini-service,mini-web,showcase,springside-core 四个项目。

刷新项目，大家可以畅快的浏览源码了......

3.2 运行项目

在Eclipse 配置Tomcat 6的目录，选择Windows->Preference->Server->Server Runtime Enviroments，选择Tomcat 6.0，选择Tomcat 6.0的下载目录。
保证已执行bin/start-db.bat 启动数据库。
对项目点右键，Run as->Run on a Server，选Tomcat 6...... 项目部署在your workspace\.metadata\.plugins\org.eclipse.wst.server.core\tmp0\wtpwebapps

注：如果m2eclipse插件又间歇性失败，没有将jar部署到项目，Tomcat报告缺少类的错误，执行项目中的copy-jar.bat进行复制。

4. 不在Eclipse中...

如果你使用是MyEclipse之类的其他IDE，就需要自行为每个项目新建项目文件，配置如下：

源码目录为src/main/java,src/main/resource，测试代码目录为src/test/java。
Web应用目录为webapp。
依赖Jar配置见上节，可用m2eclipse插件，也可以用copy-jar.bat。
项目编码为UTF-8，JDK为1.5以上版本，需要按1.5语法编译。