JavaMetaweblogClient,Metaweblog的java實現-從此上傳博客實現全平臺

• 1. 什麼是Metaweblog?
• 2. Metaweblog的應用
• 3. 如何使用Metaweblog
• 4. 本項目介紹
  • 4.1 metaweblog與java之間的關係映射
  • 4.2 使用JavaMetaweblogClient
  • 5. 最後的話
• FAQ
• 聯繫我

不知你是否會遇到下麵這樣的情況:想要通過java上傳博客,結果卻發現api的使用有些複雜。沒關係，這裡幫你解決了api的問題。在使用Metaweblog的時候，只需要調用網頁上同名的方法就好了，一鍵發送命令，感受調用api的快感。

1. 什麼是Metaweblog?

Metaweblog是一個webservice，也就是在網路上使用的api。它基於xml-rpc實現。對於現存的博客平臺，例如博客園、開源中國、wordpress等都實現了metaweblog。通過這個api，你可以不登錄網頁，直接通過一些程式來增刪查改你的博客，上傳媒體文件。

2. Metaweblog的應用

metaweblog的適用範圍不太廣，但是絕對能滿足於博客管理的需要。通常，面對下麵情況，你就可以使用metaweblog：

• 你已經編輯好了一篇博客，保存為markdown文件，想要快速上傳博客；
• 你想刪除一篇博客；
• 你想更新一篇博客，但又不想複製並粘貼全部；
• 你用離線編輯器寫博客，但是圖片又不想保存在本地，想直接把圖片上傳到博客伺服器裡面；

因此，metaweblog可以滿足你的需要

3. 如何使用Metaweblog

在使用本項目前，你首先需要瞭解一下metaweblog的原理以及如何使用。

目前，有關metaweblog的官網已經崩了，但是你仍然可以在這裡查到它的api。

如圖所示，有很多的方法（函數）可供調用。顯然，你可以按照它的指示調用方法，實現博客的增刪查改和媒體文件的上傳。

在這張圖裡，我們看到的是博客園的api調用界面，而別的網站則不一定有這樣的界面，但是你可以自己嘗試它們的api是否開放。下麵是各大博客網站的api地址

• 博客園：https://rpc.cnblogs.com/metaweblog/你的用戶名,你可以在你的後臺設置里查看有關設置

• 開源中國：https://my.oschina.net/action/xmlrpc

• 51cto：http://imguowei.blog.51cto.com/xmlrpc.php

• 網易（163）：http://os.blog.163.com/word/

• typecho 博客：http://xx.com/action/xmlrpc，其中 xx.com 為你的博客網址。如果 typecho 還沒有進行 urlrewrite，則為 http://xx.com/index.php/action/xmlrpc

• 新浪博客： http://upload.move.blog.sina.com.cn/blog_rebuild/blog/xmlrpc.php 新浪博客的 API 已關閉了

• CSDN: http://write.blog.csdn.net/xmlrpc/index,可惜CSDN的api也關閉了

• 自建wordpress博客: http://www.example.com/xmlrpc.php,其中www.example.com是你的網站地址功能變數名稱.

4. 本項目介紹

然而, 對於各種語言, metaweblog的實現也不一樣.因此,你需要去尋找各種語言的實現方法.在網上,你可以查到python如何實現metaweblog，C#更是有專門的api，極大地方便了使用者調用。那麼，java呢？很抱歉，網上有關java實現metaweblog的文章少之又少。為瞭解決這種情況，筆者做出了名為JavaMetaweblogClient的api，方便java愛好者去調用，去實現。

4.1 metaweblog與java之間的關係映射

如果你看了api的介紹，你就會知道，這個api是給多個語言使用的，所以很多的數據類型java都沒有。那麼我們就需要一個映射表。本項目通過apache 的xmlrpc實現，所以我們可以查看他的官方文檔

這些就是你要去瞭解的。其中，struct的類型對應到java裡面是Map<String,Object>。但是你並不需要如此，在本項目中，我已經將struct打包成了一個類對象，例如Post，裡面的成員變數就是dateTime description title categories四個.需要用的時候就依次把變數填入即可。

這時，你在使用這些方法時就會更加的得心應手。

4.2 使用JavaMetaweblogClient

本項目本質上只實現了Client，但是很明顯我們只需要client，伺服器的事由博客方來乾。那麼我們就要來瞭解一下如何使用api。

打開本項目的java文檔，你會看見Client類上有教程，但是在這裡我還是會再打一遍。

使用方法大致分為以下三步：(以新建一個博客文章為例)

1. 你要創建一個Client對象
2. 準備好參數
3. 上傳命令,並處理異常

這裡我們以newPost方法為例：

public static void newPostTest() {
   // 準備好命令所需參數(新建Post對象)
    Post post = new Post(new Date(), "# This is a post\n> You can see the Post\n", "Test");
    // 準備好返回值(自己看方法註釋的返回類型)
    String result = null;
    // 創建連接客戶端
    try {   // 自己解決拋出的異常
        Client client = new Client("https://www.cycode.club/xmlrpc.php");
        result = client.newPost("default", "S*******u", "******", post, false);
    } catch (MalformedURLException e) {
        e.printStackTrace();    // 一般為URL格式錯誤
    } catch (XmlRpcException e) {
        e.printStackTrace();    // 一般為參數不全、伺服器錯誤、URL輸入錯誤
    }
    // 輸出結果
    System.out.println(result);
    }

其中的核心代碼只有一條：

result = client.newPost("default", "S*****u", "*****", post, false);

至於其他的代碼，通常IDE會自己生成，以及提醒你參數的填入。其中Post參數需要直接填入本項目已創建好的Post類，而不是自己寫一個Map<String,Object>.

5. 最後的話

作為新手程式員和他的第一個api,有很多的信息都在javadoc文檔里。如果有什麼問題，儘量去查看docs文檔，有很多位置都可以查看文檔。

1. 下載使用的jar包內的docs文件夾
2. github上的項目地址中的docs文件夾
3. docs文件夾的托管地址(推薦,更新的最快)

FAQ

1. Q：目前程式有什麼已知的問題嗎？

   A：本項目就是apache的xmlrpc實現的套殼，如果有什麼問題，大多是xmlrpc的問題，畢竟現在用xmlrpc的人已經很少了。

   不過，我依舊發現瞭如下問題：

   • getPost方法與wordpress上的editor.md插件衝突

2. Q：我想知道哪裡有詳細的教程。

   A：本人是新手程式員，管理教程會非常的麻煩，但我大量的幫助文檔都寫死在程式里了，查看javadoc文檔獲得的信息會比在這裡大得多。可以查看本文檔第五項查看javadoc地址。

聯繫我

• email: [email protected]
• QQ: 1914913486
• 博客園: https://www.cnblogs.com/sxrhhh
• github: https://github.com/cycode0527
• 個人網站: https://www.sxrhhh.top(還在實驗中)