springboot中静态资源访问
在开发Web应用的时候,需要引用大量的js、css、图片等静态资源。
Spring Boot默认提供静态资源目录位置需置于classpath下,目录名需符合如下规则: /static、 /public、 /resources、 /META-INF/resources
举例:我们可以在src/main/resources/目录下创建static,在该位置放置一个图片文件,目录如下:
启动程序后访问路径:http://127.0.0.1:8080/img/架构师.jpg,访问路径不能加static。
渲染Web页面
我们都是通过@RestController来处理请求,所以返回的内容为json对象。那么如果需要渲染html页面的时候,要如何实现呢?
Spring Boot提供了默认配置的模板引擎主要有以下几种: • Thymeleaf • FreeMarker • Velocity • Groovy • Mustache Spring Boot建议使用这些模板引擎,避免使用JSP。使用上述模板引擎中的任何一个,它们默认的模板配置路径为:src/main/resources/templates。其中templates是固定写法。
使用Freemarker模板引擎渲染web视图
<!-- 引入freeMarker的依赖包. -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>
在src/main/resources/创建一个templates文件夹,后缀为*.ftl
后台代码:
访问请求地址:http://127.0.0.1:8080/getValue
使用JSP擎渲染web视图
pom文件需要加上:
在application.properties创建以下配置
spring.mvc.view.prefix=/WEB-INF/jsp/
spring.mvc.view.suffix=.jsp
目录结构:
jsp的路径应该是:xxx/src/main/webapp/WEB-INF/jsp/index.jsp
后台代码:
请求地址:http://127.0.0.1:8080/index
注意:创建SpringBoot整合JSP,一定要为war类型,否则会找不到页面. 不要把JSP页面存放在resources// jsp 不能被访问到
全局捕获异常
@ExceptionHandler 表示拦截异常
- @ControllerAdvice 是 controller 的一个辅助类,最常用的就是作为全局异常处理的切面类
- @ControllerAdvice 可以指定扫描范围
- @ControllerAdvice 约定了几种可行的返回值,如果是直接返回 model 类的话,需要使用 @ResponseBody 进行 json 转换
- 返回 String,表示跳到某个 view
- 返回 modelAndView
- 返回 model + @ResponseBody
Spring Boot中使用Swagger2构建 RESTful API文档
介绍RESTful API的重磅好伙伴Swagger2,它可以轻松的整合到Spring Boot中,并与Spring MVC程序配合组织出强大RESTful API文档。它既可以减少我们创建文档的工作量,同时说明内容又整合入实现代码中,让维护文档和修改代码整合为一体,可以让我们在修改代码逻辑的同时方便的修改文档说明。另外Swagger2也提供了强大的页面测试功能来调试每个RESTful API。
添加Swagger2依赖
在pom.xml
中加入Swagger2的依赖
|
创建Swagger2配置类
在Application.java同级创建Swagger2的配置类Swagger2。
/**
* @Configuration注解告诉Spring加载这个类的配置。
@EnableSwagger2
启用Swagger2。
apiInfo()方法添加API的基本信息.
*/
@Configuration
@EnableSwagger2
public class Swagger2Config {
@Bean
public Docket createRestApi() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.select()
.apis(RequestHandlerSelectors.basePackage("com.example.demo1.controller"))
.paths(PathSelectors.any())
.build();
}
//构建 api文档的详细信息函数
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
//页面标题
.title("Spring Boot使用 Swagger2构建RESTful API")
//创建人
.contact("wangxianshi")
//版本号
.version("1.0")
//描述
.description("API 描述")
.build();
}
}
通过@Configuration
注解,让Spring来加载该类配置。再通过@EnableSwagger2
注解来启用Swagger2。
再通过createRestApi
函数创建Docket
的Bean之后,apiInfo()
用来创建该Api的基本信息(这些基本信息会展现在文档页面中)。select()
函数返回一个ApiSelectorBuilder
实例用来控制哪些接口暴露给Swagger来展现,本例采用指定扫描的包路径来定义,Swagger会扫描该包下所有Controller定义的API,并产生文档内容(除了被@ApiIgnore
指定的请求)。
@RestController
@RequestMapping("/user")
@Api(value="/用户信息")
public class UserController {
static Map<Long, User> users = Collections.synchronizedMap(new HashMap<Long, User>());
springboot 过滤器2种实现方式:
第一中实现方式:
/**
* 1、@Component 这个注解的目的是将MyFilter交给容器来处理。也就是让MyFilter起作用
2、@ServletComponentScan 这个使用来扫描@WebFilter 的让@WebFilter起作用。
当然对于servlet线管注解也是可以的。这个@ServletComponentScan最好卸载Apllication这个上面,
通用配置。我这里因为只有一个Filter所以没有写在Application上面。
3、@WebFilter 这个用处显而易见,针对于什么链接做过滤,filter的名称是为什么。
4、@Order(1),filter执行优先级,值越小越优先
*/
@Order(1)
@Component
@ServletComponentScan
@WebFilter(urlPatterns = "/*",filterName = "MyFilter")
public class MyFilter implements Filter {
@Override
public void init(FilterConfig filterConfig) throws ServletException {
}
@Override
public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain)
throws IOException, ServletException {
HttpServletRequest req = (HttpServletRequest) servletRequest;
System.out.println("请求地址"+req.getRequestURI());
filterChain.doFilter(servletRequest,servletResponse);
}
@Override
public void destroy() {
}
}
在application启动类添加注解:@ServletComponentScan
第二中实现方式:
实现Filter接口,实现Filter方法
public class MyFilter implements Filter {
@Override
public void init(FilterConfig filterConfig) throws ServletException {
}
@Override
public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain)
throws IOException, ServletException {
HttpServletRequest req = (HttpServletRequest) servletRequest;
System.out.println("请求地址"+req.getRequestURI());
filterChain.doFilter(servletRequest,servletResponse);
}
@Override
public void destroy() {
}
}
@Configuration//添加@Configuration 注解,将自定义Filter加入过滤链
public class ConfigurationFilter {
@Bean
public RemoteIpFilter remoteIpFilter() {
return new RemoteIpFilter();
}
@Bean
public FilterRegistrationBean testFilterRegistration() {
FilterRegistrationBean registration = new FilterRegistrationBean();
registration.setFilter(new MyFilter());//添加过滤器
registration.addUrlPatterns("/*");//设置过滤路径,/*所有路径
registration.addInitParameter("name", "alue");//添加默认参数
registration.setName("MyFilter");//设置优先级
registration.setOrder(1);//设置优先级
return registration;
}
}