org.gbif.api.service.collections

Interface CollectionService

All Superinterfaces:

CollectionEntityService<Collection>, CommentService, ContactService, CrudService<Collection>, IdentifierService, MachineTagService, OccurrenceMappingService, TagService

public interface CollectionService
extends CollectionEntityService<Collection>

API Service to work with collections.

Method Summary

Modifier and Type	Method and Description
UUID	createFromDataset(UUID datasetKey, String collectionCode) Creates a Collection from a Dataset.
CollectionView	getCollectionView(@NotNull UUID key) Retrieves a CollectionView by the collection key.
PagingResponse<CollectionView>	list(CollectionSearchRequest searchRequest) Pages Collection entities based on the parameters received.
PagingResponse<CollectionView>	listDeleted(CollectionSearchRequest searchRequest) Provides access to deleted collections.
List<KeyCodeNameResult>	suggest(String q) Provides a simple suggest service.

Methods inherited from interface org.gbif.api.service.collections.CollectionEntityService

addMasterSourceMetadata, deleteMasterSourceMetadata, findByMasterSource, getMasterSourceMetadata, replace, update

Methods inherited from interface org.gbif.api.service.collections.CrudService

create, delete, exists, get, update

Methods inherited from interface org.gbif.api.service.registry.IdentifierService

addIdentifier, deleteIdentifier, listIdentifiers

Methods inherited from interface org.gbif.api.service.registry.TagService

addTag, addTag, deleteTag, listTags

Methods inherited from interface org.gbif.api.service.registry.MachineTagService

addMachineTag, addMachineTag, addMachineTag, deleteMachineTag, deleteMachineTags, deleteMachineTags, deleteMachineTags, deleteMachineTags, listMachineTags

Methods inherited from interface org.gbif.api.service.registry.CommentService

addComment, deleteComment, listComments

Methods inherited from interface org.gbif.api.service.collections.ContactService

addContactPerson, listContactPersons, removeContactPerson, replaceContactPersons, updateContactPerson

Methods inherited from interface org.gbif.api.service.collections.OccurrenceMappingService

addOccurrenceMapping, deleteOccurrenceMapping, listOccurrenceMappings

Method Detail

list

PagingResponse<CollectionView> list(CollectionSearchRequest searchRequest)

Pages Collection entities based on the parameters received.

To iterate over all entities you can use code like this: PagingRequest req = new PagingRequest(); PagingResponse<T> response; do { response = service.list(req); for (T obj : response.getResults()) { doStuff(); } req.nextPage(); } while (!response.isEndOfRecords());

Parameters:

searchRequest - CollectionSearchRequest with all the parameters

Returns:

a list of entities ordered by their creation date, newest coming first

listDeleted

PagingResponse<CollectionView> listDeleted(CollectionSearchRequest searchRequest)

Provides access to deleted collections.

getCollectionView

CollectionView getCollectionView(@NotNull
                                 @NotNull UUID key)

Retrieves a CollectionView by the collection key.

suggest

List<KeyCodeNameResult> suggest(@Nullable
                                String q)

Provides a simple suggest service.

createFromDataset

UUID createFromDataset(UUID datasetKey,
                       String collectionCode)

Creates a Collection from a Dataset.

Parameters:

datasetKey - key of the dataset to create the collection from

collectionCode - the code to assign to the collection since it can't be inferred from the dataset

Returns:

UUID of the created collection