手把手教你在Eclipse上创建一个Maven+Spring MVC的HelloWord项目

忘是亡心i 2022-07-15 12:55 180阅读 0赞

使用了框架进行开发以后，我们用到的jar包会越来越多，每次都手动下载然后拷贝进项目的话，这样会比较麻烦，而且有时候不能很好地处理jar包传递依赖的问题。庆幸的是，Maven出现了，它可以极大地方便了我们对依赖的管理。只要填写好pom.xml这个配置文件，那么Maven会自动为我们下载该jar包及其所依赖的jar包，所以这里我创建一个基于Maven的Spring MVC项目。

创建Maven项目，首先得安装好Maven环境。如未安装好环境，可参考文章：[Maven的安装和配置][Maven]。

下面是创建的详细步骤：

**1、新建项目**

![Center][]![Center 1][]

![Center 2][]![Center 3][]

![Center 4][]![Center 5][]

**2、解决项目报错**（没有报错则跳过此步骤）

新建了项目后，我发现项目中报了以下的错。

![Center 6][]

现解决一下。如果没有报错的话，就忽略此步骤。

解决方法：

（1）右击项目名 -> Buid Path -> Configure Build Path，

（2）选择Libraries选项卡，点击Add Library -> Server Runtime ，

（3）选择一个已建好的tomcat，没有建立tomcat的，请先配置好tomcat。

（4）点击 finish, 可看到如下截图。

![Center 7][]

点击Apply之后，正常情况下，可以看到项目的红叉已消失。

然后切换到Order and Export 选项：

![Center 8][]

点击上图的OK之后，可以看到，缺失的资源文件src/main/java和src/test/java已经有了。

注意：作为Maven项目必须包含以下4个资源文件夹，如果没有，需要手动创建。

![Center 9][]

新建资源文件夹的步骤：

![Center 10][]

![Center 11][]

4个资源文件建好之后，还需设置正确的Output folder。

![Center 12][]

![Center 13][]

**3****、更改配置文件pom.xml**

这是Maven的主要配置文件，可以在里面配置项目所需要的jar包。

<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>com.hello</groupId>
      <artifactId>HelloSpringMVC</artifactId>
      <version>0.0.1-SNAPSHOT</version>
      <name>HelloSpringMVC 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>${springVersion}</version>
        </dependency>
        <dependency>
        	<groupId>org.springframework</groupId>
        	<artifactId>spring-webmvc</artifactId>
        	<version>${springVersion}</version>
        </dependency>
      </dependencies>
      <build>
        <finalName>HelloSpringMVC</finalName>
      </build>
      <properties>
      	<springVersion>4.2.3.RELEASE</springVersion>
      </properties>
    </project>

![Center 14][]

**4、更改配置文件web.xml**

> **![Center 15][]**  
> 
> 
>   
> 
> 
>     <web-app 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_3_0.xsd"  
>           version="3.0">  
>         <display-name>HelloSpringMVC</display-name>
>        
>          
>         <servlet>  
>             <servlet-name>spring-mvc</servlet-name>  
>             <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> 
>            
>           	
>     		
>             <load-on-startup>1</load-on-startup>
>         </servlet>  
>       	
>       	
>         <servlet-mapping>  
>             <servlet-name>spring-mvc</servlet-name>     
>             <url-pattern>/</url-pattern>  
>         </servlet-mapping>  
>     </web-app>
> 
>   
>

**5、新建前端控制器配置文件**

> 因为这里使用的是默认的路径，所以只需要在WEB-INF目录下创建前端控制器文件。
> 
> 又因为在web.xml中配置的名称是spring-mvc，所以新建的文件名是spring-mvc-servlet。
> 
> ![Center 16][]  
>

![Center 17][]

**6、添加spring-mvc-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:p="http://www.springframework.org/schema/p" 
        xmlns:context="http://www.springframework.org/schema/context" 
        xmlns:mvc="http://www.springframework.org/schema/mvc" 
        xmlns:task="http://www.springframework.org/schema/task"
        xsi:schemaLocation="
            http://www.springframework.org/schema/beans 
            http://www.springframework.org/schema/beans/spring-beans-4.2.xsd 
            http://www.springframework.org/schema/context 
            http://www.springframework.org/schema/context/spring-context-4.2.xsd 
            http://www.springframework.org/schema/mvc 
            http://www.springframework.org/schema/mvc/spring-mvc-4.2.xsd 
            http://www.springframework.org/schema/task 
            http://www.springframework.org/schema/task/spring-task-4.2.xsd">
    
        
        <context:component-scan base-package="com.springmvc.controller" >
            <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
        </context:component-scan>
    
        
        <mvc:view-controller path="/" view-name="index"/>
    
        
        <mvc:annotation-driven />
    
        
        <mvc:resources location="/assets/" mapping="/assets/**"></mvc:resources>
    
        
        <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
            <property name="prefix" value="/WEB-INF/view/"/>
            <property name="suffix" value=".jsp"/>
        </bean>
    
    </beans>

![Center 18][]

**7、添加Controller类**

**![Center 19][]**

书写HelloController.java的内容

package com.springmvc.controller;
    
    import org.springframework.stereotype.Controller;
    import org.springframework.ui.Model;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RequestMethod;
    
    //url:  http://localhost:8080/HelloSpringMVC/hello/mvc
    
    //告诉DispatcherServlet相关的容器， 这是一个Controller，
    @Controller  
    
    //类级别的RequestMapping，告诉DispatcherServlet由这个类负责处理URL。
    //HandlerMapping依靠这个标签来工作
    @RequestMapping(value="/hello")  
    public class HelloController {
    		
    	//方法级别的RequestMapping， 限制并缩小了URL路径匹配，同类级别的标签协同工作，最终确定拦截到的URL由那个方法处理
    	//并指定访问方法为GET
    	  @RequestMapping(value="/mvc",method=RequestMethod.GET)  
    	    public String HelloWorld(Model model){  
    		  
    	        model.addAttribute("message","Hello Spring MVC!!!");  //传参数给前端
    	        
    	      //视图渲染，/WEB-INF/view/HelloWorld.jsp
    	        return "HelloWorld";  //页面的名称，根据此字符串会去寻找名为HelloWorld.jsp的页面
    	    }  
    }

**8、添加页面**

新建视图文件夹

![Center 20][]

![Center 21][]

新建页面

![Center 22][]

注意加.jsp后缀

![Center 23][]

添加页面内容：

![Image 1][]

<%@ page language="java" contentType="text/html; charset=UTF-8"  
        pageEncoding="UTF-8"%>  
    <!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=UTF-8">  
    <title>HelloSpringMVC</title>  
    </head>  
    <body>  
    <h1>message:${message}</h1>  
    <h1>this is my spring mvc</h1>  
    </body>  
    </html>

![Center 24][]

**9****、解决错误**（无错的可以跳过此步骤）

可以看到，自从添加了pom.xml的内容以后，项目是一直有红叉的，现在基本上Spring MVC的配置已经完成了，那么就来解决一下。

（1）右击项目名->Properties(在最下方) ->拖动左侧栏，找到Deployment Assembly ->移除多余部分。

![Center 25][]

注意：这里一定要确保Maven Dependencies在 Web Deployment Assembly 中，否则无法访问controller中的url。

（2）将Maven Dependencies从Build Path中移除。

![Center 26][]

（3）进入Configure Build Path，重新添加Maven Dependencies这个Library

![Center 27][]![Center 28][]

![Center 29][]![Center 30][]

![Center 31][]![Center 32][]

正常情况下，项目已经没有不报错了。

**10、运行项目**

**![Center 33][]**

![Center 34][]

![Center 35][]

![Center 36][]

上面的这个controller对应的页面如下：

![Center 37][]

至此，基于Maven+Spring MVC的HelloWord项目已创建完毕。

[源码下载][Link 1]

[Maven]: http://blog.csdn.net/u012660464/article/details/53068419
[Center]: https://img-blog.csdn.net/20161117142318795?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQv/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center
[Center 1]: /images/20220715/b522143dfb8144a9b51a2dc8710a96aa.png
[Center 2]: https://img-blog.csdn.net/20161117142534298?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQv/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center
[Center 3]: /images/20220715/cc9e155c1d7a447ab5b466a6adf12495.png
[Center 4]: https://img-blog.csdn.net/20161117144243694?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQv/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center
[Center 5]: /images/20220715/032a220476e348a482bd2a80ed76af82.png
[Center 6]: /images/20220715/172834dd71e24c559f22071424e1fc89.png
[Center 7]: /images/20220715/5335cfc3fea44297b4deb20ba788b108.png
[Center 8]: /images/20220715/da6a89183157432a8583563bfe9dc8f8.png
[Center 9]: /images/20220715/70da11c407584f0eba6714b139ffd1f7.png
[Center 10]: /images/20220715/5ea1ab63178645f98e079f56fe77c754.png
[Center 11]: /images/20220715/6c150ad1d00e4ac1afd2d4b18789f565.png
[Center 12]: /images/20220715/875c59a42b6a4cd9be49e786d2ec85ea.png
[Center 13]: /images/20220715/2867b846d6624d2c97510d8f5a517d5d.png
[Center 14]: /images/20220715/ad81bfa038094689a6b84d5f878592db.png
[Center 15]: /images/20220715/5da584a9489b43c3806f8219463b2f37.png
[Center 16]: /images/20220715/a777fbae2070414e8f56f9b7f8037eee.png
[Center 17]: /images/20220715/34043cd9fada42f1a75a2791668ae5e0.png
[Center 18]: /images/20220715/b2df66c4086f4692a39d05495b06f252.png
[Center 19]: /images/20220715/98622b7a0a374e9f9158d7174d0db735.png
[Center 20]: /images/20220715/f17e31604b7e401f97240ef55ddb91bc.png
[Center 21]: /images/20220715/995a732c92804939973954172786b80c.png
[Center 22]: /images/20220715/65160f5e0cd8485da020d415bfd5d057.png
[Center 23]: /images/20220715/1598099eb1dd4eed95b59bfd8ab05e8f.png
[Image 1]: 
[Center 24]: /images/20220715/0e87d8bd1fdd4005b2668e91d1306f0b.png
[Center 25]: /images/20220715/9ea1c52d9551472daed6bd7a5d7e5956.png
[Center 26]: /images/20220715/872ea73eb91342e88fcc7c0c2488b6ea.png
[Center 27]: https://img-blog.csdn.net/20161117172453561?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQv/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center
[Center 28]: /images/20220715/444ee4f85b19486aa41cc8fab50eda18.png
[Center 29]: https://img-blog.csdn.net/20161117172921965?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQv/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center
[Center 30]: /images/20220715/8304bd2f010943a4a1049bd8fb00c56c.png
[Center 31]: https://img-blog.csdn.net/20161117173021703?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQv/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center
[Center 32]: /images/20220715/31d4b6c4de6e436494dbe27a29ea5ef1.png
[Center 33]: /images/20220715/2df003f1657248d7bf781c12f37cfd7f.png
[Center 34]: /images/20220715/9b40fd56fd9b47b59225187690181bda.png
[Center 35]: /images/20220715/d1baadf67fba4c0581c9f59961c6ee04.png
[Center 36]: /images/20220715/413a5e872d404a298b1a7b429830f2cb.png
[Center 37]: /images/20220715/45be0f298f13456091d1d5f761c568af.png
[Link 1]: http://download.csdn.net/detail/u012660464/9695653