Quick Start

   Author: 江南白衣

1. Pre Requiment

SpringSide最稳定的运行环境是JDK5 +Tomcat 5.5  ,在此二处下载:JDK 5.0Tomcat 5.5 Windows安装版

除此之外Springside已自带一切工具与类库,无须再额外安装。 

2. 快速安装编译运行

     建议先不要急着看代码,先花1分钟把书店示例跑起来,再看代码时会更清晰。

     使用springside自带的ant, 双击交互式ant脚本--/bin/build.bat ,输入war 即会用maven下载相关的jar,编译,并在release目录中生成war文件,放入tomcat的webapps目录即完成部署。 

     springside自带了hsqldb嵌入式数据库,自带数据文件(无需手工初始化数据),自动随Web应用启动。

    部署完成后,在IE地址栏输入http://localhost:8080/springside/ 访问。其中端口号以Tomcat安装时的选择为准。

关于 Maven及 springside依赖的 jar:

     SpringSide使用Maven2来管理类库库,在下载包中不包含依赖jar,而是在ant compile过程中调用自带的maven task来下载。
     如果你坚决一次也不用ant来编译,那么请双击/bin/maven-jar.bat来下载jar。
     如果你机器上没有一点maven2 jar的积蓄,这个过程可能相对较慢,建议从springside网站上直接下载依赖jar包合集 ,直接解压到springside的 /repository目录。

3.安装Plugins

进一步体验/plugins目录里面的各种插件的功能,双击每个插件目录里的install.bat,出现"BUILD SUCCESSFUL"的字样,即会把相应功能的文件复制到项目中。

之后用/bin/build.bat 重新编译war部署。

4.源码同步升级 

如果你是用Subversion下载的源码,随着项目不断开发,会不断的修改数据库结构和依赖包,此时需要双击/bin/upgrade.bat 来完成相关的升级。

5.设置IDE

    即使只想随便看看,用IDE来看也会比UltraEdit 方便。

    双击build.bat, 能快速生成springside的 IDEA和Eclipse的项目文件。如输入idea ,即会在根目录生成springside.ipr与springside.iml。 其余选项有eclipse,myeclipse和wtp。因为要手工同步,模板文件未必时时都是最新,请见谅。

     注意项目编码要为UTF-8,否则编译后会乱码,另外JDK需为5.0,除了选用JDK5之外,还要在项目属性里配置代码等级为JDK5.0,否则编辑器会不认泛型等JDK5的语法。 详见IDE配置

6.必须阅读的重要文档

    1. SpringSide的架构选型  看看SpringSide的基础架构和选型依据。

    2. SpringSide旅游指南     列明SpringSide的Features,及具体演示代码的路标。

    3. 项目及源码目录结构

    4. CRUD 开发教程   

    5. 数据库结构: /misc/db/DB-Schema.sql  和 ER-Image.jpg

    6. 详细的参考文档

7.将意见反馈给团队

团队开发日志

Spring 中文论坛SpringSide区 

SpringSide Confluence Wiki 

用户QQ群: 21601442

缺陷跟踪系统:JIRA