com.datastax.oss.driver.api.mapper

Class MapperBuilder<MapperT>

java.lang.Object

com.datastax.oss.driver.api.mapper.MapperBuilder<MapperT>

public abstract class MapperBuilder<MapperT>
extends Object

Builds an instance of a Mapper-annotated interface wrapping a CqlSession.

The mapper generates an implementation of this class for every such interface. It is either named <InterfaceName>Builder, or what you provided in Mapper.builderName().

Field Summary

Fields

Modifier and Type	Field and Description
protected Map<Object,Object>	customState
protected CqlIdentifier	defaultKeyspaceId
protected CqlSession	session

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	MapperBuilder(CqlSession session)

Method Summary

Modifier and Type	Method and Description
abstract MapperT	build()
MapperBuilder<MapperT>	withCustomState(Object key, Object value) Stores custom state that will be propagated to MapperContext.getCustomState().
MapperBuilder<MapperT>	withDefaultKeyspace(CqlIdentifier keyspaceId) Specifies a default keyspace that will be used for all DAOs built with this mapper (unless they specify their own keyspace).
MapperBuilder<MapperT>	withDefaultKeyspace(String keyspaceName) Shortcut for withDefaultKeyspace(CqlIdentifier.fromCql(keyspaceName)).

Methods inherited from class java.lang.Object

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

Field Detail

session

protected final CqlSession session

defaultKeyspaceId

protected CqlIdentifier defaultKeyspaceId

customState

protected Map<Object,Object> customState

Constructor Detail

MapperBuilder

protected MapperBuilder(CqlSession session)

Method Detail

withDefaultKeyspace

@NonNull
public MapperBuilder<MapperT> withDefaultKeyspace(@Nullable
                                                           CqlIdentifier keyspaceId)

Specifies a default keyspace that will be used for all DAOs built with this mapper (unless they specify their own keyspace).

In other words, given the following definitions:

 @Mapper
 public interface InventoryMapper {
   @DaoFactory
   ProductDao productDao();

   @DaoFactory
   ProductDao productDao(@DaoKeyspace CqlIdentifier keyspace);
 }

 InventoryMapper mapper1 = new InventoryMapperBuilder(session)
     .withDefaultKeyspace(CqlIdentifier.fromCql("ks1"))
     .build();
 InventoryMapper mapper2 = new InventoryMapperBuilder(session)
     .withDefaultKeyspace(CqlIdentifier.fromCql("ks2"))
     .build();
 

Then:

• mapper1.productDao() will use keyspace ks1;
• mapper2.productDao() will use keyspace ks2;
• mapper1.productDao(CqlIdentifier.fromCql("ks3")) will use keyspace ks3.

See Also:

DaoFactory

withDefaultKeyspace

@NonNull
public MapperBuilder<MapperT> withDefaultKeyspace(@Nullable
                                                           String keyspaceName)

Shortcut for withDefaultKeyspace(CqlIdentifier.fromCql(keyspaceName)).

withCustomState

@NonNull
public MapperBuilder<MapperT> withCustomState(@Nullable
                                                       Object key,
                                                       @Nullable
                                                       Object value)

Stores custom state that will be propagated to MapperContext.getCustomState().

This is intended mainly for QueryProvider methods: since provider classes are instantiated directly by the generated mapper code, they have no way to access non-static state from the rest of your application. This method allows you to pass that state while building the mapper, and access it later at runtime.

Note that this state will be accessed concurrently, it should be thread-safe.

build

public abstract MapperT build()