快速开发手册.docx

1、快速开发手册appfuse快速开发手册1、开发环境搭建1. 安装JDK 5+1) 在官网（相关地址将在备注列出）找到jdk5或以上版本的下载链接，将其下载到本地。本手册使用的jdk版本为jdk1.5.0_21。2) 将下载的jdk安装到C:Program FilesJava目录下(默认安装)。3) 进入 我的电脑-属性-高级-环境变量新建系统变量：变量名（JAVA_HOME）， 变量值 (C:ProgramFilesJavajdk1.5.0_21)4) 在系统环境变量Path中添加：%JAVA_HOME%bin；5) 新建系统变量：变量名（CLASSPATH）， 变量值 (.;%JAVA_HO

2、ME%lib;)2. 安装MySQL 5.x1) 在官网找到MySQL 5.x相关版本下载链接，将其下载到本地。本手册使用的安装包为mysql-5.0.18-win32.zip。2) 双击安装。3. 安装maven1) 下载maven，最新版本为2.2.1，本手册使用的版本为2.0.92) 将下载的压缩包解压到E盘，并将文件夹命名为maven-2.0.9(不是必须的，便于说明)。3) 新建系统变量: 变量名(MAVEN_HOME)变量值(E:maven-2.0.9)4) 在系统变量Path中添加：%MAVEN_HOME%bin;5) 在系统变量CLASSPATH中添加：%MAVEN_HOME%

3、lib；4. 安装校验4.1 jdk校验在dos窗口下输入命令 java -version如果出现类似下面的截图则说明安装配置成功4.2 MySQL校验进入MySQL控制台，或者直接输入命令mysql -uroot -p按操作提示输入密码进入。若此命令无效，则是因为环境变量没有添加上去，把mysql的bin目录添加到path中去。4.3 maven校验在dos窗口下输入命令mvn -version看maven是否配置成功。2、快速建立项目本手册以建立Archetype为Struts 2 Basic的librarySystem项目为例，简单描述appfuse快速建立项目过程以及一些注意事项。1.

4、 mvn命令简介mvn 为maven的缩写，通过mvn命令，可以快速构建项目。下面对常用mvn命令进行介绍。 mvn archetype:create ：创建 Maven 项目 mvn appfuse:gen-model 根据数据库的表生成java类 mvn appfuse:gen -Dentity=XXX 建立所有的配置文档 mvn appfuse:full-source 把运行所需要的org.appfuse中的依赖类转换成你的包名称 mvn eclipse:eclipse 生成eclipse的项目的配置文件，用户可以直接把项目导入到eclipse中 mvn jetty:run-war 打包

5、并且发布你的应用程序到Jetty mvn appfuse:install 把生成的源代码及配置文件写入到src中 mvn appfuse:remove 删除appfuse:gen.生成的代码 mvn clean ：清除目标目录中的生成结果 mvn package:项目打包 .2. mvn命令建立项目在F盘建立目录myproject，在dos下进入该目录，输入以下指令：mvn archetype:create -DarchetypeGroupId=org.appfuse.archetypes -DarchetypeArtifactId=appfuse-basic-struts -DremoteR

6、epositories=http:/static.appfuse.org/releases -DarchetypeVersion=2.0.2 -DgroupId=com.librarysystem -DartifactId=librarysystem当出现build successful表明创建成功 在dos下进入生成的librarysystem目录，运行以下命令：mvn appfuse:full-source指令运行成功效果如下图：修改默认数据库MySQL配置 org.dbunit.dataset.datatype.DefaultDataTypeFactory CLEAN_INSERT or

7、g.hibernate.dialect.MySQL5InnoDBDialect mysql mysql-connector-java 5.0.5 com.mysql.jdbc.Driver root wan输入下面指令，启动内置服务器jettymvn jetty:run正常启动，dos控制台显示如下：打开浏览器，输入地址：http:/localhost:8080，效果如下：3. 项目导入eclipse以及用tomcat启动配置在dos控制台输入下面指令，可以将生成的项目导入到eclipse中，如果IDE为idea，则使用命令mvn idea:ideamvn eclipse:eclipse生成成

8、功，显示效果如下：Build successful后，就可以正式将该项目导入到eclipse中了，此时，在eclipse中用mvn jetty:run-war指令运行一次，如果不出意外项目可以在jetty服务器上正常启动。但使用tomcat服务器启动会出现问题。需要进行下面几个地方的修改： 拷贝target /librarysystem-1.0-SNAPSHOT / WEB-INF 下的lib目录，将其放到src/main/webapp/WEB-INF/ 将target /librarysystem-1.0-SNAPSHOT /WEB-INF/classes下的所有资源文件拷贝并覆盖到src/

9、main/resources下 在项目属性中，java build path -Source去掉webapp目录。如果有必要，更改其他源文件发布的默认输出文件夹。如下面更改了默认的src/test/java输出目录把User.java与Role.java中的 Id GeneratedValue(strategy=GenerationType.AUTO) public Long getId() return id; 变为： Id GeneratedValue(strategy=IDENTITY) public Long getId() return id; 因为：mqsql的ID是自增的，JPA

10、提供的四种标准用法为TABLE,SEQUENCE,IDENTITY,AUTO. TABLE：使用一个特定的数据库表格来保存主键。 SEQUENCE：根据底层数据库的序列来生成主键，条件是数据库支持序列。 IDENTITY：主键由数据库自动生成（主要是自动增长型） AUTO：主键由程序控制。否则的话无法插入信息。 用命令或直接清空target文件夹，重新发布到tomcat，运行，不出意外，就可以见到下面的效果了：注意：如果不将target /librarysystem-1.0-SNAPSHOT /WEB-INF/classes资源文件覆盖到src/main/resources下，而只是更改res

11、ources下的jdbc配置，项目可以运行，但可能出现乱码。即使删除其他国际化配置，重新发布，有时任不能解决问题。在实际操作中还经常遇到下面的异常：严重: Exception sending context initialized event to listener instance of class org.springframework.web.context.ContextLoaderListenerorg.springframework.beans.factory.BeanDefinitionStoreException: Invalid bean definition with na

12、me dataSource defined in class path resource applicationContext-resources.xml: Circular placeholder reference jdbc.driverClassName in property definitions造成此异常原因尚不清楚，一般可以通过下面方法解决此问题：在项目中运行mvn package 命令，将生成war包下的jdbc配置文件覆盖src/main/resources 下的jdbc配置文件，重新启动tomcat可以即可。4. appfuse目录结构简介src：源代码目录，需要修改的嗲吗

13、一般都位于src下。src/main/java：java 源代码目录，包括POJO，action等。src/main/resources：资源目录，各种资源文件配置。src/main/webapp：web应用源代码目录。src/test：测试源代码目录。target：目标文件目录。target/classes：源代码编译输出目录。target/test-classes：自动测试编译输出目录。5. 模块curd实现 以添加图书信息模块为例，介绍appfuse如何创建模块及实现curd的在mysql的librarysystem数据库中新增表book_info,代码如下：DROP TABLE IF

14、EXISTS book_info;CREATE TABLE book_info ( Id int(11) NOT NULL auto_increment, book_no int(10) NOT NULL default 0 COMMENT 书本编号, book_name varchar(50) default NULL COMMENT 图书名称, book_price float(5,1) default NULL COMMENT 图书价格, book_isbn varchar(20) default NULL COMMENT 图书的isbn编码, author varchar(50) de

15、fault NULL COMMENT 作者, publish varchar(50) default NULL COMMENT 出版社, publish_time date default NULL COMMENT 出版日期, status smallint(4) default 0 COMMENT 书籍状态（2:借出，1:丢失，0:在库）, in_date date default NULL COMMENT 入库时间, remark varchar(500) default NULL COMMENT 备注, PRIMARY KEY (Id) ENGINE=InnoDB DEFAULT CHA

16、RSET=utf8 COMMENT=图书信息表;建表成功后，在srctestresources”下添加一个“hibernate.reveng.xml”文件内容如下： 注意：表名为小写，与数据库一致。Exclud为true时，就是说过虑这张表，为false时，就是说对这张表建立model。运行命令 mvn appfuse:gen-modelINFO Copying generated BookInfo.java to project.INFO -INFO BUILD SUCCESSFULINFO -INFO Total time: 10 secondsINFO Finished at: Mon

17、Dec 06 22:00:29 CST 2010INFO Final Memory: 18M/42M成功后，生成BookInfo.java中会有错误，把 Id GeneratedValue(strategy=IDENTITY) GeneratedValue(strategy = GenerationType.AUTO) public Long getId() return this.id; 改为： Id GeneratedValue(strategy=IDENTITY) public Long getId() return this.id; 生成model成功后，运行以下命令，生成对应的配置文

18、件及对应的jsp页面mvn appfuse:gen -Dentity=BookInfo指令运行成功后，在浏览器中便可以见到初始效果。 国际化：修改ApplicationResources.properties配置文件，替换BookInfo相关对应中文含义bookInfo.id=IdbookInfo.author=作者bookInfo.bookIsbn=IsbnbookInfo.bookName=图书名bookInfo.bookNo=图书编号bookInfo.bookPrice=价格bookInfo.inDate=入馆日期bookInfo.publish=出版社bookInfo.publishT

19、ime=出版时间bookInfo.remark=备注bookInfo.status=图书状态bookInfo.added=图书信息添加成功bookInfo.updated=图书信息更新成功bookInfo.deleted=图书信息删除成功.改完后，重新启动项目，显示效果如下 校验：针对form表单的校验，可以在页面通过javaScript验证，也可以通过struts提供的验证框架实现。现在要实现在添加图书信息时，要求图书名称为必填，使用struts框架校验，只需在BookInfoAction-validation.xml配置文件中加入以下语句。 输入图书信息后点保存，如果图书名称没录，便会有错

20、误提示。关于struts对其他字段如浮点型等可以查看官方参考文档。3、插件配置appfuse默认集成了很多标签库、插件等。这些标签库的引入，大大提高了web项目的用户体验。在taglibs.jsp页面中，可以看到他们是如何被引进项目的。taglibs.jsp内容如下：如果我们想在项目中使用其他一些框架，比如说extJS、dwr、jamon等等，我们需要在项目中配置他们。1. ExtJS ExtJs简介：ExtJS可以用来开发RIA也即富客户端的AJAX应用，是一个用javascript写的，主要用于创建前端用户界面，是一个与后台技术无关的前端ajax框架。因此，可以把ExtJS用在.Net、Java、Php等各种开发语言开发的应用中。从官方下载ExtJS压缩包，目前最高版本为3.2.1，将下载的压缩包解压到项目的src/main/webapp/scripts。在default.jsp 文件中，加入下面代码段： 这样项目中每个jsp页面都可以使用ExtJS控件了。在新增加的bookInfoForm.jsp增加下面代码段： Form.focusFirstElement($(bookInfoForm); Ext.onReady(function() var bookInfo_publishTime_DateField = new Ext.form.DateField( id