com.cvent.dropwizard.mybatis.dataaccess

Class MyBatisMapperInvoker<TMapper>

java.lang.Object

com.cvent.dropwizard.mybatis.dataaccess.MyBatisMapperInvoker<TMapper>

Type Parameters:

TMapper - The type of your mapper interface

All Implemented Interfaces:

WrappedInvoker<TMapper>

Direct Known Subclasses:

MyBatisMapperIdentityInvoker

public class MyBatisMapperInvoker<TMapper>
extends Object
implements WrappedInvoker<TMapper>

This is a thin generic wrapper around mybatis mappers that encapsulates SQL session management so you can just invoke mapper methods (more or less) directly. Example: (initialization) WrappedInvoker<MyMapper> dataAccess = new MybatisMapperInvoker<>(MyMapper.class, sqlSessionFactoryProvider); (business logic) final IdType id = getIdFromRequest(); MyEntity entity = dataAccess.invoke(mapper -> mapper.getById(id)); As you can see, this class can replace the bespoke data access classes that exist solely to wrap mapper methods. In the example above, you can see that parameters to mapper methods may be passed by closure. This means you have to follow the rules for closures in Java, namely that the variables being closed over must be final (or effectively final). This class has its limits. It cannot execute multiple mapper methods within a transaction, and it can only support a single mapper type. If you need transactions, or your use case is complex and requires multiple mappers, you should continue to write data access wrapper classes yourself.

Constructor Summary

Constructors

Constructor and Description
MyBatisMapperInvoker(Class<TMapper> mapperClass, SqlSessionFactoryProvider sqlSessionFactoryProvider)

Method Summary

Modifier and Type	Method and Description
<TResult> TResult	invoke(Function<TMapper,TResult> function) Your implementation of this method should manufacture or reuse an instance of T, then apply function to it
<TResult> TResult	invoke(Function<TMapper,TResult> function, String environment) In case you want to eschew cvent-pangea's contextual environment and pass it yourself, this overload is available.

Methods inherited from class java.lang.Object

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

Constructor Detail

MyBatisMapperInvoker

public MyBatisMapperInvoker(Class<TMapper> mapperClass,
                            SqlSessionFactoryProvider sqlSessionFactoryProvider)

Method Detail

invoke

public <TResult> TResult invoke(Function<TMapper,TResult> function)

Description copied from interface: WrappedInvoker

Your implementation of this method should manufacture or reuse an instance of T, then apply function to it

Specified by:

invoke in interface WrappedInvoker<TMapper>

Type Parameters:

TResult - The return type of your function

Parameters:

function - Your function that will execute given an instance of T

Returns:

Usually this this just the value of function.apply(yourInstanceHere)

invoke

public <TResult> TResult invoke(Function<TMapper,TResult> function,
                                String environment)

In case you want to eschew cvent-pangea's contextual environment and pass it yourself, this overload is available.

Type Parameters:

TResult - The result of the Function, usually the result of a mapper method

Parameters:

function - The Function

environment - The environment name as registered in the SqlSessionFactoryProvider

Returns:

The result of your function