1. Howto Begin

   1. 下载allinone版本，双击springside.bat 快速开始初始化整个项目，初始化Maven2 仓库。

   2. 用SVN下载源码，将allinone版本中的/misc/servers/tomcat目录copy到svn checkout目录。(optional)

   3. 阅读IDE配置文档 配置IDE。

2. Howto 改变数据结构和数据

     hsqldb的好处就是数据库文件就是一个普通的sql文件，如果没有中文问题，可以直接修改项目里resources目录下的hsqldb.script文件即可。

     如果要输入中文，使用components/embeddb/hsqldb/bin/manager.bat 或任意的JDBC数据库管理器，在URL里填jdbc:hsqldb:file:«不带后缀名的script文件路径»，如

jdbc:hsqldb:file:C:\springside2\examples\helloworld\resources\hsqldb\helloworld

   操作完毕后，最后必须执行Shutdown的sql 命令来存盘。HSQLDB的详细文档见HSQLDB指南。

3. Howto 编写文档

      在此wiki编写，URL为http://www.springside.org.cn/wiki/

4. Howto 增加和更新jar

     如果maven主站上面有，可以直接修改相关的pom.xml。http://www.mvnrepository.com/可以查询jar的路径。

     如果没有时，请把jar加在component的/lib/nomaven 目录下，白衣稍后会进行整理。

     而对于过期的jar，需要在/components/components.properties文件的outdate.jars 参数中说明。其他用户需重新运行项目build文件的编译时进行更新。

5. Howto 增加构件

    增加构件时可参考原有的构件, 比较好的例子是web/ec 构件。

    在components目录下新建目录；

    编写pom.xml文件，定义依赖的jar(可参考web/ec/pom.xml)；

    如果构件安装时需要复制其他文件，建立temlates目录，按照目标路径放置文件；

    如果web.xml 文件需要整合，建立meta/web.xml(可参考web/extremetable/meta/web.xml)；

    如果构件在安装过程中需要特别的动作(如要求用户输入参数，并对文件进行replace)，建立build.xml，实现install target。注意在此时，默认的目录是项目的根目录，如果需要使用构件的目录，使用变量component.dir。   (可参考components下的build_sample.xml)

    最后修改/springside/components/components.properties, 增加构件的条目，并修改component.list属性。

6. Release Checklist

1. 使用IDEA 按默认样式 reformat 所有代码。
2. 使用IDEA 和 Findbugs的代码检查功能，无明显代码缺陷。
3. 运行所有的Unit Test 和 Functional Test。
4. 将release包解压并执行所有ant命令。
5. 在release包环境再次执行所有测试。