【spring MVC】新手从零新建第一个hello world项目

说明

本文适合一个没有搭建过spring MVC项目的新手（甚至没怎么参与过java相关项目的新手）参阅！
这也是arvik参考网络文章学习spring MVC搭建的一个笔记

软件安装

安装jdk

安装最新版jdk，目前是9.0.4，地址 http://www.oracle.com/technetwork/java/javase/downloads/index.html ，直接下载安装包后安装，安装包会自动设置环境变量不需要手动去配置path变量

这里写图片描述

打开windows命令行窗口运行命令检查jdk是否成功安装，如下运行java -version，显示如下结果

Microsoft Windows [版本 6.1.7601]
版权所有 (c) 2009 Microsoft Corporation。保留所有权利。

C:\Users\Administrator>java -version
java version "9.0.4"
Java(TM) SE Runtime Environment (build 9.0.4+11)
Java HotSpot(TM) 64-Bit Server VM (build 9.0.4+11, mixed mode)

C:\Users\Administrator>

安装eclipse

jdk选择的是64位，eclipse也要是64位，地址https://www.eclipse.org/downloads/，选择XOYGEN版本（最新版）

这里写图片描述

安装tomcat

直接选择最新版，地址https://tomcat.apache.org，目前9.0.4最新。按照截图步骤下载安装包（不要解压包，安装包在安装过程中会自动配置环境变量）

这里写图片描述

如果安装过程需要配置jre地址，则填写安装jdk时附带的jre安装地址

安装运行后，浏览器打开localhost:8080，看到tomcat默认首页则成功
这里写图片描述

提示

扫描二维码关注公众号，回复： 2768809 查看本文章

以上步骤通通不需要手动去设置环境变量，没有其它地方介绍的一堆那么复杂的环境变量配置。

安装maven

地址http://maven.apache.org/download.cgi，选择最新版，目前是3.5.2，下载zip压缩包

这里写图片描述

将maven解压目录末尾追加/bin加入path变量

最新的eclipse应该集成了maven，可能不是最新的maven，但是能用，也可更改为最新下载的maven，eclipse更改如下，window---->preference--->maven

在installations选择想要的maven版本

这里写图片描述

然后在user settings填上maven的配置文件路径
打开maven配置文件settings.xml文件，找到<localRepository>path/to/your/repository </localRepository>的地方，其中D:\app\maven\maven_repository更改为自己的maven仓库位置（自己设定），也就是存放公共java包的地方。

<localRepository>D:\app\maven\maven_repository</localRepository>

新建项目

打开eclipse指定workspace地址后，file--->new--->maven project或者file--->new---other搜索找到maven project

这里写图片描述

新建目录com/main/java，自己的java包就可建立在这个里面，在src/main/java下建立包com.test

这里写图片描述

配置tomcat

这里写图片描述

在com.test包下新建一个class，取名HelloWorldController
这里写图片描述

这里写图片描述

配置项目根目录下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/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.arvik</groupId>
  <artifactId>helloworld</artifactId>
  <packaging>war</packaging>
  <version>0.0.1-SNAPSHOT</version>
  <name>helloworld Maven Webapp</name>
  <url>http://maven.apache.org</url>
  <properties>
    <spring.version>4.1.1.RELEASE</spring.version>
  </properties>

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

<!--     <dependency>
         <groupId>javax.servlet</groupId>
         <artifactId>javax.servlet-api</artifactId>
         <version>3.1.0</version>
     </dependency>    -->

         <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-web</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>${spring.version}</version>
    </dependency>

    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>3.1.0</version>
    </dependency>


  </dependencies>
  <build>
    <finalName>helloworld</finalName>
  </build>
</project>

配置web.xml，在src/main/webapp/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:jsp="http://java.sun.com/xml/ns/javaee/jsp"
 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"
 version="2.5">
  <display-name>Archetype Created Web Application</display-name>

  <servlet>
      <servlet-name>dispatcher</servlet-name>
      <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
          <init-param>
             <param-name>contextConfigLocation</param-name>
          <param-value>classpath:springContext.xml</param-value>
      </init-param>
      <load-on-startup>1</load-on-startup>
  </servlet>

  <servlet-mapping>
      <servlet-name>dispatcher</servlet-name>
      <url-pattern>/</url-pattern>
  </servlet-mapping>

  <context-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:springContext.xml</param-value>
  </context-param>

  <listener>
      <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
  </listener>    

</web-app>

在/src/main/java目录下新建springContext.xml文件

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:context="http://www.springframework.org/schema/context"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    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控件 -->
    <context:component-scan base-package="com.test"></context:component-scan>
    <!-- 视图页面配置 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix">
            <value>/WEB-INF/views/</value>
        </property>
        <property name="suffix">
            <value>.jsp</value>
        </property>
    </bean>
</beans>

效果

右键运行项目，helloworld--->run as--->run on server（初次运行可能弹出框需要选择tomcat V9.0），即可看到，如图内容
这里写图片描述

显示的helloworld就是默认/src/main/webapp/下的index.jsp展示的内容，index.jsp内容如下

<html>
<body>
<h2>Hello World!</h2>
</body>
</html>

更近一步显示hello world

这次用spring MVC框架方法来返回显示一个`Hello World, Ideas worth spreading!`字符串

在com.test包下的HelloWorldController.java输入如下内容

package com.test;

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

@Controller
public class HelloWorldController {
    @RequestMapping(value = "/say") 
    @ResponseBody
    public String showhello() {

        String str = "Hello World, Ideas worth spreading! ";
        return str;
    }  
}

这里写图片描述

项目基本搭建完成，基本例子也跑通！