Quick Start

1. Pre Requiment

用户只需在此下载安装JDK5.0，并设置JAVA_HOME即可。(因为项目中使用了泛型和Annotation，必需使用JDK5.0开发，但可以生成部署到JDK1.4服务器上的war包)

除此之外Springside已自备一切，无须再额外安装。

2. 书店示例快速体验

建议不要急着看代码，先双击一下/springside.bat 花几十秒把书店示例跑起来。
经过N个版本的简化，用户体验的门槛已降到0cm，安装JDK5.0后，只需轻轻双击/springside.bat，一个黑色小窗口一阵好闪之后，就能看到"SpringSide书店示例"的IE窗口端庄素雅的呈现在面前。

3. 运行简述

1. SpringSide使用Ant来管理项目：

springside已自带ant所需的jar，总的ant脚本是/build.xml，还有一个交互式命令--/bin/build.bat，双击它就会列出所有的Task及说明，用户可以选择执行。

编译打包SpringSide所用的task是war，输入war就会在release目录中生成war文件。放入tomcat的webapps目录即完成部署，默认地址是http://localhost:8080/springside/

2. SpringSide使用Maven2来管理依赖的 jar

     springside使用maven2的ant task来运行maven，因此在下载包中不包含大部分的jar文件，而是将它们配置在/lib下的各pom.xml中, 在ant war过程中自动下载。
     如果你不喜欢用ant来编译，那么可双击/bin/maven-jar.bat来初始下载jar。
     如果你第一次安装SpringSide，建议下载All-In-One的发布包。
     如果你必须使用Proxy才能访问SpringSide网站，请参考Maven指南修改。

3. 自带的HSQLDB嵌入式数据库

springside自带了hsqldb嵌入式数据库的jar，自带了数据文件default-data.script，所以无需手工初始化数据。而且还编写了一个listener让数据库自动随Web应用启动。详细请看HSQLDB指南

4.其他注意事项：

4.1 端口号以Tomcat安装时的选择为准，如果没有使用默认的8080端口，请修改applicationContext-webservice-client.xml文件中的serviceUrl。

4.2 当然，你也可以用目录式部署而不用每次生成war，在tomcat配置文件里将Doc-base目录指向springside的/springside-bookstore/webapp，然后用ant compile来编译及复制文件。

4.3 如果你的机器上曾安装过SpringSide的其他版本，或者SVN更新代码后出现任何错误，都请双击/bin/upgrade.bat 保证对class和jar进行彻底更新。

3.快速生成IDE项目文件

即使只想随便看看，用IDE来看也比UltraEdit 方便得多。

SpringSide已经为主流IDE准备了项目文件的模版，我自己也常用这个来生成新项目

双击/bin/build.bat ,输入ide 会列出IDE的选择，如选择idea ，即会在根目录生成springside.ipr与springside.iml 两个idea项目文件，注意要补设一下JDK。

如果你坚持手工设置，注意项目编码要为UTF-8，否则乱码。JDK为5.0，编译等级也要舍维为JDK5.0，否则editor会不认识泛型等JDK5的语法，最后要将/springside-core/src, /springside-bookstore/src,/springside-bookstore/resource三个目录设为源码目录， /springside-core/test, /springside-bookstore/test 两个目录设为测试代码目录。详见IDE配置。

4.必须阅读的重要文档

1. SpringSide的选型看看SpringSide的选型依据。

2. 架构三部曲

用户故事，架构说明及旅游指南，项目及源码目录结构引领阅读SpringSide代码的最重要入门文本(重新编写中)

3. CRUD 代码开发教程

4. 数据库结构: DB-Schema-with-Comments.sql 和 ER-Image.jpg

5. 详细的参考文档

5.将意见反馈给团队

团队开发日志团队每天的开发日志，欢迎在上面对团队的开发改动作出即时评论。

Spring 中文论坛SpringSide区论坛是我们最喜欢的讨论方式。

SpringSide Confluence Wiki SpringSide的文档草稿区，欢迎在上面贡献你的文档。

用户QQ群: 21601442 SpringSide改进建议的即时讨论，在群空间可观看所有聊天记录。

缺陷跟踪系统:JIRA SpringSide的开发安排和用户提交Bug与Wish list的地方。

6.加入我们

加入SpringSide开发团队你的最终进化形态。