rui.zhang db87c84f40 edit doc
Change-Id: I158d2a7adcc2e6611b09192be4fc0df1934eeab5
2018-12-20 23:03:58 +08:00
2018-12-20 23:03:58 +08:00
2018-12-19 19:20:32 +08:00
2018-12-19 19:01:58 +08:00
2018-12-20 11:33:44 +08:00
2018-12-20 23:03:58 +08:00

简介

WordPress Client是一个Java版的WordPress客户端操作库 主要基于WordPress XML-RPC API实现。目前WordPress Client提供了如下能力

  • 获取WordPress用户信息
  • 获取博客文章信息
  • 发布文章到WordPress部署的博客
  • 对已发布的文章进行编辑、删除等操作

使用

添加依赖

只需要在maven工程中的pom文件中添加如下依赖就可以使用wp-client

        <dependency>
            <groupId>org.chobit.wp</groupId>
            <artifactId>wordpress-client</artifactId>
            <version>0.1.1</version>
        </dependency>

目前wp-client的版本是0.1.1。请尽量使用最新版本。

创建WordPress操作实例

WordPress实例是所有操作的基础。要创建WordPress实例我们需要先创建一个WPConfig实例即WordPress配置对象。WPConfig实例构建方式如下

        WPConfig config =
                new WPConfigBuilder().xmlRpcUrl(XML_RPC_URL)
                        .username(USERNAME)
                        .password(PASSWORD)
                        .trustAll(true)
                        .build();

不建议也不允许直接构建WPConfig实例正确的方式是通过WPConfigBuilder来完成构建。构建中的几个重要参数如下

  • xmlRpcUrlxmlRpc服务端地址WordPress博客的地址通常为博客地址 + xmlrpc.php,如我的博客:http://www.zhyea.com/xmlrpc.php
  • username和password登录WordPress博客后台使用的用户名和密码
  • trustAll如博客未启用https可忽略如已启用https建议将之设置为true否则需要导入证书文件后再进行操作

使用WPConfig实例来创建WordPress实例

        WordPress wp = new WordPress(config);

在WordPress类中封装了与WordPress进行交互的各种方法。接下来会逐个详细介绍下。

获取作者信息

在WordPress中提供了getUserBlogs和getAuthors两个方法来获取作者信息。

使用getUsersBlogs()方法可以获取非常简单的用户和博客信息:

        List<UserBlog> list = wp.getUsersBlogs();

返回值如下:

[
    {
        "blogName": "ZY笔记",
        "url": "http://www.zhyea.com/",
        "admin": false,
        "blogid": 1,
        "xmlrpc": "http://www.zhyea.com/xmlrpc.php"
    }
]

(为了便于查看故用json包装了下返回结果)

getAuthors()方法返回的主要是用户相关的信息:

        List<Author> list = wp.getAuthors();

返回值如下:

[
    {
        "user_id": "1",
        "user_login": "zhyea",
        "display_name": "白42"
    },
    {
        "user_id": "2",
        "user_login": "robin",
        "display_name": "robin"
    }
]

新增文章

获取文章

编辑文章

删除文章

Description
No description provided
Readme Apache-2.0 105 KiB
Languages
Java 100%