使用REST创建BlogPost XWiki

Question

我需要创建(使用XWiki API REST)一个BlogPost。但我不知道如何使用REST。使用以下命令：

$ curl -u Admin:admin -X PUT --data-binary "@newpage.xml" -H "Content-Type: application/xml" http://localhost:8080/xwiki/rest/wikis/xwiki/spaces/Main/pages/NewPage

并使用此XML文件：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<page xmlns="http://www.xwiki.org">     
        <title>Hello world</title>
        <syntax>xwiki/2.0</syntax>
        <content>This is a new page</content>
</page>

我在Main空间中创建了一个页面。但是我想在Blog空间里有个BlogPost。我必须使用的标记是什么？(我找到了这个命令here)

Answer 1

要使用的正确命令是：

curl -u Admin:admin -X POST --data-binary "@blogpost.xml" -H "Content-Type: application/xml" http://localhost:8080/xwiki/rest/wikis/xwiki/spaces/Blog/pages/A+New+Blogpost/objects

XML文件应如下所示：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<object xmlns="http://www.xwiki.org"><className>Blog.BlogPostClass</className>
    <property name="category"><value>Blog.News</value></property>
    <property name="content"><value>This is the new blog post. You can use **wiki syntax** in it.

Don't forget to escape XML entities like &amp; and &lt;!</value></property>
    <property name="publishDate"><value>2012-06-06 12:00:00.0</value></property>
    <property name="published"><value>1</value></property>
    <property name="title"><value>Second blog post</value></property>
</object>

需要注意的几件事：

• 文档必须已存在，这不适用于不存在的文档。因此，首先要做的是将标题和父对象添加到新文档中，然后您可以向新文档中添加对象。
• 创建对象的正确动词是POST，URL是通过将/objects附加到文档的REST URL中获得的。
• 新创建对象的实际REST URL将作为重定向返回。您可以截获重定向并根据需要处理URL，也可以让重定向通过，您将返回使用详细的完整语法创建的对象。
• 通常在发送资源时使用与获取资源时返回的语法相同的语法，尽管并不需要所有数据。例如，我首先获得一个现有的(').

对象，然后删除服务器不需要接收的所有内容，因为它可以在本地计算它。

• 我注意到(我认为这是一个bug)，在获取资源时，XML实体被编码两次(')，而发送的资源应该只编码一次blogpost实体。