[Java,MVC] Eclipse下搭建Spring MVC

转自:http://blog.csdn.net/blue_jjw/article/details/8752466

一、新建Dynamic Web Project

一个web工程最基本的,只看3个地方，在根目录下(这个目录一般习惯叫WebContent或WebRoot)有 ：
1.WebRoot/WEB-INF/web.xml  启动引导文件
2.WebRoot/WEB-INF/classes/  编译的class文件,会根据package建立子路径 
3.WebRoot/WEB-INF/lib/      jar包 (注意,lib下不可以再建子目录)
这就是一般比较常用的web工程的结构. 有了这三个结构, 然后把WebRoot的绝对路径告诉tomcat这样的web容器,就可以启动了(当然里面要有相应的东西才行)。
因此虽然我们一般项目的结构是: projectname/src, projectname/WebRoot 但实际上src里的.java源代码是tomcat完全不关心的,它的解析是从WebRoot开始的, .class才是它认识的.

参考：搭建简单web项目: spring3.0基础配置(1)

二、添加Spring的依赖包

其中commons-logging-1.1.1.jar是spring日志依赖jar包，jstl-api-1.2.jar与jstl-impl-1.2.jar是Oracle官方的JSTL接口与实现，如果选Apche的也可以。

在打war包时，将这些依赖包拷贝到WebContent/WEB-INF/lib下：

三、配置web.xml

WebContent/WEB-INF/web.xml:

<?xml version="1.0" encoding="UTF-8"?>
    <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5">
    <display-name>ContentManagementSystem</display-name>
        <!-- 添加spring3控制器, DispatcherServletDispatcherServlet是Spring MVC 的入口
            所有进入Spring Web的 Request都经过 DispatcherServlet
        -->
        <servlet>
            <servlet-name>LoadBalanceAlg</servlet-name>
            <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
            <load-on-startup>1</load-on-startup>
        </servlet>
        <!-- 配置spring3的映射规则 -->
        <servlet-mapping>
            <servlet-name>LoadBalanceAlg</servlet-name>
            <url-pattern>*.htm</url-pattern>
        </servlet-mapping>
        <!-- 配置log4j -->
        <!-- spring log4j configuration -->
        <context-param>
            <param-name>webAppRootKey</param-name>
            <param-value>LBAProject</param-value>
        </context-param>
        <!-- 由Spring加载的log4j配置文件的位置 -->
        <context-param>
            <param-name>log4jConfigLocation</param-name>
            <param-value>/WEB-INF/classes/log4j.conf</param-value>
        </context-param>
        <!-- Spring刷新log4j配置文件的间隔，单位为millisecond -->
        <context-param>
            <param-name>log4jRefreshIntercal</param-name>
            <param-value>60000</param-value>
        </context-param>
        <!-- Web项目Spring加载log4j的监听 -->
        <listener>
            <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>
        </listener>
        <!-- 默认跳转到根目录下的页面 -->
        <welcome-file-list>
            <welcome-file>index.htm</welcome-file>
        </welcome-file-list>
        <!-- session timeout setup, 10 mins -->
        <session-config>
            <session-timeout>10</session-timeout>
        </session-config>
    </web-app>

加载DispatcherServlet时Spring会尝试读取配置文件，默认的配置文件位于web.xml相同的路径下，文件名与注册的Servlet名有关：Servlet注册名跟上"-servlet.xml"。 
例如：上面的Servlet注册名为 LoadBalanceAlg，那么默认的配置文件名为：LoadBalanceAlg-servlet.xml。

当然 也可以明确配置文件，需要在注册servlet时设定初始化参数 ：

<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>
  <!-- 配置文件名 -->
</param-value>
</init-param>

参考：Spring mvc的配置

四、Spring配置文件

文件名需与web.xml中的<servlet-name></servlet-name>中的名字一致

<?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:p="http://www.springframework.org/schema/p"
    xmlns:context="http://www.springframework.org/schema/context"
    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"
    >   

    <!-- 开启spring MVC注解功能，完成请求和注解POJO的映射 -->
    <bean class="org.springframework.web.servlet.mvc.annotation.DefaultAnnotationHandlerMapping"/>
    <bean class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter"/>
    <!-- 默认扫描的包路径 -->
    <context:component-scan base-package="cn.ac.dsp.controller"/>
    <context:component-scan base-package="cn.ac.dsp.service"/>   

    <!-- 模型视图名称的解析，即模型前后添加前后缀 -->
    <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
       <property name="viewClass"><value>org.springframework.web.servlet.view.JstlView</value></property>
       <property name="prefix"><value>/WEB-INF/jsp/</value></property>
       <property name="suffix"><value>.jsp</value></property>
    </bean>
</beans>

五、log4j的配置

第一步：导入jar包

第二步：在web.xml中的配置：

<!-- 配置log4j -->
<!-- spring log4j configuration -->
<context-param>
        <param-name>webAppRootKey</param-name>
    <param-value>LBAProject</param-value>
</context-param>
<!-- 由Spring加载的log4j配置文件的位置 -->
   <context-param>
    <param-name>log4jConfigLocation</param-name>
    <param-value>/WEB-INF/classes/log4j.conf</param-value>
   </context-param>
   <!-- Spring刷新log4j配置文件的间隔，单位为millisecond -->
   <context-param>
    <param-name>log4jRefreshIntercal</param-name>
    <param-value>60000</param-value>
   </context-param>
   <!-- Web项目Spring加载log4j的监听 -->
   <listener>
    <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>
   </listener>

其中webAppRootKey表示Web项目根目录的绝对路径，如果不配置webAppRootKey参数，则webAppRootKey 就是缺省的"webapp.root"，最好设置，以免项目之间的名称冲突。然后，log4j配置文件中就可以用${LBAProject}表示Web项目目录的绝对路径，如果不设置webAppRootKey，可用${webapp.root}表示Web项目目录的绝对路径。

注意：

1、log4j的配置文件的文件名不能为"log4j.properties",而要改为别的名字,要不然报异常:
log4j:ERROR setFile(null,true) call failed. 
java.io.FileNotFoundException: \WEB-INF\log\abc.log (系统找不到指定的路径。)

原因是log4j.properties与tomcat的log4j重名,改个名字就好了.因为在tomcat启动是默认去找log4j.properties,但此时Listener还没有起来,tomcat就要往\WEB-INF\log\abc.log 写日志就找不到了.

2、${webapp.root}表示工程目录,可以把它加入到log4j配置文件中输入路径的前面，如:

log4j.appender.appender_demo.File = ${webapp.root}/WEB-INF/log/abc.log

3.该配置文件一定要放在src目录下,使其自动生成到/WEB-INF/classes/目录下.否则,spring报异常:

log4j:WARN No appenders could be found for logger (...).

log4j:WARN Please initialize the log4j system properly.

第三步：在src下创建配置文件log4j.conf

log4j.conf:

log4j.rootLogger = INFO, stdout, A1, A2  

##log message to console
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target = System.out
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern = %d{yyyy-MM-dd HH:mm:ss.SSS} %5p [%t] %c:%l - %m%n  

##log message to file
log4j.appender.A1.Threshold = INFO
log4j.appender.A1 = org.apache.log4j.DailyRollingFileAppender
log4j.appender.A1.File = ${LBAProject}/WEB-INF/log/LBA-info.log
log4j.appender.A1.DatePattern = '-'yyyy-MM-dd'.log'
log4j.appender.A1.layout = org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern = %d{yyyy-MM-dd HH:mm:ss.SSS} %5p [%t] %c:%l - %m%n  

##log warn/error to file
log4j.appender.A2.Threshold = WARN
log4j.appender.A2 = org.apache.log4j.DailyRollingFileAppender
log4j.appender.A2.File = ${LBAProject}/WEB-INF/log/LBA-error.log
log4j.appender.A2.DatePattern = '-'yyyy-MM-dd'.log'
log4j.appender.A2.layout = org.apache.log4j.PatternLayout
log4j.appender.A2.layout.ConversionPattern = %d{yyyy-MM-dd HH:mm:ss,SSS} %5p [%t] %c:%l - %m%n

参考：log4j注意的问题

Spring中配置log4j问题

搭建简单web项目:spring3.0基本配置(2)

在Spring的项目中配置Log4j存放日志文件到指定目录下

六、前后台代码

首先，在WEB-INF/jsp下新建一个jsp包，与上文中prefix的值相对应(LoadBalanceAlg-servlet.xml中配置了视图解析模块

<%@ page language="java" contentType="text/html; charset=ISO-8859-1"
    pageEncoding="ISO-8859-1"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>DB Operation</title>
</head>
<body>
    DB Operation Success!
</body>
</html>

在src下编写后台代码(在LoadBalanceAlg-servlet.xml配置的包中)，如DBOperation.java：

package cn.ac.dsp.controller;  

import java.util.List;  

import org.apache.log4j.Logger;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;  

import cn.ac.dsp.dao.ResourceDAO;
import cn.ac.dsp.entity.ResourceEntity;  

@Controller
public class DBOperation {  

    private final static Logger log = Logger.getLogger(DBOperation.class);  

    @RequestMapping("/dbOperation.htm")
    public String start(){
        log.info("request for dbOperation");
        List<ResourceEntity> resDAOList = ResourceDAO.getInstance().selectAll();
        for(ResourceEntity re : resDAOList){
            System.out.println(re.hashCode());
        }
        return "dbOperation";
    }
    /**
     * @param args
     */
    public static void main(String[] args) {
        DBOperation d = new DBOperation();
        d.start();
    }
}

七、测试

将Eclipse中的项目打成war包(注意要将依赖包拷贝到WEB-INF/lib下)，放到tomcat的webapps下，启动tomcat。

浏览器中打开页面如下：

参考：spring3 mvc系列一：架构基本配置(注解版)