Package org.openrefine.wikidata.schema

Class WikibaseSchema

java.lang.Object

org.openrefine.wikidata.schema.WikibaseSchema

All Implemented Interfaces:

OverlayModel

public class WikibaseSchema
extends Object
implements OverlayModel

Main class representing a skeleton of Wikibase edits with OpenRefine columns as variables.

Author:

Antonin Delpeuch

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected class	WikibaseSchema.EvaluatingRowVisitor

Field Summary

Fields

Modifier and Type	Field	Description
protected List<WbExpression<? extends EntityEdit>>	entityEditExprs
protected Map<String,String>	entityTypeSiteIri
protected String	mediaWikiApiEndpoint
protected String	siteIri

Constructor Summary

Constructors

Constructor	Description
WikibaseSchema()	Constructor.
WikibaseSchema(List<WbExpression<? extends EntityEdit>> exprs, List<WbItemEditExpr> legacyItemExprs, String siteIri, Map<String,String> entityTypeSiteIri, String mediaWikiApiEndpoint)	Constructor for deserialization via Jackson

Method Summary

Modifier and Type	Method	Description
void	dispose(Project project)
boolean	equals(Object other)
List<EntityEdit>	evaluate(Project project, Engine engine)	Same as above, ignoring any warnings.
List<EntityEdit>	evaluate(Project project, Engine engine, QAWarningStore warningStore)	Evaluates the schema on a project, returning a list of EntityUpdates generated by the schema.
List<EntityEdit>	evaluateEntityDocuments(ExpressionContext ctxt)	Evaluates all entity documents in a particular expression context.
List<WbExpression<? extends EntityEdit>>	getEntityDocumentExpressions()
Map<String,String>	getEntityTypeSiteIri()
String	getMediaWikiApiEndpoint()
String	getSiteIri()
static WikibaseSchema	load(Project project, String obj)
void	onAfterSave(Project project)
void	onBeforeSave(Project project)
static WikibaseSchema	reconstruct(String json)

Methods inherited from class java.lang.Object

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

Field Details

entityEditExprs

protected List<WbExpression<? extends EntityEdit>> entityEditExprs

siteIri

protected String siteIri

entityTypeSiteIri

protected Map<String,String> entityTypeSiteIri

mediaWikiApiEndpoint

protected String mediaWikiApiEndpoint

Constructor Details

WikibaseSchema

public WikibaseSchema()

Constructor.

WikibaseSchema

public WikibaseSchema(List<WbExpression<? extends EntityEdit>> exprs,
 List<WbItemEditExpr> legacyItemExprs,
 String siteIri,
 Map<String,String> entityTypeSiteIri,
 String mediaWikiApiEndpoint)

Constructor for deserialization via Jackson

Method Details

getSiteIri

public String getSiteIri()

Returns:

the site IRI of the Wikibase instance referenced by this schema

getEntityTypeSiteIri

public Map<String,String> getEntityTypeSiteIri()

Returns:

the site IRI of the Wikibase instance referenced by this schema

getEntityDocumentExpressions

public List<WbExpression<? extends EntityEdit>> getEntityDocumentExpressions()

Returns:

the list of document expressions for this schema

getMediaWikiApiEndpoint

public String getMediaWikiApiEndpoint()

evaluateEntityDocuments

public List<EntityEdit> evaluateEntityDocuments(ExpressionContext ctxt)
                                         throws QAWarningException

Evaluates all entity documents in a particular expression context. This specifies, among others, a row where the values of the variables will be read.

Parameters:

ctxt - the context in which the schema should be evaluated.

Returns:

Throws:

QAWarningException

evaluate

public List<EntityEdit> evaluate(Project project,
 Engine engine,
 QAWarningStore warningStore)

Evaluates the schema on a project, returning a list of EntityUpdates generated by the schema. Some warnings will be emitted in the warning store: those are only the ones that are generated at evaluation time (such as invalid formats for dates). Issues detected on candidate statements (such as constraint violations) are not included at this stage.

Parameters:

project - the project on which the schema should be evaluated

engine - the engine, which gives access to the current facets

warningStore - a store in which issues will be emitted

Returns:

entity updates are stored in their generating order (not merged yet).

evaluate

public List<EntityEdit> evaluate(Project project,
 Engine engine)

Same as above, ignoring any warnings.

reconstruct

public static WikibaseSchema reconstruct(String json)
                                  throws IOException

Throws:

IOException

load

public static WikibaseSchema load(Project project,
 String obj)
                           throws Exception

Throws:

Exception

onBeforeSave

public void onBeforeSave(Project project)

Specified by:

onBeforeSave in interface OverlayModel

onAfterSave

public void onAfterSave(Project project)

Specified by:

onAfterSave in interface OverlayModel

dispose

public void dispose(Project project)

Specified by:

dispose in interface OverlayModel

equals

public boolean equals(Object other)

Overrides:

equals in class Object