Spring Security的內(nèi)置過濾器是如何維護(hù)的
Spring Security中的內(nèi)置過濾器順序是怎么維護(hù)的?我想很多開發(fā)者都對這個問題感興趣。本篇我和大家一起探討下這個問題。
HttpSecurity包含了一個成員變量FilterOrderRegistration，這個類是一個內(nèi)置過濾器注冊表。至于這些過濾器的作用，不是本文介紹的重點(diǎn)，有興趣可以去看看FilterOrderRegistration的源碼。
內(nèi)置過濾器的順序
FilterOrderRegistration維護(hù)了一個變量filterToOrder，它記錄了類之間的順序和上下之間的間隔步長。我們復(fù)制了一個FilterOrderRegistration來直觀感受一下過濾器的順序：
CopyFilterOrderRegistration filterOrderRegistration = new CopyFilterOrderRegistration();
// 獲取內(nèi)置過濾器 此方法并未提供
Map<String, Integer> filterToOrder = filterOrderRegistration.getFilterToOrder();
TreeMap<Integer, String> orderToFilter = new TreeMap<>();
filterToOrder.forEach((name, order) -> orderToFilter.put(order,name));
orderToFilter.forEach((order,name) -> System.out.println(" 順序：" + order+" 類名：" + name ));
打印結(jié)果：
我們可以看得出內(nèi)置過濾器之間的位置是相對固定的，除了第一個跟第二個步長為200外，其它步長為100。
內(nèi)置過濾器并非一定會生效，僅僅是預(yù)置了它們的排位，需要通過HttpSecurity的addFilterXXXX系列方法顯式添加才行。
注冊過濾器的邏輯
FilterOrderRegistration提供了一個put方法：
void put(Class<? extends Filter> filter, int position) {
String className = filter.getName();
// 如果這個類已經(jīng)注冊就忽略
if (this.filterToOrder.containsKey(className)) {
return;
}
// 如果沒有注冊就注冊順序。
this.filterToOrder.put(className, position);
}
從這個方法我們可以得到幾個結(jié)論：
- 內(nèi)置的34個過濾器是有固定序號的，不可被改變。
- 新加入的過濾器的類全限定名是不能和內(nèi)置過濾器重復(fù)的。
- 新加入的過濾器的順序是可以和內(nèi)置過濾器的順序重復(fù)的。
獲取已注冊過濾器的順序值
FilterOrderRegistration還提供了一個getOrder方法：
Integer getOrder(Class<?> clazz) {
// 如果類Class 或者 父類Class 名為空就返回null
while (clazz != null) {
Integer result = this.filterToOrder.get(clazz.getName());
// 如果獲取到順序值就返回
if (result != null) {
return result;
}
// 否則嘗試去獲取父類的順序值
clazz = clazz.getSuperclass();
}
return null;
}
HttpSecurity維護(hù)過濾器的方法
接下來我們分析一下HttpSecurity維護(hù)過濾器的幾個方法。
addFilterAtOffsetOf
addFilterAtOffsetOf是一個HttpSecurity的內(nèi)置私有方法。Filter是想要注冊到DefaultSecurityFilterChain中的過濾器，offset是向右的偏移值，registeredFilter是已經(jīng)注冊到FilterOrderRegistration的過濾器，而且registeredFilter沒有注冊的話會空指針。
private HttpSecurity addFilterAtOffsetOf(Filter filter, int offset, Class<? extends Filter> registeredFilter) {
// 首先會根據(jù)registeredFilter的順序和偏移值來計(jì)算filter的
int order = this.filterOrders.getOrder(registeredFilter) + offset;
// filter添加到集合中待排序
this.filters.add(new OrderedFilter(filter, order));
// filter注冊到 FilterOrderRegistration
this.filterOrders.put(filter.getClass(), order);
return this;
}
務(wù)必記著registeredFilter一定是已注冊入FilterOrderRegistration的Filter。
addFilter系列方法
這里以addFilterAfter為例。
@Override
public HttpSecurity addFilterAfter(Filter filter, Class<? extends Filter> afterFilter) {
return addFilterAtOffsetOf(filter, 1, afterFilter);
}
addFilterAfter是將filter的位置置于afterFilter后一位，假如afterFilter順序值為400，則filter順序值為401。addFilterBefore和addFilterAt邏輯和addFilterAfter僅僅是偏移值的區(qū)別，這里不再贅述。
addFilter的方法比較特殊：
@Override
public HttpSecurity addFilter(Filter filter) {
Integer order = this.filterOrders.getOrder(filter.getClass());
if (order == null) {
throw new IllegalArgumentException("The Filter class " + filter.getClass().getName()
+ " does not have a registered order and cannot be added without a specified order. Consider using addFilterBefore or addFilterAfter instead.");
}
this.filters.add(new OrderedFilter(filter, order));
return this;
}
filter必須是已經(jīng)注冊到FilterOrderRegistration的Filter，這意味著它可能是內(nèi)置的Filter，也可能是先前通過addFilterBefore、addFilterAt或者addFilterAfter注冊的非內(nèi)置Filter。
問題來了
之前看到一個問題，如果HttpSecurity注冊兩個重復(fù)序號的Filter會是怎么樣的順序呢?我們先來看下排序的機(jī)制：
// filters
private List<OrderedFilter> filters = new ArrayList<>();
//排序
this.filters.sort(OrderComparator.INSTANCE);
看了下OrderComparator源碼，其實(shí)還是通過數(shù)字的自然排序，數(shù)字越小越靠前。如果數(shù)字相同，索引越小越靠前。也就是同樣的序號，誰先add到filters誰就越靠前。
