一、spring boot简介
spring boot是最近非常流行的，在spring的框架上改进的框架。该框架的目的是为了提高开发人员的速度，降低配置的难度等等，极大了简化了开发流程。具体的详细的说明请参考官方文档。在日常工作中，由于需要搭建一套环境或者框架的机会非常的少，大部分都是在原有的基础上开发，所以当让你搭建一个简单的框架，就会出现各种各样的困难，比如说，我在搭建的一个服务器的时候，准备了一个小的demo，原以为非常的简单，结果遇到了各种各样的问题，而发现网上的博客都是零零散散的讲一些点，很难有一个完整的流程，包括可能会遇到的问题。这里对搭建一个简单的项目流程做一个详细的总结，方便日后参考，同时这一篇博客也是为了下一篇博客tengine反向代理服务器搭建做一点前置的基础准备。
二、spring boot搭建web项目
好了废话，不多说，下面正式开始单间一个web项目，使用的工具是eclipse来进行搭建，创建一个maven工程。下面开启贴图模式，这前面的过程都是非常的简单，网上也有大量的参考资料，这里为了保证一个完整性，开始贴图。
首先就是很简单，右击-->new-->project 选择maven project
然后选择一个默认的配置即可，一般包含的文件都会在里面。
这里填写好group id其实就是包名，后面也可以更改的，还有artifiact id就是工程名称，然后单击完成，就创建一个简单的maven工程。
具体的工程目录如下所示
按照上面的流程建好了工程之后，可以查看到具体的工程目录如下，这里作为一个web项目还缺少如下相关目录用来存放web文件和配置文件。
这些文件夹手动添加即可，添加完成之后，具体得到的如下图所示：
要想把这个项目跑起来，需要做一下几个步骤：
1. 首先需要配置一下pom.xml文件，引入spring-boot的相关依赖文件 ，这个是最基本的包，里面包含了运行的相关组件，例如tomcat，以及其他的jar包
-
<parent>
-
<groupId>org.springframework.boot
</groupId>
-
<artifactId>spring-boot-starter-parent
</artifactId>
-
<version>1.5.10.RELEASE
</version>
-
</parent>
-
<dependency>
-
<groupId>org.springframework.boot
</groupId>
-
<artifactId>spring-boot-starter-web
</artifactId>
-
</dependency>
-
<!-- JSTL for JSP spring boot搭建web项目，跳转到jsp一定要添加下面的jar包，否则出现跳转的时候，变成下载的功能，保存该页面-->
-
<dependency>
-
<groupId>javax.servlet
</groupId>
-
<artifactId>jstl
</artifactId>
-
</dependency>
-
-
<!-- Need this to compile JSP -->
-
<dependency>
-
<groupId>org.apache.tomcat.embed
</groupId>
-
<artifactId>tomcat-embed-jasper
</artifactId>
-
<scope>provided
</scope>
-
</dependency>
这里面还有一个坑，在新版本的spring boot中是按上面的配置，但是在老的版本中是如下的用法,名称不一样，这里需要注意一下，否则对于新学者来说，又要懵逼半天了...
然后需要创建jsp的页面了，在添加的源码包src/main/webapp的下面添加jsp文件，注意，webapp是默认的路径，如果想继续分类，则可以在该文件夹下面进行添加，比如说添加一个pages文件夹，jsp文件都放在这里面，那么spring.mvc.view.prefix=/pages/ 否则会找不到对应的文件。大体的目录结构如下所示：
对于jsp页面中，就写入一点简单的测试语句就行了
-
<%@ 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>Insert title here
</title>
-
</head>
-
<body>
-
hello world!!!
-
name=${name } welcome!
-
-
</body>
-
</html>
好了，上面的步骤都完成之后，这里，只要编写简单的Controller即可，这里面提供了两个跳转路径一个是/home，一个是/home/page，一个是携带返回值，一个没有返回相应结果。
-
@Controller
-
public
class HomeController {
-
-
@RequestMapping(value=
"/home")
-
public String home(){
-
System.out.println(
"redirect to home page!");
-
return
"index";
-
}
-
-
-
@RequestMapping(value=
"/home/page")
-
@ResponseBody
-
public ModelAndView goHome(){
-
System.out.println(
"go to the home page!");
-
ModelAndView mode =
new ModelAndView();
-
mode.addObject(
"name",
"zhangsan");
-
mode.setViewName(
"index");
-
return mode;
-
}
-
}
然后在App类中，添加如下代码:
-
@SpringBootApplication
-
public
class App
-
{
-
public static void main( String[] args )
-
{
-
SpringApplication.run(App.class);
-
}
-
}
写好上面的Controller之后，在App类上面右击，选择Run Application执行main函数，看到控制台输出如下，说明spring boot启动成功
-
. ____ _ __ _ _
-
/\\ / ___
'_ __ _ _(_)_ __ __ _ \ \ \ \
-
( ( )\___ |
'_ | '_| | '_ \/ _` | \ \ \ \
-
\\/ ___)| |_)| | | | | || (_| | ) ) ) )
-
' |____| .__|_| |_|_| |_\__, | / / / /
-
=========|_|==============|___/=/_/_/_/
-
:: Spring Boot :: (v1
.5
.10.RELEASE)
-
-
2018
-03
-01
17:
32:
42.069 INFO
64878 --- [ main] com.spring.example.App : Starting App
on fhldeMacBook-Air.local
with PID
64878 (/Users/fhl/Documents/workspace1/spring-boot-example/target/classes started
by fhl
in /Users/fhl/Documents/workspace1/spring-boot-example)
-
2018
-03
-01
17:
32:
42.074 INFO
64878 --- [ main] com.spring.example.App : No active profile
set, falling back
to
default profiles:
default
-
2018
-03
-01
17:
32:
42.175 INFO
64878 --- [ main] ationConfigEmbeddedWebApplicationContext : Refreshing org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext@
1d8299fd: startup
date [Thu Mar
01
17:
32:
42 CST
2018]; root
of context hierarchy
-
2018
-03
-01
17:
32:
45.865 INFO
64878 --- [ main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat initialized
with port(s):
8080 (http)
-
2018
-03
-01
17:
32:
45.892 INFO
64878 --- [ main] o.apache.catalina.core.StandardService : Starting service [Tomcat]
-
2018
-03
-01
17:
32:
45.895 INFO
64878 --- [ main] org.apache.catalina.core.StandardEngine : Starting Servlet Engine: Apache Tomcat/
8.5
.27
-
2018
-03
-01
17:
32:
46.530 INFO
64878 --- [ost-startStop
-1] org.apache.jasper.servlet.TldScanner : At least one JAR was scanned
for TLDs yet contained no TLDs. Enable debug logging
for this logger
for a complete list
of JARs that were scanned but no TLDs were found
in them. Skipping unneeded JARs during scanning can improve startup time
and JSP compilation time.
-
2018
-03
-01
17:
32:
46.542 INFO
64878 --- [ost-startStop
-1] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring embedded WebApplicationContext
-
2018
-03
-01
17:
32:
46.543 INFO
64878 --- [ost-startStop
-1] o.s.web.context.ContextLoader : Root WebApplicationContext: initialization completed
in
4371 ms
-
2018
-03
-01
17:
32:
46.809 INFO
64878 --- [ost-startStop
-1] o.s.b.w.servlet.ServletRegistrationBean : Mapping servlet:
'dispatcherServlet' to [/]
-
2018
-03
-01
17:
32:
46.818 INFO
64878 --- [ost-startStop
-1] o.s.b.w.servlet.FilterRegistrationBean : Mapping filter:
'characterEncodingFilter' to: [/*]
-
2018
-03
-01
17:
32:
46.819 INFO
64878 --- [ost-startStop
-1] o.s.b.w.servlet.FilterRegistrationBean : Mapping filter:
'hiddenHttpMethodFilter' to: [/*]
-
2018
-03
-01
17:
32:
46.819 INFO
64878 --- [ost-startStop
-1] o.s.b.w.servlet.FilterRegistrationBean : Mapping filter:
'httpPutFormContentFilter' to: [/*]
-
2018
-03
-01
17:
32:
46.819 INFO
64878 --- [ost-startStop
-1] o.s.b.w.servlet.FilterRegistrationBean : Mapping filter:
'requestContextFilter' to: [/*]
-
2018
-03
-01
17:
32:
47.838 INFO
64878 --- [ main] s.w.s.m.m.a.RequestMappingHandlerAdapter : Looking
for @ControllerAdvice: org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext@
1d8299fd: startup
date [Thu Mar
01
17:
32:
42 CST
2018]; root
of context hierarchy
-
2018
-03
-01
17:
32:
48.136 INFO
64878 --- [ main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped
"{[/home]}" onto
public java.lang.
String com.spring.example.controller.HomeController.home()
-
2018
-03
-01
17:
32:
48.137 INFO
64878 --- [ main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped
"{[/home/page]}" onto
public org.springframework.web.servlet.ModelAndView com.spring.example.controller.HomeController.goHome()
-
2018
-03
-01
17:
32:
48.150 INFO
64878 --- [ main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped
"{[/error]}" onto
public org.springframework.http.ResponseEntity<java.util.Map<java.lang.
String, java.lang.
Object>> org.springframework.boot.autoconfigure.web.BasicErrorController.
error(javax.servlet.http.HttpServletRequest)
-
2018
-03
-01
17:
32:
48.152 INFO
64878 --- [ main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped
"{[/error],produces=[text/html]}" onto
public org.springframework.web.servlet.ModelAndView org.springframework.boot.autoconfigure.web.BasicErrorController.errorHtml(javax.servlet.http.HttpServletRequest,javax.servlet.http.HttpServletResponse)
-
2018
-03
-01
17:
32:
48.256 INFO
64878 --- [ main] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/webjars/**] onto handler
of type [
class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
-
2018
-03
-01
17:
32:
48.256 INFO
64878 --- [ main] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/**] onto handler
of type [
class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
-
2018
-03
-01
17:
32:
48.574 INFO
64878 --- [ main] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/**/favicon.ico] onto handler
of type [
class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
-
2018
-03
-01
17:
32:
49.556 INFO
64878 --- [ main] o.s.j.e.a.AnnotationMBeanExporter : Registering beans
for JMX exposure
on startup
-
2018
-03
-01
17:
32:
49.857 INFO
64878 --- [ main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started
on port(s):
8080 (http)
-
2018
-03
-01
17:
32:
49.867 INFO
64878 --- [ main] com.spring.example.App : Started App
in
8.378 seconds (JVM running
for
8.905)
-
2018
-03
-01
17:
32:
52.093 INFO
64878 --- [nio
-8080-exec
-1] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring FrameworkServlet
'dispatcherServlet'
-
2018
-03
-01
17:
32:
52.093 INFO
64878 --- [nio
-8080-exec
-1] o.s.web.servlet.DispatcherServlet : FrameworkServlet
'dispatcherServlet': initialization started
-
2018
-03
-01
17:
32:
52.123 INFO
64878 --- [nio
-8080-exec
-1] o.s.web.servlet.DispatcherServlet : FrameworkServlet
'dispatcherServlet': initialization completed in 29 ms
-
然后打开浏览器，输入地址http://127.0.0.1:8080/home/page
看到返回结果如下所示，则表示跳转成功：
三、Controller的几种返回值
有点时候采用Controller返回跳转到前端页面的时候，经常会出现一些问题，有些同学搞不清楚具体的返回啥，这里做一个小结。
1.ModelAndView 这个也是用的最多的类型，通过构造函数可以指定返回页面的名称，也可以通过方法setViewName()来设置需要跳转的页面，例如如下的例子，这里面不但返回index页面同时，携带参数name过来。通过addObject()可以把你需要返回的参数值设置进去，返回给前端。
-
@RequestMapping(value=
"/home/page")
-
@ResponseBody
-
public ModelAndView goHome(){
-
System.out.println(
"go to the home page!");
-
ModelAndView mode =
new ModelAndView();
-
mode.addObject(
"name",
"zhangsan");
-
mode.setViewName(
"index");
-
return mode;
-
}
也可以直接通过构造函数返回,两者的效果是一样的
-
@RequestMapping(value=
"/home/mv")
-
@ResponseBody
-
public ModelAndView goHomeByModeAndview(){
-
System.out.println(
"go to the home page!");
-
ModelAndView mode =
new ModelAndView(
"index");
-
mode.addObject(
"name",
"zhangsan");
-
return mode;
-
}
-
@RequestMapping(value=
"/home")
-
public String home(){
-
System.out.println(
"redirect to home page!");
-
return
"index";
-
}
-
@RequestMapping(value=
"/home/res")
-
@ResponseBody
-
public String homeRes(){
-
System.out.println(
"redirect to home page!");
-
return
"index";
-
}
3. Model其实是一个接口,它的实现类是extendedModeMap类继承了ModelMap，具体可以参考modeMap
主要作用用于传递控制方法的处理数据到前端 ，有点类似request的域的作用，比如setAttribute的方法来设置。
4.Map对象，其实采用的就是key-value的形式，例如下面方法
-
@RequestMapping(value=
"/home/map")
-
public Map<String,String> testMap(){
-
-
Map<String, String> map =
new HashMap<String, String>();
-
map.put(
"name",
"lisi");
-
return map;
-
}
这里响应的view等同于请求的view，等同于返回null,等同于void类型。
5. void的类型，即没有返回值，响应的页面就是请求的页面 响应的地址/home/void就是这个
-
@RequestMapping(value=
"/home/void")
-
public void testVoid(){
-
ModelAndView mode=
new ModelAndView();
-
mode.addObject(
"name",
"wagnwu");
-
}
四、遇到的坑坑洼洼小结
1. 如果有jsp文件的话，一定要进入相关的jar包依赖，否则，无法解析
2. 如果只配置了spring boot的一个参数，@SpringBootApplication 此时，一定要把对应的Controller和其他组件放在这个包的路径以及子包的路径下面，否则注解无法被解析到或者手动配置扫描路径
3. 在配置文件application.properties配置的选项没有生效的情况下，注意查看一下是否是新老版本的区别，导致配置的名称不同
持续添加....
3239
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
