springboot之旅第四篇-web开发
一、引言
有了自动配置,springboot使web开发变得简单,这个在springboot之旅中的第一篇中就有体现,实际的开发中当然不会这么简单,很多时候我们都需要自己去定制一些东西。web开发的东西比较多, 我们先掌握一些必要知识点,剩下的就是crud开发。
快速的创建一个springboot web项目在第一篇总结中有讲:
二、
现在大部分公司都是前后端分离的开发模式,一般作为后台开发不用关心前端,只需要提供相应接口,但是有关前端的知识我们最好还是能基本掌握一些。我们先了一套bootstrap框架,然后开始进行开发。
在之前的web开发中,在main目录下面会有webapp文件夹,我们将所有的静态资源放在里面,但是springboot的默认生成中并没有这个文件夹,那么springboot是怎么映射静态资源。
ctrl+n快捷键,找到webmvcautoconfiguration类,再找到里面的addresourcehandlers 方法
public void addresourcehandlers(resourcehandlerregistry registry) { if (!this.resourceproperties.isaddmappings()) { logger.debug("default resource handling disabled"); return; } duration cacheperiod = this.resourceproperties.getcache().getperiod(); cachecontrol cachecontrol = this.resourceproperties.getcache() .getcachecontrol().tohttpcachecontrol(); //webjar形式 if (!registry.hasmappingforpattern("/webjars/**")) { customizeresourcehandlerregistration(registry .addresourcehandler("/webjars/**") .addresourcelocations("classpath:/meta-inf/resources/webjars/") .setcacheperiod(getseconds(cacheperiod)) .setcachecontrol(cachecontrol)); } //匹配/** string staticpathpattern = this.mvcproperties.getstaticpathpattern(); if (!registry.hasmappingforpattern(staticpathpattern)) { customizeresourcehandlerregistration( registry.addresourcehandler(staticpathpattern) .addresourcelocations(getresourcelocations( //映射的资源文件夹 this.resourceproperties.getstaticlocations())) .setcacheperiod(getseconds(cacheperiod)) .setcachecontrol(cachecontrol)); } }
2.1
<dependency> <groupid>org.webjars</groupid> <artifactid>jquery</artifactid> <version>3.3.1-1</version> </dependency>
引入后可以看到jquer文件被引入了:
另外当访问当前项目的任何资源,都去(静态资源的文件夹)找映射,资源文件夹是一个数组,包括:
"classpath:/meta-inf/resources/", "classpath:/resources/","classpath:/static/", "classpath:/public/" ,
"/":当前项目的根路径。只要将静态文件放入其中,那么springboot就能找到。
三、
<dependency> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-starter-thymeleaf</artifactid> </dependency>
进入之后可以看到默认版本,我们也可以改成自己需要的版本。
<thymeleaf.version>3.0.9.release</thymeleaf.version> <!-- 布局功能的支持程序 thymeleaf3主程序 layout2以上版本 --> <!-- thymeleaf2 layout1--> <thymeleaf-layout-dialect.version>2.2.2</thymeleaf-layout-dialect.version>
@configurationproperties(prefix = "spring.thymeleaf") public class thymeleafproperties { private static final charset default_encoding = charset.forname("utf-8"); private static final mimetype default_content_type = mimetype.valueof("text/html"); public static final string default_prefix = "classpath:/templates/"; public static final string default_suffix = ".html";
我们可以去官网查看教程,这里只是简单的进行介绍,主要步骤
第一步:导入命名空间,导入之后会有相应提示
<html lang="en" xmlns:th="http://www.thymeleaf.org">
第二步:使用语法
<!doctype html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="utf-8"> <title>title</title> </head> <body> <h1>成功!</h1> <!--th:text 将div里面的文本内容设置为 --> <div><th th:text="${hello}"></th>这是显示欢迎信息</div> </body> </html>
更具体的使用方法,可以去查看官网教程,这种如果没有使用到的话不建议花太多时间去学,很多公司都是前后端分离,即使不是前后端分离,也有很多前端框架给我们使用。这些可以再我们使用的时候再去学习,速度也是很快的。
四、
springboot默认将为我们配置如下一些springmvc的必要组件:
-
必要的viewresolver(视图解析器:根据方法的返回值得到视图对象(view)),如contentnegotiatingviewresolver和
beannameviewresolver
。 -
将必要的
converter
,genericconverter
,formatter
等bean注册到ioc容器中。 -
添加了一系列的
httpmessageconverters
以便支持对web请求和相应的类型转换。 -
自动配置和注册
messagecodesresolver
任何时候,我们对默认提供的组件设定不满意,都可以注册新的同类型的bean定义来替换,web的所有自动场景都在org.springframework.boot.autoconfigure.web包中,我们可以参照进行配置。
当然完全靠自动配置在实际开发时不够的,我们经常需要自己配置一些东西,比如拦截器,视图映射规则。
@configuration public class webconfig implements webmvcconfigurer { @override public void addviewcontrollers(viewcontrollerregistry registry) { registry.addviewcontroller("/yuan").setviewname("success"); } }
这段代码就实现了自定义的视图映射。上面这种写法使springmvc的自动配置和我们的扩展配置都会起作用
我们甚至可以全面接管springmvc,只要在配置类中增加@enablewebmv注解,这样所有的springmvc的自动配置都失效了。当然,一般情况下我们不会这么做。
五、登陆
web系统一般少不了登录页面,我们先设定默认页面为登录页。
registry.addviewcontroller("/").setviewname("login"); registry.addviewcontroller("/index.html").setviewname("login");
@controller public class logincontroller { @postmapping(value = "/user/login") public string login(@requestparam("username") string username, @requestparam("password") string password, map<string,object> map, httpsession httpsession){ if(!stringutils.isempty(username)&& "123456".equals(password)){ //设置session httpsession.setattribute("loginuser",username); //重定向到主页 return "redirect:/main.html"; }else { map.put("msg","用户名密码错误"); return "login"; } } }
@configuration public class loginhandlerinterceptor implements handlerinterceptor { public boolean prehandle(httpservletrequest request, httpservletresponse response, object handler) throws exception { object user = request.getsession().getattribute("loginuser"); if(user == null){ //未登陆,返回登陆页面 request.setattribute("msg","没有权限请先登陆"); request.getrequestdispatcher("/index.html").forward(request,response); return false; }else{ //已登陆,放行请求 return true; } } }
然后再加入配置
@configuration public class webconfig implements webmvcconfigurer { @autowired private loginhandlerinterceptor loginhandlerinterceptor; public void addinterceptors(interceptorregistry registry) { registry.addinterceptor(loginhandlerinterceptor).addpathpatterns("/**") .excludepathpatterns("/index.html","/","/user/login"); } }
这样在访问其他页面时都会进行登录拦截操作
六、
springboot有自身的默认错误处理机制,分为两种
第一种:浏览器,浏览器会返回一个默认的错误页面,如:
第二种:客户端,客户端默认返回的是一个响应一个json数据
如果我们用postman访问,则返回:
如果我们想要展示更加详细的信息,就将页面放在模板引擎文件夹下,路径名为 error/状态码,【将错误页面命名为错误状态码.html 放在模板引擎文件夹里面的 error文件夹下】,发生此状态码的错误就会来到 对应的页面。在这个页面我们可以获取到一些错误信息,如:
-
timestamp:时间戳
-
-
error:错误提示
-
exception:异常对象
-
message:异常消息
-
errors:jsr303数据校验的错误都在这里
我们可以根据这些错误信息来展示错误,一般不需要这么做,抛出的错误不应该让用户去分析,我们只需要返回静态页面即可,返回错误静态页面是做法也是一样的,只是我们不用将文件放在模板引擎文件夹下。
6.2.2 定制错误的json数据
在实际的开发中我们会对我们的错误码进行规范处理,根据错误会返回相应的错误码,所以我们会自己进行json数据包装处理。
@controlleradvice public class globaldefaultexceptionhandler { @exceptionhandler(value = requestexception.class) public string requestexceptionhandler(requestexception e,httpservletrequest request){ map<string,object> map = new hashmap<>(); //传入我们自己的错误状态码 4xx 5xx,否则就不会进入定制错误页面的解析流程 request.setattribute("javax.servlet.error.status_code",500); map.put("code","user.notexist"); map.put("message",e.getmessage()); //转发到/error return "forward:/error"; } }
以上是我们在web开发需要先掌握的一些基本技术,有了这些基本知识之后,我们就可以进行crud开发,当然在实际的开发中,不管是登录拦截还是错误处理都比这个要复杂,我们以后再详讲。
上一篇: 开放的腾讯投资和它的焦虑症
推荐阅读
-
SpringBoot起飞系列-Web开发(五)
-
[springboot 开发单体web shop] 3. 用户注册实现
-
[springboot 开发单体web shop] 7. 多种形式提供商品列表
-
[springboot 开发单体web shop] 4. Swagger生成Javadoc
-
SpringBoot 2.0 开发案例之百倍级减肥瘦身之旅
-
SpringBoot——Web开发(静态资源映射)
-
SpringBoot web 综合开发
-
springboot(17)- 整合web开发(9)- 整合web基础组件
-
SpringBoot Web开发——拦截器的基本使用
-
Springboot的web开发中static和templates的区别