1 环境版本说明
Jdk : 1.8
Maven : 3.5
IDEA : 专业版 2017.2
2 环境准备
2.1 Maven安装及其配置
2.2 Tomcat安装及其配置
3 详细步骤
3.1 根据模板创建maven工程
file -> new -> project -> maven -> webapp
技巧01:根据模板创建web工程时,请选择 maven-archetype-webapp
3.2 目录结构调整
项目创建成功后的目录结构如下:
跳坑01:新创建的项目中没有存放源文件的java文件夹,也没有存放测试文件的test文件夹,同样没有存放资源文件的resources文件夹
跳坑01:在main目录下新建java、resources两个文件夹,分别用来存放源文件和资源文件;在main的同级目录中新建test目录用来存放测试文件夹
技巧01:虽然我们创建了相关的文件夹,但是IDEA并不知道java文件夹是用来存放源文件,test用来存放测试文件,resources用来存放资源文件的;我们必须进行手动配置:
说明:是在main的统计目录中创建一个文件夹名为test,再在test中创建一个java文件夹,并将这个java文件夹指定为存放测试文件的包(本博文是之间将test文件夹指定成了存放测试文件的地方)
file -> project structure -> modules
设置完后整个目录结构如下:
3.3 配置tomcat
3.3.1 打开启动配置页面
3.3.2 添加tomcat启动项
3.3.3 配置tomcat基本信息
3.3.4 添加web模块
技巧01:为项目添加一个web模块,file -> project structure -> module
跳坑01:利用IDEA创建项目时会在main目录下创建一个webapp文件夹,该文件夹里面的内容就是需要被部署到tomcat容器的内容,但是我们为项目添加了web模块后会自动在项目的根目录下生成一个web文件夹【建议将这个web文件夹删掉】,这个文件夹的作用和main目录下的webapp文件夹的作用相同,而且添加web模块时自动寻找的是新创建的web文件夹下面的web.xml文件;将web.xml改成webapp下面的web.xml,并将web的源文件文件夹改成webapp,修改后的效果如下:
3.3.5 添加artifacts
技巧01:添加一个web应用,这个web引用来源于modules【其实就是来源于我们创建的web工程】
3.3.6 配置发布页面
将 artifacts 中配置为web应用添加到tomcat配置中的deployment
3.3.7 配置开发热部署
就是修改前后台代码后不用重启tomcat,IDEA会自动进行【修改后台时自动重启tomcat服务器,修改前台时刷新浏览器就可以啦】
3.3.8 启动测试
直接通过IDEA启动tomcat就可以啦
技巧01:应用启动成功后,会自动访问webapp里面的index.jsp页面
4 添加框架支持
我们创建的Web应用知识一个架子,不过IDEA支持自动添加框架;这样就不需要手动在pom.xml中添加相关框架的依赖配置了
右键项目 -> add framework stupport
技巧01:本博文主要添加spring框架的支持
技巧02:点击确认后会自动将spring框架的依赖包下载到项目中去【PS: 是直接将依赖下载到项目中的lib目录下】,整个过程有点花时间
跳坑01:如果下载依赖期间由于网络原因失败,这时候就需要重新添加框架;但是这时候发现已经没有spring相关的选项了
填坑01:这是后就需要进入到项目结构中的modules配置中,将spring相关的模块删除,在重新进行框架添加
技巧03:添加完spring框架支持后会在webapp文件夹下自动生成相关的配置文件,并在webapp中的web.xml中对这些配置文件记性监听配置
5 Bean相关
Bean相关的详细内容请参见《精通spring4.x企业应用开发实战》
5.1 配置bean
5.1.1 准备
在pom.xml文件中引入lombok依赖
创建Student类和Teacher类
package domain; import lombok.Data; /** * @author 王杨帅 * @create 2018-08-10 20:43 * @desc 學生實體類 **/ @Data public class Student { private String id; private String name; private Integer age; private String address; public void info() { System.out.println("我是學生,我在學習控制反轉相關知識點。"); } }
package domain; /** * @author 王杨帅 * @create 2018-08-10 20:45 * @desc 老師實體類 **/ public class Teacher { private String id; private String name; private Integer age; private String address; public void info() { System.out.println("我是老师,我在教授IOC相关知识点。"); } }
5.1.2 利用xml配置
技巧01:需要将配置文件放到resources文件夹下【之前通过添加spring框架支持时产生的配置文件位于webapp下面,移动后需要更改web.xml配置文件???待修改】
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.xsd"> class="domain.Student">
5.1.3 利用类注解配置
package core.config; import domain.Teacher; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; /** * @author 王杨帅 * @create 2018-08-10 20:59 * @desc bean配置类 **/ @Configuration public class Beans { @Bean(value = "teacher") public Teacher buildTeacher() { return new Teacher(); } }
5.2 获取bean
5.2.1 利用BeanFactory获取
/** * 利用BeanFactory获取bean * @throws IOException */ @Test public void test01() throws IOException { System.out.println("Hello Boy"); ResourcePatternResolver resolver = new PathMatchingResourcePatternResolver(); Resource resource = resolver.getResource("classpath:applicationContext.xml"); System.out.println(resource.getURL()); DefaultListableBeanFactory factory = new DefaultListableBeanFactory(); XmlBeanDefinitionReader reader = new XmlBeanDefinitionReader(factory); reader.loadBeanDefinitions(resource); System.out.println("初始化BeanFactory完毕"); Student student = factory.getBean("student", Student.class); System.out.println("student bean 获取成功"); student.info(); }
5.2.2. 利用ApplicationContext获取
技巧01:利用ApplicationContext获取xml配置的bean和配置类配置的bean需要用不同的实现类
/** * 利用ApplicationContext獲取bean */ @Test public void test02() { ApplicationContext applicationContext = new ClassPathXmlApplicationContext("classpath:applicationContext.xml"); Student student = applicationContext.getBean("student", Student.class); student.info(); } /** * 利用ApplicationContext获取配置类配置的bean */ @Test public void test03() { ApplicationContext applicationContext = new AnnotationConfigApplicationContext(Beans.class); Teacher teacher = applicationContext.getBean("teacher", Teacher.class); teacher.info(); }
5.2.3 获取bean代码汇总
package domain; import core.config.Beans; import org.junit.Before; import org.junit.Test; import org.springframework.beans.factory.support.DefaultListableBeanFactory; import org.springframework.beans.factory.xml.XmlBeanDefinitionReader; import org.springframework.context.ApplicationContext; import org.springframework.context.annotation.AnnotationConfigApplicationContext; import org.springframework.context.support.ClassPathXmlApplicationContext; import org.springframework.core.io.Resource; import org.springframework.core.io.support.PathMatchingResourcePatternResolver; import org.springframework.core.io.support.ResourcePatternResolver; import java.io.IOException; /** * @author 王杨帅 * @create 2018-08-10 20:47 * @desc 测试类 **/ public class TestDemo { @Before public void init() { System.out.println("初始化方法"); } /** * 利用BeanFactory获取bean * @throws IOException */ @Test public void test01() throws IOException { System.out.println("Hello Boy"); ResourcePatternResolver resolver = new PathMatchingResourcePatternResolver(); Resource resource = resolver.getResource("classpath:applicationContext.xml"); System.out.println(resource.getURL()); DefaultListableBeanFactory factory = new DefaultListableBeanFactory(); XmlBeanDefinitionReader reader = new XmlBeanDefinitionReader(factory); reader.loadBeanDefinitions(resource); System.out.println("初始化BeanFactory完毕"); Student student = factory.getBean("student", Student.class); System.out.println("student bean 获取成功"); student.info(); } /** * 利用ApplicationContext獲取bean */ @Test public void test02() { ApplicationContext applicationContext = new ClassPathXmlApplicationContext("classpath:applicationContext.xml"); Student student = applicationContext.getBean("student", Student.class); student.info(); } /** * 利用ApplicationContext获取配置类配置的bean */ @Test public void test03() { ApplicationContext applicationContext = new AnnotationConfigApplicationContext(Beans.class); Teacher teacher = applicationContext.getBean("teacher", Teacher.class); teacher.info(); } }
6 web.xml配置
6.1 当前项目出现的问题
由于我们在5.1.2的时候将bean相关的配置文件都移动到了resources目录下,但是web.xml中还没有做对应的修改;默认web.xml的配置文件是放在WEB-INF下面的,默认的web.xml配置文件信息如下
我们将配置文件移动到resources目录下后,在不更改web.xml配置文件的情况下启动taomcat运行项目的报错信息如下(报错原因就是web.xml的配置中还是在WEB-INF下面去寻找配置文件,但是我们已经将配置文件移动到了resources目录下,所以会报IO异常):
6.2 修改web.xml中的配置文件路径
技巧01:如果在web.xml中不写任何参数配置信息,默认的路径是"/WEB-INF/applicationContext.xml, 在WEB-INF目录下创建的xml文件的名称必须是applicationContext.xml
技巧02:可以同时配置多个配置文件路径信息,它们之间用逗号隔开
6.3 再次启动的效果
启动结果:修改完web.xml中的配置文件路径后,再次启动容器时,虽然可以正常启动,但是在启动时会报一个错误,错误信息如下:
报错原因:使用springMVC时需要配置DispatcherServlet,而 DispatcherServlet 需要一个配置文件,该配置文件的默认值时WEB-INF下面的dispatcher-servlet.xml,我们已经将其移动到了resouces目录下,所以会报错。
解决办法:在配置DispatcherServlet 时利用
6.4 web.xml配置详情
xml version="1.0" encoding="UTF-8"?>
<web-app version="3.0" 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">
<filter>
<filter-name>characterEncodingFilterfilter-name>
<filter-class>org.springframework.web.filter.CharacterEncodingFilterfilter-class>
<init-param>
<param-name>encodingparam-name>
<param-value>UTF-8param-value>
init-param>
<init-param>
<param-name>forceEncodingparam-name>
<param-value>trueparam-value>
init-param>
filter>
<filter-mapping>
<filter-name>characterEncodingFilterfilter-name>
<url-pattern>/*url-pattern>
filter-mapping>
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListenerlistener-class>
listener>
<context-param>
<param-name>contextConfigLocationparam-name>
<param-value>classpath:spring/applicationContext.xmlparam-value>
context-param>
<servlet-mapping>
<servlet-name>defaultservlet-name>
<url-pattern>*.cssurl-pattern>
servlet-mapping>
<servlet-mapping>
<servlet-name>defaultservlet-name>
<url-pattern>*.swfurl-pattern>
servlet-mapping>
<servlet-mapping>
<servlet-name>defaultservlet-name>
<url-pattern>*.gifurl-pattern>
servlet-mapping>
<servlet-mapping>
<servlet-name>defaultservlet-name>
<url-pattern>*.jpgurl-pattern>
servlet-mapping>
<servlet-mapping>
<servlet-name>defaultservlet-name>
<url-pattern>*.pngurl-pattern>
servlet-mapping>
<servlet-mapping>
<servlet-name>defaultservlet-name>
<url-pattern>*.jsurl-pattern>
servlet-mapping>
<servlet-mapping>
<servlet-name>defaultservlet-name>
<url-pattern>*.htmlurl-pattern>
servlet-mapping>
<servlet-mapping>
<servlet-name>defaultservlet-name>
<url-pattern>*.xmlurl-pattern>
servlet-mapping>
<servlet-mapping>
<servlet-name>defaultservlet-name>
<url-pattern>*.jsonurl-pattern>
servlet-mapping>
<servlet-mapping>
<servlet-name>defaultservlet-name>
<url-pattern>*.mapurl-pattern>
servlet-mapping>
<servlet>
<servlet-name>DispatcherServletservlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServletservlet-class>
<init-param>
<param-name>contextConfigLocationparam-name>
<param-value>classpath:spring/dispatcher-servlet.xmlparam-value>
init-param>
<load-on-startup>1load-on-startup>
servlet>
<servlet-mapping>
<servlet-name>DispatcherServletservlet-name>
<url-pattern>/url-pattern>
servlet-mapping>
<welcome-file-list>
<welcome-file>login.htmlwelcome-file>
welcome-file-list>
<error-page>
<error-code>404error-code>
<location>/nopage.htmllocation>
error-page>
<error-page>
<exception-type>java.lang.NullPointerExceptionexception-type>
<location>/error.htmllocation>
error-page>
<session-config>
<session-timeout>360session-timeout>
session-config>
web-app>
参考博文
7 利用注解配置Bean
利用XML或者java配置类来配置Bean都比较麻烦,从spring2.0开始就支持利用注解来配置Bean,常用的注解如下(详情参见《精通Spring4.x企业应用开发实战》P155):
@Repository
@Service
@Controller
@Component
7.1 注解配置Bean实战
7.1.1 创建一个实例
技巧01:在该注解上添加@Component注解
技巧02:通过注解配置Bean时默认的Bean名称是对应类的类名首字母小写后的结果,当然也可以通过注解的value属性进行指定
package domain; import lombok.Data; import org.springframework.stereotype.Component; /** * @author 王杨帅 * @create 2018-08-11 15:46 * @desc **/ @Data @Component public class Dog { private String id; private String name; public void info() { System.out.println("我是哮天犬"); } }
7.1.2 配置Bean配置注解扫描
技巧01:在配置文件中添加扫描类包来应用注解定义的Bean
技巧02:配置前扫描包前需要在配置文件中先进行命名空间的声明(详情参见《精通Spring4.x企业应用开发实战》P117)
7.1.3 测试一下
@Test public void test01() { ApplicationContext applicationContext = new ClassPathXmlApplicationContext("classpath:applicationContext.xml"); Dog dog = applicationContext.getBean("dog", Dog.class); dog.info(); }
跳坑01:直接利用@Autowired进行依赖注入配置好的Bean是总是失败,错误信息如下
填坑01:参考博文
8 自动装配Bean
传统的注入方式有:构造器注入、set注入(属性注入)、工厂方法注入(详情参见《精通Spring4.x企业应用开发实战》P121)
实现依赖注入的注解有(详情参见《精通Spring4.x企业应用开发实战》P157):
@Autowired -> 根据类型注入【推荐使用】
@Resource -> 根据Bean名称注入
@Inject -> 根据类型注入
9 MVC配置
前后端分离的项目,后台根据不同的URL调用不同的类及其方法进行逻辑操作,操作完毕后后台需要向前台返回JSON的数据。
9.1 配置步骤
9.1.1 修改web.xml中DispatcherServlet配置
技巧01:DispacherServlet是用来拦截请求的,前后端分离项目中DispacherServlet会将拦截到的请求url分发到对应的类进行逻辑处理
技巧02:默认的DispacherServlet配置只是拦截 .form 结尾的请求url,本案例修改为拦截请求url中带 / 的所有请求
9.1.2 利用注解编写控制层
技巧01:控制层就是处理DispatcherServlet拦截到的请求url的类【就是进行逻辑处理的入口】
技巧02:lombok的日志使用logback实现的,所以需要导入logback依赖
org.projectlombok lombok 1.16.20 provided ch.qos.logback logback-classic 1.2.3
package cn.xiangxu.controller; import lombok.extern.slf4j.Slf4j; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; /** * @author 王杨帅 * @create 2018-08-11 16:22 * @desc **/ @RestController @RequestMapping(value = "/test") @Slf4j public class TestConroller { @GetMapping public String test01() { String result = "前后台连接测试"; log.info(result); return result; } }
9.1.3 开启MVC注解支持
10 本博文参考源代码
点击下载源代码
11 参考博文
项目创建
添加框架依赖
web.xml配置详解
springMVC配置详解