第五章springboot实现web的常用功能

本章讲解springboot实现web开发中涉及的一些常用的功能进行详细讲解

5.1 SpringMvc整合

5.1.1springmvc自动化配置

springboot引入web依赖启动器spring-boot-starter------web就可以不用再额外配置其他的东西就可以进行web开发啦。

1.内置两个视图解析器(视图解析器的作用是将逻辑视图名称解析成实际的视图对象,以便最终在浏览器中呈现给用户。例如,当用户请求一个 URL 时,控制器可以返回一个逻辑视图名称为 "home",而视图解析器会将其解析成一个 JSP 页面,最终在浏览器中渲染出来。):

5.1.2springmvc功能拓展实现

在实际开发中还需要开发者对一些功能进行扩展实现,下面通过案例进行讲解;

1.创建案例:springboot的案例如下添加的依赖:并且把第四章的案例的一些文件复制过来

目录如下:

2.拓展功能的实现:

我们springboot整合springmvc进行web开发,实现简单的页面跳转功能。

1.注册视图管理器:

复制代码
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.ViewControllerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

//该类用于对mvc框架功能进行扩展
@Configuration
public class MyMvcConfig implements WebMvcConfigurer {
    //添加视图管理,实现WebMvcConfigurer接口的下面那个方法
    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        //请求/toLoginPage映射或者login.html页面都会自动映射到login。html页面,setViewName("login");的作用是映射路径为login.html页面
        registry.addViewController("/login.html").setViewName("login");
        registry.addViewController("/toLoginPage").setViewName("login");
    }
}

需要关闭传统的LoginController控制器。

使用这个方法进行视图界面的控制,很简单。我个人理解就是:替代啦传统的页面访问方式,就可以进行页面的控制,你在浏览器框输入自己规定的页面链接就可以访问到自己想访问到的界面。

就是参数之间没有互相传送,也就是说明说的。

2.自定义拦截器

WebMvcConfigurer接口提供啦许多MVC开发的相关方法,接下来我们使用相关方法进行注册自定义拦截器:

1.定义拦截器类,并编写简单的拦截器业务代码:

HttpServletRequest

它封装了客户端发送的HTTP请求。当客户端通过HTTP协议访问服务器时,请求中的所有信息,包括请求头、参数等,都被封装在HttpServletRequest对象中。通过HttpServletRequest提供的方法,可以获取到这些信息。

复制代码
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import org.springframework.lang.Nullable;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;
import java.util.Calendar;

/**
 * 自定义一个拦截器类
 */
@Component
public class MyInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response,
                             Object handler) throws Exception {
        // 用户请求/admin开头路径时,判断用户是否登录
        String uri = request.getRequestURI();//接受客户端请求过来的请求路径
        Object loginUser = request.getSession().getAttribute("loginUser");
        //如果用户请求以/admin开头,就判断用户是否登录,如果没有登录,就重定向到"/toLoginPage",请求对应的登录页面。
        if (uri.startsWith("/admin") && null == loginUser) {
            response.sendRedirect("/toLoginPage");
            return false;
        }
        return true;
    }
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response,
                           Object handler, @Nullable ModelAndView modelAndView) throws Exception {
        //使用request对象向前端页面传递表示年份的currentYear数据
        request.setAttribute("currentYear", Calendar.getInstance().get(Calendar.YEAR));
    }
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse
            response, Object handler, @Nullable Exception ex) throws Exception {
    }
}

2.在mvc扩展功能的类

MyMvcConfig中扩展拦截器

复制代码
    //重写addInterceptors方法注册定义的拦截器
//引入自定义的MyInterceptor拦截器组件
    @Autowired
    private MyInterceptor myInterceptor;
    //添加拦截器管理,重写addInterceptors方法,注册自定义的拦截器,
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(myInterceptor)
//                拦截所有 路径请求
                .addPathPatterns("/**")
                //对/login.html路径进行放行
                .excludePathPatterns("/login.html");
    }

访问路径:http://localhost:8080/admin

自动跳转到登录页面,同时动态显示出当前年份,说明拦截器定制成功啦。

5.2springboot整合servlet三大组件

servlet三大组件:ServletFilterListener

Servlet是JavaWeb的核心组件之一,主要负责处理客户端的请求和生成动态内容。

Filter,即过滤器,是用于拦截请求和响应的组件。

Listener,即监听器,用于监听和响应应用程序事件。

springboot提供啦组件注册和路径扫描两种方式整合servlet三大组件,接下来讲解这两种方式:

1.使用组件注册方式整合servlet:

创建自定义类:servlet类。

复制代码
import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import org.springframework.stereotype.Component;

import java.io.IOException;


/*
自定义servlet类
 */
@Component//将类作为主键注入spring容器中
public class MyServlet extends HttpServlet {
    /**
     * 通过HttpServletResponse向页面输出helloMyServlet
     * @param req
     * @param resp
     * @throws ServletException
     * @throws IOException
     */

    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
//调用本类中的doPost方法,把值传到客户端
        this.doPost(req, resp);
    }

//该方法定义resp.getWriter().write,向客户端响应信息
    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
       resp.getWriter().write("hello,fanronglou");
    }
}

创建servlet配置类:

复制代码
import com.waiguoyu.day5.servletComponent.MyServlet;
import org.springframework.boot.web.servlet.ServletRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

/**
 * 用来对servlet相关组件进行注册
 */
@Configuration//标记类为配置类
public class ServletConfig {
    //注册servlet组件,getServlet注册前面自定义的MyServlet组件,返回ServletRegistrationBean类型的bean对象
    @Bean
    public ServletRegistrationBean getServlet(MyServlet myservlet) {
        ServletRegistrationBean servletRegistrationBean =
                //这里设置访问路径为/servlet出发自定义的servlet组件
                new ServletRegistrationBean(myservlet,"/servlet");
        return servletRegistrationBean;
    }
}

访问地址:http://localhost:8080/servlet

如果调试成功就代表整合sevlet成功。

使用组件注册方式整合Filter

整合的思路是一样的,这里进行代码讲解:

创建自定义类:

复制代码
import jakarta.servlet.*;
import org.springframework.stereotype.Component;

import java.io.IOException;

/**
 * 自定义Filter类
 */

@Component//将Myfiltet类作为组件注入spring容器中
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 {
        System.out.println("MyFilter");
        filterChain.doFilter(servletRequest, servletResponse);

    }
    @Override
    public void destroy() {
    }
}

注册组件:

复制代码
  @Bean//这个方法反回组装好的registrationBean对象,@bean将registrationBean对象作为bean组件返回
    public FilterRegistrationBean getFilter(MyFilter myfilter) {
        FilterRegistrationBean registrationBean =
                new FilterRegistrationBean(myfilter);
        //设置过滤的请求路径为"/toLoginPage","/myFilter",
        registrationBean.setUrlPatterns(Arrays.asList("/toLoginPage","/myFilter"));
        return registrationBean;




    }

测试:http://localhost:8080/myFilter

由于没有编写对应路径的处理方法,所以会404,只需要看控制器的信息就知道整合成功啦不。

使用组件注册方法整合Listener

流程一样:

创建自定义的Listener类:

复制代码
import jakarta.servlet.ServletContextEvent;
import jakarta.servlet.ServletContextListener;
import org.springframework.stereotype.Component;

/**
 * MyListener
 */
@Component
public class MyListener implements ServletContextListener {
    @Override
    public void contextDestroyed(ServletContextEvent sce) {
        System.out.println("contextDestroyed");
    }

    @Override
    public void contextInitialized(ServletContextEvent sce) {
        System.out.println("MyListener contextInitialized");
    }
}

Serlvet容器提供啦很多listener接口,我们可以根据自己的需求选择对应接口实现就可以啦。

注册组件:

复制代码
    @Bean
    public ServletListenerRegistrationBean getServletListener(MyListener mylistener) {
        ServletListenerRegistrationBean servletListenerRegistrationBean=
                new ServletListenerRegistrationBean(mylistener);
        return servletListenerRegistrationBean;


    }

启动程序:

启动项目和关闭项目之后有这两个语句就算整合成功啦。

如果注释掉注册类,servlet组件仍然生效。

5.2.2 路径扫描整合Servlet三大组

使用这个方式扫描三大件时,需要在自定义组件上添加:这三个注解进行声明,并且配置相关注解属性,在项目主程序上用特定的注解开启组件扫描就可以啦

我们在上一节的案例上进行操作:

1.使用路径扫描方式整合servlet三大件:

避免与之前的注册方式干扰,我们将之前定义的组件配置类(也就是进行注册组件的类)注释掉。

还注释掉三大组件上的@Component注解。

复制代码
/**
 * 自定义Filter类
 */
@WebFilter(value = {"/antionLogin","/antionMyFilter"})
//@Component//将Myfiltet类作为组件注入spring容器中

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 {
        System.out.println("MyFilter");
        filterChain.doFilter(servletRequest, servletResponse);

    }
    @Override
    public void destroy() {
    }
}


自定义servlet类
 */
@WebServlet("/annotationServlet")
//@Component//将类作为主键注入spring容器中
public class MyServlet extends HttpServlet {
    /**
     * 通过HttpServletResponse向页面输出helloMyServlet
     * @param req
     * @param resp
     * @throws ServletException
     * @throws IOException
     */

    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        this.doPost(req, resp);
    }

    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
       resp.getWriter().write("hello,fanronglou");
    }
}


 */
@WebListener
//@Component
public class MyListener implements ServletContextListener {
    @Override
    public void contextDestroyed(ServletContextEvent sce) {
        System.out.println("contextDestroyed");
    }

    @Override
    public void contextInitialized(ServletContextEvent sce) {
        System.out.println("MyListener contextInitialized");
    }
}

在主程序上添加注解对组件扫描:

复制代码
@SpringBootApplication
@ServletComponentScan
public class Day5Application {

    public static void main(String[] args) {
        SpringApplication.run(Day5Application.class, args);
    }

}

进行对应的测试,就成功啦。

这里就讲解成功springboot整合servlet三大组件的方法。大家可以根据需求进行使用。

5.3 文件上传下载

5.3.1 文件上传

web开发中,这个功能很常见,浏览器通过表单形式将文件以流的形式传递给服务器,服务器再对上传的数据解析处理。

下面我们对这个操作进行案例讲解:

1.编写文件上传的表单页面

在根目录下创建upload.html

复制代码
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>动态添加文件上传列表</title>
    <link th:href="@{/login/css/bootstrap.min.css}" rel="stylesheet">
<!--    引入静态资源/login/js/jquery.min.js-->
    <script th:src="@{/login/js/jquery.min.js}"></script>
</head>
<body>
<div th:if="${uploadStatus}" style="color: red" th:text="${uploadStatus}">上传成功</div>
<!--这里用于创建上传文件的表单-->
<form th:action="@{/uploadFile}" method="post" enctype="multipart/form-data">
    上传文件:&nbsp;&nbsp;<input type="button" value="添加文件" onclick="add()"/>
    <div id="file" style="margin-top: 10px;" th:value="文件上传区域">  </div>
    <input id="submit" type="submit" value="上传"
           style="display: none;margin-top: 10px;"/>
</form>

<!--这里用于处理用户动态添加或者移除上传输入框,这是一段js代码-->
<script type="text/javascript">
    // 动态添加上传按钮
    function add(){
        var innerdiv = "<div>";
        innerdiv += "<input type='file' name='fileUpload' required='required'>" +
            "<input type='button' value='删除' onclick='remove(this)'>";
        innerdiv +="</div>";
        $("#file").append(innerdiv);
        // 打开上传按钮
        $("#submit").css("display","block");
    }
    // 删除当前行<div>
    function remove(obj) {
        $(obj).parent().remove();
        if($("#file div").length ==0){
            $("#submit").css("display","none");
        }
    }
</script>
</body>
</html>

添加静态资源:

复制代码
/*! jQuery v2.2.3 | (c) jQuery Foundation | jquery.org/license */
!function(a,b){"object"==typeof module&&"object"==typeof module.exports?module.exports=a.document?b(a,!0):function(a){if(!a.document)throw new Error("jQuery requires a window with a document");return b(a)}:b(a)}("undefined"!=typeof window?window:this,function(a,b){var c=[],d=a.document,e=c.slice,f=c.concat,g=c.push,h=c.indexOf,i={},j=i.toString,k=i.hasOwnProperty,l={},m="2.2.3",n=function(a,b){return new n.fn.init(a,b)},o=/^[s??]+|[s??]+$/g,p=/^-ms-/,q=/-([da-z])/gi,r=function(a,b){return b.toUpperCase()};n.fn=n.prototype={jquery:m,constructor:n,selector:"",length:0,toArray:function(){return e.call(this)},get:function(a){return null!=a?0>a?this[a+this.length]:this[a]:e.call(this)},pushStack:function(a){var b=n.merge(this.constructor(),a);return b.prevObject=this,b.context=this.context,b},each:function(a){return n.each(this,a)},map:function(a){return this.pushStack(n.map(this,function(b,c){return a.call(b,c,b)}))},slice:function(){return this.pushStack(e.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},eq:function(a){var b=this.length,c=+a+(0>a?b:0);return this.pushStack(c>=0&&b>c?[this[c]]:[])},end:function(){return this.prevObject||this.constructor()},push:g,sort:c.sort,splice:c.splice},n.extend=n.fn.extend=function(){var a,b,c,d,e,f,g=arguments[0]||{},h=1,i=arguments.length,j=!1;for("boolean"==typeof g&&(j=g,g=arguments[h]||{},h++),"object"==typeof g||n.isFunction(g)||(g={}),h===i&&(g=this,h--);i>h;h++)if(null!=(a=arguments[h]))for(b in a)c=g[b],d=a[b],g!==d&&(j&&d&&(n.isPlainObject(d)||(e=n.isArray(d)))?(e?(e=!1,f=c&&n.isArray(c)?c:[]):f=c&&n.isPlainObject(c)?c:{},g[b]=n.extend(j,f,d)):void 0!==d&&(g[b]=d));return g},n.extend({expando:"jQuery"+(m+Math.random()).replace(/D/g,""),isReady:!0,error:function(a){throw new Error(a)},noop:function(){},isFunction:function(a){return"function"===n.type(a)},isArray:Array.isArray,isWindow:function(a){return null!=a&&a===a.window},isNumeric:function(a){var b=a&&a.toString();return!n.isArray(a)&&b-parseFloat(b)+1>=0},isPlainObject:function(a){var b;if("object"!==n.type(a)||a.nodeType||n.isWindow(a))return!1;if(a.constructor&&!k.call(a,"constructor")&&!k.call(a.constructor.prototype||{},"isPrototypeOf"))return!1;for(b in a);return void 0===b||k.call(a,b)},isEmptyObject:function(a){var b;for(b in a)return!1;return!0},type:function(a){return null==a?a+"":"object"==typeof a||"function"==typeof a?i[j.call(a)]||"object":typeof a},globalEval:function(a){var b,c=eval;a=n.trim(a),a&&(1===a.indexOf("use strict")?(b=d.createElement("script"),b.text=a,d.head.appendChild(b).parentNode.removeChild(b)):c(a))},camelCase:function(a){return a.replace(p,"ms-").replace(q,r)},nodeName:function(a,b){return a.nodeName&&a.nodeName.toLowerCase()===b.toLowerCase()},each:function(a,b){var c,d=0;if(s(a)){for(c=a.length;c>d;d++)if(b.call(a[d],d,a[d])===!1)break}else for(d in a)if(b.call(a[d],d,a[d])===!1)break;return a},trim:function(a){return null==a?"":(a+"").replace(o,"")},makeArray:function(a,b){var c=b||[];return null!=a&&(s(Object(a))?n.merge(c,"string"==typeof a?[a]:a):g.call(c,a)),c},inArray:function(a,b,c){return null==b?-1:h.call(b,a,c)},merge:function(a,b){for(var c=+b.length,d=0,e=a.length;c>d;d++)a[e++]=b[d];return a.length=e,a},grep:function(a,b,c){for(var d,e=[],f=0,g=a.length,h=!c;g>f;f++)d=!b(a[f],f),d!==h&&e.push(a[f]);return e},map:function(a,b,c){var d,e,g=0,h=[];if(s(a))for(d=a.length;d>g;g++)e=b(a[g],g,c),null!=e&&h.push(e);else for(g in a)e=b(a[g],g,c),null!=e&&h.push(e);return f.apply([],h)},guid:1,proxy:function(a,b){var c,d,f;return"string"==typeof b&&(c=a[b],b=a,a=c),n.isFunction(a)?(d=e.call(arguments,2),f=function(){return a.apply(b||this,d.concat(e.call(arguments)))},f.guid=a.guid=a.guid||n.guid++,f):void 0},now:Date.now,support:l}),"function"==typeof Symbol&&(n.fn[Symbol.iterator]=c[Symbol.iterator]),n.each("Boolean Number String Function Array Date RegExp Object Error Symbol".split(" "),function(a,b){i["[object "+b+"]"]=b.toLowerCase()});function s(a){var b=!!a&&"length"in a&&a.length,c=n.type(a);return"function"===c||n.isWindow(a)?!1:"array"===c||0===b||"number"==typeof b&&b>0&&b-1 in a}var t=function(a){var b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u="sizzle"+1*new Date,v=a.document,w=0,x=0,y=ga(),z=ga(),A=ga(),B=function(a,b){return a===b&&(l=!0),0},C=1<<31,D={}.hasOwnProperty,E=[],F=E.pop,G=E.push,H=E.push,I=E.slice,J=function(a,b){for(var c=0,d=a.length;d>c;c++)if(a[c]===b)return c;return-1},K="checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped",L="[\x20\t\r

\f]",M="(?:\.|\\w-|^\\x00-\\xa0)+",N=""+L+"\*("+M+")(?:"+L+"\*(\[\*^KaTeX parse error: Got function '\\\\' with no arguments as superscript at position 28: ...\*(?:'((?:\\\\.\|\[\^\\̲\\̲')*)'|"((?:\\....","g"),R=new RegExp("^"+L+","+L+" "),S=new RegExp("^"+L+"(\>+\~|"+L+")"+L+" "),T=new RegExp("="+L+"(\^'"] ?)"+L+"]","g"),U=new RegExp(O),V=new RegExp("^"+M+"KaTeX parse error: Expected group after '^' at position 22: ...ID:new RegExp("^̲#("+M+")"),CLAS...","i"),needsContext:new RegExp("^"+L+"*\>+\~|:(even|odd|eq|gt|lt|nth|first|last)(?😦"+L+"*((?:-\d)?\d*)"+L+"*)|)(?=^-|KaTeX parse error: Expected 'EOF', got '}' at position 8: )","i")}̲,X=/^(?:input|s.../i,Y=/^hdKaTeX parse error: Double superscript at position 9: /i,Z=/^\^̲{+{s*native w...=/\^(?:#(\[w-+)|(w+)|.(w-+))KaTeX parse error: Undefined control sequence: \/ at position 18: ..._=/+\~/,aa=/'|\̲/̲g,ba=new RegExp....exec(a)))if(f=o1){if(9=x){if(!(j=b.getElementById(f)))return d;if(j.id=f)return d.push(j),d}else if(w&&(j=w.getElementById(f))&&t(b,j)&&j.id===f)return d.push(j),d}else{if(o2)return H.apply(d,b.getElementsByTagName(a)),d;if((f=o3)&&c.getElementsByClassName&&b.getElementsByClassName)return H.apply(d,b.getElementsByClassName(f)),d}if(c.qsa&&!Aa+" "&&(!q||!q.test(a))){if(1!==x)w=b,s=a;else if("object"!b.nodeName.toLowerCase()){(k=b.getAttribute("id"))?k=k.replace(aa,"\&"):b.setAttribute("id",k=u),r=g(a),h=r.length,l=V.test(k)?"#"+k:"\[id='"+k+"'\]";while(h--)r\[h\]=l+" "+qa(r\[h\]);s=r.join(","),w=_.test(a)\&\&oa(b.parentNode)\|\|b}if(s)try{return H.apply(d,w.querySelectorAll(s)),d}catch(y){}finally{k=u\&\&b.removeAttribute("id")}}}return i(a.replace(Q,"KaTeX parse error: Expected 'EOF', got '}' at position 11: 1"),b,d,e)}̲function ga(){v...\]="+L+"* (?:''\|"")"),a.querySelectorAll("\[selected\]").length\|\|q.push("\["+L+"*(?:value\|"+K+")"),a.querySelectorAll("\[id~="+u+"-\]").length\|\|q.push("~="),a.querySelectorAll(":checked").length\|\|q.push(":checked"),a.querySelectorAll("a#"+u+"+* ").length\|\|q.push(".#.+\[+\~\]")}),ia(function(a){var b=n.createElement("input");b.setAttribute("type","hidden"),a.appendChild(b).setAttribute("name","D"),a.querySelectorAll("\[name=d\]").length\&\&q.push("name"+L+"*\[* \^|!~]?="),a.querySelectorAll(":enabled").length||q.push(":enabled",":disabled"),a.querySelectorAll(",:x"),q.push(",.* :")})),(c.matchesSelector=Z.test(s=o.matches||o.webkitMatchesSelector||o.mozMatchesSelector||o.oMatchesSelector||o.msMatchesSelector))&&ia(function(a){c.disconnectedMatch=s.call(a,"div"),s.call(a,"s!='':x"),r.push("!=",O)}),q=q.length&&new RegExp(q.join("|")),r=r.length&&new RegExp(r.join("|")),b=Z.test(o.compareDocumentPosition),t=b||Z.test(o.contains)?function(a,b){var c=9=a.nodeType?a.documentElement:a,d=b&&b.parentNode;return a=d||!(!d||1!d.nodeType||!(c.contains?c.contains(d):a.compareDocumentPosition&&16&a.compareDocumentPosition(d)))}:function(a,b){if(b)while(b=b.parentNode)if(b=a)return!0;return!1},B=b?function(a,b){if(a=b)return l=!0,0;var d=!a.compareDocumentPosition-!b.compareDocumentPosition;return d?d:(d=(a.ownerDocument||a)=(b.ownerDocument||b)?a.compareDocumentPosition(b):1,1&d||!c.sortDetached&&b.compareDocumentPosition(a)=d?a=n||a.ownerDocument=v&&t(v,a)?-1:b=n||b.ownerDocument=v&&t(v,b)?1:k?J(k,a)-J(k,b):0:4&d?-1:1)}:function(a,b){if(a=b)return l=!0,0;var c,d=0,e=a.parentNode,f=b.parentNode,g=a,h=b;if(!e||!f)return a=n?-1:b=n?1:e?-1:f?1:k?J(k,a)-J(k,b):0;if(e===f)return ka(a,b);c=a;while(c=c.parentNode)g.unshift©;c=b;while(c=c.parentNode)h.unshift©;while(gd===hd)d++;return d?ka(gd,hd):gd===v?-1:hd===v?1:0},n):n},fa.matches=function(a,b){return fa(a,null,null,b)},fa.matchesSelector=function(a,b){if((a.ownerDocument||a)!==n&&m(a),b=b.replace(T,"='KaTeX parse error: Expected 'EOF', got '&' at position 24: ...matchesSelector&̲&p&&!Ab+" "&&...)"))&&y(a,function(a){return b.test("string"typeof a.className&&a.className||"undefined"!=typeof a.getAttribute&&a.getAttribute("class")||"")})},ATTR:function(a,b,c){return function(d){var e=fa.attr(d,a);return nulle?"!="===b:b?(e+="","="=b?e=c:"!="=b?e!c:"^="=b?c&&0=e.indexOf©:"*="=b?c&&e.indexOf©>-1:"="=b?c\&\&e.slice(-c.length)=c:"\~="=b?(" "+e.replace(P," ")+" ").indexOf©\>-1:"\|="=b?e=c\|\|e.slice(0,c.length+1)=c+"-":!1):!0}},CHILD:function(a,b,c,d,e){var f="nth"!a.slice(0,3),g="last"!a.slice(-4),h="of-type"=b;return 1=d\&\&0=e?function(a){return!!a.parentNode}:function(b,c,i){var j,k,l,m,n,o,p=f!g?"nextSibling":"previousSibling",q=b.parentNode,r=h\&\&b.nodeName.toLowerCase(),s=!i\&\&!h,t=!1;if(q){if(f){while§{m=b;while(m=m\[p\])if(h?m.nodeName.toLowerCase()=r:1=m.nodeType)return!1;o=p="only"=a\&\&!o\&\&"nextSibling"}return!0}if(o=\[g?q.firstChild:q.lastChild\],g\&\&s){m=q,l=m\[u\]\|\|(m\[u\]={}),k=l\[m.uniqueID\]\|\|(l\[m.uniqueID\]={}),j=k\[a\]\|\|\[\],n=j\[0\]=w\&\&j\[1\],t=n\&\&j\[2\],m=n\&\&q.childNodes\[n\];while(m=++n\&\&m\&\&m\[p\]\|\|(t=n=0)\|\|o.pop())if(1=m.nodeType\&\&++t\&\&m=b){k\[a\]=\[w,n,t\];break}}else if(s\&\&(m=b,l=m\[u\]\|\|(m\[u\]={}),k=l\[m.uniqueID\]\|\|(l\[m.uniqueID\]={}),j=k\[a\]\|\|\[\],n=j\[0\]=w\&\&j\[1\],t=n),t=!1)while(m=++n\&\&m\&\&m\[p\]\|\|(t=n=0)\|\|o.pop())if((h?m.nodeName.toLowerCase()=r:1=m.nodeType)\&\&++t\&\&(s\&\&(l=m\[u\]\|\|(m\[u\]={}),k=l\[m.uniqueID\]\|\|(l\[m.uniqueID\]={}),k\[a\]=\[w,t\]),m=b))break;return t-=e,t=d\|\|t%d=0\&\&t/d\>=0}}},PSEUDO:function(a,b){var c,e=d.pseudos\[a\]\|\|d.setFilters\[a.toLowerCase()\]\|\|fa.error("unsupported pseudo: "+a);return e\[u\]?e(b):e.length\>1?(c=\[a,a,"",b\],d.setFilters.hasOwnProperty(a.toLowerCase())?ha(function(a,c){var d,f=e(a,b),g=f.length;while(g--)d=J(a,f\[g\]),a\[d\]=!(c\[d\]=f\[g\])}):function(a){return e(a,0,c)}):e}},pseudos:{not:ha(function(a){var b=\[\],c=\[\],d=h(a.replace(Q,"1"));return du?ha(function(a,b,c,e){var f,g=d(a,null,e,\[\]),h=a.length;while(h--)(f=gh)&&(ah=!(bh=f))}):function(a,e,f){return b0=a,d(b,null,f,c),b0=null,!c.pop()}}),has:ha(function(a){return function(b){return fa(a,b).length>0}}),contains:ha(function(a){return a=a.replace(ba,ca),function(b){return(b.textContent||b.innerText||e(b)).indexOf(a)>-1}}),lang:ha(function(a){return V.test(a||"")||fa.error("unsupported lang: "+a),a=a.replace(ba,ca).toLowerCase(),function(b){var c;do if(c=p?b.lang:b.getAttribute("xml:lang")||b.getAttribute("lang"))return c=c.toLowerCase(),c=a||0=c.indexOf(a+"-");while((b=b.parentNode)&&1=b.nodeType);return!1}}),target:function(b){var c=a.location&&a.location.hash;return c&&c.slice(1)=b.id},root:function(a){return a=o},focus:function(a){return a=n.activeElement&&(!n.hasFocus||n.hasFocus())&&!!(a.type||a.href||~a.tabIndex)},enabled:function(a){return a.disabled=!1},disabled:function(a){return a.disabled=!0},checked:function(a){var b=a.nodeName.toLowerCase();return"input"===b&&!!a.checked||"option"=b&&!!a.selected},selected:function(a){return a.parentNode&&a.parentNode.selectedIndex,a.selected=!0},empty:function(a){for(a=a.firstChild;a;a=a.nextSibling)if(a.nodeType<6)return!1;return!0},parent:function(a){return!d.pseudos.empty(a)},header:function(a){return Y.test(a.nodeName)},input:function(a){return X.test(a.nodeName)},button:function(a){var b=a.nodeName.toLowerCase();return"input"===b&&"button"===a.type||"button"===b},text:function(a){var b;return"input"=a.nodeName.toLowerCase()&&"text"=a.type&&(null(b=a.getAttribute("type"))||"text"=b.toLowerCase())},first:na(function(){return0}),last:na(function(a,b){returnb-1}),eq:na(function(a,b,c){return0\>c?c+b:c}),even:na(function(a,b){for(var c=0;b>c;c+=2)a.push©;return a}),odd:na(function(a,b){for(var c=1;b>c;c+=2)a.push©;return a}),lt:na(function(a,b,c){for(var d=0>c?c+b:c;--d>=0;)a.push(d);return a}),gt:na(function(a,b,c){for(var d=0>c?c+b:c;++d<b;)a.push(d);return a})}},d.pseudos.nth=d.pseudos.eq;for(b in{radio:!0,checkbox:!0,file:!0,password:!0,image:!0})d.pseudosb=la(b);for(b in{submit:!0,reset:!0})d.pseudosb=ma(b);function pa(){}pa.prototype=d.filters=d.pseudos,d.setFilters=new pa,g=fa.tokenize=function(a,b){var c,e,f,g,h,i,j,k=za+" ";if(k)return b?0:k.slice(0);h=a,i=\[\],j=d.preFilter;while(h){c&&!(e=R.exec(h))||(e&&(h=h.slice(e0.length)||h),i.push(f=\[\])),c=!1,(e=S.exec(h))&&(c=e.shift(),f.push({value:c,type:e0.replace(Q," ")}),h=h.slice(c.length));for(g in d.filter)!(e=Wg.exec(h))||jg&&!(e=jg)||(c=e.shift(),f.push({value:c,type:g,matches:e}),h=h.slice(c.length));if(!c)break}return b?h.length:h?fa.error(a)😒(a,i).slice(0)};function qa(a){for(var b=0,c=a.length,d="";c>b;b++)d+=ab.value;return d}function ra(a,b,c){var d=b.dir,e=c&&"parentNode"=d,f=x++;return b.first?function(b,c,f){while(b=bd)if(1=b.nodeType||e)return a(b,c,f)}:function(b,c,g){var h,i,j,k=w,f;if(g){while(b=bd)if((1=b.nodeType||e)&&a(b,c,g))return!0}else while(b=bd)if(1=b.nodeType||e){if(j=bu||(bu={}),i=jb.uniqueID||(jb.uniqueID={}),(h=id)&&h0=w&&h1=f)return k2=h2;if(id=k,k2=a(b,c,g))return!0}}}function sa(a){return a.length>1?function(b,c,d){var e=a.length;while(e--)if(!ae)return!1;return!0}:a0}function ta(a,b,c){for(var d=0,e=b.length;e>d;d++)fa(a,bd,c);return c}function ua(a,b,c,d,e){for(var f,g=\[\],h=0,i=a.length,j=null!=b;i>h;h++)(f=ah)&&(c&&!c(f,d,e)||(g.push(f),j&&b.push(h)));return g}function va(a,b,c,d,e,f){return d&&!du&&(d=va(d)),e&&!eu&&(e=va(e,f)),ha(function(f,g,h,i){var j,k,l,m=\[\],n=\[\],o=g.length,p=f||ta(b||"*",h.nodeType?h:h,\[\]),q=!a||!f&&b?p:ua(p,m,a,h,i),r=c?e||(f?a:o||d)?\[\]:g:q;if(c&&c(q,r,h,i),d){j=ua(r,n),d(j,\[\],h,i),k=j.length;while(k--)(l=jk)&&(rn\[k]=!(qn\[k]=l))}if(f){if(e||a){if(e){j=\[\],k=r.length;while(k--)(l=rk)&&j.push(qk=l);e(null,r=\[\],j,i)}k=r.length;while(k--)(l=rk)&&(j=e?J(f,l):mk)>-1&&(fj=!(gj=l))}}else r=ua(r=g?r.splice(o,r.length):r),e?e(null,g,r,i):H.apply(g,r)})}function wa(a){for(var b,c,e,f=a.length,g=d.relativea\[0.type],h=g||d.relative" ",i=g?1:0,k=ra(function(a){return a=b},h,!0),l=ra(function(a){return J(b,a)>-1},h,!0),m=function(a,c,d){var e=!g\&\&(d\|\|c!==j)\|\|((b=c).nodeType?k(a,c,d):l(a,c,d));return b=null,e};f>i;i++)if(c=d.relativea\[i.type])m=ra(sa(m),c);else{if(c=d.filtera\[i.type].apply(null,ai.matches),cu){for(e=++i;f>e;e++)if(d.relativea\[e.type])break;return va(i>1&&sa(m),i>1&&qa(a.slice(0,i-1).concat({value:" "===ai-2.type?"":""})).replace(Q,"KaTeX parse error: Expected 'EOF', got '&' at position 10: 1"),c,e>i&̲&wa(a.slice(i,e.../,y=/^.^:#\[., KaTeX parse error: Expected '}', got '&' at position 334: ...d=b0;return c&̲&(a=":not("+a+".../,C=n.fn.init=function(a,b,c){var e,f;if(!a)return this;if(c=c||A,"string"==typeof a){if(e="<"===a0&&">"===aa.length-1&&a.length>=3?null,a,null:B.exec(a),!e||!e1&&b)return!b||b.jquery?(b||c).find(a):this.constructor(b).find(a);if(e1){if(b=b instanceof n?b0:b,n.merge(this,n.parseHTML(e1,b&&b.nodeType?b.ownerDocument||b:d,!0)),x.test(e1)&&n.isPlainObject(b))for(e in b)n.isFunction(thise)?thise:this.attr(e,be);return this}return f=d.getElementById(e2),f&&f.parentNode&&(this.length=1,this0=f),this.context=d,this.selector=a,this}return a.nodeType?(this.context=this0=a,this.length=1,this):n.isFunction(a)?void 0!c.ready?c.ready(a):a(n):(void 0!a.selector&&(this.selector=a.selector,this.context=a.context),n.makeArray(a,this))};C.prototype=n.fn,A=n(d);var D=/^(?:parents|prev(?:Until|All))/,E={children:!0,contents:!0,next:!0,prev:!0};n.fn.extend({has:function(a){var b=n(a,this),c=b.length;return this.filter(function(){for(var a=0;c>a;a++)if(n.contains(this,ba))return!0})},closest:function(a,b){for(var c,d=0,e=this.length,f=\[\],g=w.test(a)||"string"!=typeof a?n(a,b||this.context):0;e>d;d++)for(c=thisd;c&&c!b;c=c.parentNode)if(c.nodeType<11&&(g?g.index©>-1:1=c.nodeType&&n.find.matchesSelector(c,a))){f.push©;break}return this.pushStack(f.length>1?n.uniqueSort(f):f)},index:function(a){return a?"string"typeof a?h.call(n(a),this0):h.call(this,a.jquery?a0:a):this0&&this0.parentNode?this.first().prevAll().length:-1},add:function(a,b){return this.pushStack(n.uniqueSort(n.merge(this.get(),n(a,b))))},addBack:function(a){return this.add(nulla?this.prevObject:this.prevObject.filter(a))}});function F(a,b){while((a=ab)&&1!a.nodeType);return a}n.each({parent:function(a){var b=a.parentNode;return b&&11!b.nodeType?b:null},parents:function(a){return u(a,"parentNode")},parentsUntil:function(a,b,c){return u(a,"parentNode",c)},next:function(a){return F(a,"nextSibling")},prev:function(a){return F(a,"previousSibling")},nextAll:function(a){return u(a,"nextSibling")},prevAll:function(a){return u(a,"previousSibling")},nextUntil:function(a,b,c){return u(a,"nextSibling",c)},prevUntil:function(a,b,c){return u(a,"previousSibling",c)},siblings:function(a){return v((a.parentNode||{}).firstChild,a)},children:function(a){return v(a.firstChild)},contents:function(a){return a.contentDocument||n.merge(\[\],a.childNodes)}},function(a,b){n.fna=function(c,d){var e=n.map(this,b,c);return"Until"!a.slice(-5)&&(d=c),d&&"string"typeof d&&(e=n.filter(d,e)),this.length>1&&(Ea||n.uniqueSort(e),D.test(a)&&e.reverse()),this.pushStack(e)}});var G=/S+/g;function H(a){var b={};return n.each(a.match(G)||\[\],function(a,c){bc=!0}),b}n.Callbacks=function(a){a="string"typeof a?H(a):n.extend({},a);var b,c,d,e,f=\[\],g=\[\],h=-1,i=function(){for(e=a.once,d=b=!0;g.length;h=-1){c=g.shift();while(++h<f.length)fh.apply(c0,c1)=!1&&a.stopOnFalse&&(h=f.length,c=!1)}a.memory||(c=!1),b=!1,e&&(f=c?\[\]:"")},j={add:function(){return f&&(c&&!b&&(h=f.length-1,g.push©),function d(b){n.each(b,function(b,c){n.isFunction©?a.unique&&j.has©||f.push©:c&&c.length&&"string"!n.type©&&d©})}(arguments),c&&!b&&i()),this},remove:function(){return n.each(arguments,function(a,b){var c;while((c=n.inArray(b,f,c))>-1)f.splice(c,1),h>=c&&h--}),this},has:function(a){return a?n.inArray(a,f)>-1:f.length>0},empty:function(){return f&&(f=\[\]),this},disable:function(){return e=g=\[\],f=c="",this},disabled:function(){return!f},lock:function(){return e=g=\[\],c||(f=c=""),this},locked:function(){return!!e},fireWith:function(a,c){return e||(c=c||\[\],c=a,c.slice?c.slice():c,g.push©,b||i()),this},fire:function(){return j.fireWith(this,arguments),this},fired:function(){return!!d}};return j},n.extend({Deferred:function(a){var b=\["resolve","done",n.Callbacks("once memory"),"resolved","reject","fail",n.Callbacks("once memory"),"rejected","notify","progress",n.Callbacks("memory")],c="pending",d={state:function(){return c},always:function(){return e.done(arguments).fail(arguments),this},then:function(){var a=arguments;return n.Deferred(function©{n.each(b,function(b,f){var g=n.isFunction(ab)&&ab;ef\[1](function(){var a=g&&g.apply(this,arguments);a&&n.isFunction(a.promise)?a.promise().progress(c.notify).done(c.resolve).fail(c.reject):cf0+"With"})}),a=null}).promise()},promise:function(a){return null!=a?n.extend(a,d):d}},e={};return d.pipe=d.then,n.each(b,function(a,f){var g=f2,h=f3;df\[1]=g.add,h&&g.add(function(){c=h},b1\^a2.disable,b22.lock),ef\[0]=function(){return ef0+"With",this},ef\[0+"With"]=g.fireWith}),d.promise(e),a&&a.call(e,e),e},when:function(a){var b=0,c=e.call(arguments),d=c.length,f=1!d||a&&n.isFunction(a.promise)?d:0,g=1=f?a:n.Deferred(),h=function(a,b,c){return function(d){ba=this,ca=arguments.length>1?e.call(arguments):d,c=i?g.notifyWith(b,c):--f||g.resolveWith(b,c)}},i,j,k;if(d>1)for(i=new Array(d),j=new Array(d),k=new Array(d);d>b;b++)cb&&n.isFunction(cb.promise)?cb.promise().progress(h(b,j,i)).done(h(b,k,c)).fail(g.reject):--f;return f||g.resolveWith(k,c),g.promise()}});var I;n.fn.ready=function(a){return n.ready.promise().done(a),this},n.extend({isReady:!1,readyWait:1,holdReady:function(a){a?n.readyWait++:n.ready(!0)},ready:function(a){(a=!0?--n.readyWait:n.isReady)||(n.isReady=!0,a!!0&&--n.readyWait>0||(I.resolveWith(d,n),n.fn.triggerHandler&&(n(d).triggerHandler("ready"),n(d).off("ready"))))}});function J(){d.removeEventListener("DOMContentLoaded",J),a.removeEventListener("load",J),n.ready()}n.ready.promise=function(b){return I||(I=n.Deferred(),"complete"=d.readyState||"loading"!d.readyState&&!d.documentElement.doScroll?a.setTimeout(n.ready):(d.addEventListener("DOMContentLoaded",J),a.addEventListener("load",J))),I.promise(b)},n.ready.promise();var K=function(a,b,c,d,e,f,g){var h=0,i=a.length,j=nullc;if("object"=n.type©){e=!0;for(h in c)K(a,b,h,ch,!0,f,g)}else if(void 0!d&&(e=!0,n.isFunction(d)||(g=!0),j&&(g?(b.call(a,d),b=null):(j=b,b=function(a,b,c){return j.call(n(a),c)})),b))for(;i>h;h++)b(ah,c,g?d:d.call(ah,h,b(ah,c)));return e?a:j?b.call(a):i?b(a0,c):f},L=function(a){return 1=a.nodeType||9=a.nodeType||!+a.nodeType};function M(){this.expando=n.expando+M.uid++}M.uid=1,M.prototype={register:function(a,b){var c=b||{};return a.nodeType?athis.expando=c:Object.defineProperty(a,this.expando,{value:c,writable:!0,configurable:!0}),athis.expando},cache:function(a){if(!L(a))return{};var b=athis.expando;return b||(b={},L(a)&&(a.nodeType?athis.expando=b:Object.defineProperty(a,this.expando,{value:b,configurable:!0}))),b},set:function(a,b,c){var d,e=this.cache(a);if("string"typeof b)eb=c;else for(d in b)ed=bd;return e},get:function(a,b){return void 0=b?this.cache(a):athis.expando&&athis.expandob},access:function(a,b,c){var d;return void 0=b||b&&"string"typeof b&&void 0=c?(d=this.get(a,b),void 0!d?d:this.get(a,n.camelCase(b))):(this.set(a,b,c),void 0!c?c:b)},remove:function(a,b){var c,d,e,f=athis.expando;if(void 0!f){if(void 0=b)this.register(a);else{n.isArray(b)?d=b.concat(b.map(n.camelCase)):(e=n.camelCase(b),b in f?d=b,e:(d=e,d=d in f?d:d.match(G)||\[\])),c=d.length;while(c--)delete fd\[c]}(void 0=b||n.isEmptyObject(f))&&(a.nodeType?athis.expando=void 0:delete athis.expando)}},hasData:function(a){var b=athis.expando;return void 0!b&&!n.isEmptyObject(b)}};var N=new M,O=new M,P=/^(?:{wW}|\[wW ])KaTeX parse error: Expected '}', got '&' at position 51: ...d;if(void 0===c&̲&1===a.nodeType...&").toLowerCase(),c=a.getAttribute(d),"string"typeof c){try{c="true"=c?!0:"false"=c?!1:"null"=c?null:+c+""=c?+c:P.test©?n.parseJSON©:c;
}catch(e){}O.set(a,b,c)}else c=void 0;return c}n.extend({hasData:function(a){return O.hasData(a)||N.hasData(a)},data:function(a,b,c){return O.access(a,b,c)},removeData:function(a,b){O.remove(a,b)},_data:function(a,b,c){return N.access(a,b,c)},_removeData:function(a,b){N.remove(a,b)}}),n.fn.extend({data:function(a,b){var c,d,e,f=this0,g=f&&f.attributes;if(void 0=a){if(this.length&&(e=O.get(f),1=f.nodeType&&!N.get(f,"hasDataAttrs"))){c=g.length;while(c--)gc&&(d=gc.name,0=d.indexOf("data-")&&(d=n.camelCase(d.slice(5)),R(f,d,ed)));N.set(f,"hasDataAttrs",!0)}return e}return"object"typeof a?this.each(function(){O.set(this,a)}):K(this,function(b){var c,d;if(f&&void 0=b){if(c=O.get(f,a)||O.get(f,a.replace(Q,"-KaTeX parse error: Expected 'EOF', got '&' at position 1: &̲").toLowerCase(...","i"),U="Top","Right","Bottom","Left",V=function(a,b){return a=b||a,"none"=n.css(a,"display")||!n.contains(a.ownerDocument,a)};function W(a,b,c,d){var e,f=1,g=20,h=d?function(){return d.cur()}:function(){return n.css(a,b,"")},i=h(),j=c&&c3||(n.cssNumberb?"":"px"),k=(n.cssNumberb||"px"!j&&+i)&&T.exec(n.css(a,b));if(k&&k3!j){j=j||k3,c=c||\[\],k=+i||1;do f=f||".5",k/=f,n.style(a,b,k+j);while(f!(f=h()/i)&&1!f&&--g)}return c&&(k=+k||+i||0,e=c1?k+(c1+1)c2:+c2,d&&(d.unit=j,d.start=k,d.end=e)),e}var X=/^(?:checkbox|radio)KaTeX parse error: Expected group after '^' at position 21: .../<(w:-+)/,Z=/^̲|/(?:java|ecma)script/i, = o p t i o n : 1 , " \< s e l e c t m u l t i p l e = ′ m u l t i p l e ′ \> " , " \< / s e l e c t \> " , t h e a d : 1 , " \< t a b l e \> " , " \< / t a b l e \> " , c o l : 2 , " \< t a b l e \> \< c o l g r o u p \> " , " \< / c o l g r o u p \> \< / t a b l e \> " , t r : 2 , " \< t a b l e \> \< t b o d y \> " , " \< / t b o d y \> \< / t a b l e \> " , t d : 3 , " \< t a b l e \> \< t b o d y \> \< t r \> " , " \< / t r \> \< / t b o d y \> \< / t a b l e \> " , d e f a u l t : 0 , " " , " " ; ={option:1,"\