com.adobe.cq.social.srp.internal

Interface SocialDataService

public interface SocialDataService

An interface defining low-level access to Adobe Cloud Storage.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	SocialDataService.BrowseDocumentsResult Used in browseDocuments to return the page of documents found and the count of all matching documents.
static class	SocialDataService.Counts Used in browseDocuments to indicate whether and which count of children is desired.

Method Summary

Modifier and Type	Method and Description
void	addAttachment(String key, Map<String,Object> attachment) Add an attachment.
List<APIResult>	batchCommit(List<APICommand> commands)
List<Map<String,Object>>	browseDocuments(String keyName, String keyValue, String baseType, int maxResults, int page, List<Map.Entry<String,Boolean>> orderBy, boolean visibleOnly) Browse the documents associated with the given key.
SocialDataService.BrowseDocumentsResult	browseDocuments(String keyName, String keyValue, String baseType, int maxResults, int page, List<Map.Entry<String,Boolean>> orderBy, boolean visibleOnly, SocialDataService.Counts counts) Browse the documents associated with the given key.
void	close() Close the service.
Map<String,Long>	countChildren(List<String> keyValues, String childType, boolean visibleOnly) Count the visible, or all the documents associated with the given keys.
long	countChildren(String keyValue, String childType, boolean visibleOnly) Count the visible, or all the documents associated with the given key.
void	deleteAttachment(String key) Delete an attachment.
FacetResults	facetedSearch(String queryToAs, List<String> facetFields, List<String> pivotFields, String numRows, String mincount, boolean isPivot) Do a faceted search.
SocialResourceSearchResult<Map<String,Object>>	find(String componentFilter, String luceneQuery, List<SearchSortField> sortFields, int offset, int limit) Search.
SocialResourceSearchResult<Map<String,Object>>	find(String component, String solrQueryString, List<SearchSortField> sortFields, int offset, int limit, Map<String,Object> signals) Search.
FacetSearchResult	findFacets(List<String> fieldNames, List<FacetRangeField> rangeFields, String resourceTypeFilter, String componentFilter, int count, boolean visibleOnly, boolean includeChildren) Search collections Faceted search
SocialResourceSearchResult<Map<String,Object>>	findFacets(List<String> inPath, List<String> notInPath, List<String> fieldNames, List<FacetRangeField> facetRanges, String scoredQueryString, int maxFacetCount, List<SearchSortField> sortFields, int offset, int pageSize) Do a combined faceted search and filtered search, returning both the facets and an actual page of results
InputStream	getAttachmentInputStream(String path) Get the attachment data as an InputStream and not just the meta data of the attachment
String	getDSClient() Return the placeholder for dataservice client EG: 'ASRP|MSRP'
List<Map<String,Object>>	getMLTResults(String query, String statusFilter, String resourceTypeFilter, String componentFilter, List<String> mltField, int maxResults, int minTermFreq, int minDocFreq) Look for documents close to the provided query.
boolean	isConfigured()
List<Map<String,Object>>	nonFacetedSearch(String queryToAs) Do a regular search.
Map<String,Object>	readAttachment(String key) Read an attachment.
Map<String,Object>	readDocument(String key) Read a document.
Map<String,APIResult>	readDocuments(List<String> keys) Read a list of documents.
void	setConfiguration(SocialResourceConfiguration configuration) Set the configuration to use.

Method Detail

readDocument

Map<String,Object> readDocument(String key)
                         throws IOException

Read a document.

Parameters:

key - the key

Returns:

the document

Throws:

IOException - on failure

readDocuments

Map<String,APIResult> readDocuments(List<String> keys)
                             throws IOException

Read a list of documents.

Parameters:

keys - the keys

Returns:

a map where each key is associated with the corresponding document, or else the error associated with trying to retrieve it

Throws:

IOException - on failure to parse

batchCommit

List<APIResult> batchCommit(List<APICommand> commands)
                     throws IOException

Throws:

IOException

getMLTResults

List<Map<String,Object>> getMLTResults(String query,
                                       String statusFilter,
                                       String resourceTypeFilter,
                                       String componentFilter,
                                       List<String> mltField,
                                       int maxResults,
                                       int minTermFreq,
                                       int minDocFreq)
                                throws IOException

Look for documents close to the provided query.

Parameters:

query - The string to match

statusFilter - the status of the documents to match

resourceTypeFilter - the resource type(s) to match

componentFilter - the component to match

mltField - the field in the document to match

maxResults - the most results to return

minTermFreq - the number of times a term has to be in the query to be used

minDocFreq - the number of docs a term has to be in for the term to be used.

Returns:

the matching list of documents

Throws:

IOException - on failure

find

SocialResourceSearchResult<Map<String,Object>> find(String componentFilter,
                                                    String luceneQuery,
                                                    List<SearchSortField> sortFields,
                                                    int offset,
                                                    int limit)
                                             throws IOException

Search.

Parameters:

componentFilter - the component to filter on

luceneQuery - the lucene query

sortFields - sort fields

offset - starting offset

limit - max to return

Returns:

list of matching docs

Throws:

IOException - on failure

find

SocialResourceSearchResult<Map<String,Object>> find(String component,
                                                    String solrQueryString,
                                                    List<SearchSortField> sortFields,
                                                    int offset,
                                                    int limit,
                                                    Map<String,Object> signals)
                                             throws IOException

Search.

Parameters:

component - the component to filter on

solrQueryString - the lucene query

sortFields - sort fields

offset - starting offset

limit - max to return

signals - contains query params(userlanguage, browserlanguge etc)

Returns:

list of matching docs

Throws:

IOException - on failure

findFacets

FacetSearchResult findFacets(List<String> fieldNames,
                             List<FacetRangeField> rangeFields,
                             String resourceTypeFilter,
                             String componentFilter,
                             int count,
                             boolean visibleOnly,
                             boolean includeChildren)
                      throws IOException

Search collections Faceted search

Parameters:

fieldNames - Fields for which we want facet counts

resourceTypeFilter - Resource filter

componentFilter - Component filter

count - Maximum number of results

visibleOnly - whether to filter by visibility

Returns:

map containing names and counts

Throws:

IOException

findFacets

SocialResourceSearchResult<Map<String,Object>> findFacets(List<String> inPath,
                                                          List<String> notInPath,
                                                          List<String> fieldNames,
                                                          List<FacetRangeField> facetRanges,
                                                          String scoredQueryString,
                                                          int maxFacetCount,
                                                          List<SearchSortField> sortFields,
                                                          int offset,
                                                          int pageSize)
                                                   throws IOException

Do a combined faceted search and filtered search, returning both the facets and an actual page of results

Parameters:

inPath - a list of the parent paths to be searched

fieldNames - the fields being used for faceted searches by value

facetRanges - the fields and intervals being used for faceted searches by range

scoredQueryString - a search string for which solr calculates degree of match (the "q" parameter)

maxFacetCount - the limit of facet results to return, or 0 for no limit

sortFields - fields to sort by, with their directions, in the returned results

offset - page offset

pageSize - page size

Returns:

The returned data structure is basically a list of the raw results that also holds results for the facets

Throws:

IOException

browseDocuments

SocialDataService.BrowseDocumentsResult browseDocuments(String keyName,
                                                        String keyValue,
                                                        String baseType,
                                                        int maxResults,
                                                        int page,
                                                        List<Map.Entry<String,Boolean>> orderBy,
                                                        boolean visibleOnly,
                                                        SocialDataService.Counts counts)
                                                 throws IOException

Browse the documents associated with the given key.

Parameters:

keyName - the name of the index to query on

keyValue - the value in the index

baseType - the base type of the documents to list (can be empty or null)

maxResults - the max number of result to return. If all results should be returned, send maxResults < 0

page - the 0-based page of results to return. Only used if maxResults > 0

orderBy - a list of field name and booleans to dictate the order of the results. For the boolean false is descending order and true is to sort in ascending order.

visibleOnly - whether to (true) return only visible documents, or (false) all documents

counts - whether to count matching documents and whether to count all documents or just the visible documents.

Returns:

the list of matching documents and if requested a count of the matching documents (either all or just the visible ones)

Throws:

IOException - on failure

browseDocuments

List<Map<String,Object>> browseDocuments(String keyName,
                                         String keyValue,
                                         String baseType,
                                         int maxResults,
                                         int page,
                                         List<Map.Entry<String,Boolean>> orderBy,
                                         boolean visibleOnly)
                                  throws IOException

Browse the documents associated with the given key.

Parameters:

keyName - the name of the index to query on

keyValue - the value in the index

baseType - the base type of the documents to list (can be empty or null)

maxResults - the max number of result to return. If all results should be returned, send maxResults < 0

page - the 0-based page of results to return. Only used if maxResults > 0

orderBy - a list of field name and booleans to dictate the order of the results. For the boolean false is descending order and true is to sort in ascending order.

visibleOnly - whether to (true) return only visible documents, or (false) all documents

Returns:

the list of matching docs.

Throws:

IOException - on failure

addAttachment

void addAttachment(String key,
                   Map<String,Object> attachment)
            throws IOException

Add an attachment.

Parameters:

key - the key

attachment - the attachment data

Throws:

IOException - on failure

readAttachment

Map<String,Object> readAttachment(String key)
                           throws IOException

Read an attachment.

Parameters:

key - the key

Returns:

the attachment data

Throws:

IOException - on failure

countChildren

long countChildren(String keyValue,
                   String childType,
                   boolean visibleOnly)
            throws IOException

Count the visible, or all the documents associated with the given key.

Parameters:

keyValue - the value in the index

childType - the value of the base_type to filter by, or null if no base type filtering should be done

visibleOnly - if true, the count of only the visible (not hidden, spam ..) docs is returned

Returns:

The number of matching docs and the number of visible matching docs.

Throws:

IOException - on failure

countChildren

Map<String,Long> countChildren(List<String> keyValues,
                               String childType,
                               boolean visibleOnly)
                        throws IOException

Count the visible, or all the documents associated with the given keys.

Parameters:

keyValues - the path of each parent id to get a child count for

childType - the value of the base_type to filter by, or null if no base type filtering should be done

visibleOnly - if true, the count of only the visible (not hidden, spam ..) docs is returned

Returns:

The number of matching docs and the number of visible matching docs.

Throws:

IOException - on failure

close

void close()

Close the service.

deleteAttachment

void deleteAttachment(String key)
               throws IOException

Delete an attachment.

Parameters:

key - the key to be deleted.

Throws:

IOException - on failure

setConfiguration

void setConfiguration(SocialResourceConfiguration configuration)

Set the configuration to use.

Parameters:

configuration - the configuration.

isConfigured

boolean isConfigured()

Returns:

true if configuration was set

facetedSearch

FacetResults facetedSearch(String queryToAs,
                           List<String> facetFields,
                           List<String> pivotFields,
                           String numRows,
                           String mincount,
                           boolean isPivot)
                    throws IOException

Do a faceted search.

Parameters:

queryToAs - the query to use

facetFields - the facet fields to use

pivotFields - the pivot fields to use

numRows - the number of results to return

mincount - the min number of docs matching the facet to include the result

isPivot - true iff this is a pivot search

Returns:

the results.

Throws:

IOException - on failure

nonFacetedSearch

List<Map<String,Object>> nonFacetedSearch(String queryToAs)
                                   throws IOException

Do a regular search.

Parameters:

queryToAs - the query

Returns:

the matching documents

Throws:

IOException - on failure

getAttachmentInputStream

InputStream getAttachmentInputStream(String path)
                              throws IOException

Get the attachment data as an InputStream and not just the meta data of the attachment

Parameters:

path - path the to attachment resource

Returns:

the attachment as an InputStream

Throws:

IOException - on error

getDSClient

String getDSClient()

Return the placeholder for dataservice client EG: 'ASRP|MSRP'

Returns: