org.dspace.discovery

Class SolrServiceImpl

java.lang.Object

org.dspace.discovery.SolrServiceImpl

All Implemented Interfaces:

IndexingService, SearchService

@Service
public class SolrServiceImpl
extends java.lang.Object
implements SearchService, IndexingService

SolrIndexer contains the methods that index Items and their metadata, collections, communities, etc. It is meant to either be invoked from the command line (see dspace/bin/index-all) or via the indexContent() methods within DSpace.

The Administrator can choose to run SolrIndexer in a cron that repeats regularly, a failed attempt to index from the UI will be "caught" up on in that cron. The SolrServiceImple is registered as a Service in the ServiceManager via A spring configuration file located under classpath://spring/spring-dspace-applicationContext.xml Its configuration is Autowired by the ApplicationContext

Author:

Kevin Van de Velde (kevin at atmire dot com), Mark Diggory (markd at atmire dot com), Ben Bosman (ben at atmire dot com)

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	AUTHORITY_SEPARATOR
static java.lang.String	FILTER_SEPARATOR
protected static java.lang.String	LAST_INDEXED_FIELD
static java.lang.String	STORE_SEPARATOR
static java.lang.String	VARIANTS_STORE_SEPARATOR

Constructor Summary

Constructors

Constructor and Description
SolrServiceImpl()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	addContainerMetadataField(org.apache.solr.common.SolrInputDocument doc, java.util.List<java.lang.String> highlightedMetadataFields, java.util.List<java.lang.String> toIgnoreMetadataFields, java.lang.String metadataField, java.lang.String value) Add the metadata value of the community/collection to the solr document IF needed highlighting is added !
protected void	buildDocument(Context context, Collection collection) Build a solr document for a DSpace Collection.
protected void	buildDocument(Context context, Community community) Build a solr document for a DSpace Community.
protected void	buildDocument(Context context, Item item) Build a Lucene document for a DSpace Item and write the index
protected org.apache.solr.common.SolrInputDocument	buildDocument(int type, int id, java.lang.String handle, java.util.List<java.lang.String> locations) Create Lucene document with all the shared fields initialized.
void	cleanIndex(boolean force) Iterates over all documents in the Lucene index and verifies they are in database, if not, they are removed.
void	commit()
void	createIndex(Context c) create full index - wiping old index
protected void	emailException(java.lang.Exception exception)
protected static DSpaceObject	findDSpaceObject(Context context, org.apache.solr.common.SolrDocument doc)
protected java.util.List<java.lang.String>	getCollectionLocations(Collection target)
protected java.util.List<java.lang.String>	getItemLocations(Item myitem)
java.util.List<Item>	getRelatedItems(Context context, Item item, DiscoveryMoreLikeThisConfiguration mltConfig)
protected org.apache.solr.client.solrj.impl.HttpSolrServer	getSolr()
void	indexContent(Context context, DSpaceObject dso) If the handle for the "dso" already exists in the index, and the "dso" has a lastModified timestamp that is newer than the document in the index then it is updated, otherwise a new document is added.
void	indexContent(Context context, DSpaceObject dso, boolean force) If the handle for the "dso" already exists in the index, and the "dso" has a lastModified timestamp that is newer than the document in the index then it is updated, otherwise a new document is added.
void	indexContent(Context context, DSpaceObject dso, boolean force, boolean commit)
static java.lang.String	locationToName(Context context, java.lang.String field, java.lang.String value)
void	optimize() Maintenance to keep a SOLR index efficient.
void	reIndexContent(Context context, DSpaceObject dso) reIndexContent removes something from the index, then re-indexes it
protected boolean	requiresIndexing(java.lang.String handle, java.util.Date lastModified) Is stale checks the lastModified time stamp in the database and the index to determine if the index is stale.
protected org.apache.solr.client.solrj.SolrQuery	resolveToSolrQuery(Context context, DiscoverQuery discoveryQuery, boolean includeUnDiscoverable)
protected DiscoverResult	retrieveResult(Context context, DiscoverQuery query, org.apache.solr.client.solrj.response.QueryResponse solrQueryResponse)
DiscoverResult	search(Context context, DiscoverQuery query) Convenient method to call @see #search(Context, DSpaceObject, DiscoverQuery) with a null DSpace Object as scope (i.e.
DiscoverResult	search(Context context, DiscoverQuery discoveryQuery, boolean includeUnDiscoverable)
DiscoverResult	search(Context context, DSpaceObject dso, DiscoverQuery query) Convenient method to call @see #search(Context, DSpaceObject, DiscoverQuery, boolean) with includeWithdrawn=false
DiscoverResult	search(Context context, DSpaceObject dso, DiscoverQuery discoveryQuery, boolean includeUnDiscoverable)
java.util.List<DSpaceObject>	search(Context context, java.lang.String query, int offset, int max, java.lang.String... filterquery)
java.util.List<DSpaceObject>	search(Context context, java.lang.String query, java.lang.String orderfield, boolean ascending, int offset, int max, java.lang.String... filterquery)
java.io.InputStream	searchAsInputStream(DiscoverQuery query) Simple means to return the search result as an InputStream
java.io.InputStream	searchJSON(Context context, DiscoverQuery query, DSpaceObject dso, java.lang.String jsonIdentifier)
java.io.InputStream	searchJSON(Context context, DiscoverQuery discoveryQuery, java.lang.String jsonIdentifier)
static java.util.Date	toDate(java.lang.String t) Helper function to retrieve a date using a best guess of the potential date encodings on a field
DiscoverFilterQuery	toFilterQuery(Context context, java.lang.String field, java.lang.String operator, java.lang.String value) Transforms the given string field and value into a filter query
java.lang.String	toSortFieldIndex(java.lang.String metadataField, java.lang.String type) Transforms the metadata field of the given sort configuration into the indexed field which we can then use in our solr queries
protected java.lang.String	transformAuthorityValue(Context context, java.lang.String field, java.lang.String value)
protected java.lang.String	transformDisplayedValue(Context context, java.lang.String field, java.lang.String value)
protected java.lang.String	transformFacetField(DiscoverFacetField facetFieldConfig, java.lang.String field, boolean removePostfix)
protected java.lang.String	transformSortValue(Context context, java.lang.String field, java.lang.String value)
void	unIndexContent(Context context, DSpaceObject dso) unIndex removes an Item, Collection, or Community
void	unIndexContent(Context context, DSpaceObject dso, boolean commit) unIndex removes an Item, Collection, or Community
void	unIndexContent(Context context, java.lang.String handle) Unindex a Document in the Lucene index.
void	unIndexContent(Context context, java.lang.String handle, boolean commit) Unindex a Document in the Lucene Index.
void	updateIndex(Context context) Iterates over all Items, Collections and Communities.
void	updateIndex(Context context, boolean force) Iterates over all Items, Collections and Communities.
protected void	writeDocument(org.apache.solr.common.SolrInputDocument doc) Write the document to the index under the appropriate handle.

Methods inherited from class java.lang.Object

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

Field Detail

LAST_INDEXED_FIELD

protected static final java.lang.String LAST_INDEXED_FIELD

See Also:

Constant Field Values

FILTER_SEPARATOR

public static final java.lang.String FILTER_SEPARATOR

See Also:

Constant Field Values

AUTHORITY_SEPARATOR

public static final java.lang.String AUTHORITY_SEPARATOR

See Also:

Constant Field Values

STORE_SEPARATOR

public static final java.lang.String STORE_SEPARATOR

See Also:

Constant Field Values

VARIANTS_STORE_SEPARATOR

public static final java.lang.String VARIANTS_STORE_SEPARATOR

See Also:

Constant Field Values

Constructor Detail

SolrServiceImpl

public SolrServiceImpl()

Method Detail

getSolr

protected org.apache.solr.client.solrj.impl.HttpSolrServer getSolr()

indexContent

public void indexContent(Context context,
                DSpaceObject dso)
                  throws java.sql.SQLException

If the handle for the "dso" already exists in the index, and the "dso" has a lastModified timestamp that is newer than the document in the index then it is updated, otherwise a new document is added.

Specified by:

indexContent in interface IndexingService

Parameters:

context - Users Context

dso - DSpace Object (Item, Collection or Community

Throws:

java.sql.SQLException

java.io.IOException

indexContent

public void indexContent(Context context,
                DSpaceObject dso,
                boolean force)
                  throws java.sql.SQLException

If the handle for the "dso" already exists in the index, and the "dso" has a lastModified timestamp that is newer than the document in the index then it is updated, otherwise a new document is added.

Specified by:

indexContent in interface IndexingService

Parameters:

context - Users Context

dso - DSpace Object (Item, Collection or Community

force - Force update even if not stale.

Throws:

java.sql.SQLException

java.io.IOException

unIndexContent

public void unIndexContent(Context context,
                  DSpaceObject dso)
                    throws java.sql.SQLException,
                           java.io.IOException

unIndex removes an Item, Collection, or Community

Specified by:

unIndexContent in interface IndexingService

Parameters:

context -

dso - DSpace Object, can be Community, Item, or Collection

Throws:

java.sql.SQLException

java.io.IOException

unIndexContent

public void unIndexContent(Context context,
                  DSpaceObject dso,
                  boolean commit)
                    throws java.sql.SQLException,
                           java.io.IOException

unIndex removes an Item, Collection, or Community

Specified by:

unIndexContent in interface IndexingService

Parameters:

context -

dso - DSpace Object, can be Community, Item, or Collection

commit - if true force an immediate commit on SOLR

Throws:

java.sql.SQLException

java.io.IOException

unIndexContent

public void unIndexContent(Context context,
                  java.lang.String handle)
                    throws java.io.IOException,
                           java.sql.SQLException

Unindex a Document in the Lucene index.

Specified by:

unIndexContent in interface IndexingService

Parameters:

context - the dspace context

handle - the handle of the object to be deleted

Throws:

java.io.IOException

java.sql.SQLException

unIndexContent

public void unIndexContent(Context context,
                  java.lang.String handle,
                  boolean commit)
                    throws java.sql.SQLException,
                           java.io.IOException

Unindex a Document in the Lucene Index.

Specified by:

unIndexContent in interface IndexingService

Parameters:

context - the dspace context

handle - the handle of the object to be deleted

Throws:

java.sql.SQLException

java.io.IOException

reIndexContent

public void reIndexContent(Context context,
                  DSpaceObject dso)
                    throws java.sql.SQLException,
                           java.io.IOException

reIndexContent removes something from the index, then re-indexes it

Specified by:

reIndexContent in interface IndexingService

Parameters:

context - context object

dso - object to re-index

Throws:

java.sql.SQLException

java.io.IOException

createIndex

public void createIndex(Context c)
                 throws java.sql.SQLException,
                        java.io.IOException

create full index - wiping old index

Specified by:

createIndex in interface IndexingService

Parameters:

c - context to use

Throws:

java.sql.SQLException

java.io.IOException

updateIndex

public void updateIndex(Context context)

Iterates over all Items, Collections and Communities. And updates them in the index. Uses decaching to control memory footprint. Uses indexContent and isStale to check state of item in index.

Specified by:

updateIndex in interface IndexingService

Parameters:

context - the dspace context

updateIndex

public void updateIndex(Context context,
               boolean force)

Iterates over all Items, Collections and Communities. And updates them in the index. Uses decaching to control memory footprint. Uses indexContent and isStale to check state of item in index.

At first it may appear counterintuitive to have an IndexWriter/Reader opened and closed on each DSO. But this allows the UI processes to step in and attain a lock and write to the index even if other processes/jvms are running a reindex.

Specified by:

updateIndex in interface IndexingService

Parameters:

context - the dspace context

force - whether or not to force the reindexing

cleanIndex

public void cleanIndex(boolean force)
                throws java.io.IOException,
                       java.sql.SQLException,
                       SearchServiceException

Iterates over all documents in the Lucene index and verifies they are in database, if not, they are removed.

Specified by:

cleanIndex in interface IndexingService

Parameters:

force - whether or not to force a clean index

Throws:

java.io.IOException - IO exception

java.sql.SQLException - sql exception

SearchServiceException - occurs when something went wrong with querying the solr server

optimize

public void optimize()

Maintenance to keep a SOLR index efficient. Note: This might take a long time.

Specified by:

optimize in interface IndexingService

emailException

protected void emailException(java.lang.Exception exception)

requiresIndexing

protected boolean requiresIndexing(java.lang.String handle,
                       java.util.Date lastModified)
                            throws java.sql.SQLException,
                                   java.io.IOException,
                                   SearchServiceException

Is stale checks the lastModified time stamp in the database and the index to determine if the index is stale.

Parameters:

handle - the handle of the dso

lastModified - the last modified date of the DSpace object

Returns:

a boolean indicating if the dso should be re indexed again

Throws:

java.sql.SQLException - sql exception

java.io.IOException - io exception

SearchServiceException - if something went wrong with querying the solr server

getItemLocations

protected java.util.List<java.lang.String> getItemLocations(Item myitem)
                                                     throws java.sql.SQLException

Parameters:

myitem - the item for which our locations are to be retrieved

Returns:

a list containing the identifiers of the communities & collections

Throws:

java.sql.SQLException - sql exception

getCollectionLocations

protected java.util.List<java.lang.String> getCollectionLocations(Collection target)
                                                           throws java.sql.SQLException

Throws:

java.sql.SQLException

writeDocument

protected void writeDocument(org.apache.solr.common.SolrInputDocument doc)
                      throws java.io.IOException

Write the document to the index under the appropriate handle.

Parameters:

doc - the solr document to be written to the server

Throws:

java.io.IOException - IO exception

buildDocument

protected void buildDocument(Context context,
                 Community community)
                      throws java.sql.SQLException,
                             java.io.IOException

Build a solr document for a DSpace Community.

Parameters:

community - Community to be indexed

Throws:

java.sql.SQLException

java.io.IOException

buildDocument

protected void buildDocument(Context context,
                 Collection collection)
                      throws java.sql.SQLException,
                             java.io.IOException

Build a solr document for a DSpace Collection.

Parameters:

collection - Collection to be indexed

Throws:

java.sql.SQLException - sql exception

java.io.IOException - IO exception

addContainerMetadataField

protected void addContainerMetadataField(org.apache.solr.common.SolrInputDocument doc,
                             java.util.List<java.lang.String> highlightedMetadataFields,
                             java.util.List<java.lang.String> toIgnoreMetadataFields,
                             java.lang.String metadataField,
                             java.lang.String value)

Add the metadata value of the community/collection to the solr document IF needed highlighting is added !

Parameters:

doc - the solr document

highlightedMetadataFields - the list of metadata fields that CAN be highlighted

metadataField - the metadata field added

value - the value (can be NULL !)

buildDocument

protected void buildDocument(Context context,
                 Item item)
                      throws java.sql.SQLException,
                             java.io.IOException

Build a Lucene document for a DSpace Item and write the index

Parameters:

context - Users Context

item - The DSpace Item to be indexed

Throws:

java.sql.SQLException

java.io.IOException

buildDocument

protected org.apache.solr.common.SolrInputDocument buildDocument(int type,
                                                     int id,
                                                     java.lang.String handle,
                                                     java.util.List<java.lang.String> locations)

Create Lucene document with all the shared fields initialized.

Parameters:

type - Type of DSpace Object

id -

handle -

locations - @return

toDate

public static java.util.Date toDate(java.lang.String t)

Helper function to retrieve a date using a best guess of the potential date encodings on a field

Parameters:

t - the string to be transformed to a date

Returns:

a date if the formatting was successful, null if not able to transform to a date

locationToName

public static java.lang.String locationToName(Context context,
                              java.lang.String field,
                              java.lang.String value)
                                       throws java.sql.SQLException

Throws:

java.sql.SQLException

search

public DiscoverResult search(Context context,
                    DiscoverQuery query)
                      throws SearchServiceException

Description copied from interface: SearchService

Convenient method to call @see #search(Context, DSpaceObject, DiscoverQuery) with a null DSpace Object as scope (i.e. all the repository)

Specified by:

search in interface SearchService

Parameters:

context - DSpace Context object.

query - the discovery query object.

Throws:

SearchServiceException

search

public DiscoverResult search(Context context,
                    DSpaceObject dso,
                    DiscoverQuery query)
                      throws SearchServiceException

Description copied from interface: SearchService

Convenient method to call @see #search(Context, DSpaceObject, DiscoverQuery, boolean) with includeWithdrawn=false

Specified by:

search in interface SearchService

Parameters:

context - DSpace Context object

dso - a DSpace Object to use as scope of the search (only results within this object)

query - the discovery query object

Throws:

SearchServiceException

search

public DiscoverResult search(Context context,
                    DSpaceObject dso,
                    DiscoverQuery discoveryQuery,
                    boolean includeUnDiscoverable)
                      throws SearchServiceException

Specified by:

search in interface SearchService

Parameters:

context - DSpace Context object

dso - a DSpace Object to use as scope of the search (only results within this object)

discoveryQuery - the discovery query object

includeUnDiscoverable - use true to include in the results also withdrawn items that match the query

Throws:

SearchServiceException

search

public DiscoverResult search(Context context,
                    DiscoverQuery discoveryQuery,
                    boolean includeUnDiscoverable)
                      throws SearchServiceException

Specified by:

search in interface SearchService

Parameters:

context - DSpace Context object.

discoveryQuery - the discovery query object.

includeUnDiscoverable - use true to include in the results also withdrawn items that match the query.

Throws:

SearchServiceException

resolveToSolrQuery

protected org.apache.solr.client.solrj.SolrQuery resolveToSolrQuery(Context context,
                                                        DiscoverQuery discoveryQuery,
                                                        boolean includeUnDiscoverable)

searchJSON

public java.io.InputStream searchJSON(Context context,
                             DiscoverQuery query,
                             DSpaceObject dso,
                             java.lang.String jsonIdentifier)
                               throws SearchServiceException

Specified by:

searchJSON in interface SearchService

Throws:

SearchServiceException

searchJSON

public java.io.InputStream searchJSON(Context context,
                             DiscoverQuery discoveryQuery,
                             java.lang.String jsonIdentifier)
                               throws SearchServiceException

Specified by:

searchJSON in interface SearchService

Throws:

SearchServiceException

retrieveResult

protected DiscoverResult retrieveResult(Context context,
                            DiscoverQuery query,
                            org.apache.solr.client.solrj.response.QueryResponse solrQueryResponse)
                                 throws java.sql.SQLException

Throws:

java.sql.SQLException

findDSpaceObject

protected static DSpaceObject findDSpaceObject(Context context,
                            org.apache.solr.common.SolrDocument doc)
                                        throws java.sql.SQLException

Throws:

java.sql.SQLException

searchAsInputStream

public java.io.InputStream searchAsInputStream(DiscoverQuery query)
                                        throws SearchServiceException,
                                               java.io.IOException

Simple means to return the search result as an InputStream

Throws:

SearchServiceException

java.io.IOException

search

public java.util.List<DSpaceObject> search(Context context,
                                  java.lang.String query,
                                  int offset,
                                  int max,
                                  java.lang.String... filterquery)

search

public java.util.List<DSpaceObject> search(Context context,
                                  java.lang.String query,
                                  java.lang.String orderfield,
                                  boolean ascending,
                                  int offset,
                                  int max,
                                  java.lang.String... filterquery)

Specified by:

search in interface SearchService

toFilterQuery

public DiscoverFilterQuery toFilterQuery(Context context,
                                java.lang.String field,
                                java.lang.String operator,
                                java.lang.String value)
                                  throws java.sql.SQLException

Description copied from interface: SearchService

Transforms the given string field and value into a filter query

Specified by:

toFilterQuery in interface SearchService

Parameters:

context - the DSpace context

field - the field of the filter query

value - the filter query value

Returns:

a filter query

Throws:

java.sql.SQLException - ...

getRelatedItems

public java.util.List<Item> getRelatedItems(Context context,
                                   Item item,
                                   DiscoveryMoreLikeThisConfiguration mltConfig)

Specified by:

getRelatedItems in interface SearchService

toSortFieldIndex

public java.lang.String toSortFieldIndex(java.lang.String metadataField,
                                java.lang.String type)

Description copied from interface: SearchService

Transforms the metadata field of the given sort configuration into the indexed field which we can then use in our solr queries

Specified by:

toSortFieldIndex in interface SearchService

Parameters:

metadataField - the metadata field

Returns:

the indexed field

transformFacetField

protected java.lang.String transformFacetField(DiscoverFacetField facetFieldConfig,
                                   java.lang.String field,
                                   boolean removePostfix)

transformDisplayedValue

protected java.lang.String transformDisplayedValue(Context context,
                                       java.lang.String field,
                                       java.lang.String value)
                                            throws java.sql.SQLException

Throws:

java.sql.SQLException

transformAuthorityValue

protected java.lang.String transformAuthorityValue(Context context,
                                       java.lang.String field,
                                       java.lang.String value)
                                            throws java.sql.SQLException

Throws:

java.sql.SQLException

transformSortValue

protected java.lang.String transformSortValue(Context context,
                                  java.lang.String field,
                                  java.lang.String value)
                                       throws java.sql.SQLException

Throws:

java.sql.SQLException

indexContent

public void indexContent(Context context,
                DSpaceObject dso,
                boolean force,
                boolean commit)
                  throws SearchServiceException,
                         java.sql.SQLException

Specified by:

indexContent in interface IndexingService

Throws:

SearchServiceException

java.sql.SQLException

commit

public void commit()
            throws SearchServiceException

Specified by:

commit in interface IndexingService

Throws:

SearchServiceException