IntelliJ IDEA 中的 Maven 项目初体验及搭建 Spring MVC 框架

温馨提示:本教程的 GitHub 地址为「intellij-idea-tutorial」,欢迎感兴趣的童鞋StarFork,纠错。

在「详述 IntelliJ IDEA 创建 Maven 项目及设置 java 源目录的方法」一文中,我们已经将 IntelliJ IDEA 中的 Maven 项目的框架搭建完成。接着上文,在本文中,我们更近一步,利用 Tomcat 运行我们的 Web 项目。

structure

如上图所示,我们进一步扩展了项目的结构,在java目录下新建了一系列的目录层级,并在annotation目录下建立一个名为AnnotationController的 Java 类,用于测试 Spring MVC 框架;在WEB-INF目录下,新建了一个pages目录,用于存放jsp页面,并新建了一个名为springmvc-servlet.xml的文件,用于书写 Spring MVC 框架的配置项。接下来,我们依次看看这些文件的内容:

  • 控制类:AnnotationController
package com.hit.action.demo.annotation;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;

/**
 * author:Charies Gavin
 * https:github.com/guobinhit
 */
@Controller
public class AnnotationController {

    // 请求映射地址 http://localhost:8080/gitcode/test,其中 8080 为默认端口
    @RequestMapping(value = "/test")
    public String goTest(HttpServletRequest request) {
        // 输出请求 URL 路径
        System.out.println(request.getRequestURL());
        // 返回逻辑名
        return "index";
    }
}
  • Spring MVC 配置文件:springmvc-servlet.xml
<?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"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
                        http://www.springframework.org/schema/beans/spring-beans-3.2.xsd
                        http://www.springframework.org/schema/mvc
                        http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd
                        http://www.springframework.org/schema/context
                        http://www.springframework.org/schema/context/spring-context-3.2.xsd ">

    <!-- 声明注解开发方式 -->
    <mvc:annotation-driven/>

    <!-- 包自动扫描 -->
    <context:component-scan base-package="com.hit.action"/>

    <!-- 内部资源视图解析器,前缀 + 逻辑名 + 后缀 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/pages/"/>
        <property name="suffix" value=".jsp"/>
    </bean>
</beans>
  • 全局配置文件:web.xml
<!DOCTYPE web-app PUBLIC
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd" >

<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
         http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">

    <!-- 如果修改 Spring 配置文件的位置和名称,则通过以下方式进行声明全局配置文件 -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/springmvc-servlet.xml</param-value>
    </context-param>

    <!-- 配置 Spring 监听器 -->
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

    <!-- 配置 DispatcherServlet 对 url 进行过滤 -->
    <servlet>
        <servlet-name>springmvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>

        <!-- 显示配置用于解析 DispatcherServlet 的配置文件 -->
        <!-- 如果不显示指定,则 Spring MVC 会自动扫描 WEB-INF 下以 servlet-name 标签声明的名称开头以 servlet 结尾的配置文件 -->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>/WEB-INF/springmvc-servlet.xml</param-value>
        </init-param>
        <!-- 显示指定加载顺序-->
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>springmvc</servlet-name>
        <!-- 如果声明 /* 则会拦截所有请求,包括 action 返回的 .jsp 页面 -->
        <url-pattern>/</url-pattern>
    </servlet-mapping>

    <!-- 配置欢迎页 -->
    <welcome-file-list>
        <welcome-file>index.jsp</welcome-file>
    </welcome-file-list>
</web-app>

如上述代码以配置文件所示,我们对 Spring MVC 框架进行了简单的配置,其中有两点需要我们特别注意,分别是:

  • 配置文件,如果不显示指定,则 Spring MVC 会自动扫描WEB-INF下以servlet-name标签声明的名称开头以servlet结尾的配置文件;
  • 拦截请求,如果声明/*则会拦截所有请求,包括 action 返回的.jsp页面,因此一般声明/即可,可以防止请求重复拦截。

此外,因为我们这是 Maven 项目,自然不需要我们再手动导入jar啦,只需要在pom.xml文件中配置依赖即可:

<?xml version="1.0" encoding="UTF-8"?>

<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>com.hit</groupId>
    <artifactId>gitcode</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>war</packaging>

    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.10</version>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-web</artifactId>
            <version>RELEASE</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>RELEASE</version>
        </dependency>
    </dependencies>
</project>

接下来,配置 Tomcat,运行 Web 项目:

Tomcat1
Tomcat2

如上图所示,依次对 Tomcat 进行配置,完成后,运行项目:

hellowolrd

如上图所示,项目成功运行。在这里,很多同学可能会遇到如下错误:

500

造成上述错误的原因是jar包冲突,一般是servlet-api.jarjsp-api.jar这个两个jar包冲突导致的。至于为什么会出现jar包冲突,很有可能是在写Controller的时候,需要导入javax.servlet.http.HttpServletRequest,这时看到项目中竟然没有引入该jar,自然是顺手就在pom.xml中添加了该jar的依赖,好吧,冲突种子就在这里种下啦!实际上,在 Tomcat 的lib目录中,已经包含上述两个jar包:

jar

解决方法:如果是 Maven 项目,就删除pom.xml文件中对servlet-api.jarjsp-api.jar的依赖;如果是非 Maven 项目,就手动排除这两个jar包。然后,进入 IntelliJ IDEA 的Project Structure -> Modules -> Dependencies配置页:

modules

如上图所示,检查 Tomcat 是否引入;如果引入,则检查是否勾选 Tomcat 前的Export选项,实际上不勾选这个选项是正确的,勾选Export之后,会在项目启动后,将该 Tomcat 导出到本地仓库,从而导致两份 Tomcat,再次产生jar包冲突。除此之外,还要检查 JDK、Tomcat 以及 Maven 的版本,以防止版本不兼容的问题,例如:

  • Maven 3.3.1及以上的版本需要JDK 1.7及以上的版本;
  • Spring 4需要JDK 1.7以上的版本等。

如果还解决不了问题的话,呃,再检查检查 IntelliJ IDEA 的 Java 编译器的版本吧,囧!


温馨提示:上述的示例代码已上传至 GitHub 中的「gitcode」项目之中啦!


———— ☆☆☆ —— 返回 -> 史上最简单的 IntelliJ IDEA 教程 <- 目录 —— ☆☆☆ ————

原创声明,本文系作者授权云+社区发表,未经许可,不得转载。

如有侵权,请联系 yunjia_community@tencent.com 删除。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏拂晓风起

Netbeans 使用 Hibernate 逆向工程 生成hbm和pojo

17640
来自专栏搜云库

Spring Cloud(八)高可用的分布式配置中心 Spring Cloud Config

在分布式系统中,由于服务数量巨多,为了方便服务配置文件统一管理,实时更新,所以需要分布式配置中心组件。在Spring Cloud中,有分布式配置中心组件spri...

30560
来自专栏乐百川的学习频道

安装持续集成工具Jenkins

Jenkins是一个流行的持续集成框架,可以在我们提交项目的时候自动测试、运行和部署项目。虽然Jenkins使用Java编写,但是由于Jenkins支持多种语言...

45260
来自专栏Python小屋

虚拟Python环境可以这样创建

Python支持创建多个虚拟环境,每个虚拟环境都是包含Python和相应扩展库的一个目录,多个虚拟环境(文件夹)之间互相不干扰。如果有可能根据需要使用不同版本的...

35470
来自专栏码农笔录

ubuntu、deepin 程序启动菜单创建

16550
来自专栏游戏杂谈

JNI开发示例

安装:eclipse(http://www.eclipse.org/)、CDT(C/C++ Development Tooling)、ADT(Android D...

16720
来自专栏互联网研发闲思录

对Spring运用的一些思考

       最近使用spring总是遇到启动时启动不起来,或者启动起来一会就服务就关闭掉。        停下来想想不是spring不好复杂,而是我对它掌握不...

28970
来自专栏JAVA同学会

Spring Cloud之——Config(配置中心)

  大家好,有一段时间没有写技术博客了。由于工作上的事情,这方面很难分配时间。近几年随着服务化的兴起,一批服务化的框架应运而生,像dubbo,thrift,sp...

15940
来自专栏梦里茶室

Android NOTE

一些小的点就记在这里吧…… MultiDex打包时zip错误 我遇到的是 Execution failed for task ':excelSior:packa...

19260
来自专栏java、Spring、技术分享

Spring Cloud Config

  每个系统都会有一些配置信息需要处理,比如通用的数据源的配置,连接池的配置,log信息的配置。原来系统的处理方式都是通过将配置文件打包部署到线上,对于需要动态...

16220

扫码关注云+社区

领取腾讯云代金券