本文目錄一覽：
什麼是java過濾器! 它的功能和作用是什麼啊?
Servlet API 很久以前就已成為企業應用開發的基石，而 Servlet 過濾器則是對 J2EE 家族的相對較新的補充。在 J2EE 探索者 系列文章的最後一篇中，作者 Kyle Gabhart 將向您介紹 Servlet 過濾器體系結構，定義過濾器的許多應用，並指導您完成典型過濾器實現的三個步驟。他還會透露 bean 的一些激動人心的變化，預計剛發布的 Java Servlet 2.4 規範會引入這些變化。
Servlet 過濾器是可插入的 Web 組件，它允許我們實現 Web 應用程序中的預處理和後期處理邏輯。過濾器支持 servlet 和 JSP 頁面的基本請求處理功能，比如日誌記錄、性能、安全、會話處理、XSLT 轉換，等等。 過濾器最初是隨 Java Servlet 2.3 規範發布的，最近定稿的 2.4 規範對它進行了重大升級。在這 J2EE 探索者 系列文章的最後一篇中，我將向您介紹 Servlet 過濾器的基礎知識 —— 比如總體的體系結構設計、實現細節，以及在 J2EE Web 應用程序中的典型應用，還會涉及一些預計最新的 Servlet 規範將會提供的擴展功能。
Servlet 過濾器是什麼？
Servlet 過濾器是小型的 Web 組件，它們攔截請求和響應，以便查看、提取或以某種方式操作正在客戶機和服務器之間交換的數據。過濾器是通常封裝了一些功能的 Web 組件，這些功能雖然很重要，但是對於處理客戶機請求或發送響應來說不是決定性的。典型的例子包括記錄關於請求和響應的數據、處理安全協議、管理會話屬性， 等等。過濾器提供一種面向對象的模塊化機制，用以將公共任務封裝到可插入的組件中，這些組件通過一個配置文件來聲明，並動態地處理。
Servlet 過濾器中結合了許多元素，從而使得過濾器成為獨特、強大和模塊化的 Web 組件。也就是說，Servlet 過濾器是：
聲明式的：過濾器通過 Web 部署描述符（web.xml）中的 XML 標籤來聲明。這樣允許添加和刪除過濾器，而無需改動任何應用程序代碼或 JSP 頁面。
動態的：過濾器在運行時由 Servlet 容器調用來攔截和處理請求和響應。
靈活的：過濾器在 Web 處理環境中的應用很廣泛，涵蓋諸如日誌記錄和安全等許多最公共的輔助任務。過濾器還是靈活的，因為它們可用於對來自客戶機的直接調用執行預處理和後期處 理，以及處理在防火牆之後的 Web 組件之間調度的請求。最後，可以將過濾器鏈接起來以提供必需的功能。
模塊化的：通過把應用程序處理邏輯封裝到單個類文件中，過濾器從而定義了可容易地從請求/響應鏈中添加或刪除的模塊化單元。
可移植的：與 Java 平台的其他許多方面一樣，Servlet 過濾器是跨平台和跨容器可移植的，從而進一步支持了 Servler 過濾器的模塊化和可重用本質。
可重用的：歸功於過濾器實現類的模塊化設計，以及聲明式的過濾器配置方式，過濾器可以容易地跨越不同的項目和應用程序使用。
透明的：在請求/響應鏈中包括過濾器，這種設計是為了補充（而不是以任何方式替代）servlet 或 JSP 頁面提供的核心處理。因而，過濾器可以根據需要添加或刪除，而不會破壞 servlet 或 JSP 頁面。
所以 Servlet 過濾器是通過一個配置文件來靈活聲明的模塊化可重用組件。過濾器動態地處理傳入的請求和傳出的響應，並且無需修改應用程序代碼就可以透明地添加或刪除它 們。最後，過濾器獨立於任何平台或者 Servlet 容器，從而允許將它們容易地部署到任何相容的 J2EE 環境中。
在接下來的幾小節中，我們將進一步考察 Servlet 過濾器機制的總體設計，以及實現、配置和部署過濾器所涉及的步驟。我們還將探討 Servlet 過濾器的一些實際應用，最後簡要考察一下模型-視圖-控制器（MVC）體系結構中包含的 Servlet 過濾器，從而結束本文的討論。
Servlet 過濾器體系結構
正如其名稱所暗示的，Servlet 過濾器 用於攔截傳入的請求和/或傳出的響應，並監視、修改或以某種方式處理正在通過的數據流。過濾器是自包含、模塊化的組件，可以將它們添加到請求/響應鏈中， 或者在無需影響應用程序中其他 Web 組件的情況下刪除它們。過濾器僅只是改動請求和響應的運行時處理，因而不應該將它們直接嵌入 Web 應用程序框架，除非是通過 Servlet API 中良好定義的標準接口來實現。
Web 資源可以配置為沒有過濾器與之關聯（這是默認情況）、與單個過濾器關聯（這是典型情況），甚至是與一個過濾器鏈相關聯。那麼過濾器究竟做什麼呢？ 像 servlet 一樣，它接受請求並響應對象。然後過濾器會檢查請求對象，並決定將該請求轉發給鏈中的下一個組件，或者中止該請求並直接向客戶機發回一個響應。如果請求被 轉發了，它將被傳遞給鏈中的下一個資源（另一個過濾器、servlet 或 JSP 頁面）。在這個請求設法通過過濾器鏈並被服務器處理之後，一個響應將以相反的順序通過該鏈發送回去。這樣就給每個過濾器都提供了根據需要處理響應對象的機 會。
當過濾器在 Servlet 2.3 規範中首次引入時，它們只能過濾 Web 客戶機和客戶機所訪問的指定 Web 資源之間的內容。如果該資源然後將請求調度給其他 Web 資源，那就不能向幕後委託的任何請求應用過濾器。2.4 規範消除了這個限制。Servlet 過濾器現在可以應用於 J2EE Web 環境中存在請求和響應對象的任何地方。因此，Servlet 過濾器可以應用在客戶機和 servlet 之間、servlet 和 servlet 或 JSP 頁面之間，以及所包括的每個 JSP 頁面之間。這才是我所稱的強大能力和靈活性！
實現一個 Servlet 過濾器
他們說“好事多磨”。我不知道“他們”指的是誰，或者這句古老的諺語究竟有多真實，但是實現一個 Servlet 過濾器的確要經歷三個步驟。首先要編寫過濾器實現類的程序，然後要把該過濾器添加到 Web 應用程序中（通過在 Web 部署描述符 /web.xml 中聲明它），最後要把過濾器與應用程序一起打包並部署它。我們將詳細研究這其中的每個步驟。
1. 編寫實現類的程序
過濾器 API 包含 3 個簡單的接口（又是數字 3！），它們整潔地嵌套在 javax.servlet 包中。那 3 個接口分別是 Filter、FilterChain 和 FilterConfig。從編程的角度看，過濾器類將實現 Filter 接口，然後使用這個過濾器類中的 FilterChain 和 FilterConfig 接口。該過濾器類的一個引用將傳遞給 FilterChain 對象，以允許過濾器把控制權傳遞給鏈中的下一個資源。FilterConfig 對象將由容器提供給過濾器，以允許訪問該過濾器的初始化數據。
為了與我們的三步模式保持一致，過濾器必須運用三個方法，以便完全實現 Filter 接口：
init()：這個方法在容器實例化過濾器時被調用，它主要設計用於使過濾器為處理做準備。該方法接受一個 FilterConfig 類型的對象作為輸入。
doFilter()：與 servlet 擁有一個 service() 方法（這個方法又調用 doPost() 或者 doGet()）來處理請求一樣，過濾器擁有單個用於處理請求和響應的方法——doFilter()。這個方法接受三個輸入參數：一個 ServletRequest、response 和一個 FilterChain 對象。
destroy()：正如您想像的那樣，這個方法執行任何清理操作，這些操作可能需要在自動垃圾收集之前進行。展示了一個非常簡單的過濾器，它跟蹤滿足一個客戶機的 Web 請求所花的大致時間。
一個過濾器類實現
import javax.servlet.*;
import java.util.*;
import java.io.*;
public class TimeTrackFilter implements Filter {
private FilterConfig filterConfig = null;
public void init(FilterConfig filterConfig)
throws ServletException {
this.filterConfig = filterConfig;
}
public void destroy() {
this.filterConfig = null;
}
public void doFilter( ServletRequest request,
ServletResponse response, FilterChain chain )
throws IOException, ServletException {
Date startTime, endTime;
double totalTime;
startTime = new Date();
// Forward the request to the next resource in the chain
chain.doFilter(request, wrapper);
// — Process the response — \\
// Calculate the difference between the start time and end time
endTime = new Date();
totalTime = endTime.getTime() – startTime.getTime();
totalTime = totalTime / 1000; //Convert from milliseconds to seconds
StringWriter sw = new StringWriter();
PrintWriter writer = new PrintWriter(sw);
writer.println();
writer.println(“===============”);
writer.println(“Total elapsed time is: ” + totalTime + ” seconds.” );
writer.println(“===============”);
// Log the resulting string
writer.flush();
filterConfig.getServletContext().
log(sw.getBuffer().toString());
}
}
複製代碼
這個過濾器的生命周期很簡單，不管怎樣，我們還是研究一下它吧：
初始化
當容器第一次加載該過濾器時，init() 方法將被調用。該類在這個方法中包含了一個指向 FilterConfig 對象的引用。我們的過濾器實際上並不需要這樣做，因為其中沒有使用初始化信息，這裡只是出於演示的目的。
過濾
過濾器的大多數時間都消耗在這裡。doFilter() 方法被容器調用，同時傳入分別指向這個請求/響應鏈中的 ServletRequest、ServletResponse 和 FilterChain 對象的引用。然後過濾器就有機會處理請求，將處理任務傳遞給鏈中的下一個資源（通過調用 FilterChain 對象引用上的 doFilter()方法），之後在處理控制權返回該過濾器時處理響應。
析構
容器緊跟在垃圾收集之前調用 destroy() 方法，以便能夠執行任何必需的清理代碼。
2. 配置 Servlet 過濾器
過濾器通過 web.xml 文件中的兩個 XML 標籤來聲明。filter 標籤定義過濾器的名稱，並且聲明實現類和 init() 參數。filter-mapping 標籤將過濾器與 servlet 或 URL 模式相關聯。
摘自一個 web.xml 文件，它展示了如何聲明過濾器的包含關係：
在 web.xml 中聲明一個過濾器
filter
filter-namePage Request Timer/filter-name
filter-classTimeTrackFilter/filter-class
/filter
filter-mapping
filter-namePage Request Timer/filter-name
servlet-nameMain Servlet/servlet-name
/filter-mapping
servlet
servlet-nameMain Servlet/servlet-name
servlet-classMainServlet/servlet-class
/servlet
servlet-mapping
servlet-nameMain Servlet/servlet-name
url-pattern/*/url-pattern
/servlet-mapping
複製代碼
上 面的代碼示例聲明了一個過濾器（”Page Request Timer”），並把它映射到一個 servlet（”Main Servlet”）。然後為該 servlet 定義了一個映射，以便把每個請求（由通配符指定）都發送到該 servlet。這是控制器組件的典型映射聲明。您應該注意這些聲明的順序，因為千萬不能背離這些元素的順序。
3. 部署 Servlet 過濾器
事實上，與 Web 應用程序一起部署過濾器絕對不涉及任何複雜性。只需把過濾器類和其他 Web 組件類包括在一起，並像您通常所做的那樣把 web.xml 文件（連同過濾器定義和過濾器映射聲明）放進 Web 應用程序結構中，servlet 容器將處理之後的其他所有事情。
過濾器的許多應用
您在 J2EE Web 應用程序中利用過濾器的能力，僅受到您自己的創造性和應用程序設計本領的限制。在適合使用裝飾過濾器模式或者攔截器模式的任何地方，您都可以使用過濾器。過濾器的一些最普遍的應用如下：
加載：對於到達系統的所有請求，過濾器收集諸如瀏覽器類型、一天中的時間、轉發 URL 等相關信息，並對它們進行日誌記錄。
性能：過濾器在內容通過線路傳來並在到達 servlet 和 JSP 頁面之前解壓縮該內容，然後再取得響應內容，並在將響應內容發送到客戶機機器之前將它轉換為壓縮格式。
安全：過濾器處理身份驗證令牌的管理，並適當地限制安全資源的訪問，提示用戶進行身份驗證和/或將他們指引到第三方進行身份驗證。過濾器甚至能夠管理訪問 控制列表（Access Control List，ACL），以便除了身份驗證之外還提供授權機制。將安全邏輯放在過濾器中，而不是放在 servlet 或者 JSP 頁面中，這樣提供了巨大的靈活性。在開發期間，過濾器可以關閉（在 web.xml 文件中注釋掉）。在生產應用中，過濾器又可以再次啟用。此外還可以添加多個過濾器，以便根據需要提高安全、加密和不可拒絕的服務的等級。
會話處理：將 servlet 和 JSP 頁面與會話處理代碼混雜在一起可能會帶來相當大的麻煩。使用過濾器來管理會話可以讓 Web 頁面集中精力考慮內容顯示和委託處理，而不必擔心會話管理的細節。
XSLT 轉換：不管是使用移動客戶端還是使用基於 XML 的 Web 服務，無需把邏輯嵌入應用程序就在 XML 語法之間執行轉換的能力都絕對是無價的。
使過濾器適應 MVC 體系結構
模型-視圖-控制器（Model-View-Controller，MVC）體系結構是一個有效的設計，它現在已作為最重要的設計方法學，整合到了諸如 Jakarta Struts 和 Turbine 等大多數流行的 Web 應用框架中。過濾器旨在擴充 MVC 體系結構的請求/響應處理流。不管請求/響應發生在客戶機和服務器之間，還是發生在服務器上的其他組件之間，過濾器在處理流中的應用都是相同的。從 MVC 的觀點看，調度器組件（它或者包括在控制器組件中，或者配合控制器組件工作）把請求轉發給適當的應用程序組件以進行處理。這使得控制器層成為包括 Servlet 過濾器的最佳位置。通過把過濾器放在控制器組件本身的前面，過濾器可以應用於所有請求，或者通過將它放在控制器/調度器與模型和控制器之間，它可以應用於 單獨的 Web 組件。
MVC 體系結構廣為傳播，並具有良好的文檔。請通過 參考資料 中的鏈接了解關於 MVC 和 MVC 體系結構中的 Servlet 實現的更多信息。
結束語
雖然過濾器才出現幾年時間，但它們本身已作為一個關鍵組件嵌入到了所有敏捷的、面向對象的 J2EE Web 應用程序中。本文向您介紹了 Servlet 過濾器的使用。本文討論了過濾器的高級設計，比較了當前規範（2.4）和以前（2.3）的模型，講述了實現過濾器所涉及的精確步驟，以及如何在 Web 應用程序中聲明過濾器，然後與應用程序一起部署它。本文還闡述了 Servlet 過濾器的一些最普遍應用，並提到了過濾器如何適應傳統的 MVC 體系結構。
這是 J2EE 探索者 系列的最後一篇文章。我們在年初通過粗略研究 Enterprise JavaBean 組件來開始我們的旅程，並提到了何時使用這些組件才真正有意義，以及何時這些組件才會變得大材小用的問題。然後我們將目光轉向了 Web 層，繪製了一條通過 Servlet、JSP 頁面、JavaBean 技術以及 Java Servlet API 中的無數選擇和功能的路徑。在這個系列文章中與您一起艱苦跋涉真是一件快樂的事情。我享受着編寫這個系列文章的樂趣，並且我從大家的反饋中知道，這對您也 是一個很有價值的過程。
Java 過濾器的作用
java 文件過濾器怎麼實現。？？
import java.io.File;
import java.io.FilenameFilter;
/**
* 文件過濾器的簡單實現
*
* @author ajaxfan
* @date 2010-04-17
*/
public class FileNameFilterDemo {
public static void main(String[] args) {
list(“d:/”);
}
/**
* 列出特定路徑下的txt文件
*
* @param directoryName
* 路徑名
*/
private static void list(String directoryName) {
File dir = new File(directoryName);
// 確定該路徑指向一個目錄
if (dir.exists() dir.isDirectory()) {
// 列出所有結尾為txt的文件
File[] files = dir.listFiles(new FilenameFilter() {
@Override
public boolean accept(File dir, String name) {
return name.endsWith(“txt”);
}
});
System.out.println(java.util.Arrays.toString(files));
}
}
}
什麼是java過濾器！ 它的功能和作用是什麼啊？
Filter 技術是servlet 2.3 新增加的功能.servlet2.3是sun公司與2000年10月發布的,它的開發者包括許多個人和公司團體,充分體現了sun公司所倡導的代碼開放性原則.由於眾多的參與者的共同努力,servlet2.3比以往功能都強大了許多,而且性能也有了大幅提高.
它新增加的功能包括:
1. 應用程序生命周期事件控制;
2. 新的國際化;
3. 澄清了類的裝載規則;
4. 新的錯誤及安全屬性;
5. 不贊成使用HttpUtils 類;
6. 各種有用的方法;
7. 闡明並擴展了幾個servlet DTD;
8. filter功能.
其中最重要的就是filter功能.它使用戶可以改變一個request和修改一個 response. Filter 不是一個servlet,它不能產生一個response,它能夠在一個request到達servlet之前預處理request,也可以在離開 servlet時處理response.換種說法,filter其實是一個”servlet chaining”(servlet 鏈).一個filter 包括:
1. 在servlet被調用之前截獲;
2. 在servlet被調用之前檢查servlet request;
3. 根據需要修改request頭和request數據;
4. 根據需要修改response頭和response數據;
5. 在servlet被調用之後截獲.
你能夠配置一個filter 到一個或多個servlet;單個servlet或servlet組能夠被多個filter 使用.幾個實用的filter 包括:用戶辨認filter,日誌filter,審核filter,加密filter,符號filter,能改變xml內容的XSLT filter等.
一個filter必須實現javax.servlet.Filter接口並定義三個方法:
1.void setFilterConfig(FilterConfig config) //設置filter 的配置對象;
2. FilterConfig getFilterConfig() //返回filter的配置對象;
3. void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) //執行filter 的工作.
服務器每次只調用setFilterConfig方法一次準備filter 的處理;調用doFilter方法多次以處理不同的請求.FilterConfig接口有方法可以找到filter名字及初始化參數信息.服務器可以設置 FilterConfig為空來指明filter已經終結.
每一個filter從doFilter()方法中得到當前的request及 response.在這個方法里,可以進行任何的針對request及response的操作.(包括收集數據,包裝數據等).filter調用 chain.doFilter()方法把控制權交給下一個filter.一個filter在doFilter()方法中結束.如果一個filter想停止 request處理而獲得對response的完全的控制,那它可以不調用下一個filter.
一個filter可以包裝request 或response以改變幾個方法和提供用戶定製的屬性.Api2.3提供了HttpServletRequestWrapper 和HttpServletResponseWrapper來實現.它們能分派最初的request和response.如果要改變一個方法的特性,必須繼承wapper和重寫方法.下面是一段簡單的日誌filter用來記錄所有request的持續時間.
public class LogFilter implements Filter {
FilterConfig config;
public void setFilterConfig(FilterConfig config) {
this.config = config;
}
public FilterConfig getFilterConfig() {
return config;
}
public void doFilter(ServletRequest req,
ServletResponse res,
FilterChain chain) {
ServletContext context = getFilterConfig().getServletContext();
long bef = System.currentTimeMillis();
chain.doFilter(req, res); // no chain parameter needed here
long aft = System.currentTimeMillis();
context.log(“Request to ” + req.getRequestURI()
+ “: ” + (aft-bef));
}
}
當server調用setFilterConfig(),filter保存config信息. 在doFilter()方法中通過config信息得到servletContext.如果要運行這個filter,必須去配置到web.xml中.以 tomcat4.01為例:
filter
filter-name
log //filter 名字
/filter-name
filter-class
LogFilter //filter class(上例的servlet)
/filter-class
/filter
filter-mapping
filter-namelog/filter-name
servletnameservletname/servlet-name
/filter-mapping
servlet
servlet-nameservletname/servletname
servletclassservletclass/servlet-class
/servlet
servlet-mapping
servlet-nameservletname/servlet-name
url-pattern*/url-pattern
/servlet-mapping
把這個web.xml放到web-inf中(詳請參考tomcat幫助文檔).
當每次請求一個request時(如index.jsp),先到LogFilter中去並調用doFilter()方法,然後才到各自的servlet中去.如果是一個簡單的servlet(只是一個頁面,無任何輸出語句),那麼可能的輸出是:
Request to /index.jsp: 10
Filter是一個COM組件，由一個或多個Pin組成。Pin也是一個COM組件。 Filter文件的擴展名為.ax，但也可以是.dll。Filter根據其包含Input pin或Output pin的情況（或在Filter Graph的位置），大致可分為三類：Source Filter(僅有Output pin)、Transform Filter(同時具有Input pin和Output pin)和Renderer Filter(僅有Input pin)。
一般情況下，創建Filter使用一個普通的Win32 DLL項目。而且，一般Filter項目不使用MFC。這時，應用程序通過CoCreateInstance函數Filter實例；Filter與應用程序在二進制級別的協作。另外一種方法，也可以在MFC的應用程序項目中創建Filter。這種情況下，Filter不需註冊為COM組件，Filter與應用程序之間的協作是源代碼級別的；創建Filter實例，不再使用CoCreateInstance函數，而是直接new出一個Filter對象，如下：
m_pFilterObject = new CFilterClass();
// make the initial refcount 1 to match COM creation
m_pFilterObject -AddRef();
因為Filter的基類實現了對象的引用計數，所以即使在第二種情況下，對創建後的Filter對象的操作也完全可以遵循COM標準。
Filter是一個獨立功能模塊，最好不要將Filter依賴於其他第三方的DLL。因為 Filter具有COM的位置透明性特點，Filter文件可以放在硬盤的任何位置，只要位置移動後重新註冊。但此時，如果Filter依賴其他DLL，則Filter對該DLL的定位就會出現問題。
Filter不能脫離Filter Graph單獨使用。所以，如果你想繞過Filter Graph直接使用Filter實現的模塊功能，請將你的Filter移植成DMO（DirectX Media Object）。對於DirectShow應用程序開發者來說，還有一點，請不要忘記使用OleInitialize進行初始化。
2. Filter的註冊
Filter是COM組件，所以在使用前一定要註冊。Filter的註冊程序為 regsvr32.exe。如果帶上命令行參數/u，表示註銷；如果帶上是/s，表示不彈出任何註冊/註銷成功與否的提示對話框。如果你想在Build Filter項目的時候進行自動註冊，請在VC的Project settings的Custom Build頁如下設置：
Description: Register filter
Commands: regsvr32 /s /c $(TargetPath)
echo regsvr32 exe.time $(TargetDir)\$(TargetName).trg
Outputs: $(TargetDir)\$(TargetName).trg
Filter的註冊信息包括兩部分：基本的COM信息和Filter信息。註冊信息都存放在註冊表中。前者的位置為：HKEY_CLASSES_ROOT\CLSID\Filter Clsid\，後者的位置為：HKEY_CLASSES_ROOT\CLSID\Category\Instance\ Filter Clsid\。COM信息標示了Filter是一個標準的可以通過CoCreateInstance函數創建的COM組件，Filter信息標示了我們通過Graphedit看到的描述這個Filter的信息。如果你不想讓Graphedit看到（或者讓Filter枚舉器找到）你寫的Filter，你完全可以不註冊Filter信息。而且不用擔心，你這麼做也完全不會影響Filter的功能。
屏蔽註冊Filter信息的方法也很簡單。因為CBaseFilter實現了IAMovieSetup接口的兩個函數：Register和Unregister。我們只需重載這兩個函數，直接return S_OK就行了。
Filter的Merit值。這個值是微軟的“智能連接”函數使用的。在Graphedit中，當我們加入一個Source Filter後，在它的pin上執行“Render”，會自動連上一些Filter。Merit的值參考如下：
MERIT_PREFERRED = 0x800000,
MERIT_NORMAL = 0x600000,
MERIT_UNLIKELY = 0x400000,
MERIT_DO_NOT_USE = 0x200000,
MERIT_SW_COMPRESSOR = 0x100000,
MERIT_HW_COMPRESSOR = 0x100050
Merit值只有大於MERIT_DO_NOT_USE的時候才有可能被“智能連接”使用；Merit的值越大，這個Filter的機會就越大。
3. Filter之間Pin的連接過程
Filter只有加入到Filter Graph中並且和其它Filter連接成完整的鏈路後，才會發揮作用。Filter之間的連接（也就是Pin之間的連接），實際上是連接雙方的一個 Media type的協商過程。連接的方向總是從Output pin指向Input pin。連接的大致過程為：如果調用連接函數時已經指定了完整的Media type，則用這個Media type進行連接，成功與否都結束連接過程；如果沒有指定或不完全指定了Media type，則進入下面的枚舉過程。枚舉欲連接的Input pin上所有的Media type，逐一用這些Media type與Output pin進行連接（如果連接函數提供了不完全Media type，則要先將每個枚舉出來的Media type與它進行匹配檢查），如果Output pin也接受這種Media type，則Pin之間的連接宣告成功；如果所有Input pin上枚舉的Media type，Output pin都不支持，則枚舉Output pin上的所有Media type，並逐一用這些Media type與Input pin進行連接。如果Input pin接受其中的一種Media type，則Pin之間的連接到此也宣告成功；如果Output pin上的所有Media type，Input pin都不支持，則這兩個Pin之間的連接過程宣告失敗。
每個Pin都可以實現GetMediaType函數來提供該Pin上支持的所有 Preferred Media type（但一般只在Output pin上實現，Input pin主要實現CheckMediaType看是否支持當前提供的Media type就行了）。連接過程中，Pin上枚舉得到的所有Media type就是這裡提供的。
在CBasePin類中有一個protected的成員變量 m_bTryMyTypesFirst，默認值為false。在我們定製Filter的Output pin中改變這個變量的值為true，可以定製我們自己的連接過程（先枚舉Output pin上的Media type）。
當Pin之間的連接成功後，各自的pin上都會調用CompleteConnect函數。我們可以在這裡取得一些連接上的Media type的信息，以及進行一些計算等。在Output pin的CompleteConnect實現中，還有一個重要的任務，就是協商Filter Graph運行起來後Sample傳輸使用的內存配置情況。這同樣是一個交互過程：首先要詢問一下Input pin上的配置要求，如果Input pin提供內存管理器（Allocator），則優先使用Input pin上的內存管理器；否則，使用Output pin自己生成的內存管理器。我們一般都要實現DecideBufferSize來決定存放Sample的內存大小。注意：這個過程協商完成之後，實際的內存並沒有分配，而要等到Output pin上的Active函數調用。
4. Filter Media type概述
Media type一般可以有兩種表示：AM_MEDIA_TYPE和CMediaType。前者是一個Struct，後者是從這個Struct繼承過來的類。
每個Media type有三部分組成：Major type、Subtype和Format type。這三個部分都使用GUID來唯一標示。Major type主要定性描述一種Media type，比如指定這是一個Video，或Audio或Stream等；Subtype進一步細化Media type，如果Video的話可以進一步指定是UYVY或YUY2或RGB24或RGB32等；Format type用一個Struct更進一步細化Media type。
如果Media type的三個部分都是指定了某個具體的GUID值，則稱這個Media type是完全指定的；如果Media type的三個部分中有任何一個值是GUID_NULL，則稱這個Media type 是不完全指定的。GUID_NULL具有通配符的作用。
常用的Major type:
MEDIATYPE_Video;
MEDIATYPE_Audio;
MEDIATYPE_AnalogVideo; // Analog capture
MEDIATYPE_AnalogAudio;
MEDIATYPE_Text;
MEDIATYPE_Midi;
MEDIATYPE_Stream;
MEDIATYPE_Interleaved; // DV camcorder
MEDIATYPE_MPEG1SystemStream;
MEDIATYPE_MPEG2_PACK;
MEDIATYPE_MPEG2_PES;
MEDIATYPE_DVD_ENCRYPTED_PACK;
MEDIATYPE_DVD_NAVIGATION;
常用的Subtype:
MEDIASUBTYPE_YUY2;
MEDIASUBTYPE_YVYU;
MEDIASUBTYPE_YUYV;
MEDIASUBTYPE_UYVY;
MEDIASUBTYPE_YVU9;
MEDIASUBTYPE_Y411;
MEDIASUBTYPE_RGB4;
MEDIASUBTYPE_RGB8;
MEDIASUBTYPE_RGB565;
MEDIASUBTYPE_RGB555;
MEDIASUBTYPE_RGB24;
MEDIASUBTYPE_RGB32;
MEDIASUBTYPE_ARGB32; // Contains alpha value
MEDIASUBTYPE_Overlay;
MEDIASUBTYPE_MPEG1Packet;
MEDIASUBTYPE_MPEG1Payload; // Video payload
MEDIASUBTYPE_MPEG1AudioPayload; // Audio payload
MEDIASUBTYPE_MPEG1System; // A/V payload
MEDIASUBTYPE_MPEG1VideoCD;
MEDIASUBTYPE_MPEG1Video;
MEDIASUBTYPE_MPEG1Audio;
MEDIASUBTYPE_Avi;
MEDIASUBTYPE_Asf;
MEDIASUBTYPE_QTMovie;
MEDIASUBTYPE_PCM;
MEDIASUBTYPE_WAVE;
MEDIASUBTYPE_dvsd; // DV
MEDIASUBTYPE_dvhd;
MEDIASUBTYPE_dvsl;
MEDIASUBTYPE_MPEG2_VIDEO;
MEDIASUBTYPE_MPEG2_PROGRAM;
MEDIASUBTYPE_MPEG2_TRANSPORT;
MEDIASUBTYPE_MPEG2_AUDIO;
MEDIASUBTYPE_DOLBY_AC3;
MEDIASUBTYPE_DVD_SUBPICTURE;
MEDIASUBTYPE_DVD_LPCM_AUDIO;
MEDIASUBTYPE_DVD_NAVIGATION_PCI;
MEDIASUBTYPE_DVD_NAVIGATION_DSI;
MEDIASUBTYPE_DVD_NAVIGATION_PROVIDER;
常用的Format type：
FORMAT_None
FORMAT_DvInfo DVINFO
FORMAT_MPEGVideo MPEG1VIDEOINFO
FORMAT_MPEG2Video MPEG2VIDEOINFO
FORMAT_VideoInfo VIDEOINFOHEADER
FORMAT_VideoInfo2 VIDEOINFOHEADER2
FORMAT_WaveFormatEx WAVEFORMATEX
5. Filter之間的數據傳送
Filter之間的數據是通過Sample來傳送的。Sample是一個COM組件，擁有自己的一段數據緩衝。Sample由Allocator統一管理。如下圖所示：
Filter之間數據傳送的方式有兩種：Push模式和Pull模式。
java過濾器中的FilterChain對象
1、什麼是過濾器？
與Servlet相似，過濾器是一些web應用程序組件，可以綁定到一個web應用程序中。但是與其他web應用程序組件不同的是，過濾器是”鏈”在容器的處理過程中的。這就意味着它們會在servlet處理器之前訪問一個進入的請求，並且在外發響應信息返回到客戶前訪問這些響應信息。這種訪問使得過濾器可以檢查並修改請求和響應的內容。
2、過濾鏈FilterChain
兩個過濾器，EncodingFilter負責設置編碼，SecurityFilter負責控制權限，服務器會按照web.xml中過濾器定義的先後循序組裝成一條鏈，然後一次執行其中的doFilter()方法。執行的順序就如下圖所示，執行第一個過濾器的chain.doFilter()之前的代碼，第二個過濾器的chain.doFilter()之前的代碼，請求的資源，第二個過濾器的chain.doFilter()之後的代碼，第一個過濾器的chain.doFilter()之後的代碼，最後返迴響應。
3、過濾鏈的好處是，執行過程中任何時候都可以打斷，只要不執行chain.doFilter()就不會再執行後面的過濾器和請求的內容。而在實際使用時，就要特別注意過濾鏈的執行順序問題，像EncodingFilter就一定要放在所有Filter之前，這樣才能確保在使用請求中的數據前設置正確的編碼。
原創文章，作者：小藍，如若轉載，請註明出處：https://www.506064.com/zh-hant/n/192661.html
微信掃一掃 
支付寶掃一掃 