MetaWeblog, скажу я вам, — довольно занятная вещица. Простая и ясная аки двери. Когда всё там поймешь.

О протоколах

Впервые я столкнулся с этим интерфейсом в тот момент, когда прикручивал к своему вики-движку API для редактирования этих самых вики-страниц и постов в блоги. Blogger API не подошел из-за того, что ребята из Google, занятые разработкой GData API, основанного на Atom Publishing Protocol, от него отвернулись, а сам APP еще не был стандартизирован. По Movable Type API не нашлось внятной документации, а других как-то и не нашлось.

О русских программистах

Как бы то ни было, остановился я на MetaWeblog API. Поскольку построен он поверх XML-RPC, возникла потребность в библиотеке, которая брала бы все эти низкоуровневые детали на себя. Таковая нашлась: XML-RPC.NET (автор — Charles Cook). Неплохая, в общем-то, библиотека, но не без минусов. Во-первых, слишком тяжеловесная — там тебе и кодогенерация, и поддержка Remoting, и возможность создать свой stand-alone XML-RPC сервер, и еще много чего. В-третьих, с документацией там не ахти. И, наконец, при сериализации структур в расчет брались только общедоступные поля, что, может быть, не так уж и плохо, но мне не подходило.

Короче говоря, решено было написать свою библиотеку (ах да, «его писали не они» — тоже немаловажный фактор). Результат доступен на Google Code.

octalforty Brushie Web

Вот так и назвал, да.

Самый главный класс — это XmlRpcService; абстрактный и реализующий широко известный System.Web.IHttpHandler. Для создания собственного XML-RPC-сервиса достаточно унаследоваться от этого класса и пометить выставляемые наружу методы атрибутом XmlRpcServiceMethodAttribute:

public class MathXmlRpcService : octalforty.Brushie.Web.XmlRpc.XmlRpcService

{

  [XmlRpcServiceMethod("add")]

  public int Add(int x, int y)

  {

    return x + y;

  }

}

Для примитивных типов (коим int и является) этого достаточно. Если же потребуется передавать структуры (слово «структура» я употребляю применительно к XML-RPC, а не к .NET), то класс (вот здесь речь уже о .NET) надо дополнительно разметить:

[XmlRpcStructure()]

public class BlogPostCategory

{

  private string title = String.Empty;

 

  [XmlRpcMember("title")]

  public string Title

  {

    get { return title; }

    set { title = value; }

  }

}

Вот в общем-то и всё. Больше ничего о XML-RPC знать не требуется.

MetaWeblog API

Настал черед реализации самого API. Имея в руках octalforty.Brushie.Web.XmlRpc.XmlRpcService и всю сопутствующую инфраструктуру, дело остается за малым — понять довольно расплывчатую спецификацию и написать соответствующий код. Взяв в одну руку Fiddler, а в другую — Windows Live Writer я начал исследование. В результате вышел вот такой каменный цветок.

Теперь реализация API стала делом до неприличия простым: унаследовать класс сервиса от XmlRpcService да реализовать IMetaWeblogService.

Под занавес...

… пример того, как выглядит реализация NewMediaObject.

namespace octalforty.Kudos.Web.Api.Wiki

{

  ///   /// A MetaWeblog XML-RPC service for editing wiki pages.

  /// 

  public class MetaWeblogService : XmlRpcService, IMetaWeblogService, IPageManagerServiceDependency,

    ISpaceManagerServiceDependency, INavigationServiceDependency,

    IGlobalTagManagerServiceDependency, ISecurityServiceDependency,

    IUserManagerServiceDependency, IPageAttachmentManagerServiceDependency

  {

    public MediaObjectInfo NewMediaObject(string blogID, string login, string password, MediaObject mediaObject)

    {

      if(!SecurityService.IsValid(login, password))

        throw new SecurityException();



      //

      // Parsing media object name.

      if(mediaObject.Name.IndexOf("^") < 0)

        throw new ArgumentException();



      string pageName = mediaObject.Name.Substring(0, mediaObject.Name.IndexOf("^"));

      string attachmentName = mediaObject.Name.Substring(mediaObject.Name.IndexOf("^") + 1);



      Space space = SpaceManagerService.GetSpaceByID(Convert.ToInt64(blogID));

      Page page = PageManagerService.GetPageBySpaceKeyAndPageName(space.Key, pageName);



      PageAttachment pageAttachment = PageAttachmentManagerService.GetPageAttachmentByName(page, attachmentName);

      if(pageAttachment == null)

      {

        pageAttachment = new PageAttachment(attachmentName, mediaObject.MimeType);

        page.AddAttachment(pageAttachment);

      } // if



      pageAttachment.AddRevision(new PageAttachmentRevision(UserManagerService.GetUserByLogin(login), mediaObject.Content));



      PageManagerService.SavePage(page);



      return new MediaObjectInfo(NavigationService.ResolveVirtualUrl(NavigationService.GetPageAttachmentUrl(pageAttachment)));

    }

  }

}

MetaWeblog API в.NET