org.springframework.data.couchbase.core

Class CouchbaseTemplate

java.lang.Object

org.springframework.data.couchbase.core.CouchbaseTemplate

All Implemented Interfaces:

Aware, ApplicationContextAware, CouchbaseOperations, ExecutableExistsByIdOperation, ExecutableFindByAnalyticsOperation, ExecutableFindByIdOperation, ExecutableFindByQueryOperation, ExecutableFindFromReplicasByIdOperation, ExecutableInsertByIdOperation, ExecutableRemoveByIdOperation, ExecutableRemoveByQueryOperation, ExecutableReplaceByIdOperation, ExecutableUpsertByIdOperation, FluentCouchbaseOperations

public class CouchbaseTemplate
extends Object
implements CouchbaseOperations, ApplicationContextAware

Implements lower-level couchbase operations on top of the SDK with entity mapping capabilities.

Since:

3.0

Author:

Michael Nitschinger, Michael Reiche, Jorge Rodriguez Martin

Nested Class Summary

Nested classes/interfaces inherited from interface org.springframework.data.couchbase.core.ExecutableUpsertByIdOperation

ExecutableUpsertByIdOperation.ExecutableUpsertById<T>, ExecutableUpsertByIdOperation.TerminatingUpsertById<T>, ExecutableUpsertByIdOperation.UpsertByIdInCollection<T>, ExecutableUpsertByIdOperation.UpsertByIdInScope<T>, ExecutableUpsertByIdOperation.UpsertByIdWithDurability<T>, ExecutableUpsertByIdOperation.UpsertByIdWithExpiry<T>, ExecutableUpsertByIdOperation.UpsertByIdWithOptions<T>

Nested classes/interfaces inherited from interface org.springframework.data.couchbase.core.ExecutableInsertByIdOperation

ExecutableInsertByIdOperation.ExecutableInsertById<T>, ExecutableInsertByIdOperation.InsertByIdInCollection<T>, ExecutableInsertByIdOperation.InsertByIdInScope<T>, ExecutableInsertByIdOperation.InsertByIdWithDurability<T>, ExecutableInsertByIdOperation.InsertByIdWithExpiry<T>, ExecutableInsertByIdOperation.InsertByIdWithOptions<T>, ExecutableInsertByIdOperation.TerminatingInsertById<T>

Nested classes/interfaces inherited from interface org.springframework.data.couchbase.core.ExecutableReplaceByIdOperation

ExecutableReplaceByIdOperation.ExecutableReplaceById<T>, ExecutableReplaceByIdOperation.ReplaceByIdInCollection<T>, ExecutableReplaceByIdOperation.ReplaceByIdInScope<T>, ExecutableReplaceByIdOperation.ReplaceByIdWithDurability<T>, ExecutableReplaceByIdOperation.ReplaceByIdWithExpiry<T>, ExecutableReplaceByIdOperation.ReplaceByIdWithOptions<T>, ExecutableReplaceByIdOperation.TerminatingReplaceById<T>

Nested classes/interfaces inherited from interface org.springframework.data.couchbase.core.ExecutableFindByIdOperation

ExecutableFindByIdOperation.ExecutableFindById<T>, ExecutableFindByIdOperation.FindByIdInCollection<T>, ExecutableFindByIdOperation.FindByIdInScope<T>, ExecutableFindByIdOperation.FindByIdWithExpiry<T>, ExecutableFindByIdOperation.FindByIdWithOptions<T>, ExecutableFindByIdOperation.FindByIdWithProjection<T>, ExecutableFindByIdOperation.TerminatingFindById<T>

Nested classes/interfaces inherited from interface org.springframework.data.couchbase.core.ExecutableFindFromReplicasByIdOperation

ExecutableFindFromReplicasByIdOperation.ExecutableFindFromReplicasById<T>, ExecutableFindFromReplicasByIdOperation.FindFromReplicasByIdInCollection<T>, ExecutableFindFromReplicasByIdOperation.FindFromReplicasByIdInScope<T>, ExecutableFindFromReplicasByIdOperation.FindFromReplicasByIdWithOptions<T>, ExecutableFindFromReplicasByIdOperation.TerminatingFindFromReplicasById<T>

Nested classes/interfaces inherited from interface org.springframework.data.couchbase.core.ExecutableFindByQueryOperation

ExecutableFindByQueryOperation.ExecutableFindByQuery<T>, ExecutableFindByQueryOperation.FindByQueryConsistentWith<T>, ExecutableFindByQueryOperation.FindByQueryInCollection<T>, ExecutableFindByQueryOperation.FindByQueryInScope<T>, ExecutableFindByQueryOperation.FindByQueryWithConsistency<T>, ExecutableFindByQueryOperation.FindByQueryWithDistinct<T>, ExecutableFindByQueryOperation.FindByQueryWithOptions<T>, ExecutableFindByQueryOperation.FindByQueryWithProjecting<T>, ExecutableFindByQueryOperation.FindByQueryWithProjection<T>, ExecutableFindByQueryOperation.FindByQueryWithQuery<T>, ExecutableFindByQueryOperation.TerminatingFindByQuery<T>

Nested classes/interfaces inherited from interface org.springframework.data.couchbase.core.ExecutableFindByAnalyticsOperation

ExecutableFindByAnalyticsOperation.ExecutableFindByAnalytics<T>, ExecutableFindByAnalyticsOperation.FindByAnalyticsConsistentWith<T>, ExecutableFindByAnalyticsOperation.FindByAnalyticsInCollection<T>, ExecutableFindByAnalyticsOperation.FindByAnalyticsInScope<T>, ExecutableFindByAnalyticsOperation.FindByAnalyticsWithConsistency<T>, ExecutableFindByAnalyticsOperation.FindByAnalyticsWithOptions<T>, ExecutableFindByAnalyticsOperation.FindByAnalyticsWithProjection<T>, ExecutableFindByAnalyticsOperation.FindByAnalyticsWithQuery<T>, ExecutableFindByAnalyticsOperation.TerminatingFindByAnalytics<T>

Nested classes/interfaces inherited from interface org.springframework.data.couchbase.core.ExecutableExistsByIdOperation

ExecutableExistsByIdOperation.ExecutableExistsById, ExecutableExistsByIdOperation.ExistsByIdInCollection<T>, ExecutableExistsByIdOperation.ExistsByIdInScope<T>, ExecutableExistsByIdOperation.ExistsByIdWithOptions<T>, ExecutableExistsByIdOperation.TerminatingExistsById

Nested classes/interfaces inherited from interface org.springframework.data.couchbase.core.ExecutableRemoveByIdOperation

ExecutableRemoveByIdOperation.ExecutableRemoveById, ExecutableRemoveByIdOperation.RemoveByIdInCollection, ExecutableRemoveByIdOperation.RemoveByIdInScope, ExecutableRemoveByIdOperation.RemoveByIdWithCas, ExecutableRemoveByIdOperation.RemoveByIdWithDurability, ExecutableRemoveByIdOperation.RemoveByIdWithOptions, ExecutableRemoveByIdOperation.TerminatingRemoveById

Nested classes/interfaces inherited from interface org.springframework.data.couchbase.core.ExecutableRemoveByQueryOperation

ExecutableRemoveByQueryOperation.ExecutableRemoveByQuery<T>, ExecutableRemoveByQueryOperation.RemoveByQueryConsistentWith<T>, ExecutableRemoveByQueryOperation.RemoveByQueryInCollection<T>, ExecutableRemoveByQueryOperation.RemoveByQueryInScope<T>, ExecutableRemoveByQueryOperation.RemoveByQueryWithConsistency<T>, ExecutableRemoveByQueryOperation.RemoveByQueryWithOptions<T>, ExecutableRemoveByQueryOperation.RemoveByQueryWithQuery<T>, ExecutableRemoveByQueryOperation.TerminatingRemoveByQuery<T>

Constructor Summary

Constructors

Constructor and Description
CouchbaseTemplate(CouchbaseClientFactory clientFactory, CouchbaseConverter converter)
CouchbaseTemplate(CouchbaseClientFactory clientFactory, CouchbaseConverter converter, TranslationService translationService)
CouchbaseTemplate(CouchbaseClientFactory clientFactory, CouchbaseConverter converter, TranslationService translationService, com.couchbase.client.java.query.QueryScanConsistency scanConsistency)

Method Summary

Modifier and Type	Method and Description
ExecutableExistsByIdOperation.ExecutableExistsById	existsById() Deprecated.
ExecutableExistsByIdOperation.ExecutableExistsById	existsById(Class<?> domainType) Checks if the document exists in the bucket.
<T> ExecutableFindByAnalyticsOperation.ExecutableFindByAnalytics<T>	findByAnalytics(Class<T> domainType) Queries the analytics service.
<T> ExecutableFindByIdOperation.ExecutableFindById<T>	findById(Class<T> domainType) Loads a document from a bucket.
<T> ExecutableFindByQueryOperation.ExecutableFindByQuery<T>	findByQuery(Class<T> domainType) Queries the N1QL service.
<T> ExecutableFindFromReplicasByIdOperation.ExecutableFindFromReplicasById<T>	findFromReplicasById(Class<T> domainType) Loads a document from a replica.
String	getBucketName() The name of the bucket used.
com.couchbase.client.java.Collection	getCollection(String collectionName) Provides access to a Collection on the configured CouchbaseClientFactory.
com.couchbase.client.java.query.QueryScanConsistency	getConsistency() Returns the default consistency to use for queries
CouchbaseConverter	getConverter() Returns the converter used for this template/operations.
CouchbaseClientFactory	getCouchbaseClientFactory() Returns the underlying client factory.
String	getScopeName() The name of the scope used, null if the default scope is used.
<T> ExecutableInsertByIdOperation.ExecutableInsertById<T>	insertById(Class<T> domainType) Insert using the KV service.
ReactiveCouchbaseTemplate	reactive()
ExecutableRemoveByIdOperation.ExecutableRemoveById	removeById() Deprecated.
ExecutableRemoveByIdOperation.ExecutableRemoveById	removeById(Class<?> domainType) Removes a document.
<T> ExecutableRemoveByQueryOperation.ExecutableRemoveByQuery<T>	removeByQuery(Class<T> domainType) Remove via the query service.
<T> ExecutableReplaceByIdOperation.ExecutableReplaceById<T>	replaceById(Class<T> domainType) Replace using the KV service.
void	setApplicationContext(ApplicationContext applicationContext)
TemplateSupport	support()
<T> ExecutableUpsertByIdOperation.ExecutableUpsertById<T>	upsertById(Class<T> domainType) Upsert using the KV service.

Methods inherited from class java.lang.Object

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

Constructor Detail

CouchbaseTemplate

public CouchbaseTemplate(CouchbaseClientFactory clientFactory,
                         CouchbaseConverter converter)

CouchbaseTemplate

public CouchbaseTemplate(CouchbaseClientFactory clientFactory,
                         CouchbaseConverter converter,
                         TranslationService translationService)

CouchbaseTemplate

public CouchbaseTemplate(CouchbaseClientFactory clientFactory,
                         CouchbaseConverter converter,
                         TranslationService translationService,
                         com.couchbase.client.java.query.QueryScanConsistency scanConsistency)

Method Detail

upsertById

public <T> ExecutableUpsertByIdOperation.ExecutableUpsertById<T> upsertById(Class<T> domainType)

Description copied from interface: ExecutableUpsertByIdOperation

Upsert using the KV service.

Specified by:

upsertById in interface ExecutableUpsertByIdOperation

Parameters:

domainType - the entity type to upsert.

insertById

public <T> ExecutableInsertByIdOperation.ExecutableInsertById<T> insertById(Class<T> domainType)

Description copied from interface: ExecutableInsertByIdOperation

Insert using the KV service.

Specified by:

insertById in interface ExecutableInsertByIdOperation

Parameters:

domainType - the entity type to insert.

replaceById

public <T> ExecutableReplaceByIdOperation.ExecutableReplaceById<T> replaceById(Class<T> domainType)

Description copied from interface: ExecutableReplaceByIdOperation

Replace using the KV service.

Specified by:

replaceById in interface ExecutableReplaceByIdOperation

Parameters:

domainType - the entity type to replace.

findById

public <T> ExecutableFindByIdOperation.ExecutableFindById<T> findById(Class<T> domainType)

Description copied from interface: ExecutableFindByIdOperation

Loads a document from a bucket.

Specified by:

findById in interface ExecutableFindByIdOperation

Parameters:

domainType - the entity type to use for the results.

findFromReplicasById

public <T> ExecutableFindFromReplicasByIdOperation.ExecutableFindFromReplicasById<T> findFromReplicasById(Class<T> domainType)

Description copied from interface: ExecutableFindFromReplicasByIdOperation

Loads a document from a replica.

Specified by:

findFromReplicasById in interface ExecutableFindFromReplicasByIdOperation

Parameters:

domainType - the entity type to use for the results.

findByQuery

public <T> ExecutableFindByQueryOperation.ExecutableFindByQuery<T> findByQuery(Class<T> domainType)

Description copied from interface: ExecutableFindByQueryOperation

Queries the N1QL service.

Specified by:

findByQuery in interface ExecutableFindByQueryOperation

Parameters:

domainType - the entity type to use for the results.

findByAnalytics

public <T> ExecutableFindByAnalyticsOperation.ExecutableFindByAnalytics<T> findByAnalytics(Class<T> domainType)

Description copied from interface: ExecutableFindByAnalyticsOperation

Queries the analytics service.

Specified by:

findByAnalytics in interface ExecutableFindByAnalyticsOperation

Parameters:

domainType - the entity type to use for the results.

removeById

@Deprecated
public ExecutableRemoveByIdOperation.ExecutableRemoveById removeById()

Deprecated.

Description copied from interface: ExecutableRemoveByIdOperation

Removes a document.

Specified by:

removeById in interface ExecutableRemoveByIdOperation

removeById

public ExecutableRemoveByIdOperation.ExecutableRemoveById removeById(Class<?> domainType)

Description copied from interface: ExecutableRemoveByIdOperation

Removes a document.

Specified by:

removeById in interface ExecutableRemoveByIdOperation

existsById

@Deprecated
public ExecutableExistsByIdOperation.ExecutableExistsById existsById()

Deprecated.

Description copied from interface: ExecutableExistsByIdOperation

Checks if the document exists in the bucket.

Specified by:

existsById in interface ExecutableExistsByIdOperation

existsById

public ExecutableExistsByIdOperation.ExecutableExistsById existsById(Class<?> domainType)

Description copied from interface: ExecutableExistsByIdOperation

Checks if the document exists in the bucket.

Specified by:

existsById in interface ExecutableExistsByIdOperation

removeByQuery

public <T> ExecutableRemoveByQueryOperation.ExecutableRemoveByQuery<T> removeByQuery(Class<T> domainType)

Description copied from interface: ExecutableRemoveByQueryOperation

Remove via the query service.

Specified by:

removeByQuery in interface ExecutableRemoveByQueryOperation

getBucketName

public String getBucketName()

Description copied from interface: CouchbaseOperations

The name of the bucket used.

Specified by:

getBucketName in interface CouchbaseOperations

getScopeName

public String getScopeName()

Description copied from interface: CouchbaseOperations

The name of the scope used, null if the default scope is used.

Specified by:

getScopeName in interface CouchbaseOperations

getCouchbaseClientFactory

public CouchbaseClientFactory getCouchbaseClientFactory()

Description copied from interface: CouchbaseOperations

Returns the underlying client factory.

Specified by:

getCouchbaseClientFactory in interface CouchbaseOperations

getConsistency

public com.couchbase.client.java.query.QueryScanConsistency getConsistency()

Description copied from interface: CouchbaseOperations

Returns the default consistency to use for queries

Specified by:

getConsistency in interface CouchbaseOperations

getCollection

public com.couchbase.client.java.Collection getCollection(String collectionName)

Provides access to a Collection on the configured CouchbaseClientFactory.

Parameters:

collectionName - the name of the collection, if null is passed in the default collection is assumed.

Returns:

the collection instance.

getConverter

public CouchbaseConverter getConverter()

Description copied from interface: CouchbaseOperations

Returns the converter used for this template/operations.

Specified by:

getConverter in interface CouchbaseOperations

reactive

public ReactiveCouchbaseTemplate reactive()

setApplicationContext

public void setApplicationContext(ApplicationContext applicationContext)
                           throws BeansException

Specified by:

setApplicationContext in interface ApplicationContextAware

Throws:

BeansException

support

public TemplateSupport support()