一.背景介紹
對於初學者,用maven構建項目並不是一件容易的事,springmvc並不是MVC中的主流,但是本人覺得springmvc比struts要好用,真正做到了零配置。一次使用,就放不下了。
二.準備工作
1.Eclipse 3.7
2.maven
3.Eclipse 需要安裝maven插件。url:maven - http://download.eclipse.org/technology/m2e/releases 。安裝maven-3.0.4。並且選擇本地的maven,如下圖:
三.構建工程
1.用maven插件構建項目框架
maven具有強大構建功能,使用maven可以構建多種不同類型的工程。這裏我們構建maven-archetype-webapp類型的項目。在Eclipse->New中選擇other,找到maven Project型。如下圖:
在選完路徑之後,我們選擇構建類型,如下圖:
接下來,填寫工程的Group Id,Artifact Id,如下圖:
這裏的Group Id就是大項目的id,Arifact Id就是該項目的Id。就像一個大項目中有許多小項目組成一樣。此時,我們的項目已經成型了,樣子如下圖:
接下來,我們要完善項目的目錄,配置。
2.完善項目
首先,完善目錄,增加重要的source Folder,這個不是簡單的Floder,這些文件夾是會參與編譯的。增加src/main/java,src/test/resources,src/test/java目錄。讓目錄變成標準的maven結構。如下圖:
接下來,改變一些配置:
讓工程的JDK用本地的jdk;
讓工程的字符集爲UTF-8;
改變工程的目錄順序;
這些都完成之後,工程目錄應該是如下的樣子:
3.將工程變成web工程
此時,我們的工程還不是標準的web工程,可以在eclipse中增加web工程的特性,選擇工程的Properties,選Project Facets,如下圖:
這裏,我們選擇Dynamic Web Module,版本選擇2.4,這個版本比較通用。如下圖:
此時,我們看到目錄中多了一個WebContent目錄,由於使用maven構建,web目錄是src/main/webapp,所以我們刪除WebContent目錄。接下來,要配置web項目的發佈目錄,就是Deployment Assembly,如圖:
test目錄不要發佈,WebContent目錄沒有了,所以這三項都刪掉。並且增加src/main/webapp目錄,和Maven Dependenices,完成之後如下圖:
於是,我們的工程就完全是一個web工程了。
4.賦予工程的springmvc特性
配置web.xml,使其具有springmvc特性,主要配置兩處,一個是ContextLoaderListener,一個是DispatcherServlet。代碼如下:
<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<servlet>
<servlet-name>exam</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>exam</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
</web-app>
配置ContextLoaderListener表示,該工程要以spring的方式啓動。啓動時會默認在/WEB-INF目錄下查找applicationContext.xml作爲spring容器的配置文件,這裏可以初始化一些bean,如DataSource和iBATIS的集成。代碼如下:
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:aop="http://www.springframework.org/schema/aop"
xmlns:tx="http://www.springframework.org/schema/tx"
xsi:schemaLocation="
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-3.0.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx-3.0.xsd
http://www.springframework.org/schema/aop
http://www.springframework.org/schema/aop/spring-aop-3.0.xsd" default-autowire="byName">
<!-- DataSource定義 -->
<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource"
destroy-method="close">
<property name="driverClassName" value="com.microsoft.sqlserver.jdbc.SQLServerDriver" />
<property name="url"
value="jdbc:sqlserver://172.16.40.5:1433;DatabaseName=dev_his" />
<property name="username" value="sa" />
<property name="password" value="bsoft" />
<property name="maxActive" value="50" />
<property name="maxIdle" value="5" />
<property name="maxWait" value="5000" />
<property name="removeAbandoned" value="true" />
<property name="removeAbandonedTimeout" value="5" />
</bean>
<!-- TransactionManager定義 -->
<bean id="transactionManager"
class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<property name="dataSource" ref="dataSource" />
</bean>
<bean id="transactionTemplate"
class="org.springframework.transaction.support.TransactionTemplate">
<property name="transactionManager" ref="transactionManager" />
</bean>
<!-- iBatis SQL map定義 -->
<bean id="sqlMapClient" class="org.springframework.orm.ibatis.SqlMapClientFactoryBean">
<property name="dataSource" ref="dataSource" />
<property name="configLocation" value="classpath:conf/sql-map-config.xml"/>
</bean>
</beans>配置DispatcherServlet表示,該工程將採用springmvc的方式。啓動時也會默認在/WEB-INF目錄下查找XXX-servlet.xml作爲配置文件,XXX就是DispatcherServlet的名字,該文件中將配置兩項重要的mvc特性:
HandlerMapping,負責爲DispatcherServlet這個前端控制器的請求查找Controller;
ViewResolver,負責爲DispatcherServlet查找ModelAndView的視圖解析器。
代碼如下:
exam-servlet.xml:
<?xml version="1.0" encoding="UTF-8"?><!-- Bean頭部 -->
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p"
xmlns:mvc="http://www.springframework.org/schema/mvc" xmlns:context="http://www.springframework.org/schema/context"
xmlns:util="http://www.springframework.org/schema/util"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd
http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd
http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-3.0.xsd">
<!-- 防止jsp等靜態資源被攔截 -->
<mvc:default-servlet-handler/>
<!-- 激活@Controller模式 -->
<mvc:annotation-driven />
<!-- 對包中的所有類進行掃描,以完成Bean創建和自動依賴注入的功能 需要更改 -->
<context:component-scan base-package="cc.monggo.web.controller" />
<bean
class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter" />
<bean id="viewResolver"
class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix">
<value>/WEB-INF/jsp/</value>
</property>
<property name="suffix">
<value>.jsp</value>
</property>
</bean>
</beans>
5.讓maven自動配置jar包
在用maven生成框架時,就生成了pop.xml,這就是maven的配置文件。我們要引入spring-web,servlet等特性的包。代碼如下:
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>exam</groupId>
<artifactId>exam_3</artifactId>
<packaging>war</packaging>
<version>0.0.1-SNAPSHOT</version>
<name>exam_3 Maven Webapp</name>
<url>http://maven.apache.org</url>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>3.0.5.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>3.0.5.RELEASE</version>
</dependency>
<dependency>
<groupId>org.apache.geronimo.specs</groupId>
<artifactId>geronimo-servlet_2.5_spec</artifactId>
<version>1.2</version>
</dependency>
</dependencies>
<build>
<finalName>exam_3</finalName>
</build>
</project>
更多的jar包可以在maven中心庫下載:http://mvnrepository.com。
run-jetty-run插件下載地址:http://run-jetty-run.googlecode.com/svn/trunk/updatesite/
jetty配置:
<build>
<finalName>WebProject_SMM</finalName>
<plugins>
<plugin>
<groupId>org.mortbay.jetty</groupId>
<artifactId>maven-jetty-plugin</artifactId>
<version>6.1.10</version>
<configuration>
<scanIntervalSeconds>10</scanIntervalSeconds>
<stopKey>foo</stopKey>
<stopPort>9999</stopPort>
</configuration>
<executions>
<execution>
<id>start-jetty</id>
<phase>pre-integration-test</phase>
<goals>
<goal>run</goal>
</goals>
<configuration>
<scanIntervalSeconds>0</scanIntervalSeconds>
<daemon>true</daemon>
</configuration>
</execution>
<execution>
<id>stop-jetty</id>
<phase>post-integration-test</phase>
<goals>
<goal>stop</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
6.做個測試
說了一大堆,只有運行起來纔有意思,下面寫個簡單的測試。先寫Controller。編寫兩個類,LoginControler.java,LoginForm.java。代碼如下:
LoginController.java1 package cc.monggo.web.controller; 2 3 4 import javax.servlet.http.HttpServletRequest; 5 import javax.servlet.http.HttpServletResponse; 6 7 import org.springframework.stereotype.Controller; 8 import org.springframework.web.bind.annotation.RequestMapping; 9 import org.springframework.web.servlet.ModelAndView; 10 11 import cc.monggo.domain.LoginForm;
12 //第一種註解方式(不需要在上下文中配置bean) 13 @Controller 14 public class LoginController { 15 @RequestMapping(value="login") 16 public ModelAndView login(HttpServletRequest request,HttpServletResponse response,LoginForm command ){ 17 String username = command.getUsername(); 18 ModelAndView mv = new ModelAndView("/index/index","command","LOGIN SUCCESS, " + username); 19 return mv; 20 } 21 }