静态编程语言/Java：将多个项目添加到一次只允许一个. add（）的Builder类

Question

问题:我在Kotlin中使用AWS DynamoDb增强的Java客户端V2(客户端的细节可能并不重要)，在这里我想创建一个包含一堆请求的< code > BatchWriteItemEnhancedRequest 。根据文件，标准用法是:

val batchWriteItemEnhancedRequest = BatchWriteItemEnhancedRequest.builder()
    .addWriteBatch(
        WriteBatch.builder(MyClass::class.java)
            .mappedTableResource(myMappedTable)
            .addPutItem(putRequest1)
            .addPutItem(putRequest2)
            .addPutItem(putRequest3)
            .build()
    )
    .build()

< code>WriteBatch的生成器似乎不允许添加请求列表:doc

正如我所看到的，做到这一点的唯一方法是制作一个for循环：

var writeBatchBuilder = WriteBatch.builder(MyClass::class.java)
    .mappedTableResource(myMappedTable)

for (request in putItemRequests){
    writeBatchBuilder = writeBatchBuilder.addPutItem(request)
}

val writeBatch = writeBatchBuilder.build()

这对我来说似乎很可怕。必须有一种更惯用的方式来做到这一点，对吧？

Answer 1

在这种情况下，扩展函数函数可能会派上用场。让我们假设，WriteBatch.builder（MyClass::class.java）具有类型WriteBatch.Builder可能带有一些泛型，这在示例中很难说。

val writeBatch = WriteBatch.builder(MyClass::class.java)
    .mappedTableResource(myMappedTable)
    .addItems(putItemRequests)
    .build()
// I did use Any for items type, change it according to your need
fun WriteBatch.Builder.addItems(items: List<Any>) {
    items.forEach { item -> addPutItem(item) }
}

Answer 2

给定< code>WriteBatch的实例。Builder，没有必要明确需要链接DSL，所以您的< code>writeBatchBuilder可以是一个< code>val。每个构建器函数都会改变< code>WriteBatch的内部状态。Builder实例，返回值只是为了方便起见——源代码。

因此，您可以简化您的for循环并使WriteBatchBuilder成为val：

val writeBatchBuilder = WriteBatch.builder(MyClass::class.java)
    .mappedTableResource(myMappedTable)

for (request in putItemRequests){
    writeBatchBuilder.addPutItem(request)
}

val writeBatch = writeBatchBuilder.build()

更进一步，作用域函数是将JavaDSL转换为更静态编程语言的好方法。

< code>apply {}将转换创建的< code>WriteBatch。生成器到接收器中，这意味着您不需要为生成器准备一个变量，只需使用< code>this即可。

val writeBatch = WriteBatch.builder(MyClass::class.java).apply {
  mappedTableResource(myMappedTable)

  putItemRequests.forEach { request -> 
    addPutItem(request)
  }
}.build()

（我还将 for 循环更改为 forEach {} - 这更像是科特林-ey。

下一个改进是将应用{}逻辑封装在辅助函数WriteBatchBuilder（）中，因此样板被隐藏起来，这使得重新使用该函数更容易。

使用inline和具体化T意味着无需每次都定义::class.java-相反，类可以定义为类型参数，并且如果静态编程语言可以推断类型，则可以省略类。

请注意，builderarg的接收器是WriteBatch.Builder，就像应用{}范围函数如何将接收器更改为构建器一样。

inline fun <reified T> buildWriteBatch(
  builder: WriteBatch.Builder<T>.() -> Unit
) : WriteBatch<T> {
  return WriteBatch.builder(T::class.java).apply(builder).build()
}

示例用法：

val writeBatch = buildWriteBatch<MyClass> {
  mappedTableResource(myMappedTable)

  putItemRequests.forEach { request -> 
    addPutItem(request)
  }
}


// no need for explicit typing on buildWriteBatch - Kotlin can infer the type
val writeBatch2: WriteBatch<MyClass> = buildWriteBatch {}