org.dspace.rest

Class FilteredItemsResource

java.lang.Object

org.dspace.rest.Resource

org.dspace.rest.FilteredItemsResource

@Path(value="/filtered-items")
public class FilteredItemsResource
extends Resource

Field Summary

Fields

Modifier and Type	Field and Description
protected CollectionService	collectionService
protected ConfigurationService	configurationService
protected ItemService	itemService
protected MetadataFieldService	metadataFieldService
protected MetadataSchemaService	metadataSchemaService
protected SiteService	siteService

Fields inherited from class org.dspace.rest.Resource

servletContext

Constructor Summary

Constructors

Constructor and Description
FilteredItemsResource()

Method Summary

Modifier and Type

Method and Description

ItemFilter

getItemQuery(String expand, Integer limit, Integer offset, String user_ip, String user_agent, String xforwarderfor, String filters, List<String> query_field, List<String> query_op, List<String> query_val, List<String> collSel, javax.ws.rs.core.HttpHeaders headers, javax.servlet.http.HttpServletRequest request, javax.servlet.ServletContext servletContext) Return instance of collection with passed id.

Methods inherited from class org.dspace.rest.Resource

createContext, getActionString, mySplit, processException, processFinally, writeStats

Methods inherited from class java.lang.Object

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

Field Detail

itemService

protected ItemService itemService

metadataFieldService

protected MetadataFieldService metadataFieldService

metadataSchemaService

protected MetadataSchemaService metadataSchemaService

collectionService

protected CollectionService collectionService

siteService

protected SiteService siteService

configurationService

protected ConfigurationService configurationService

Constructor Detail

FilteredItemsResource

public FilteredItemsResource()

Method Detail

getItemQuery

@GET
 @Produces(value={"application/json","application/xml"})
public ItemFilter getItemQuery(@QueryParam(value="expand")
                                                                                             String expand,
                                                                                             @QueryParam(value="limit") @DefaultValue(value="100")
                                                                                             Integer limit,
                                                                                             @QueryParam(value="offset") @DefaultValue(value="0")
                                                                                             Integer offset,
                                                                                             @QueryParam(value="userIP")
                                                                                             String user_ip,
                                                                                             @QueryParam(value="userAgent")
                                                                                             String user_agent,
                                                                                             @QueryParam(value="xforwarderfor")
                                                                                             String xforwarderfor,
                                                                                             @QueryParam(value="filters") @DefaultValue(value="is_item,all_filters")
                                                                                             String filters,
                                                                                             @QueryParam(value="query_field[]") @DefaultValue(value="dc.title")
                                                                                             List<String> query_field,
                                                                                             @QueryParam(value="query_op[]") @DefaultValue(value="exists")
                                                                                             List<String> query_op,
                                                                                             @QueryParam(value="query_val[]") @DefaultValue(value="")
                                                                                             List<String> query_val,
                                                                                             @QueryParam(value="collSel[]") @DefaultValue(value="")
                                                                                             List<String> collSel,
                                                                                             @Context
                                                                                             javax.ws.rs.core.HttpHeaders headers,
                                                                                             @Context
                                                                                             javax.servlet.http.HttpServletRequest request,
                                                                                             @Context
                                                                                             javax.servlet.ServletContext servletContext)

Return instance of collection with passed id. You can add more properties through expand parameter.

Parameters:

expand - String in which is what you want to add to returned instance of collection. Options are: "all", "parentCommunityList", "parentCommunity", "items", "license" and "logo". If you want to use multiple options, it must be separated by commas.

limit - Limit value for items in list in collection. Default value is 100.

offset - Offset of start index in list of items of collection. Default value is 0.

filters - Comma separated list of Item Filters to use to evaluate against the items in a collection

query_field - List of metadata fields to evaluate in a metadata query. Each list value is used in conjunction with a query_op and query_field.

query_op - List of metadata operators to use in a metadata query. Each list value is used in conjunction with a query_field and query_field.

query_val - List of metadata values to evaluate in a metadata query. Each list value is used in conjunction with a query_value and query_op.

collSel - List of collections to query.

headers - If you want to access to collection under logged user into context. In headers must be set header "rest-dspace-token" with passed token from login method.

Returns:

Return instance of collection. It can also return status code NOT_FOUND(404) if id of collection is incorrect or status code UNATHORIZED(401) if user has no permission to read collection.

Throws:

javax.ws.rs.WebApplicationException - It is thrown when was problem with database reading (SQLException) or problem with creating context(ContextException). It is thrown by NOT_FOUND and UNATHORIZED status codes, too.