IDEA创建Spring MVC Hello World 详细入门教程

时间  2019-11-05
标签 idea 创建 spring mvc hello world 详细 入门 教程 栏目 Eclipse 繁體版
原文   原文链接
引子，其实从.NET转Java已经有几个月时间了，项目也作了很多，可是不少配置都是根据公司模板或者网上教程比忽略画瓢，对其中最简单的配置和设置并不彻底理解，依旧是小白用户。最近项目不忙，从新梳理了一下Spring MVC的相关配置，顺便保存下来，但愿也能帮到其余同窗……高手忽略~~~

 

目录
  • 经过IDEA新建Spring MVC项目
  • 设置运行、调试相关配置
  • 导入Spring MVC 相关类库
  • 添加 Controller
  • 修改 url-pattern（web.xml）
  • 配置 component-scan（dispatcher-servlet.xml）
  • 配置 ViewResolver（dispatcher-servlet.xml）
  • 添加视图文件（.jsp）
  • 经过 Model 向 View 传值

 

经过IDEA新建Spring MVC项目

先建立项目，从封面或者主窗体均可以建立html

 “New Project”窗口，选择附加的类库"Spring MVC"java

 

选择项目名称和存放的位置web

 最后点击Finish按钮，IDEA会帮你下载须要的类库spring

 建立完成后项目有这些文件，主要是三个xml文件+一个index.jsp浏览器

这个jsp文件最后确定是不要的，不过也先不要慌着删安全

 

 

设置运行、调试相关配置

 项目建好后，并不能直接运行，Run和Debug菜单都是灰色不能点击的mvc

要须要作一下运行和调试的相关配置app

做为.NET转Java的码农，有时候真的很怀念宇宙第一IDE:Visual Studio，根据模板建立的项目不多有不能直接运行的，算了，不说也罢，继续配置。。。jsp

先设置“Server”选项卡工具

 

点开“Deployment”选项卡,继续设置,

建立Artifact，最后记得点OK保存

 

如今，Run菜单下出现了Run 'mvc-helloworld'的菜单项目（Shift+F10运行，Shift+F9调试）

工具栏上也有了运行和调试按钮，你能够选择本身喜欢的方式运行项目

虽然咱们还没开始写代码，可是毕竟IDEA帮咱们生成了一个jsp文件，能够用这个文件看看站点可否打开（index.jsp代码以下）

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
  <head>
    <title>$Title$</title>
  </head>
  <body>
  $END$
  </body>
</html>

浏览器输入地址 http://localhost:8080/index.jsp

项目是运行不起来的（其实离运行起来，还缺很多配置，继续日后看），

啥状况？固然要看日志。。。点开下面的“Tomcat Localhost Log”，能够看到问题出在哪里。。。

 

java.lang.ClassNotFoundException: org.springframework.web.context.ContextLoaderListener

意思就是找不到ContextLoaderListener这个类

导入Spring MVC相关类库

 Java中，ClassNotFoundException好像是个挺常见的异常，先检查相应的jar包有没有包含进来...

打开Project Structure,跟项目相关配置基本都在个菜单里边。。。

 

点开"Artifacts"选项卡后，上面有多出很明显的提示，缺失Spring MVC相关类库的引用

尽管IDEA搞这么多提醒，为啥我感受仍是不够醒目？

 

 按照下面的几个方法修复错误，随便选一种就行

让程序部署的时候，把Spring MVC相关类库复制到lib文件夹中

 

从新运行一次项目（Shift+F10运行，Shift+F9调试）……

若是你上次没有Stop，此次运行可能会弹出这个对话框，选择“Restart server”而后"OK"吧...

再一次访问 http://localhost:8080/index.jsp

此次终于能够看见点内容了，起码说明服务启动了。。

 

若是再看刚才的日志，原来报错也没有了

 

添加Controller

站点能够打开了，不过咱们这个不是MVC，由于没有M、没有V也没有C

咱们就从MVC中的C（Controller）开始，继续配置

在新建Controller以前，首先要建一个包，SpringMVC是无法运行在默认包下的，按照以下方式建包，

我建的包名称为：wormday.springmvc.helloworld

其实包名随意，可是必需要有。。。

 

 

 再这个包下新建Java Class文件 HiController

 

代码以下

package wormday.springmvc.helloworld;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
@RequestMapping("/hi")
public class HiController {

    @RequestMapping("/say")
    public String say() {
        return "/WEB-INF/jsp/say.jsp";
    }
}

若是你跟我同样又火烧眉毛的要访问一下这个Controller的Action 地址应该是：

 http://localhost:8080/hi/say.form   其实这个时候访问结果是404，由于后边还有很多配置没有作...

 

 

类上的注解@RequestMapping("/hi")指定 Url路径前边一部分

方法上的注解@RequestMapping("/say")指定 Url路径最后一部分

也能够只把注解写在方法上，好比@RequestMapping("/hi/say”)

那个结尾的form是什么鬼，就接着看下一段 url-pattern...

修改 url-pattern（web.xml）

先打开web\WEB-INF\web.xml文件

有关于ServletMapping的设置，经过这个设置，能够配置那些类型的url用那些servlet来处理

    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>*.form</url-pattern>
    </servlet-mapping>

结合这一段xml，咱们能够看到,IDEA默认帮我配置了一个名字叫作dispatcher的Servlet

这个Servlet使用org.springframework.web.servlet.DispatcherServlet这个类来处理

这个Servlet对应的Url是*.form

若是你跟我同样不喜欢每一个MVC Url后边都带一个form，能够改为斜杠

<url-pattern>/</url-pattern>

若是你如今从新启动程序，而后继续访问http://localhost:8080/hi/say

发现，依旧404，而且伴随每次访问，都在Server的Output窗口有一个错误日志

org.springframework.web.servlet.PageNotFound.noHandlerFound No mapping found for HTTP request with URI [/hi/say] in DispatcherServlet with name 'dispatcher'

意思就是没有找到相应的Controller，不但要把Controller的代码写好，还要告诉Spring(在这里实际上是dispatcher servlet)去哪里找这些Controller。。。

做为验证，你能够在Controller里边加一个断点，而后刷新页面，程序根本就没有执行到Controller里边

因此如今轮到修改另一个配置文件了，dispatcher-servlet.xml

 

配置 component-scan（dispatcher-servlet.xml）

 component-scan就是告诉Servlet去哪里找到相应的Controller

打开 dispatcher-servlet.xml

在已经存在的<beans></beans>中间加上

<context:component-scan base-package="wormday.springmvc.helloworld"/>

base-package指定的就是存放Controller的包

 作完这一步以后，从新启动项目，再次访问  http://localhost:8080/hi/say

此次应该仍是404错误，不过比刚才的404错误前进了一大步

毕竟此次Controller已经执行了，若是刚才的断点没有去掉，你能够验证一下看看

这一回是由于是“/WEB-INF/jsp/say.jsp”这个View找不到（咱们刚才确实只是告诉他这个位置，可是历来没有建立过这个文件）

再强调一次，Spring Mvc若是找不到Controller或者View都会报404错误，具体找不到的是谁，要具体分析了，好在通常都能简单的分辨出来。

这个地方有个问题要额外说明一下，通常来讲Controller代码的返回值是成字符串“say”就能够了，不须要.jsp,也不须要前边的路径，好比

可是若是如今这样写，会报一个很奇怪的500错误，而不是404

HTTP Status 500 - Circular view path [say]: would dispatch back to the current handler URL [/hi/say] again. Check your ViewResolver setup! (Hint: This may be the result of an unspecified view, due to default view name generation.)

 缘由是：

  1. 咱们尚未配置ViewResolver，Spring会默认帮咱们生成一个，自动生成的并无配置View默认的前缀和后缀(针对本项目本别是"/WEB-INF/jsp/"和".jsp")，因此暂时只能写绝对路径，本文后边也会讲到如何配置
  2. 若是不是"/"开头的路径（也就是相对路径了），Spring会把当前路径给配上去，当前Controller路径是"/hi/"配上View的路径"say",变成了"/hi/say"，Controller执行结果发给View,这个View偏偏又是Controller自己，Spring发现这是个死循环，就再也不执行直接报上面的错误了
  3. 这个错误我再Controller单元测试的时候也遇到过，原理知道了就知道如何解决了

可是目前必须制定View的绝对路径，由于咱们尚未配置 配置 ViewResolver，后边会专门说到这个问题 

 

添加视图文件(.jsp)

 

 这个没啥好解释的，刚才你让Spring去哪里找这个View,就把这个View建立在哪里

若是找不到，他就简单粗暴的报404错误，根据前边我写的代码，建立位置应该入下图。

其实Spring并不限制你必须建立在WEB-INF下，可是这样更安全，由于WEB-INF目录用户是不能直接访问的，毕竟View里边可能会有一些代码

<%@ page contentType="text/html;charset=UTF-8" language="java" %> <html> <head> <title>Title</title> </head> <body>hello world</body> </html>

再次访问 http://localhost:8080/hi/say

终于再也不报错了，看起来Controller也把相应的视图找到了

  

配置 ViewResolver（dispatcher-servlet.xml）

还记得刚才Controller返回值必须是View的绝对路径这个事情么？通常状况下，咱们是不会这样写的

网上的教程大部分也仅仅返回View的名字，好比

 

缘由是通常都会在dispatcher-servlet.xml上指定以下的代码。

    <!--指定视图解析器-->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <!-- 视图的路径 -->
        <property name="prefix" value="/WEB-INF/jsp/"/>
        <!-- 视图名称后缀  -->
        <property name="suffix" value=".jsp"/>
    </bean>

 class 指定ViewResolver的实现的类，你能够根据不一样的状况，使用不用的ViewResolver，这里指定的是 org.springframework.web.servlet.view.InternalResourceViewResolver

刚才我没有指定，默认的也是这个类

后边的前缀和后缀比较简单，看看就明白了

记得改完xml以后，同步修改Controller的返回值。。否则又要404了

经过 Model 向 View 传值

经过上面的操做，已经完成了MVC中的(V和C)，M还没见影子，让咱们继续修改

打开刚才定义的Controller 也就是 HiController.java文件

修改以下（修改点我已经高亮了）

package wormday.springmvc.helloworld;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model; // 这里导入了一个Model类
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
@RequestMapping("/hi")
public class HiController {

    @RequestMapping("/say")
    public String say(Model model) { // 参数中传入Model
        model.addAttribute("name","wormday"); // 指定Model的值
        model.addAttribute("url","http://www.cnblogs.com/wormday/p/8435617.html"); // 指定Model的值
        return "say";
    }
}

而后再打开View，也就是say.jsp文件，修改以下

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
hello world,${name} <br/>${url}</body>
</html>

两个之间的关系就不解释了，而后从新运行项目，刷新页面

一个最简单的MVC项目完成了！！！

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程