Spring Boot 入門之web基礎篇（二）

一、前言

上一篇《Spring Boot 入門之基礎篇（一）》介紹了 Spring Boot 的環境搭建以及專案啟動打包等基礎內容，本篇繼續深入介紹 Spring Boot 與 Web 開發相關的知識。

二、整合模板引擎

由於 jsp 不被 SpringBoot 推薦使用，所以模板引擎主要介紹 Freemarker 和 Thymeleaf。

2.1 整合 Freemarker

2.1.1 新增 Freemarker 依賴

在 application.properties 中新增如下內容：

2.1.2 新增 Freemarker 模板配置

2.1.3 Freemarker 案例演示

在 controller 包中建立 FreemarkerController：

結果如下：在 templates 目錄中建立名為 hello.ftl 檔案，內容如下：

2.2 整合 Thymeleaf

2.2.1 新增 Thymeleaf 依賴

在 pom.xml 檔案中新增：

在 application.properties 中新增如下內容：

2.2.2 新增 Thymeleaf 模板配置

2.2.3 Thymeleaf 案例演示上述配置都是預設值。

在 controller 包中建立 ThymeleafController:

在 template 目錄下建立名為 hello.html 的檔案，內容如下：

結果如下：

三、整合 Fastjson

3.1 新增依賴

建立一個配置管理類 WebConfig ，如下：

3.2 整合 Fastjson

3.3 演示案例：

建立一個實體類 User：

建立controller:

此時，還不能看出 Fastjson 是否正常工作，我們在 User 類中使用 Fastjson 的註解，如下內容：

12	@JSONField(format="yyyy-MM-dd")private Date birthday;

日期格式與我們修改的內容格式一致，說明 Fastjson 整合成功。

四、自定義 Servlet

4.1 編寫 Servlet

1234567891011121314

public class ServletTest extends HttpServlet { @Override

protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { doPost(req, resp); } @Override protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { resp.setContentType("text/html;charset=utf-8"); resp.getWriter().write("自定義 Servlet"); }}

4.2 註冊 Servlet

將 Servelt 註冊成 Bean。在上文建立的 WebConfig 類中新增如下程式碼：

1234	@Beanpublic ServletRegistrationBean servletRegistrationBean() { return new ServletRegistrationBean(new ServletTest(),"/servletTest");}

結果如下：

五、自定義過濾器/第三方過濾器

5.1 編寫過濾器

12345678910111213141516171819202122232425

public class TimeFilter implements Filter { @Override public void init(FilterConfig filterConfig) throws ServletException { System.out.println("=======初始化過濾器========="); } @Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain filterChain) throws IOException, ServletException { long start = System.currentTimeMillis(); filterChain.doFilter(request, response); System.out.println("filter 耗時：" + (System.currentTimeMillis() - start)); } @Override public void destroy() { System.out.println("=======銷燬過濾器========="); }}

5.2 註冊過濾器

要是該過濾器生效，有兩種方式：

1) 使用 @Component 註解

2) 新增到過濾器鏈中，此方式適用於使用第三方的過濾器。將過濾器寫到 WebConfig 類中，如下：

12345678910111213

@Beanpublic FilterRegistrationBean timeFilter() { FilterRegistrationBean registrationBean = new FilterRegistrationBean(); TimeFilter timeFilter = new TimeFilter(); registrationBean.setFilter(timeFilter); List<String> urls = new ArrayList<>(); urls.add("/*"); registrationBean.setUrlPatterns(urls); return registrationBean;}

結果如下：

六、自定義監聽器

6.1 編寫監聽器

12345678910111213

public class ListenerTest implements ServletContextListener { @Override public void contextInitialized(ServletContextEvent sce) { System.out.println("監聽器初始化..."); } @Override public void contextDestroyed(ServletContextEvent sce) { }}

6.2 註冊監聽器

註冊監聽器為 Bean，在 WebConfig 配置類中新增如下程式碼：

1234	@Beanpublic ServletListenerRegistrationBean<ListenerTest> servletListenerRegistrationBean() { return new ServletListenerRegistrationBean<ListenerTest>(new ListenerTest());}

當啟動容器時，結果如下：

針對自定義 Servlet、Filter 和 Listener 的配置，還有另一種方式：

12345678910111213141516171819

@SpringBootApplicationpublic class SpringbootWebApplication implements ServletContextInitializer { @Override public void onStartup(ServletContext servletContext) throws ServletException { // 配置 Servlet servletContext.addServlet("servletTest",new ServletTest()) .addMapping("/servletTest"); // 配置過濾器 servletContext.addFilter("timeFilter",new TimeFilter()) .addMappingForUrlPatterns(EnumSet.of(DispatcherType.REQUEST),true,"/*"); // 配置監聽器 servletContext.addListener(new ListenerTest()); } public static void main(String[] args) { SpringApplication.run(SpringbootWebApplication.class, args); }}

七、自定義攔截器

7.1 編寫攔截器

使用 @Component 讓 Spring 管理其生命週期：

123456789101112131415161718192021222324252627282930313233343536

@Componentpublic class TimeInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { System.out.println("========preHandle========="); System.out.println(((HandlerMethod)handler).getBean().getClass().getName()); System.out.println(((HandlerMethod)handler).getMethod().getName()); request.setAttribute("startTime", System.currentTimeMillis()); return true; } @Override public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception { System.out.println("========postHandle========="); Long start = (Long) request.getAttribute("startTime"); System.out.println("耗時:"+(System.currentTimeMillis() - start)); } @Override public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception exception) throws Exception { System.out.println("========afterCompletion========="); Long start = (Long) request.getAttribute("startTime"); System.out.println("耗時:"+(System.currentTimeMillis() - start)); System.out.println(exception); }}

7.2 註冊攔截器

編寫攔截器後，我們還需要將其註冊到攔截器鏈中，如下配置：

12345678910111213

@Configurationpublic class WebConfig extends WebMvcConfigurerAdapter{ @Autowired private TimeInterceptor timeInterceptor; @Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(timeInterceptor); }}

請求一個 controller ，結果如下：

八、配置 AOP 切面

8.1 新增依賴

1234	<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-aop</artifactId></dependency>

8.2 編寫切面類

使用 @Component，@Aspect 標記到切面類上：

12345678910111213141516171819202122

@Aspect@Componentpublic class TimeAspect { @Around("execution(* com.light.springboot.controller.FastJsonController..*(..))") public Object method(ProceedingJoinPoint pjp) throws Throwable { System.out.println("=====Aspect處理======="); Object[] args = pjp.getArgs(); for (Object arg : args) { System.out.println("引數為:" + arg); } long start = System.currentTimeMillis(); Object object = pjp.proceed(); System.out.println("Aspect 耗時:" + (System.currentTimeMillis() - start)); return object; }}

請求 FastJsonController 控制器的方法，結果如下：

九、錯誤處理

9.1 友好頁面

先演示非友好頁面，修改 FastJsonController 類中的 test 方法：

12345678910111213141516171819

@RestController@RequestMapping("fastjson")public class FastJsonController { @RequestMapping("/test") public User test() { User user = new User(); user.setId(1); user.setUsername("jack"); user.setPassword("jack123"); user.setBirthday(new Date()); // 模擬異常 int i = 1/0; return user; }}

當系統報錯時，返回到頁面的內容通常是一些雜亂的程式碼段，這種顯示對使用者來說不友好，因此我們需要自定義一個友好的提示系統異常的頁面。

在 src/main/resources 下建立 /public/error，在該目錄下再建立一個名為 5xx.html 檔案，該頁面的內容就是當系統報錯時返回給使用者瀏覽的內容：

12345678910111213

<!DOCTYPE html><html lang=

Spring Boot 入門之web基礎篇（二）

一、前言

二、整合模板引擎

2.1 整合 Freemarker

2.1.1 新增 Freemarker 依賴

在 application.properties 中新增如下內容：

2.1.2 新增 Freemarker 模板配置

2.1.3 Freemarker 案例演示

2.2 整合 Thymeleaf

2.2.1 新增 Thymeleaf 依賴

在 application.properties 中新增如下內容：

2.2.2 新增 Thymeleaf 模板配置

三、整合 Fastjson

3.1 新增依賴

建立一個配置管理類 WebConfig ，如下：

3.2 整合 Fastjson

四、自定義 Servlet

4.1 編寫 Servlet

4.2 註冊 Servlet

五、自定義過濾器/第三方過濾器

5.1 編寫過濾器

5.2 註冊過濾器

六、自定義監聽器

6.1 編寫監聽器

6.2 註冊監聽器

七、自定義攔截器

7.1 編寫攔截器

7.2 註冊攔截器

八、配置 AOP 切面

8.1 新增依賴

8.2 編寫切面類

九、錯誤處理

9.1 友好頁面

相關推薦