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)
WikibaseRepository(String scheme, String host, int port)
WikibaseRepository(String scheme, String host, int port, long[] entityNamespaces)

Method Summary

Methods

Modifier and Type	Method and Description
void	delete(String entityId) Delete entity from repository.
Collection<org.openrdf.model.Statement>	fetchRdfForEntity(String entityId) Fetch the RDF for some entity.
org.json.simple.JSONObject	fetchRecentChanges(Date nextStartTime, int batchSize) Fetch recent changes starting from nextStartTime or continuing from lastContinue depending on the contents of lastContinue way to use MediaWiki.
org.json.simple.JSONObject	fetchRecentChangesBackoff(Date nextStartTime, int batchSize, boolean useBackoff) 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.
Change	getChangeFromContinue(Map<String,Object> nextContinue) Extract timestamp from continue JSON object.
org.json.simple.JSONObject	getContinueObject(Change lastChange) Create JSON change description for continuing.
static org.apache.http.client.HttpRequestRetryHandler	getRetryHandler(int max) Create retry handler.
static DateFormat	inputDateFormat() Create a new DateFormat object that parses from and formats to the date in the format that wikibase returns.
boolean	isEntityNamespace(long namespace) Check that a namespace is valid wikibase entity namespace.
boolean	isValidEntity(String name) Check if the entity ID is a valid entity ID.
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)

WikibaseRepository

public WikibaseRepository(String scheme,
                  String host,
                  int port)

WikibaseRepository

public WikibaseRepository(String scheme,
                  String host,
                  int port,
                  long[] entityNamespaces)

Method Detail

getRetryHandler

public static org.apache.http.client.HttpRequestRetryHandler getRetryHandler(int max)

Create retry handler.

Parameters:

max - Maximum retries number.

Returns:

fetchRecentChangesBackoff

public org.json.simple.JSONObject fetchRecentChangesBackoff(Date nextStartTime,
                                                   int batchSize,
                                                   boolean useBackoff)
                                                     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

batchSize - the number of recent changes to fetch

useBackoff - Should we use backoff time to handle race conditions?

Returns:

result of query

Throws:

RetryableException - thrown if there is an error communicating with wikibase

fetchRecentChanges

public org.json.simple.JSONObject fetchRecentChanges(Date nextStartTime,
                                            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

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

delete

public void delete(String entityId)
            throws RetryableException

Delete entity from repository.

Parameters:

entityId -

Throws:

RetryableException - thrown if there is an error communicating with wikibase

isEntityNamespace

public boolean isEntityNamespace(long namespace)

Check that a namespace is valid wikibase entity namespace.

Parameters:

namespace - the namespace index

Returns:

isValidEntity

public boolean isValidEntity(String name)

Check if the entity ID is a valid entity ID.

Parameters:

name -

Returns:

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.

getChangeFromContinue

public Change getChangeFromContinue(Map<String,Object> nextContinue)
                             throws ParseException

Extract timestamp from continue JSON object.

Parameters:

nextContinue -

Returns:

Timestamp as date

Throws:

ParseException - When data is in is wrong format