技术标签： filter 【spring系列】 servlet registration initializer
springboot提供在Servlet 3.0+环境中用于编码方式配置ServletContext的接口，此接口（ServletContextInitializer）主要被RegistrationBean抽象类实现用于往ServletContext容器中注册Servlet、Filter或者Listener。这些实现了此接口的Bean的生命周期将会交给Spring容器管理，而不会交给Servlet容器。
@FunctionalInterface
public interface ServletContextInitializer {
/**
* 使用初始化所需要的任何servlet、Filter、Listener上下文参数及所需要的参数进行初始化ServletContext
* @param servletContext 将要初始化的上下文
* @throws ServletException 抛出发生的异常信息
*/
void onStartup(ServletContext servletContext) throws ServletException;
}
public abstract class RegistrationBean implements ServletContextInitializer, Ordered {
private static final Log logger = LogFactory.getLog(RegistrationBean.class);
//注册bean的优先级
private int order = Ordered.LOWEST_PRECEDENCE;
//指示注册是否已经启用的标记
private boolean enabled = true;
@Override
public final void onStartup(ServletContext servletContext) throws ServletException {
//获取注册bean的描述信息
String description = getDescription();
//判定是否开启注册功能，否则打印info日志并且直接返回
if (!isEnabled()) {
logger.info(StringUtils.capitalize(description) + " was not registered (disabled)");
return;
}
//调用抽象的注册方法
register(description, servletContext);
}
/**
* 返回注册的描述说明
*/
protected abstract String getDescription();
/**
* 在servlet上下文中注册这个bean.
* @param description 正在注册项的描述
* @param servletContext the servlet context
*/
protected abstract void register(String description, ServletContext servletContext);
/**
* 指示注册是否已经启用的标记
*/
public void setEnabled(boolean enabled) {
this.enabled = enabled;
}
/**
* 返回注册是否一起用的标记boolean值
*/
public boolean isEnabled() {
return this.enabled;
}
/**
* 设置注册bean的优先级顺序
*/
public void setOrder(int order) {
this.order = order;
}
/**
* 获取注册bean的优先级顺序
*/
@Override
public int getOrder() {
return this.order;
}
}
public abstract class DynamicRegistrationBean<D extends Registration.Dynamic> extends RegistrationBean {
private static final Log logger = LogFactory.getLog(RegistrationBean.class);
//注册的名称，如果没有指定，将使用bean的名称
private String name;
//是否支持异步注册
private boolean asyncSupported = true;
private Map<String, String> initParameters = new LinkedHashMap<>();
/**
* 设置注册的名称，如果没有指定，将使用bean的名称
*/
public void setName(String name) {
Assert.hasLength(name, "Name must not be empty");
this.name = name;
}
/**
* 如果此操作支持异步注册，则支持异步集，如果未指定，则默认为true
*/
public void setAsyncSupported(boolean asyncSupported) {
this.asyncSupported = asyncSupported;
}
/**
* 判定当前注册是否支持异步注册
*/
public boolean isAsyncSupported() {
return this.asyncSupported;
}
/**
* 为此注册设置init参数，调用此方法将替换任何现有的init参数
*/
public void setInitParameters(Map<String, String> initParameters) {
Assert.notNull(initParameters, "InitParameters must not be null");
this.initParameters = new LinkedHashMap<>(initParameters);
}
/**
* 返回注册的初始化参数
*/
public Map<String, String> getInitParameters() {
return this.initParameters;
}
/**
* 添加一个init参数，用相同的名称替换任何现有的参数
* @param name 初始化参数名
* @param value 初始化参数值
*/
public void addInitParameter(String name, String value) {
Assert.notNull(name, "Name must not be null");
this.initParameters.put(name, value);
}
//注册方法的具体实现
@Override
protected final void register(String description, ServletContext servletContext) {
//调用具体的注册方法
D registration = addRegistration(description, servletContext);
if (registration == null) {
logger.info(StringUtils.capitalize(description) + " was not registered (possibly already registered?)");
return;
}
//配置注册结果
configure(registration);
}
//注册具体动作抽象方法
protected abstract D addRegistration(String description, ServletContext servletContext);
//注册结果及设置参数
protected void configure(D registration) {
registration.setAsyncSupported(this.asyncSupported);
if (!this.initParameters.isEmpty()) {
registration.setInitParameters(this.initParameters);
}
}
/**
* 推断此注册的名称，将返回用户指定的名称或回退到基于约定的命名
*/
protected final String getOrDeduceName(Object value) {
return (this.name != null) ? this.name : Conventions.getVariableName(value);
}
}
public class ServletRegistrationBean<T extends Servlet> extends DynamicRegistrationBean<ServletRegistration.Dynamic> {
//默认路径匹配
private static final String[] DEFAULT_MAPPINGS = {
"/*" };
//将要注册的servlet
private T servlet;
//映射的URL路由模式集合
private Set<String> urlMappings = new LinkedHashSet<>();
//如果省略了URL映射，则应将其替换为"/*"
private boolean alwaysMapUrl = true;
//启动优先级
private int loadOnStartup = -1;
//要设置的配置
private MultipartConfigElement multipartConfig;
/**
* 创建一个ServletRegistrationBean实例对象
*/
public ServletRegistrationBean() {
}
/**
* 创建一个ServletRegistrationBean实例对象，并且制定servlet和URL映射参数
*/
public ServletRegistrationBean(T servlet, String... urlMappings) {
this(servlet, true, urlMappings);
}
/**
* 创建一个ServletRegistrationBean实例对象，并且制定servlet、如果省略URL则使用"/*"替换,和URL映射参数
* @param servlet the servlet being mapped
* @param alwaysMapUrl if omitted URL mappings should be replaced with '/*'
* @param urlMappings the URLs being mapped
*/
public ServletRegistrationBean(T servlet, boolean alwaysMapUrl, String... urlMappings) {
Assert.notNull(servlet, "Servlet must not be null");
Assert.notNull(urlMappings, "UrlMappings must not be null");
this.servlet = servlet;
this.alwaysMapUrl = alwaysMapUrl;
this.urlMappings.addAll(Arrays.asList(urlMappings));
}
/**
* Sets the servlet to be registered.
* @param servlet the servlet
*/
public void setServlet(T servlet) {
Assert.notNull(servlet, "Servlet must not be null");
this.servlet = servlet;
}
/**
* 返回正在注册的servlet
*/
public T getServlet() {
return this.servlet;
}
/**
* 设置servlet的URL映射，如果未指定，映射将默认为"/",这将替换以前指定的任何映射
*/
public void setUrlMappings(Collection<String> urlMappings) {
Assert.notNull(urlMappings, "UrlMappings must not be null");
this.urlMappings = new LinkedHashSet<>(urlMappings);
}
/**
* 返回注册的servlet的映射集合
* @return the urlMappings
*/
public Collection<String> getUrlMappings() {
return this.urlMappings;
}
/**
* 添加注册的servlet的url映射
* @param urlMappings the mappings to add
* @see #setUrlMappings(Collection)
*/
public void addUrlMappings(String... urlMappings) {
Assert.notNull(urlMappings, "UrlMappings must not be null");
this.urlMappings.addAll(Arrays.asList(urlMappings));
}
/**
* 设置loadOnStartup方法的优先级
*/
public void setLoadOnStartup(int loadOnStartup) {
this.loadOnStartup = loadOnStartup;
}
/**
* 设置注册servlet的配置
*/
public void setMultipartConfig(MultipartConfigElement multipartConfig) {
this.multipartConfig = multipartConfig;
}
/**
* 获取servlet的配置
*/
public MultipartConfigElement getMultipartConfig() {
return this.multipartConfig;
}
//获取注册servlet的描述
@Override
protected String getDescription() {
Assert.notNull(this.servlet, "Servlet must not be null");
return "servlet " + getServletName();
}
//核心，向ServletContext注册servlet对象
@Override
protected ServletRegistration.Dynamic addRegistration(String description, ServletContext servletContext) {
String name = getServletName();
return servletContext.addServlet(name, this.servlet);
}
/**
* 配置注册配置
*/
@Override
protected void configure(ServletRegistration.Dynamic registration) {
super.configure(registration);
String[] urlMapping = StringUtils.toStringArray(this.urlMappings);
if (urlMapping.length == 0 && this.alwaysMapUrl) {
urlMapping = DEFAULT_MAPPINGS;
}
if (!ObjectUtils.isEmpty(urlMapping)) {
registration.addMapping(urlMapping);
}
registration.setLoadOnStartup(this.loadOnStartup);
if (this.multipartConfig != null) {
registration.setMultipartConfig(this.multipartConfig);
}
}
/**
* 获取将被注册的servlet的名字
* @return the servlet name
*/
public String getServletName() {
return getOrDeduceName(this.servlet);
}
@Override
public String toString() {
return getServletName() + " urls=" + getUrlMappings();
}
}
public abstract class AbstractFilterRegistrationBean<T extends Filter> extends DynamicRegistrationBean<Dynamic> {
//默认的URL映射路径
private static final String[] DEFAULT_URL_MAPPINGS = {
"/*" };
private Set<ServletRegistrationBean<?>> servletRegistrationBeans = new LinkedHashSet<>();
private Set<String> servletNames = new LinkedHashSet<>();
private Set<String> urlPatterns = new LinkedHashSet<>();
private EnumSet<DispatcherType> dispatcherTypes;
private boolean matchAfter = false;
/**
* 创建AbstractFilterRegistrationBean实例对象，参数为ServletRegistrationBean集合
*/
AbstractFilterRegistrationBean(ServletRegistrationBean<?>... servletRegistrationBeans) {
Assert.notNull(servletRegistrationBeans, "ServletRegistrationBeans must not be null");
Collections.addAll(this.servletRegistrationBeans, servletRegistrationBeans);
}
/**
* 设置ServletRegistrationBean，过滤器将会针对其进行注册
*/
public void setServletRegistrationBeans(Collection<? extends ServletRegistrationBean<?>> servletRegistrationBeans) {
Assert.notNull(servletRegistrationBeans, "ServletRegistrationBeans must not be null");
this.servletRegistrationBeans = new LinkedHashSet<>(servletRegistrationBeans);
}
/**
* 返回Filter简要根据ServletRegistrationBean集合对象进行注册的ServletRegistrationBean集合
*/
public Collection<ServletRegistrationBean<?>> getServletRegistrationBeans() {
return this.servletRegistrationBeans;
}
/**
* 添加ServletRegistrationBean对象
*/
public void addServletRegistrationBeans(ServletRegistrationBean<?>... servletRegistrationBeans) {
Assert.notNull(servletRegistrationBeans, "ServletRegistrationBeans must not be null");
Collections.addAll(this.servletRegistrationBeans, servletRegistrationBeans);
}
/**
* 设置过滤器将注册的servlet名称，这将替换以前指定的任何servlet名称
*/
public void setServletNames(Collection<String> servletNames) {
Assert.notNull(servletNames, "ServletNames must not be null");
this.servletNames = new LinkedHashSet<>(servletNames);
}
/**
* 返回用于注册过滤器的servlet名称的可变集合
*/
public Collection<String> getServletNames() {
return this.servletNames;
}
/**
* 为Filter添加servlet名称
*/
public void addServletNames(String... servletNames) {
Assert.notNull(servletNames, "ServletNames must not be null");
this.servletNames.addAll(Arrays.asList(servletNames));
}
/**
* 设置将根据其注册Filter的URL模式，这将替换以前指定的任何URL模式
*/
public void setUrlPatterns(Collection<String> urlPatterns) {
Assert.notNull(urlPatterns, "UrlPatterns must not be null");
this.urlPatterns = new LinkedHashSet<>(urlPatterns);
}
/**
* 返回一个URL模式的可变集合，如Servlet规范中定义的那样，过滤器针对这些模式进行注册
*/
public Collection<String> getUrlPatterns() {
return this.urlPatterns;
}
/**
* 添加URL模式，如Servlet规范中所定义的，过滤器将针对这些模式进行注册
*/
public void addUrlPatterns(String... urlPatterns) {
Assert.notNull(urlPatterns, "UrlPatterns must not be null");
Collections.addAll(this.urlPatterns, urlPatterns);
}
/**
*
* @param first the first dispatcher type
* @param rest additional dispatcher types
*/
public void setDispatcherTypes(DispatcherType first, DispatcherType... rest) {
this.dispatcherTypes = EnumSet.of(first, rest);
}
/**
* Sets the dispatcher types that should be used with the registration. If not
* specified the types will be deduced based on the value of
* {@link #isAsyncSupported()}.
* @param dispatcherTypes the dispatcher types
*/
public void setDispatcherTypes(EnumSet<DispatcherType> dispatcherTypes) {
this.dispatcherTypes = dispatcherTypes;
}
/**
* Set if the filter mappings should be matched after any declared filter mappings of
* the ServletContext. Defaults to {@code false} indicating the filters are supposed
* to be matched before any declared filter mappings of the ServletContext.
* @param matchAfter if filter mappings are matched after
*/
public void setMatchAfter(boolean matchAfter) {
this.matchAfter = matchAfter;
}
/**
* Return if filter mappings should be matched after any declared Filter mappings of
* the ServletContext.
* @return if filter mappings are matched after
*/
public boolean isMatchAfter() {
return this.matchAfter;
}
@Override
protected String getDescription() {
Filter filter = getFilter();
Assert.notNull(filter, "Filter must not be null");
return "filter " + getOrDeduceName(filter);
}
//注册过滤器
@Override
protected Dynamic addRegistration(String description, ServletContext servletContext) {
Filter filter = getFilter();
return servletContext.addFilter(getOrDeduceName(filter), filter);
}
/**
* 配置过滤器的配置
*/
@Override
protected void configure(FilterRegistration.Dynamic registration) {
super.configure(registration);
EnumSet<DispatcherType> dispatcherTypes = this.dispatcherTypes;
if (dispatcherTypes == null) {
T filter = getFilter();
if (ClassUtils.isPresent("org.springframework.web.filter.OncePerRequestFilter",
filter.getClass().getClassLoader()) && filter instanceof OncePerRequestFilter) {
dispatcherTypes = EnumSet.allOf(DispatcherType.class);
}
else {
dispatcherTypes = EnumSet.of(DispatcherType.REQUEST);
}
}
Set<String> servletNames = new LinkedHashSet<>();
for (ServletRegistrationBean<?> servletRegistrationBean : this.servletRegistrationBeans) {
servletNames.add(servletRegistrationBean.getServletName());
}
servletNames.addAll(this.servletNames);
if (servletNames.isEmpty() && this.urlPatterns.isEmpty()) {
registration.addMappingForUrlPatterns(dispatcherTypes, this.matchAfter, DEFAULT_URL_MAPPINGS);
}
else {
if (!servletNames.isEmpty()) {
registration.addMappingForServletNames(dispatcherTypes, this.matchAfter,
StringUtils.toStringArray(servletNames));
}
if (!this.urlPatterns.isEmpty()) {
registration.addMappingForUrlPatterns(dispatcherTypes, this.matchAfter,
StringUtils.toStringArray(this.urlPatterns));
}
}
}
/**
* Return the {@link Filter} to be registered.
* @return the filter
*/
public abstract T getFilter();
@Override
public String toString() {
StringBuilder builder = new StringBuilder(getOrDeduceName(this));
if (this.servletNames.isEmpty() && this.urlPatterns.isEmpty()) {
builder.append(" urls=").append(Arrays.toString(DEFAULT_URL_MAPPINGS));
}
else {
if (!this.servletNames.isEmpty()) {
builder.append(" servlets=").append(this.servletNames);
}
if (!this.urlPatterns.isEmpty()) {
builder.append(" urls=").append(this.urlPatterns);
}
}
builder.append(" order=").append(getOrder());
return builder.toString();
}
}
public class FilterRegistrationBean<T extends Filter> extends AbstractFilterRegistrationBean<T> {
//将要注册的Filter对象
private T filter;
/**
* 创建一个FilterRegistrationBean实例对象
*/
public FilterRegistrationBean() {
}
/**
* 创建一个新的FilterRegistrationBean实例，使用指定的Filter和ServletRegistrationBean作为参数
* @param filter the filter to register
* @param servletRegistrationBeans associate {@link ServletRegistrationBean}s
*/
public FilterRegistrationBean(T filter, ServletRegistrationBean<?>... servletRegistrationBeans) {
super(servletRegistrationBeans);
Assert.notNull(filter, "Filter must not be null");
this.filter = filter;
}
//获取将要注册的获取器
@Override
public T getFilter() {
return this.filter;
}
/**
* 设置将要被注册的过滤器
*/
public void setFilter(T filter) {
Assert.notNull(filter, "Filter must not be null");
this.filter = filter;
}
}
文章浏览阅读539次，点赞3次，收藏3次。线上服务器宕机问题的解决。如果你也有类似的问题，可以参考下。主要思路用mat 工具分析下.hprof文件_生产服务宕机了,我们通过哪些方式去定位问题
文章浏览阅读1.6k次。这是系列文章中的一篇，阅读本文前请先阅读《Windows下Qt 5.2 for Android开发入门》，以便确保开发环境和作者一致。部分文章被转发/转载却没有注明出处，特此声明：版权所有 foruok ，如需转载敬请注明出处(http://blog.csdn.net/foruok)。我将从实践出发，带领大家一步一步完成在 Android 上的第一个 Qt 应用： Hello Qt_qt kids
文章浏览阅读1.5k次，点赞3次，收藏11次。③只有当链路状态发生变化时，路由器才用洪泛法向所有路由器发送此信息，并且更新过程收敛的快，不会出现RIP“坏消息传得慢”的问题。②发送的信息是与本路由器相邻的所有路由器的链路状态，但这只是路由器所知道的部分信息。③网络出现故障时，会出现慢收敛现象，俗称“坏消息传得慢”，使更新过程的收敛时间长。②路由器之间交换的是路由器中的完整路由表，因此网络规模越大，开销也越大。：BGP是不同自治系统的路由器之间交换路由信息的协议，是一种外部网关协议。②路由器交换的信息是当前路由器所知道的全部信息，即。_rip,ospf,bgp三个协议的区别
文章浏览阅读6.1k次。uni-app运行到微信小程序时报错：“[ pages/index/index.json 文件内容错误] pages/index/index.json: [“usingComponents”][“u-navbar”] 未找到”这是由于引用了第三方UI库，比如uview，pages.json配置easycom规则(按需引入)，使用了npm安装方式，但微信开发者工具没有构建npm，可以改下下载方式// pages.json{ "easycom": { // 下载安装的方式需要前面_[ pages/index/index.json 文件内容错误] pages/index/index.json: ["usingcompon
文章浏览阅读6.7k次，点赞32次，收藏108次。嵌入式软件自留地 今天编者荐语：五分钟了解物联网SIM卡——这个文章刷新了我对sim卡的认识，不熟悉的可以看看~~以下文章来源于华为云IoT ，作者我是卤蛋这个文章来自网络，看了觉得不错，因此特意整理转载下。是华为iot小助手分享的，都知道华为在物联网领域是国内老大的地位，分享的文章还是比较有价值的。【摘要】SIM卡是移动通信中不可或缺的组成部分，在物联网解决方案中，设备移动上网也需要使用SIM卡。那么，SIM卡是什么？SIM卡有几种？各种SIM卡有什么区别？本文将为您答疑.._中移物联nb-iot模块 不认识sim卡
文章浏览阅读1.1w次。JavaScript 获取当前时间戳：第一种方法：var timestamp = Date.parse(new Date());第二种方法:var timestamp=new Date().getTime()；第三种方法：var timestamp = (new Date()).valueOf();第一种：获取的时间戳是把毫秒改成000显示，_js unix时间戳
文章浏览阅读4.9k次。python学习笔记 类型判断，异常处理，终止程序，实例代码：#idle中按F5可以运行代码#引入外部模块 import xxx#random模块，randint(开始数，结束数) 产生整数随机数import randomimport sysimport ossecret = random.randint(1,10)temp = input("请输入一个数字\n")#print(type(temp..._程序抛出异常不一定终止程序
文章浏览阅读583次。C#中添加引用Dll文件必须先注册！！注册方法：regsvr32 *.dll (*代表Dll文件名称)！！_引用dll失败
文章浏览阅读685次，点赞14次，收藏25次。Visual Studio Code 的主要功能之一是其强大的调试支持。VS Code 的内置调试器有助于加速编辑、编译和调试循环。在插件库内搜索python Debugger，安装插件（1）创建debug_learning.py测试文件（2）设置断点（2）启动debug模式（3）debug的各个按钮的介绍以下文档基于内置的 Node.js 调试器，但大多数概念和功能也适用于其他调试器。在阅读有关调试的信息之前，首先创建一个示例Node.js应用程序会很有帮助。您可以按照Node.js演练安_python vs debug
文章浏览阅读112次。Python3.7.7+Django+Mysql5.7+pip list+HBuilderX（Vscode也行）+uni+Vue+Pychram社区版。[附源码]计算机毕业设计Python+uniapp家校通微信小程序rjeuh(程序+lw+远程部署)2. 前端：uni+css+javascript+jQuery+easyUI+highcharts。Django + uni小程序 +Python+Mysql 等等组成，B/S模式等等。该项目含有源码、文档、程序、数据库、配套开发软件、软件安装教程。_家校互通小程序开源
文章浏览阅读1.5w次，点赞5次，收藏31次。需求：想要获取快手短视频app的用户粉丝数声明：本博文只是作为研究学习用途，请不要用于非法、商业用途。写个帖子不容易，转载请说明出处，谢谢首先需要用Fidder抓包工具找到接口地址重点来了，快手所有的接口基本都用到了一个参数sig(数据签名)声明：本博文只是作为研究学习用途，请不要用于非法、商业用途。写个帖子不容易，转载请说明出处，谢谢首先需要用Fidder抓包工具找到接口地址这个过程省略..._java获取快手视频评论数
文章浏览阅读3.3k次，点赞22次，收藏85次。Python是一种高级、通用、解释型编程语言。它具有简单易学的语法和强大的功能，适用于多种应用领域，包括Web开发、数据分析、人工智能和科学计算等。Python拥有庞大的社区支持，且拥有丰富的第三方库和工具，使得开发变得更加高效和便捷。python 语言不仅可以应用到网络编程、游戏开发等领域，还可以在图形图像处理、智能机器人、爬取数据、自动化运维等多方面发挥特长，为开发者提供简约、优雅的编程体验。_python一百天