分类

使用JavaConfig和注解方式实现零xml配置的Spring MVC项目

JAVA学习网 2017-08-23 07:41:08

1. 引言

Spring MVC是Spring框架重要组成部分，是一款非常优秀的Web框架。Spring MVC以DispatcherServlet为核心，通过可配置化的方式去处理各种web请求。

在平时项目开发中，通常在web.xml下配置

2. Spring MVC 项目的搭建

2.1 构建Maven项目

pom.xml

<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/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>org.aming</groupId>
    <artifactId>springmvc1</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>war</packaging>

    <properties>
        <!-- Generic properties -->
        <java.version>1.8</java.version>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <!-- Web -->
        <jsp.version>2.2</jsp.version>
        <jstl.version>1.2</jstl.version>
        <servlet.version>3.1.0</servlet.version>
        <!-- Spring -->
        <spring.version>4.1.5.RELEASE</spring.version>
        <!-- Logging -->
        <logback.version>1.0.13</logback.version>
        <slf4j.version>1.7.5</slf4j.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>javax</groupId>
            <artifactId>javaee-web-api</artifactId>
            <version>7.0</version>
            <scope>provided</scope>
        </dependency>
        <!-- Spring MVC -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>${spring.version}</version>
        </dependency>
        <!-- 其他Web依赖 -->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>jstl</artifactId>
            <version>${jstl.version}</version>
        </dependency>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>${servlet.version}</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>jsp-api</artifactId>
            <version>${jsp.version}</version>
        </dependency>

        <!-- Spring -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-tx</artifactId>
            <version>${spring.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
            <version>${spring.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-beans</artifactId>
            <version>${spring.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>${spring.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context-support</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <!-- 使用SLF4J和Logback作为日志 -->
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>${slf4j.version}</version>
        </dependency>
        <!-- 代码直接调用log4j会被桥接到slf4j -->
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>log4j-over-slf4j</artifactId>
            <version>${slf4j.version}</version>
        </dependency>
        <!-- 代码直接调用commons-logging会被桥接到slf4j -->
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>jcl-over-slf4j</artifactId>
            <version>${slf4j.version}</version>
        </dependency>
        <!-- 代码直接调用java.util.logging会被桥接到slf4j -->
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>jul-to-slf4j</artifactId>
            <version>${slf4j.version}</version>
        </dependency>
        <!-- log4jdbc -->
        <dependency>
            <groupId>com.googlecode.log4jdbc</groupId>
            <artifactId>log4jdbc</artifactId>
            <version>1.2</version>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
            <version>${logback.version}</version>
        </dependency>
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-core</artifactId>
            <version>${logback.version}</version>
        </dependency>
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-access</artifactId>
            <version>${logback.version}</version>
        </dependency>
    </dependencies>

    <build>
        <finalName>springmvc</finalName>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>2.5.1</version>
                <configuration>
                    <source>${java.version}</source>
                    <target>${java.version}</target>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-war-plugin</artifactId>
                <version>2.3</version>
                <configuration>
                    <failOnMissingWebXml>false</failOnMissingWebXml>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

2.1 日志配置

我们使用logback去管理我们的日志，相比去log4j，logback性能更为出色。我们在src/main/reources目录下，新建logback.xml，其内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<configuration scan="true" scanPeriod="1 seconds">
    <contextListener class="ch.qos.logback.classic.jul.LevelChangePropagator">
        <resetJUL>true</resetJUL>
    </contextListener>
    
    <jmxConfigurator/>
    
    <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <!--格式化输出：%d表示日期，%thread表示线程名，%-5level：级别从左显示5个字符宽度，%msg：日志消息，%n是换行符--> 
            <pattern>
                %d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} -%method - [%X{logback}] - %msg%n
            </pattern>
        </encoder>
    </appender>
    
    <logger name="org.springframework.web" level="DEBUG"/>
    
    <root level="info">
        <appender-ref ref="console"/>
    </root>
</configuration>

说明：在开发Spring MVC的过程中经常出现和参数类型相关的4XX错误，将org.springframework.web包下的类的日志级别设置为debug可以看到更详细的错误信息。

2.3 演示页面

在src/main/resources下建立views目录，并在此目录下新建index.jsp，body元素中添加以下内容：

    <pre>
        Welcome to Spring MVC world
    </pre>

说明:

  1. 在Maven标准中，页面通常放在src/main/webapp/WEB-INF下，此处这样放置页面的主要目的是和Spring Boot的页面放置方式保持一致；

  2. 在ecplise中新建jsp页面默认是在webapp中，即使是在src/main/resources下目录点击新建，因此在新建jsp时需要重新选择合适的目录。

2.4 Spring MVC 配置

新建ApplicationConfiguration类作为Spring MVC的配置类，其内容如下：

@Configuration
@EnableWebMvc
@ComponentScan("org.aming.demo.springmvc")
public class ApplicationConfiguration {
    
    @Bean
    public InternalResourceViewResolver viewResolver() {
        InternalResourceViewResolver viewResolver = new InternalResourceViewResolver();
        //运行时代码会将位于src/main/resources目录下的页面自动编译到/WEB-INF/classes/views/下
        //如果是src/main/webapp/WEB-INF的页面，那么prefix是/WEB-INF/views/
        viewResolver.setPrefix("/WEB-INF/classes/views/");
        viewResolver.setSuffix(".jsp");
        viewResolver.setViewClass(JstlView.class);
        return viewResolver;
    }
}

说明：

  1. @Configuration注解表明ApplicationConfiguration是一个普普通通配置类；
  2. @EnableWebMvc注解会开启一些默认配置，如一些ViewResolver或者MessageConverter等;

  3. @ComponentScan注解将会扫描指定包下通过注解配置的bean。

2.5 Web配置

新建WebInitializer类并实现WebApplicationInitializer接口：

public class WebInitializer implements WebApplicationInitializer {

    @Override
    public void onStartup(ServletContext servletContext) throws ServletException {
        AnnotationConfigWebApplicationContext ctx = new AnnotationConfigWebApplicationContext();
         ctx.register(ApplicationConfiguration.class);
         ctx.setServletContext(servletContext);
         Dynamic servlet = servletContext.addServlet("dispatcher",new DispatcherServlet(ctx));
         servlet.addMapping("/");
         servlet.setLoadOnStartup(1);
    }
}

说明：

  1. WebApplicationInitializer是Spring提供用来配置Servlet3.0+配置的接口，从而实现了替代web.xml的位置。实现此接口将会自动被SpringServletContainerInitializer(用来启动Servlet3.0容器)获取到。
  2. 新建WebApplicationContext，注册配置类(ApplicationConfiguration),并和其和当前servletContext关联
  3. 注册Spring MVC的DispatcherServlet。

2.6 简单控制器

新建HelloController类去完成URL和方法之间的映射：

@Controller
public class HelloController {
    @RequestMapping("/index")
    public String hello() {
        return "index";
    }
}

3. 运行结果

将项目打成war包部署到tomcat中，启动tomcat，在浏览器中输入：http://127.0.0.1:8080/springmvc/index
运行结果截图

4. 参考书籍

汪云飞：JavaEE开发的颠覆者：Spring Boot实战。

阅读(796) 评论(0)