fiddler 插件开发二
本篇主要讲解Fildder插件开发中的涉及到的主要接口与类。
1.IFiddlerExtension 接口
如果要开发的自定义插件有UI界面，则需要实现IFiddlerExtension 接口。你程序集中的实现了IFiddlerExtension接口的公有类(public class)将会在Fiddler启动时加载。
public interface IFiddlerExtension { // Called when Fiddler User Interface is fully available void OnLoad(); // Called when Fiddler is shutting down void OnBeforeUnload(); }
- OnLoad 方法将会在Fiddler加载完成并且她的UI完全可用时调用，在这个方法中，你可以安全地添加菜单项，选项卡页或者其他UI元素到Fiddler UI。
- OnBeforeUnload 方法将会在Fiddler 关闭和卸载所有插件时执行。
2.IAutoTamper 接口
IAutoTamper 接口继承了IFiddlerExtension接口，所有实现了IAutoTamper 接口的插件将会在每一个http/https 请求或响应时被调用，所以可以用来劫持或修改http/https 请求响应数据。
注意：这个接口的方法是在后台被调用，非UI线程，如果想要更新UI，可以使用Invoke 或者 BeginInvoke 方法来更新UI。IAutoTamper 的所有方法可能会在OnLoad事件之前就执行。
public interface IAutoTamper : IFiddlerExtension { // Called before the user can edit a request using the Fiddler Inspectors void AutoTamperRequestBefore(Session oSession); // Called after the user has had the chance to edit the request using the Fiddler Inspectors, but before the request is sent void AutoTamperRequestAfter(Session oSession); // Called before the user can edit a response using the Fiddler Inspectors, unless streaming. void AutoTamperResponseBefore(Session oSession); // Called after the user edited a response using the Fiddler Inspectors. Not called when streaming. void AutoTamperResponseAfter(Session oSession); // Called Fiddler returns a self-generated HTTP error (for instance DNS lookup failed, etc) void OnBeforeReturningError(Session oSession); }
3.IAutoTamper2 接口
所有实现了IAutoTamper2 接口（继承自IAutoTamper接口)的扩展将会在响应头(Response Headers)可用时被调用。
/// <summary> /// Interface for AutoTamper extensions that want to "peek" at response headers /// </summary> public interface IAutoTamper2 : IAutoTamper { /// <summary> /// Called when the response headers become available /// </summary> /// <param name="oSession">The Session object for which the response headers are available</param> void OnPeekAtResponseHeaders(Session oSession); }
4.IAutoTamper3 接口
所有实现了IAutoTamper3接口(继承自IAutoTamper2接口)的扩展将会在请求头(Request Headers)可用时被调用。
/// <summary> /// Interface for AutoTamper extensions that want to "peek" at request headers /// </summary> public interface IAutoTamper3 : IAutoTamper2 { /// <summary> /// Called when the request headers become available /// </summary> /// <param name="oSession">The Session object for which the request headers are available</param> void OnPeekAtRequestHeaders(Session oSession); }
5.IHandleExecAction接口
所有实现了IHandleExecAction接口的扩展将在用户执行QuickExec命令时被调用。OnExecAction方法中返回 true 表示命令执行成功，不用再处理其他Action。
public interface IHandleExecAction { // return TRUE if handled. bool OnExecAction(string sCommand); }
例如：
public bool OnExecAction(string sCommand) { if (sCommand == "clearcache") { //检测到用户在quickexec中输入的命令是clearcache时，调用Fiddler的清缓存方法 FiddlerApplication.UI.actClearWinINETCache(); return true; //表示命令处理成功，不用继续其他的处理 } return false; //表示命令没有被处理，允许其他 ExecAction handlers继续处理 }
6.参考资料
http://www.fiddlerbook.com/Fiddler/dev/IFiddlerExtension.asp