本程序是一个maven程序,使用maven方便管理jar包和程序,简化了操作步骤。本程序的目的是通过一个简单的程序,了解Spring MVC框架的基本工作流程,由简入繁的学习Spring MVC框架,而不是直白无聊的理论知识堆积。
新建maven项目
新建的maven项目一般会报这个错误,错误的原因也很简单,右击项目–>Properties–>Java Build Path–>Libraries–>Add Library–>Server Runtime 选择一个服务器即可,点击Finish。此时项目应该不会报错,下图就是正常情况下的maven项目列表
配置各种xml
即便是使用注解的方式,xml这种配置文件也是少不了的,本项目中使用到的xml文件有三个:spring-mvc.xml、web.xml、pom.xml。
(1)spring-mvc.xml
这个是spring的核心配置文件代码如下:
<?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"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-4.0.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-4.0.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">
<!-- 自动扫描该包,使SpringMVC认为包下用了@controller注解的类是控制器,记得换成自己的包名 -->
<context:component-scan base-package="com.cn.test.controller" />
<!-- 定义跳转的文件的前后缀 ,视图模式配置-->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<!-- 将action的方法setview()return的字符串加上前缀和后缀,变成一个 可用的url地址 -->
<property name="prefix" value="/html/" />
<property name="suffix" value=".html" />
</bean>
</beans>
(2)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.cn.EPhotoAlbum</groupId>
<artifactId>EPhotoAlbum</artifactId>
<packaging>war</packaging>
<version>0.0.1-SNAPSHOT</version>
<name>EPhotoAlbum Maven Webapp</name>
<url>http://maven.apache.org</url>
<properties>
<!-- spring版本号 -->
<spring.version>4.0.2.RELEASE</spring.version>
<!-- mybatis版本号 -->
<mybatis.version>3.2.6</mybatis.version>
<!-- log4j日志文件管理包版本 -->
<slf4j.version>1.7.7</slf4j.version>
<log4j.version>1.2.17</log4j.version>
</properties>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.11</version>
<scope>test</scope>
</dependency>
<!-- spring核心包 -->
<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-oxm</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-tx</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-jdbc</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-aop</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context-support</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-test</artifactId>
<version>${spring.version}</version>
</dependency>
<!-- mybatis核心包 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>${mybatis.version}</version>
</dependency>
<!-- mybatis/spring包 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-spring</artifactId>
<version>1.2.2</version>
</dependency>
<!-- 导入java ee jar 包 -->
<dependency>
<groupId>javax</groupId>
<artifactId>javaee-api</artifactId>
<version>7.0</version>
</dependency>
<!-- 导入dbcp的jar包,用来在applicationContext.xml中配置数据库 -->
<dependency>
<groupId>commons-dbcp</groupId>
<artifactId>commons-dbcp</artifactId>
<version>1.2.2</version>
</dependency>
<!-- JSTL标签类 -->
<dependency>
<groupId>jstl</groupId>
<artifactId>jstl</artifactId>
<version>1.2</version>
</dependency>
<!-- 日志文件管理包 -->
<!-- log start -->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>${log4j.version}</version>
</dependency>
<!-- 映入JSON -->
<dependency>
<groupId>org.codehaus.jackson</groupId>
<artifactId>jackson-mapper-asl</artifactId>
<version>1.9.13</version>
</dependency>
</dependencies>
<build>
<finalName>test</finalName>
</build>
</project>
(3)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"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
id="WebApp_ID" version="3.0">
<!-- 配置DispatchcerServlet -->
<servlet>
<servlet-name>springDispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!-- 配置Spring mvc下的配置文件的位置和名称 -->
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:spring-mvc.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>springDispatcherServlet</servlet-name>
<url-pattern>*.do</url-pattern>
</servlet-mapping>
<!-- 编码过滤器 -->
<filter>
<filter-name>encodingFilter</filter-name>
<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
<async-supported>true</async-supported>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>encodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>
创建Controller
controller文件的一个标志就是在类的前面有一个@Controller的注解,我们创建这些类的时候,可以先创建一个普通的类,然后在类中的类名前面加上@Controller,如下图所示:
此外在SSM框架中的service层和dao层都有它们各自的标志性注解(当然现在已经不分的那么清楚了),如service层的@Service,dao层的@Repository,这些注解将会在以后的博文中进行介绍。
从上图中我们也可以看到,紧接着@Controller的是@RequestMapping(value=”/test”),这个注解的作用就是给我们的类标注一个访问地址,如果它出现在一个方法的前面,那就是给一个方法添加一个访问地址(访问时记得带上它所在类的访问地址)。
controller中的方法可以有三种返回类型ModelAndView、String和void,这几种方法都是经常使用到的。
(1)返回ModelAndView
ModelAndView,里面包含着model和view(名字起的就是这个直白),他是一个比较复杂的类,但是构造函数就有7个,今天我们只做hello world 所以就不详细讲解了,不过现在你可以将它理解为一个大容器,里面可以放许多你想要向前台传递的东西。
@Controller
@RequestMapping(value="/test")
public class UserController {
public ModelAndView user(){
//新建一个ModelAndView
ModelAndView mv = new ModelAndView();
//返回的html页面的名字,对应配置文件
mv.setViewName("hello");
return mv;
}
}
上述代码中,我们可以使用mv.setViewName(“hello”),这个方法指定我们想要返回的页面。
(2)返回String
public String userString(){
//在这里直接返回我们想要返回的页面名称
return "hello";
}
在return中就可以直接返回我们想要返回的页面。
(3)返回void
这个最直接,就是在这个方法执行完之后,什么都不返回,但我们任然可以做一些操作。
public void userVoid(){
ModelAndView mv = new ModelAndView();
//返回的html页面的名字,对应配置文件
mv.setViewName("hello");
}
我写的上述三个方法的作用都是将页面转到一个名叫“hello.html”的页面。为了方便以后的学习我们可以使用第一中方法。注意在方法上面追加了一个注解用于访问时作为访问路径。
@RequestMapping(value="/user")
public ModelAndView user(){
ModelAndView mv = new ModelAndView();
//返回的html页面的名字,对应配置文件
mv.setViewName("hello");
return mv;
}
创建html文件
在上面我们提到的hello.html文件将会在这里创建,首先我们在src–>webapp下面新建一个html文件夹,方便存放html文件,然后在html文件夹下面新建一个名叫hello.html的html文件,代码如下:
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>第一个springmvc项目</title>
</head>
<body>
<h1>Hello World!!!</h1>
</body>
</html>
就是这个简单,因为是刚刚学习,太复杂的话容易报错,从而降低我们的学习热情。
接下来就是我们新建项目的时候自动生成的index.jsp文件,它的作用只是点击之后就会转向hello页面,当然是通过controller跳转的。
index.jsp代码
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<html>
<body>
<a href="/test/test/user.do">点我就变</a>
</body>
</html>
启动项目
至此,一个简单的hello world程序已经完成,最后上一张项目完成之后的图片:
启动项目,点击pom运行加载jar包,然后启动tomcat服务器,在浏览器中输入url,首先访问index.jsp
http://localhost:8090/test/index.jsp
点击“点我就变”就会跳转到hello.html页面,注意地址栏中的变化,这个地址就是我们的项目名/类的注解访问地址/方法的注解访问地址.do(web.xml文件中的配置,可以自行更改)
总结
到这里我们的第一个spring mvc也就完成了,虽然它很简单,但是作为一个入门的hello world程序,如果我们能够认真完成它,对于以后的springmvc 学习也是具有鼓励作用。如果大家遇到什么问题,可以再评论中指出,大家共同学习探讨。