发布了PHP REST客户端的稳定版本和开发人员教程

作为几个月前宣布，有用于PHP的新REST客户端开发人员（restclient-php）。现在，我们可以宣布1.0.0版的第一个稳定版本。这个PHP库非常易于使用和支持BibSonomy REST API的所有功能它还提供了一个集成的CSL处理器（citeproc-php），帮助您呈现书目。

此外，还有restclient-php的使用教程其中包含一些有用的示例脚本。

我们希望这能帮助您开发自己的BibSonomy应用程序。

快乐标签，
塞巴斯蒂安

本周特色：PHP新REST客户端

我们花了一些时间开发了一个新的全功能REST客户端为了让您更容易为BibSonomy开发新的应用程序，请使用PHP。

新的REST客户端库具有许多新功能：

• 它功能齐全，这意味着客户端支持API的全部功能。
• 它包含一个模型，便于您处理数据。
• 它支持基本身份验证以及OAuth（OAuth）身份验证方法。
• 很容易集成到您的PHP应用程序中，因为我们已经使用作曲家，一个强大的工具，用于集成和自动加载第三方软件的需求。
• 您可以将获取的出版物集输出为CSL呈现的出版物列表，并使用您喜欢的引用样式。

为了使用rest客户端-php库需要执行三个步骤：

1. 通过composer安装库并包含自动加载器文件。
   
   在本地安装Composer只需在项目目录中运行安装程序：
   
   卷曲-sShttps://getcomposer.org/安装程序| php（电话）
   
   然后，将restclient添加到项目的需求中。在项目文件夹中的终端上运行以下命令：
   
   php-composer.phar需要academpuma/restclient-php:1.0.0-alpha
    
2. 创建访问器。需要此对象才能在上对应用程序进行身份验证REST APIBibSonomy的。您可以选择两种身份验证方法，基本身份验证或OAuth公司。对于基本身份验证这将是：
   
   <？php

需要“path/to/vendor/autoload.php”；
使用AcademicPuma\RestClient\Accessor\BasicAuthAccessor；

$accessor=新的BasicAuthAccessor（'http://www.bibsonomy.org'，[您的用户名]，'[您的名字]'）；
?>
 
3. 创建一个RESTClient对象并执行请求。此对象是BibSonomy的接口。此类提供了所有支持的函数来获取、创建、更新和删除帖子、标记、文档、用户和组。例如：
   
   <？php

使用AcademicPuma\RestClient\RestClient；
使用AcademicPuma\RestClient\Config；

$restClient=新restClient（$accessor）；
//选择资源类型和标记
$restClient->getPosts（Config\Resourcetype:：BIBTEX，Config\Grouping:：USER，[username]，['tag1'，'tag2']）；
?>
   
   现在，您可以选择格式。有四个选项：XML、CSL（JSON）、Model（PHP Objects）、Bibliography（CSL呈现的出版物列表）：
   
   

   <？php//输出xmlecho$restClient->xml（）；//输出CSLecho json_encode（$restClient->csl（））；//使用模型$posts=$restClient->model（）；foreach（$posts作为$post）{echo$post->getResource（）->getTitle（）。“<br/>\n”；}//用你喜欢的风格和语言打印一份参考书目echo$restClient->书目（'apa'，'en-US'）；?>

目前rest客户端-php被认为是不稳定的alpha版本。如果您遇到任何错误或问题，请随时在代码库中报告问题.

快乐标签，
塞巴斯蒂安。

本周特色：通过REST API创建概念

作为我们博客的细心读者，你会注意到标记关系，或概念是BibSonomy的一个功能，对我们来说很重要，但可能并不常用。我们之前的一些博客帖子中提出了以下概念

• http://blog.bibsonomy.org/2007/04/feature-of-wek-relations.html
• http://blog.bibsonomy.org/2007/11/feature-of-wek-retrieve-resources-by.html
• http://blog.bibsonomy.org/2010/04/feature-of-wek-relations-last-major.html

我们最近开始更好地支持概念BibSonomy的REST API通过实施创造新概念在Java REST客户端中。在这篇文章中，我给你一个如何访问此功能的示例。由于我们从头开始，因此本文也很好地介绍了如何使用Java REST客户端。

设置Maven

使用马文因为构建管理确实简化了许多事情，所以让我们使用它。首先，为项目创建一个目录并更改为该目录。你所做的一切现在都会发生在那里。然后在该目录中，为源代码创建一个目录：

mkdir-p src/main/java

然后创建一个名为pom.xml（pom.xml）包含以下内容：

<？xml version=“1.0”encoding=“UTF-8”？><项目xmlns=“http://maven.apache.org/POM/4.0.0"                                                                                                        xmlns:xsi=“http://www.w3.org/2001/XMLSchema-instance"                                                                                               xsi:schemaLocation=“http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0.xsd"><modelVersion>4.0.0测试<groupId>com.example</groupId><artifactId>测试<版本>0.0.1</版本><存储库><存储库><id>dev.bibsonomy.org<网址>http://dev.bibsonomy.org/maven2/</url></repository></repositories（存储库）><依赖项><依赖性><groupId>org.bibsonomy</groupId><artifactId>bibsonomy-rest-client<版本>2.0.43</依赖性><依赖性><groupId>org.bibsonomy</groupId><artifactId>bibsonomy-model<版本>2.0.43</依赖性></依赖项></项目>

如果一切正常，您现在可以通过呼叫进行测试根项目上进行构建它会用最后一个

[信息]构建成功

编写和调用Java代码

现在可以开始编写第一个Java代码了。创建文件src/main/java/Test.java包含以下内容：

类别测试{public static void main（字符串参数[]）{System.out.println（“你好，世界！”）；}}

您可以通过调用根项目上进行构建再一次。生成的JAR文件测试-0.0.1.jar将位于目标文件夹。您可以使用以下命令运行此类

java-cp target/test-0.0.1.jar测试

或者与

mvn-exec:java-Dexec.mainClass=“测试”

后者是下一步的首选，因为您将包括Maven自动解析其依赖项的一些库。

调用REST API

更改文件测试.java至以下代码：

导入java.util.*；                                                                                                                                          导入org.bibsonomy.common.enums.*；导入org.bibsonomy.model.*；                                                                                                                                导入org.bibsonomy.model.logic.*；导入org.bibsonomy.model.enums.*；                                                                                                                          导入org.bibsonomy.rest.client.*；类别测试{公共静态void main（字符串参数[]）{RestLogicFactory rlf=新RestLogic工厂（“http://www.bibsonomy.org/api");LogicInterface逻辑=rlf.getLogicAccess（“jaeschke”，“YOUR-API-KEY-HERE”）；列表<Post<BibTex>>posts=logic.getPosts（BibTex.class，GroupingEntity.USER，“jaeschke”，null，null、null、null、Order.ADDED，null和null，0，1）；for（Post<BibTex>帖子：帖子）{BibTex发布=post.getResource（）；System.out.println（publication.getTitle（））；}}}

请注意，您必须更改行

LogicInterface逻辑=rlf.getLogicAccess（“jaeschke”，“YOUR-API-KEY-HERE”）；

使用BibSonomy用户名而不是“jaeschke”。您还必须插入API密钥，您可以从中获取BibSonomy的设置页面.编译时(根项目上进行构建)然后运行(mvn-exec:java-Dexec.mainClass=“测试”)这个类，它应该打印我上一篇发表文章。现在再次更改该代码，以最终创建概念。

使用REST API创建概念

导入java.util.*；导入org.bibsonomy.common.enums.*；导入组织bibsonomy.model.*；导入org.bibsonomy.model.logic.*；导入org.bibsonomy.model.enums.*；导入org.bibsonomy.model.util.*；导入org.bibsonomy.rest.client.*；类别测试{公共静态void main（字符串args[]）{LogicInterface逻辑=new RestLogicFactory（）.getLogicAccess（“jaeschke”，“YOUR-API-KEY-HERE”）；标签概念=新标签（“科学”）；concept.addSubTag（新标签（“物理”））；concept.addSubTag（新标签（“化学”））；concept.addSubTag（新标签（“生物学”））；logic.createConcept（concept，GroupingEntity.USER，“jaeschke”）；}}

同样，您必须在呼叫中更改您的凭据获取逻辑访问（）.

代码的作用是什么？首先，它为“科学”概念创建了一个对象

标签概念=新标签（“科学”）；

然后添加子概念“物理”、“化学”和“生物”：

concept.addSubTag（新标签（“物理”））；concept.addSubTag（新标签（“化学”））；concept.addSubTag（新标签（“生物学”））；

最后，概念存储在服务器上：

logic.createConcept（concept，GroupingEntity.USER，“jaeschke”）；

请注意，您必须在此处用用户名交换“jaeschke”，因为您只能为自己的帐户创建概念。然后，您可以在侧边栏中找到这个概念：

就这样！ :-)


快乐编程和标记！

本周特色：BibSonomy REST-API的Python客户端

本周的专题涉及当前正在进行的几项活动：

1. 我们正在将我们的开发基础设施迁移到比特桶.
2. 我们正在重新激活蟒蛇REST API的客户端。
3. 我们正在开发一个CKAN公司扩展。

这些活动在某种程度上是相关的，至少我必须在这篇文章中提到这三个方面。

移动到Bitbucket

作为进一步向其他开发人员开放BibSonomy并简化使用BibSonomy基础设施的应用程序开发的重要步骤，我们将迁移到Bitbucket，直到下一个版本（计划于1月底发布）。目前菲律宾比索, 类型3, 安卓等移动到新的Bitbucket BibSonomy帐户。其他代码将在接下来的几周内发布，特别是当前在dev.bibsonomy.org网站.

Python客户端

The 旧的Python客户端对于BibSonomy REST API不再进行维护，也没有被真正的用户真正使用（因此也没有测试）。由于我们现在需要Python客户端（请参阅下一节），我们开始开发新客户.

作为测试代码和实现一些不错功能的第一个用途，我们编写了一个小脚本一个文件.py它允许您将BibSonomy中的所有帖子下载到一个HTML文件中，您可以在脱机模式下使用该文件。这对于没有互联网连接的情况很方便，特别是因为脚本还允许您下载所有文档！您可以使用访问的文档--帮助向您展示了可能的情况：

用法：onefile.py[-h][-u USER][-t TAG[TAG…]][-d]

[-书签文件BFILE][-发布文件BFILE]

[--css-file CSSFILE][--无书签][--没有发布]

[--测试]

用户apikey

从BibSonomy下载帖子并将其存储在文件中。

位置参数：

user BibSonomy用户名

apikey对应的API密钥（从

                        http://www.bibsonomy.org/settings？selTab=1)

可选参数：

-h，--help显示此帮助消息并退出

-u USER，--用户USER为USER而不是用户返回帖子

-t TAG[标签…]，--标签TAG[标记…]

返回包含给定标记的帖子

-d，--文档为出版物下载文档

--书签文件

书签的文件名

--公开文件BFILE

出版物的文件名

--css-file CSSFILE将css写入文件

--无书签不写入书签

--无出版物不编写出版物

--测试使用测试数据

我们目前正在积极改进脚本，因此反馈和建议如下非常欢迎.

CKAN扩展

CKAN公司是一个基于web的平台，供科学家管理和发布数据集元数据链接的打开数据。为了更好地将数据集与描述和使用数据集的出版物联系起来，我们目前正在实施CKAN扩展它允许用户将其数据集与BibSonomy中的相应出版物相连接。模型屏幕截图显示了我们打算如何将出版物集成到CKAN中：

我们认为这些对所有开发人员来说都是好消息，因为使用Python快速开发基于BibSonomy的应用程序现在变得容易多了。欢迎反馈和贡献-源代码对每个人都是开放和免费的。

快乐发展！