SpringSide 3.0 开发人员快速开始指南

 

SpringSide 3.0

开发人员快速开始指南

1.                  简介

本文档描述了开发人员如何参与SpringSide 3.0的开发。

2.                  预要求

l         安装JDK5.0 ，并设置JAVA_HOME 指向 JDK5.0 安装目录

3.                  初始化项目

3.1               启动HSQLDB

双击tools/db/hsqldb-1.8.0.7/server.bat

3.2               Maven编译项目

双击bin/quickstart.bat，调用tools/maven/maven-${version} /bin/mvn，执行mvn install eclipse:eclipse命令，下载所依赖的JAR文件，编译项目，并生成Eclipse的项目文件。

 

3.3               配置Eclipse WTP打开项目

以Eclipse 3.3 +WTP 2.0 举例

l         导入项目。
打开Eclipse，选择file->import，选择General->Existing Projects into Workspace，选择SS3根目录，选择所有项目打开。

l         配置Maven本地仓库路径。
选择Windows->Preferences ->Java->Build Path->Classpath Varibales，选择New，新增M2_REPO变量，指向C:/Document and setting/你的登录用户名/.m2/repository

l         配置Tomcat Server。
选择Windows->Preferences ->Server->Installed RunTime，选择Add，选择Tomcat 6，根目录指向SS3根目录/tools/server/tomcat-${version}

l         配置代码格式
选择Windows->Preferences->Java->Code Style->Formatter，选择Import，选择SS3根目录/tools/ide/eclipse/code-style.xml 文件

l         设置项目的编码为UTF-8

4.                  了解系统设计

l         阅读docs/developer-guide/design/下的设计文档。

5.                  运行系统

5.1               运行mini-service

l         在Eclipse WTP 中运行项目。

6.                  了解项目组开发方式与习惯

l         阅读docs/developer-guide/guidline/下的指南。

l         阅读docs/developer-guide/ specification/下的规范 。

7.                  增加依赖的JAR

l         查找jar在maven官网上的位置，如用google 查询 site:repo1.maven.org/maven2/ spring 来查找springframework的位置，找到所需的版本后，打开其pom文件，获得其groupId, artifactId,version

l         在tools/maven/spring-parent/pom.xml 中，在    <dependencies>节点内加入该jar

l         在项目的pom.xml中，在    <dependencies>节点内加入该jar（此处无需写version属性）

l         重新运行bin/eclipse.bat命令，即会下载该jar及所有相关需要的jar，并更新eclipse项目文件。

8.                  修改数据库结构

l         依次修改项目的db目录下各类型数据库的sql文件

l         将修改同步到hsqldb:
启动hsqldb(运行tools/db/hsqldb-1.8.0.7/server.bat)
运行tools/db/hsqldb-1.8.0.7/manager.bat，选择HSQL DataBase Engine，URL为jdbc:hsqldb:hsql://localhost/miniservice，其中miniservice是相应的项目名
执行修改脚本
选择command->SHUTDOWN, 执行execute，将会把改动存入data/miniservice.script文件

l         重新启动hsqldb