org.wikidata.query.rdf.tool.wikibase

Class WikibaseRepository

java.lang.Object

org.wikidata.query.rdf.tool.wikibase.WikibaseRepository

public class WikibaseRepository
extends Object

Wraps Wikibase api.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	WikibaseRepository.Uris URIs used for accessing wikibase.

Constructor Summary

Constructors

Constructor and Description
WikibaseRepository(String scheme, String host)

Method Summary

Modifier and Type	Method and Description
Collection<org.openrdf.model.Statement>	fetchRdfForEntity(String entityId) Fetch the RDF for some entity.
org.json.simple.JSONObject	fetchRecentChanges(Date nextStartTime, org.json.simple.JSONObject lastContinue, int batchSize) Fetch recent changes starting from nextStartTime or continuing from lastContinue depending on the contents of lastContinue way to use MediaWiki.
String	firstEntityIdForLabelStartingWith(String label, String language, String type) Get the first id with the provided label in the provided language.
org.json.simple.JSONObject	getContinueObject(Change lastChange) Create JSON change description for continuing.
static DateFormat	inputDateFormat() Create a new DateFormat object that parses from and formats to the date in the format that wikibase returns.
static DateFormat	outputDateFormat() Create a new DateFormat object that parses from and formats to the date in the format that wikibase wants as input.
String	setLabel(String entityId, String type, String label, String language) Edits or creates a page by setting a label.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

WikibaseRepository

public WikibaseRepository(String scheme,
                          String host)

Method Detail

fetchRecentChanges

public org.json.simple.JSONObject fetchRecentChanges(Date nextStartTime,
                                                     org.json.simple.JSONObject lastContinue,
                                                     int batchSize)
                                              throws RetryableException

Fetch recent changes starting from nextStartTime or continuing from lastContinue depending on the contents of lastContinue way to use MediaWiki. See RecentChangesPoller for how to poll these. Or just use it.

Parameters:

nextStartTime - if lastContinue is null then this is the start time of the query

lastContinue - continuation point if not null

batchSize - the number of recent changes to fetch

Returns:

result of query

Throws:

RetryableException - thrown if there is an error communicating with wikibase

fetchRdfForEntity

public Collection<org.openrdf.model.Statement> fetchRdfForEntity(String entityId)
                                                          throws RetryableException

Fetch the RDF for some entity.

Throws:

RetryableException - thrown if there is an error communicating with wikibase

firstEntityIdForLabelStartingWith

public String firstEntityIdForLabelStartingWith(String label,
                                                String language,
                                                String type)
                                         throws RetryableException

Get the first id with the provided label in the provided language.

Throws:

RetryableException - thrown if there is an error communicating with wikibase

setLabel

public String setLabel(String entityId,
                       String type,
                       String label,
                       String language)
                throws RetryableException

Edits or creates a page by setting a label. Used for testing.

Parameters:

entityId - id of the entity - if null then the entity will be created new

type - type of entity to create or edit

label - label of the page to create

language - language of the label to add

Returns:

the entityId

Throws:

RetryableException - thrown if there is an error communicating with wikibase

outputDateFormat

public static DateFormat outputDateFormat()

Create a new DateFormat object that parses from and formats to the date in the format that wikibase wants as input.

inputDateFormat

public static DateFormat inputDateFormat()

Create a new DateFormat object that parses from and formats to the date in the format that wikibase returns.

getContinueObject

public org.json.simple.JSONObject getContinueObject(Change lastChange)

Create JSON change description for continuing.

Parameters:

lastChange -

Returns:

Change description that can be used to continue from the next change.