eu.europeana.corelib.search

Interface SearchService

All Known Implementing Classes:

SearchServiceImpl

public interface SearchService

Search service that retrieves BriefBeans or APIBeans in the case of a query calculateTag or a FullBean in the case of a user selection. Currently the implementation uses SOLR for Brief/APIBeans and MongoDB for FullBean retrieval.

Author:

Yorgos.Mamakis@ kb.nl, Willem-Jan Boogerd

Method Summary

Modifier and Type	Method and Description
List<org.apache.solr.client.solrj.response.FacetField.Count>	createCollections(String facetFieldName, String queryString, String... refinements) Create collection list for a given query and facet field
FullBean	findById(String europeanaObjectId, boolean similarItems) Retrieve a record by id.
FullBean	findById(String collectionId, String recordId, boolean similarItems) Retrieve a record by splitted collectionId and recordId
List<BriefBean>	findMoreLikeThis(String europeanaObjectId) Deprecated.
List<BriefBean>	findMoreLikeThis(String europeanaObjectId, int count) Deprecated.
Date	getLastSolrUpdate()
Map<String,Integer>	queryFacetSearch(String query, String[] qf, List<String> queries)
FullBean	resolve(String europeanaObjectId, boolean similarItems) Retrieve a record by id.
FullBean	resolve(String collectionId, String recordId, boolean similarItems) Retrieve a record by splitted collectionId and recordId
String	resolveId(String europeanaObjectId) Checks if an europeanaObjectId is old and has a newId.
String	resolveId(String collectionId, String recordId) Uses the provided collectionId and recordId to create an EuropeanaId and checks if that id is old and has a newId.
<T extends IdBean> ResultSet<T>	search(Class<T> beanInterface, Query query) Perform a calculateTag in SOLR based on the given query and return the results in the format of the given class.
<T extends IdBean> ResultSet<T>	search(Class<T> beanInterface, Query query, boolean debug) Perform a calculateTag in SOLR based on the given query and return the results in the format of the given class.
Map<String,Integer>	seeAlso(List<String> queries) Returns a list of "see also" suggestions.
List<Term>	suggestions(String query, int pageSize) returns a list of calculateTag suggestions and frequencies
List<Term>	suggestions(String query, int pageSize, String field) returns a list of calculateTag suggestions and frequencies

Method Detail

findById

FullBean findById(String collectionId,
                  String recordId,
                  boolean similarItems)
           throws MongoRuntimeException,
                  MongoDBException

Retrieve a record by splitted collectionId and recordId

Parameters:

collectionId - id of the collection to which this record belongs

recordId -

similarItems - whether to retrieve similar items

Returns:

A full europeana record

Throws:

MongoRuntimeException, - SolrTypeException

MongoRuntimeException

MongoDBException

findById

FullBean findById(String europeanaObjectId,
                  boolean similarItems)
           throws MongoRuntimeException,
                  MongoDBException

Retrieve a record by id.

Parameters:

europeanaObjectId - The unique europeana id

similarItems - Whether to retrieve similar items

Returns:

A full europeana record

Throws:

MongoRuntimeException, - MongoDBException

MongoRuntimeException

MongoDBException

resolve

FullBean resolve(String europeanaObjectId,
                 boolean similarItems)
          throws SolrTypeException

Retrieve a record by id. If the record cannot be found, it will retry

Parameters:

europeanaObjectId - The unique europeana id

similarItems - Whether to retrieve similar items

Returns:

A full europeana record

Throws:

SolrTypeException

resolve

FullBean resolve(String collectionId,
                 String recordId,
                 boolean similarItems)
          throws SolrTypeException

Retrieve a record by splitted collectionId and recordId

Parameters:

collectionId - id of the collection to which this record belongs

recordId -

similarItems - Whether to retrieve similar items

Returns:

A full europeana record

Throws:

SolrTypeException

resolveId

String resolveId(String europeanaObjectId)
          throws BadDataException

Checks if an europeanaObjectId is old and has a newId. Note that this new id may also be old so we check iteratively and return the newest id

Parameters:

europeanaObjectId - the old record id

Returns:

a new record id, null if none was found

Throws:

BadDataException - if a circular id reference is found

resolveId

String resolveId(String collectionId,
                 String recordId)
          throws BadDataException

Uses the provided collectionId and recordId to create an EuropeanaId and checks if that id is old and has a newId. Note that this new id may also be old so we check iteratively and return the newest id

Parameters:

collectionId - the collection Id

recordId - the record Id

Returns:

a new record id, null if none was found

Throws:

BadDataException - if a circular id reference is found

search

<T extends IdBean> ResultSet<T> search(Class<T> beanInterface,
                                       Query query,
                                       boolean debug)
                                throws SolrTypeException

Perform a calculateTag in SOLR based on the given query and return the results in the format of the given class.

Parameters:

beanInterface - The required bean type, should be ApiBean or BriefBean

query - Model class containing the calculateTag specification.

debug - includes the string representing the Solrquery in the ResultSet

Returns:

The calculateTag results, including facets, breadcrumb and original query.

Throws:

SolrTypeException

search

<T extends IdBean> ResultSet<T> search(Class<T> beanInterface,
                                       Query query)
                                throws SolrTypeException

Perform a calculateTag in SOLR based on the given query and return the results in the format of the given class.

Parameters:

beanInterface - The required bean type, should be ApiBean or BriefBean

query - Model class containing the calculateTag specification.

Returns:

The calculateTag results, including facets, breadcrumb and original query.

Throws:

SolrTypeException

createCollections

List<org.apache.solr.client.solrj.response.FacetField.Count> createCollections(String facetFieldName,
                                                                               String queryString,
                                                                               String... refinements)
                                                                        throws SolrTypeException

Create collection list for a given query and facet field

Parameters:

facetFieldName - The SolrFacetType field to create the collection for

queryString - The Query to use for creating the collection

refinements - Optional refinements

Returns:

A List of FacetField.Count objects containing the collection

Throws:

SolrTypeException

suggestions

List<Term> suggestions(String query,
                       int pageSize)
                throws SolrTypeException

returns a list of calculateTag suggestions and frequencies

Parameters:

query - The calculateTag term to find suggestions for

pageSize - Amount of requested suggestions

Returns:

List of calculateTag suggestions

Throws:

SolrTypeException

suggestions

List<Term> suggestions(String query,
                       int pageSize,
                       String field)
                throws SolrTypeException

returns a list of calculateTag suggestions and frequencies

Parameters:

query - The calculateTag term to find suggestions for

pageSize - Amount of requested suggestions

Returns:

List of calculateTag suggestions

Throws:

SolrTypeException

findMoreLikeThis

@Deprecated
List<BriefBean> findMoreLikeThis(String europeanaObjectId)
                                      throws org.apache.solr.client.solrj.SolrServerException

Deprecated.

Retrieves the moreLikeThis List of BriefBeans

Parameters:

europeanaObjectId -

Returns:

moreLikeThis List of BriefBeans

Throws:

org.apache.solr.client.solrj.SolrServerException

seeAlso

Map<String,Integer> seeAlso(List<String> queries)

Returns a list of "see also" suggestions. The suggestions are organized by fields (who, what, where, when, and title). Each suggestion contains a field value and the number of documents it matches.

Parameters:

queries - Map of field names, and corresponding field values.

Returns:

list of see also suggestions

findMoreLikeThis

@Deprecated
List<BriefBean> findMoreLikeThis(String europeanaObjectId,
                                             int count)
                                      throws org.apache.solr.client.solrj.SolrServerException

Deprecated.

Returns a specified number of moreLikeThis objects

Parameters:

europeanaObjectId -

count -

Returns:

a specified number of moreLikeThis objects

Throws:

org.apache.solr.client.solrj.SolrServerException

getLastSolrUpdate

Date getLastSolrUpdate()
                throws org.apache.solr.client.solrj.SolrServerException,
                       IOException

Returns:

last modification time of Solr index

Throws:

org.apache.solr.client.solrj.SolrServerException

IOException

queryFacetSearch

Map<String,Integer> queryFacetSearch(String query,
                                     String[] qf,
                                     List<String> queries)