org.wikibrain.wikidata

Class WikidataSqlDao

java.lang.Object

org.wikibrain.core.dao.sql.AbstractSqlDao<WikidataStatement>

org.wikibrain.wikidata.WikidataSqlDao

All Implemented Interfaces:

Dao<WikidataStatement>, WikidataDao

public class WikidataSqlDao
extends AbstractSqlDao<WikidataStatement>
implements WikidataDao

Author:

Shilad Sen

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	WikidataSqlDao.Provider

Field Summary

Fields inherited from class org.wikibrain.core.dao.sql.AbstractSqlDao

cache, DEFAULT_FETCH_SIZE, dialect, LOG, wpDs

Constructor Summary

Constructors

Constructor and Description
WikidataSqlDao(WpDataSource dataSource, LocalPageDao lpDao, UniversalPageDao upDao)

Method Summary

Methods

Modifier and Type	Method and Description
void	beginLoad()
protected WikidataStatement	buildStatement(org.jooq.Record record)
Set<Integer>	conceptsWithValue(String propertyName, WikidataValue value)
void	endLoad()
Iterable<WikidataStatement>	get(DaoFilter daoFilter)
Iterable<WikidataStatement>	get(WikidataFilter filter) Returns all statements that meet some sort of criterion.
Iterable<WikidataStatement>	getByValue(String propertyName, WikidataValue value)
Iterable<WikidataStatement>	getByValue(WikidataEntity property, WikidataValue value)
int	getCount(DaoFilter daoFilter)
WikidataEntity	getItem(int id) Returns the item associated with the particular id
Integer	getItemId(LocalId localId)
Integer	getItemId(LocalPage page) Gets the item id for a given LocalPage (the number after "Q")
LocalWikidataStatement	getLocalStatement(Language language, WikidataStatement statement) Translates a single language-agnostic statement into a human interpretable statement in that particular language.
Map<String,List<LocalWikidataStatement>>	getLocalStatements(Language lang, WikidataEntity.Type type, int id) Returns all statements for the specified concept id.
Map<String,List<LocalWikidataStatement>>	getLocalStatements(LocalPage page) Returns human-understandable interpretations of statements for a particular page.
Map<Integer,WikidataEntity>	getProperties() Returns all known properties.
WikidataEntity	getProperty(int id) Fetches the property associated with an id.
WikidataEntity	getProperty(Language language, String name) Gets a property by a name in some language.
Collection<WikidataEntity>	getPropertyByName(Language language, String name)
Collection<WikidataEntity>	getPropertyByName(String name)
List<WikidataStatement>	getStatements(LocalPage page) Returns all statements for a particular page.
UniversalPage	getUniversalPage(int itemId) Gets the LocalPage for the input itemId (the number after "Q") and language (if it exists)
Set<LocalId>	pagesWithValue(String propertyName, WikidataValue value, Language language)
void	save(WikidataEntity entity) Saves the specified entity
void	save(WikidataStatement item)

Methods inherited from class org.wikibrain.core.dao.sql.AbstractSqlDao

clear, executeSqlResource, executeSqlScriptWithSuffix, freeJooq, getFetchSize, getJooq, getLoadedLanguages, insert, quietlyCloseConn, setFetchSize, useCache

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.wikibrain.core.dao.Dao

clear, getLoadedLanguages

Constructor Detail

WikidataSqlDao

public WikidataSqlDao(WpDataSource dataSource,
              LocalPageDao lpDao,
              UniversalPageDao upDao)
               throws DaoException

Parameters:

dataSource - Data source for jdbc connections

Throws:

DaoException

Method Detail

getProperty

public WikidataEntity getProperty(Language language,
                         String name)
                           throws DaoException

Description copied from interface: WikidataDao

Gets a property by a name in some language.

Specified by:

getProperty in interface WikidataDao

Throws:

DaoException

getProperty

public WikidataEntity getProperty(int id)
                           throws DaoException

Description copied from interface: WikidataDao

Fetches the property associated with an id. There aren't many properties (~850 as of Jan 2014), so the implementation should cache them.

Specified by:

getProperty in interface WikidataDao

Parameters:

id - The numeric number appearing after the "P" in the Wikimedia Foundation ids.

Returns:

Throws:

DaoException

getItem

public WikidataEntity getItem(int id)
                       throws DaoException

Description copied from interface: WikidataDao

Returns the item associated with the particular id

Specified by:

getItem in interface WikidataDao

Parameters:

id - The numeric number appearing after the "Q" in the Wikimedia Foundation ids.

Returns:

Throws:

DaoException

getProperties

public Map<Integer,WikidataEntity> getProperties()
                                          throws DaoException

Description copied from interface: WikidataDao

Returns all known properties. The implementation should cache them.

Specified by:

getProperties in interface WikidataDao

Returns:

Throws:

DaoException

getItemId

public Integer getItemId(LocalPage page)
                  throws DaoException

Description copied from interface: WikidataDao

Gets the item id for a given LocalPage (the number after "Q")

Specified by:

getItemId in interface WikidataDao

Returns:

Throws:

DaoException

getItemId

public Integer getItemId(LocalId localId)
                  throws DaoException

Specified by:

getItemId in interface WikidataDao

Throws:

DaoException

getUniversalPage

public UniversalPage getUniversalPage(int itemId)
                               throws DaoException

Description copied from interface: WikidataDao

Gets the LocalPage for the input itemId (the number after "Q") and language (if it exists)

Specified by:

getUniversalPage in interface WikidataDao

Returns:

The matching LocalPage, or null if it doesn't exist

Throws:

DaoException

getStatements

public List<WikidataStatement> getStatements(LocalPage page)
                                      throws DaoException

Description copied from interface: WikidataDao

Returns all statements for a particular page.

Specified by:

getStatements in interface WikidataDao

Returns:

Throws:

DaoException

getPropertyByName

public Collection<WikidataEntity> getPropertyByName(Language language,
                                           String name)
                                             throws DaoException

Throws:

DaoException

getPropertyByName

public Collection<WikidataEntity> getPropertyByName(String name)
                                             throws DaoException

Throws:

DaoException

getLocalStatements

public Map<String,List<LocalWikidataStatement>> getLocalStatements(LocalPage page)
                                                            throws DaoException

Description copied from interface: WikidataDao

Returns human-understandable interpretations of statements for a particular page. They are translated into the language of the requested page.

Specified by:

getLocalStatements in interface WikidataDao

Returns:

Throws:

DaoException

beginLoad

public void beginLoad()
               throws DaoException

Specified by:

beginLoad in interface Dao<WikidataStatement>

Overrides:

beginLoad in class AbstractSqlDao<WikidataStatement>

Throws:

DaoException

save

public void save(WikidataEntity entity)
          throws DaoException

Description copied from interface: WikidataDao

Saves the specified entity

Specified by:

save in interface WikidataDao

Throws:

DaoException

save

public void save(WikidataStatement item)
          throws DaoException

Specified by:

save in interface Dao<WikidataStatement>

Throws:

DaoException

endLoad

public void endLoad()
             throws DaoException

Specified by:

endLoad in interface Dao<WikidataStatement>

Overrides:

endLoad in class AbstractSqlDao<WikidataStatement>

Throws:

DaoException

getLocalStatements

public Map<String,List<LocalWikidataStatement>> getLocalStatements(Language lang,
                                                          WikidataEntity.Type type,
                                                          int id)
                                                            throws DaoException

Description copied from interface: WikidataDao

Returns all statements for the specified concept id.

Specified by:

getLocalStatements in interface WikidataDao

Parameters:

lang - Language for local statements

type - Type of entity (item or property)

id - numeric id (i.e. suffix after "Q" or "P")

Returns:

Throws:

DaoException

getLocalStatement

public LocalWikidataStatement getLocalStatement(Language language,
                                       WikidataStatement statement)
                                         throws DaoException

Description copied from interface: WikidataDao

Translates a single language-agnostic statement into a human interpretable statement in that particular language.

Specified by:

getLocalStatement in interface WikidataDao

Returns:

Throws:

DaoException

getByValue

public Iterable<WikidataStatement> getByValue(WikidataEntity property,
                                     WikidataValue value)
                                       throws DaoException

Specified by:

getByValue in interface WikidataDao

Throws:

DaoException

getByValue

public Iterable<WikidataStatement> getByValue(String propertyName,
                                     WikidataValue value)
                                       throws DaoException

Specified by:

getByValue in interface WikidataDao

Throws:

DaoException

conceptsWithValue

public Set<Integer> conceptsWithValue(String propertyName,
                             WikidataValue value)
                               throws DaoException

Specified by:

conceptsWithValue in interface WikidataDao

Throws:

DaoException

pagesWithValue

public Set<LocalId> pagesWithValue(String propertyName,
                          WikidataValue value,
                          Language language)
                            throws DaoException

Specified by:

pagesWithValue in interface WikidataDao

Throws:

DaoException

get

public Iterable<WikidataStatement> get(WikidataFilter filter)
                                throws DaoException

Description copied from interface: WikidataDao

Returns all statements that meet some sort of criterion.

Specified by:

get in interface WikidataDao

Returns:

Throws:

DaoException

get

public Iterable<WikidataStatement> get(DaoFilter daoFilter)
                                throws DaoException

Specified by:

get in interface Dao<WikidataStatement>

Throws:

DaoException

getCount

public int getCount(DaoFilter daoFilter)
             throws DaoException

Specified by:

getCount in interface Dao<WikidataStatement>

Throws:

DaoException

buildStatement

protected WikidataStatement buildStatement(org.jooq.Record record)
                                    throws DaoException

Throws:

DaoException