CIPSDN

Spring认证中国教育管理中心-Spring Data R2DBC框架教程六

原标题：Spring认证中国教育管理中心-Spring Data R2DBC框架教程六（Spring中国教育管理中心）

16.1.4.Kotlin 支持

Spring Data 调整了 Kotlin 的细节以允许创建和更改对象。

Kotlin 对象创建

Kotlin 类支持实例化，默认情况下所有类都是不可变的，并且需要显式属性声明来定义可变属性。考虑以下data类Person：

data class Person(val id: String, val name: String)

上面的类编译为具有显式构造函数的典型类。我们可以通过添加另一个构造函数来自定义这个类，并使用注释@PersistenceConstructor来指示构造函数首选项：

data class Person(var id: String, val name: String) {

    @PersistenceConstructor
    constructor(id: String) : this(id, "unknown")
}

Kotlin 通过允许在未提供参数时使用默认值来支持参数可选性。当 Spring Data 检测到具有参数默认值的构造函数时，如果数据存储不提供值（或简单地返回null），它就会使这些参数不存在，因此 Kotlin 可以应用参数默认值。考虑以下应用参数默认值的类name

data class Person(var id: String, val name: String = "unknown")

每次name参数不是结果的一部分或其值为时null，则name默认为unknown。

Kotlin 数据类的属性填充

在 Kotlin 中，默认情况下所有类都是不可变的，并且需要明确的属性声明来定义可变属性。考虑以下data类Person：

data class Person(val id: String, val name: String)

这个类实际上是不可变的。它允许创建新实例，因为 Kotlin 生成copy(…)创建新对象实例的方法，该方法从现有对象复制所有属性值并将作为参数提供的属性值应用到该方法。

Kotlin 覆盖属性

Kotlin 允许声明属性覆盖来改变子类中的属性。

open class SuperType(open var field: Int)

class SubType(override var field: Int = 1) :
  SuperType(field) {
}

这样的安排呈现了两个名称为的属性field。Kotlin 为每个类中的每个属性生成属性访问器（getter 和 setter）。实际上，代码如下所示：

public class SuperType {

   private int field;

   public SuperType(int field) {
      this.field = field;
   }

   public int getField() {
      return this.field;
   }

   public void setField(int field) {
      this.field = field;
   }
}

public final class SubType extends SuperType {

   private int field;

   public SubType(int field) {
      super(field);
      this.field = field;
   }

   public int getField() {
      return this.field;
   }

   public void setField(int field) {
      this.field = field;
   }
}

getter 和 setterSubType只在set 上，SubType.field而不是SuperType.field. 在这种安排中，使用构造函数是设置的唯一默认方法SuperType.field。添加方法 to SubTypeset
SuperType.fieldviathis.SuperType.field = …是可能的，但不属于支持的约定。属性覆盖在某种程度上会产生冲突，因为属性共享相同的名称但可能代表两个不同的值。我们通常建议使用不同的属性名称。

Spring Data 模块通常支持包含不同值的覆盖属性。从编程模型的角度来看，需要考虑以下几点：

应该保留哪个属性（默认为所有声明的属性）？您可以通过使用注释这些属性来排除属性@Transient。
如何表示数据存储中的属性？对不同的值使用相同的字段/列名称通常会导致数据损坏，因此您应该使用明确的字段/列名称来注释至少一个属性。
using@AccessType(PROPERTY)不能使用，因为不能设置超级属性。

16.2.基于约定的映射

MappingR2dbcConverter当没有提供额外的映射元数据时，有一些将对象映射到行的约定。这些约定是：

简短的 Java 类名以下列方式映射到表名。将com.bigbank.SavingsAccount类映射到SAVINGS_ACCOUNT表名。相同的名称映射应用于将字段映射到列名称。例如，firstName字段映射到FIRST_NAME列。您可以通过提供自定义NamingStrategy. 有关更多详细信息，请参阅映射配置。默认情况下，在 SQL 语句中使用从属性或类名派生的表名和列名，不带引号。您可以通过设置来控制这种行为R2dbcMappingContext.setForceQuote(true)。
不支持嵌套对象。
转换器使用任何注册的 Spring 转换器来覆盖对象属性到行列和值的默认映射。
对象的字段用于在行中的列之间进行转换。JavaBean不使用公共属性。
如果您有一个非零参数构造函数，其构造函数参数名称与行的顶级列名称匹配，则使用该构造函数。否则，将使用零参数构造函数。如果有多个非零参数构造函数，则会引发异常。

16.3.映射配置

默认情况下（除非明确配置）MappingR2dbcConverter在您创建DatabaseClient. 您可以创建自己的MappingR2dbcConverter. 通过创建您自己的实例，您可以注册 Spring 转换器以将特定类映射到数据库或从数据库映射。

您可以配置MappingR2dbcConverter以及DatabaseClient和ConnectionFactory使用基于Java的元数据。以下示例使用 Spring 的基于 Java 的配置：

如果设置setForceQuote为R2dbcMappingContext totrue，则从类和属性派生的表名和列名将与数据库特定的引号一起使用。这意味着可以在这些名称中使用保留的 SQL 字（例如 order）。您可以通过重写这样做r2dbcMappingContext(Optional)的
AbstractR2dbcConfiguration。Spring Data 将此类名称的字母大小写转换为不使用引用时配置的数据库也使用的形式。因此，您可以在创建表时使用不带引号的名称，只要您的名称中不使用关键字或特殊字符即可。对于遵循 SQL 标准的数据库，这意味着名称被转换为大写。引用字符和名称大写的方式由 used 控制Dialect。有关如何配置自定义方言的信息，请参阅R2DBC 驱动程序。

例 87.@Configuration 类来配置 R2DBC 映射支持

@Configuration
public class MyAppConfig extends AbstractR2dbcConfiguration {

  public ConnectionFactory connectionFactory() {
    return ConnectionFactories.get("r2dbc:…");
  }

  // the following are optional

  @Override
  protected List