思路,功能介绍及DEMO之5: 如何做一个自己的插件

大洲

你需要在Visual Studio 中,引用
% `9 _' ]) Q- J2 {) `using Mr9.SiteMirror.IPlugin;
% N9 f% d: w( F5 h. P
# q8 F+ J. r% {9 G6 P
$ q+ }9 Y) F4 g- H

( U: ?9 b5 q( }" B6 `构造中初使化变量: 插件类型,名称,版本,guid,介绍 ,支持URL,和处理的内容类型 ,以及一些你自己可能用到的自己定义的变量.
' D& f# B2 s' f7 Y' z# E: u


有2个函数是你必须要处理的, 来自于  IMr9SMPlugin 接口
" _( T4 q6 {9 R! `( t& A- P
4 I- C5 B* [, a% d" ^1 k5 @一个是MANAGE,一个是EXECUTE

! I" I# M7 _- _  u1 a% R# O! y

1 M  t9 f0 R" L9 f) s都只有一个参数 和一个标准的返回类型
. k0 D! |" P. \+ O1 J$ d; ~9 v
& S8 T6 k2 @% Z3 C. ]+ N
数据结构如上.


* n, d8 d" Q; W3 F0 \% [( d你可以获取到当前用户的URL和QUERYSTRING,也可以获取到 POST 数据
也可以知道是GET,还是POST.  当前请求的域名,目标域名等等.

返回类型为PluginResult , 包括 :
- i# S+ ]9 i( j. D+ B/ v' OCompleted = 完成,继续执行下一个
$ j, d# ^2 w3 r$ kFailed = 执行失败,继续下一个
, c! n; f1 D" ^1 u; n7 N5 VRedirect = 完成,结果跳转到一个指定URL
ShowContent = 完成,后面的插件不处理 ,显示一个 自定义内容.
: @$ Z1 K3 I) z! h* h: T" y0 D
3 m3 e+ [7 V" v* F5 r当 结果为 Redirect的时候,StringValue 为 URL,BytesValue 为空
  r1 E# l: h  d  T, k当结果为 ShowContent 的时候,StringValue 为 MimeType , BytesValue 为你要显示的内容.如果是HTML要显示,需要先 Encoding.UTF8.GetBytes(html) 一下.
" G9 c" L: }& o. ?
* D6 ~) u; Z9 I) i& G2 z来看看 NOSCRIPT插件 的源代码 .
这是一个过滤乱七八JS的插件.  逻辑上很简单:
' t* L: L% G8 @- v; i' {& i保留当前自己域名下的JS, 和包含JQUERY关键字的JS.别的可能是广告,都干掉.
这个插件的可配置版本,后面有空了整完美.

            PluginResult _Result = new PluginResult();
            _Result.ResultType = PluginResultType.Failed;
8 y) L# \/ H  Z$ S( q6 H9 ~
, i1 h% ]* {4 s: D+ _) v$ J            if (requestMeta == null)
# G$ c  z6 l/ u6 G# Y* A! K$ I* U( }                return _Result;  //如果请求信息异常,直接退了

            if ((requestMeta.ContentType & this._ContentType4Plugin) != ContentTypes.HTML)
# u* f8 Y# J0 ~+ e                return _Result;  //如果内容类型不是HTML的,不处理 .退了

            if (!File.Exists(requestMeta.OutputFilePath))
                return _Result; //如果CACHE文件不存在,退了.
8 Z) L# P% ]% {  ]+ z7 z

            try{
            string _content = File.ReadAllText(requestMeta.OutputFilePath);  //读取HTML文件内容

! S. Z( {1 ]7 U
            HtmlAgilityPack.HtmlDocument _doc = new HtmlAgilityPack.HtmlDocument();
9 f- _; a7 b8 b: I            _doc.LoadHtml(_content);   //获取 一个DOM解析对像.


            bool _changed = false;   //做个标志,是否有改动.因为没改动,就不需要再写文件了.不然会浪费IO.
7 L) e$ B5 r: ^5 X4 Y            var _ScriptNodes = _doc.DocumentNode.SelectNodes("//script");   //用XPATH查找所有的SCRIPT对像.
* H2 ~! v, w6 N1 U7 B) Z            if (_ScriptNodes != null)
3 T! F9 v+ y+ K$ Q                foreach (var item in _ScriptNodes)
# X- m& a7 T3 r  h) j1 O: I) |% p                {
9 v4 b/ k# @  K5 [8 W                    if(item.Attributes["src"]!=null)
" y4 [0 M  H3 o, q# p: ~- o1 v                    {
2 |+ B& D, E4 Q2 a6 v: P& i                    try
4 x. X' P1 S% t0 _                    {
% P" i3 Q* _6 s& l% Q                        Uri _url = new Uri(item.Attributes["src"].Value);
                        if (_url.Host.Equals(requestMeta.Domain, StringComparison.OrdinalIgnoreCase) ||
                            _url.ToString().IndexOf("jquery") > 0
3 Z( P1 L  Y3 k" j- J. i//如果SCRIPT SRC 的值不为空,并且(域名和当前域名相同,或者包括 JQUERY 关键字的时候,不处理 .
                            )
* |9 E) I; W7 j                            continue;
/ [  l: u1 i" E) f# v                        else
                        {
                            item.Remove(); //否则干掉.
                            _changed = true; //做个标志,有修改.
- f3 ]( O7 P7 i                        }
                    }
, P; Z, e) v3 |: ~6 }# r                    catch { }
                    }
" X- X7 K0 x$ K8 C( V/ I. t* _                }


( S0 S8 x; X$ r6 |) g            if (_changed)  //如果发生了修改
7 p" g  z/ h  t/ B' _. ^7 _6 S            {
                _content = _doc.DocumentNode.WriteTo();
                File.WriteAllText(requestMeta.OutputFilePath, _content);
; S" y$ t  z: c% Y  }//写回去.
            }

3 C6 G* |& o$ h+ j& ], K8 S( R3 L4 t8 \            _Result.ResultType = PluginResultType.Completed; //设置插件工作完成了.
            return _Result; //返回给SM继续处理 下一个.

/ t$ G( g  R" U! p) R; e            }
, o: [' A% _2 H# |& q: M( e            catch{}
7 o3 |$ a: C! v; p% o6 D" I
            return _Result;

搞定.
- Y3 o1 e1 j& N2 F# o! R  E



* \, ]' J5 H# j" L9 \- E* M  q

sadffg

我表示完全晕菜

Jack

这个超实用，但是超级蒙

goyh

看不懂了，，这个

dfzds

这是给牛人的课，我等完全败退。

~星~

插件太厉害了

muster

这个插件能实现过滤所有站的原站的js的广告？