一次批量修改博客文章的经验(上):准备工作
2010-01-04 18:57 by 老赵, 6595 visits这几天赋闲在家,除了看书和还债(如RSS订阅),终于把一直以来想做却拖着的事情完成了:批量去除博客文章段首的空格。这个过程并不难,只需要按部就班地去做就行了,一切资料都可以在互联网上搜索到。不过我还是打算记录一下,也是为了今后再做类似工作时有个参考,少走一些弯路。
前言
我是个略有些强迫症的人,希望很多东西可以统一。例如,几个月前我才在RSS订阅里输出了全文——那是因为博客园终于提供这个统一设置的选项了。其实在此之前就有很多朋友建议我开放全文,但我一直没有做。不是我追求PV,而是我只能做到所有的新文章输出全文,对于旧文章则必须一篇一篇地去修改——如果不修改,不就不统一了吗?但手动修改实在太繁琐,于是便一直没有去做。
同样的,在我以前的文章中,每段段首都是空两格的,但是现在感觉没有什么必要,于是最近的几十篇文章都顶格写了。这个“不统一”我便“容忍”了,因为我知道博客园提供了MetaWeblog API,这样我理论上可以写一段程序来批量修改之前的文章内容。只可惜,直到现在我才下决心这么做。
整个过程分几步完成,在此一一记录一下。
XML RPC与MetaWeblog
MetaWeblog是一个通用的博客内容修改接口,许多博客都实现了协议,因此我们可以使用Windows Live Writer这样的工具来写文章。网上关于这个协议最好的描述文档我认为是MSDN上的MetaWeblog API Reference——这其实是Windows Live Space服务所公开的接口。从理论上来说,博客园也应该实现完全相同的功能,但是实际使用上来看,还是有一些区别。由于任务的性质,这里我们自然以博客园为准,我也不再去追究到底谁是真正符合标准的做法了。
MetaWeblog API使用了基于XML RPC的调用方式。XML RPC使用HTTP来传输一段XML来表示一个远程调用,与SOAP不同,XML RPC非常简单,他的传输内容您一看就懂。我只是在开发过程中使用Fiddler简单查看了一下Windows Live Writer与博客园的通信,如果您感兴趣的话也可以仔细研究一下XML RPC。
在.NET上调用XML RPC服务可以利用开源的XML-RPC.NET类库来简化操作。虽然MSDN上提供了一段基于XML-RPC.NET的演示代码,但是您也可以看出其实这段代码无比粗略,而且我根本没跑通,差点让我认为XML-RPC.NET非常不成熟。但我看了XML-RPC.NET的文档之后才意识到,其实这个类库使用起来非常简单。因此,我在这里建议您忽略MSDN上的示例代码,而以XML-RPC.NET为准——甚至只要首页上的几行代码您就可以明白了。
当然,您也可以继续阅读这篇文章,用于完成简单的工作已经足够了。
使用MetaWeblog API修改博客园文章
使用XML-RPC.NET调用MetaWeblog API非常容易,我们只要根据API的样式来定义“类型”和“接口”就可以了。例如:
public class Post { [XmlRpcMember("postid")] public int PostID; [XmlRpcMember("dateCreated")] public DateTime CreateTime; [XmlRpcMember("title")] public string Title; [XmlRpcMember("description")] public string Content; [XmlRpcMember("categories")] public string[] Categories; } public interface IMetaWeblogProxy : IXmlRpcProxy { [XmlRpcMethod("metaWeblog.getPost")] Post GetPost(string postId, string userName, string password); [XmlRpcMethod("metaWeblog.editPost")] bool UpdatePost(string postId, string userName, string password, Post post, bool publish); }
首先我们定义了一个Post类型,其中有多个字段,每个字段上标记了在XML RPC结构中的名称。此外,我们又定义了一个IMetaWeblogProxy接口类型,XML-PRC.NET会根据根据接口的签名自动与远程服务进行交互。这里有个问题,便是Post的PostID字段到底是哪个类型。MSDN上描述,与Windows Live Space的API使用的是字符串,而博客园使用的确实32位整数——如前文所述,我们这里以博客园为准。
调用接口很容易:
var client = XmlRpcProxyGen.Create<IMetaWeblogProxy>(); client.Url = "http://www.cnblogs.com/JeffreyZhao/services/metaweblog.aspx"; string userName = "JeffreyZhao"; string password = "..."; string postId = "1629216"; var post = client.GetPost(postId, userName, password); post.Content += "<p>Hello World!</p>"; client.UpdatePost(postId, userName, password, post, true);
以上,便在ID为1629216的文章内容后添加一行“Hello World”字样了。
异步调用
F#并不是万能的,之前我们也看到说,由于F#缺少诸多语言特性,在XML构造方面的方便程度并不如C#。但是,我这里还是选择使用F#,关键的因素还是在于其异步支持实在是太方便了。我们的任务需要大量的网络IO操作,而其中高性能的关键还是在于利用异步IO操作。那么在F#中,我们又该如何异步访问MetaWeblog API呢?
其实XML-RPC.NET已经为我们提供了支持,例如我们可以这样定义上面GetPost和UpdatePost的“异步版本”:
type IMetaWeblogProxy = inherit IXmlRpcProxy [<XmlRpcBegin("metaWeblog.getPost")>] abstract BeginGetPost : string -> string -> string -> AsyncCallback -> obj -> IAsyncResult [<XmlRpcEnd("metaWeblog.getPost")>] abstract EndGetPost : IAsyncResult -> Post [<XmlRpcBegin("metaWeblog.editPost")>] abstract BeginUpdatePost : string -> string -> string -> Post -> bool -> AsyncCallback -> obj -> IAsyncResult [<XmlRpcEnd("metaWeblog.editPost")>] abstract EndUpdatePost : IAsyncResult -> bool
完整的代码(如Post类型的定义)您可以从文末的链接里获得。这里我们直接定义了Begin/End两个方法的签名,与C#版本相比省略了参数名,如果您希望保证可读性也可以在定义时补上。只要我们使用这种方法定义了接口,标记了方法,XML-RPC.NET便可以为我们生成一个代理对象。自然,我们也可以在F#中使用XmlRpcProxyGen.Create方法:
let createProxy() = XmlRpcProxyGen.Create<IMetaWeblogProxy>()
在实际使用的时候,我们可以按常规来扩展一下IMetaWeblogProxy接口:
type MetaWeblog.IMetaWeblogProxy with member p.GetPostAsync(postId, userName, password) = let beginGet (ac, o) = p.BeginGetPost postId userName password ac o Async.FromBeginEnd(beginGet, p.EndGetPost) member p.UpdatePostAsync(postId, userName, password, post, publish) = let beginUpdate (ac, o) = p.BeginUpdatePost postId userName password post publish ac o Async.FromBeginEnd(beginUpdate, p.EndUpdatePost)
于是之前的C#代码便可以改写成如下的F#异步工作流:
let workflow = async { let client = MetaWeblog.createProxy() client.Url <- "http://www.cnblogs.com/JeffreyZhao/services/metaweblog.aspx" let userName, password, postId = "JeffreyZhao", "...", "1629216" let! post = client.GetPostAsync(postId, userName, password) post.Content <- post.Content + "<p>Hello World!</p>" return! client.UpdatePostAsync(postId, userName, password, post, true) }
当然,以上代码只是进行了“定义”,在实际运行时您还需要使用某种方法来执行这个异步工作流。
相关文章
- 一次批量修改博客文章的经验(上):准备工作
- 一次批量修改博客文章的经验(下):操作过程
沙发