Execution Context & Resolver

MongoTemplateResolverがkeyごとのMongoExecutionContextを選択し、DriverMongoExecutionContextがdatabase、session、mappingの境界を提供する方法を説明します。

MongoTemplateResolver契約

MongoTemplateResolver.java

java

public interface MongoTemplateResolver<K> {
  MongoExecutionContext getTemplate(K key);
}

ReactiveMongoDsl<K>는 key마다 MongoExecutionContext를 가져옵니다. MongoExecutionContext가 MongoDatabase, ClientSession, collection naming, entity ↔ Document mapping과 save lifecycle hook의 경계를 담당합니다.

DriverMongoExecutionContext

java

MongoClient frontClient = MongoClients.create(frontConnectionString);
MongoClient backClient = MongoClients.create(backConnectionString);

MongoExecutionContext frontContext = new DriverMongoExecutionContext(
    frontClient,
    frontClient.getDatabase("front")
);

MongoExecutionContext backContext = new DriverMongoExecutionContext(
    backClient,
    backClient.getDatabase("back")
);

MongoTemplateResolver<MongoTemplateName> resolver = key ->
    key == MongoTemplateName.BACK ? backContext : frontContext;

기본 collection 이름은 entity simple class name을 decapitalize해서 결정합니다. 프로젝트의 실제 naming 규칙이 다르면 생성자에 collection-name resolver를 전달합니다.

コレクション名付け

java

MongoExecutionContext context = new DriverMongoExecutionContext(
    mongoClient,
    mongoDatabase,
    entityClass -> collectionNameResolver(entityClass)
);

collection名がアプリケーションのライフサイクル中に完全に固定されている場合、DriverMongoExecutionContext.cachedCollectionNameResolver(...)を使用できます。tenant/request/timeに応じて名前が変わるresolverにはキャッシュヘルパーを使用しません。

セッションスコープとトランザクション

getTxJob(...)で作成されたClientSessionはMongoExecutionContext#getSessionScope()が同じDSL実行にのみ伝播します。DriverMongoExecutionContextは基本的に自分のMongoClientをセッションスコープとして使用します。

異なるMongoClientは1つのDSLトランザクションに束ねられません

複数のdatabaseが同じMongoClientを共有する場合、1つのセッションを使用できますが、異なるMongoClientに接続されたcontext同士は同じClientSessionトランザクションに参加できません。

Spring Data MongoDBを使用する場合

Spring Integration

ReactiveMongoTemplate、MongoConverterとreactive callbackをMongoExecutionContextに接続します。