一次批量修改博客文章的经验（上）：准备工作
2010-01-04 18:57 by 老赵, 6593 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) }
当然，以上代码只是进行了“定义”，在实际运行时您还需要使用某种方法来执行这个异步工作流。
相关文章
- 一次批量修改博客文章的经验（上）：准备工作
- 一次批量修改博客文章的经验（下）：操作过程
沙发