HowTo: Einführung in die MetaWebLogAPI
Dieser Blogpost basiert auf Scott Hanselmans “WeeklySourceCode”, wo diese Woche das Thema MetaWebLogAPI dran kam. In dem Blogpost berichtet er, dass MS auch intern zum Verwalten ihrer Seiten den Windows Live Writer nutzen. Das Tool ist absolut praktisch und ist “MetaWebLogAPI” kompatibel. Durch diese API ist es z.B. möglich mit Standard Tools (Word oder den Windows Live Writer) “CMS” Content zu erzeugen.
Was nützt mir das?
Der normale Endanwender mag ein einfachen WYSIWYG Editor haben. Es gibt einige nette Editoren, wie z.B. tinyMCE. Das größte Problem was ich bislang mit solchen Web-basierten Lösungen habe ist, dass der Umgang mit Bildern meistens Arg abenteuerlich gestaltet ist. Der normale User mag es, einfach die Bilder per Copy and Paste ins Word zu verschieben und dort noch ein paar Effekte anzustellen. Wenn man nun selber Webseitenbetreiber ist und seinen Kunden ein “einfaches” Frontend zur Verfügung stellen möchte, der kann die MetaWebLog API implementieren.
Standard Tools
Der große Vorteil ergibt sich durch die netten Clients. Auf der einen Seite gibt es z.B. den Windows Live Writer:
Aber auch Word ab der Version 2007:
In diesen Tools kann man einfach aus der Zwischenablage Bilder etc. einfügen und entsprechend editieren. Erst beim “Veröffentlichen” werden die Daten zum Server übertragen.
Technischer Hintergrund: XmlRPC
Die MetaWebLog API basiert nicht auf SOAP, sondern auf XML Remote Process Call (RPC). Im Grunde wird dort auch nur XML übertragen. Ein Beispiel von Wikipedia:
<?xml version="1.0"?>
<methodCall>
<methodName>examples.getStateName</methodName>
<params>
<param>
<value><i4>40</i4></value>
</param>
</params>
</methodCall>
Dafür gibt es auch einen .NET Wrapper.
Die MetaWebLog API hat ein festes Set an Methoden. Dafür wurde bereits im Jahre 2008 von Keyvan Nayyeri eine Schnittstelle für ASP.NET.
namespace NotABlog
{
public interface IMetaWeblog
{
#region MetaWeblog API
[XmlRpcMethod("metaWeblog.newPost")]
string AddPost(string blogid, string username, string password, Post post, bool publish);
[XmlRpcMethod("metaWeblog.editPost")]
bool UpdatePost(string postid, string username, string password, Post post, bool publish);
[XmlRpcMethod("metaWeblog.getPost")]
Post GetPost(string postid, string username, string password);
[XmlRpcMethod("metaWeblog.getCategories")]
CategoryInfo[] GetCategories(string blogid, string username, string password);
[XmlRpcMethod("metaWeblog.getRecentPosts")]
Post[] GetRecentPosts(string blogid, string username, string password, int numberOfPosts);
[XmlRpcMethod("metaWeblog.newMediaObject")]
MediaObjectInfo NewMediaObject(string blogid, string username, string password, MediaObject mediaObject);
#endregion
#region Blogger API
[XmlRpcMethod("blogger.deletePost")]
[return: XmlRpcReturnValue(Description = "Returns true.")]
bool DeletePost(string key, string postid, string username, string password, bool publish);
[XmlRpcMethod("blogger.getUsersBlogs")]
BlogInfo[] GetUsersBlogs(string key, string username, string password);
[XmlRpcMethod("blogger.getUserInfo")]
UserInfo GetUserInfo(string key, string username, string password);
#endregion
}
}
Diese Schnittstelle hat ScottHa in seinem Demoprojekt implementiert, so z.B. :
string IMetaWeblog.AddPost(string blogid, string username, string password,
Post post, bool publish)
{
if (ValidateUser(username, password))
{
string id = string.Empty;
string postFileName;
if (String.IsNullOrEmpty(post.title))
postFileName = Guid.NewGuid() + ".html";
else
postFileName = post.title + ".html";
File.WriteAllText(Path.Combine(LocalPublishPath, postFileName), post.description);
return postFileName;
}
throw new XmlRpcFaultException(0, "User is not valid!");
}
Da ich mich fragte, was mit Bildern geschieht: Diese kommen in der Methode “NewMediaObject” an und können dort als byte Array verarbeitet werden.
Demoprojekt gibts bei ScottHa
Wie bereits gesagt, basiert dieser Post auf dem Post von Scott. Er hat auch sein Demoprojekt veröffentlicht und Daten die ich vom Windows Live Writer oder Word abschicke kommen auch bei den entsprechenden Methoden an.
About the author
Written by Robert Mühsig
Robert Mühsig (@robert0muehsig) ist Webentwickler und beschäftigt sich mit Web-Frameworks (vor allem dem ASP.NET MVC Framework) und scheut sich auch nicht vor Javascript. Ansonsten bloggt er über all jene Probleme, die ihm über den Weg laufen. Seit 2008 ist er Microsoft MVP für ASP.NET und er arbeitet bei der T-Systems Multimedia Solutions GmbH in Dresden. Treffen kann man ihn online via Twitter (@robert0muehsig) oder dieser Seite oder bei der .NET User Group Dresden.
Letzte Kommentare