Apache Avro Maven 插件生成 UUID 字段而不是字符串

Question

鉴于以下 Avro 架构：

{
    "namespace": "ro.dspr.coreentities",
    "type": "record",
    "name": "Organization",
    "fields": [
      {
        "name": "id",
        "type": "string",
        "logicalType": "uuid"
      },
      {
        "name": "name",
        "type": "string"
      },
      {
        "name": "description",
        "type": "string"
      }
    ]
}

运行 avro-maven-plugin 1.9.0 目标 schema，我得到：

@org.apache.avro.specific.AvroGenerated
public class Organization extends org.apache.avro.specific.SpecificRecordBase implements org.apache.avro.specific.SpecificRecord {

  public static final org.apache.avro.Schema SCHEMA$ = new org.apache.avro.Schema.Parser().parse("{\"type\":\"record\",\"name\":\"Organization\",\"namespace\":\"ro.dspr.coreentities\",\"fields\":[{\"name\":\"id\",\"type\":{\"type\":\"string\",\"avro.java.string\":\"String\"},\"logicalType\":\"uuid\"},{\"name\":\"name\",\"type\":{\"type\":\"string\",\"avro.java.string\":\"String\"}},{\"name\":\"description\",\"type\":{\"type\":\"string\",\"avro.java.string\":\"String\"}}]}");

  // truncated 

  @Deprecated public java.lang.String id;
  @Deprecated public java.lang.String name;
  @Deprecated public java.lang.String description;

  // truncated
}

我希望为组织生成的 POJO 具有 id UUID，而不是字符串（我现在拥有的）。

我看过的链接：

我确实看到了 logical type def from Avro 并且有 Conversion class 我实际上正在尝试触发，但我无法连接这些点。

其他

相关的 Maven pom 部件

<plugin>
  <groupId>org.apache.avro</groupId>
  <artifactId>avro-maven-plugin</artifactId>
  <version>${avro.version}</version>
  <configuration>
    <sourceDirectory>${avro-files-path}</sourceDirectory>
    <outputDirectory>${project.build.directory}/generated-sources</outputDirectory>
    <stringType>String</stringType>
  </configuration>
  <executions>
    <execution>
      <goals>
        <goal>schema</goal>
      </goals>
      <configuration>
        <sourceDirectory>${avro-files-path}</sourceDirectory>
        <outputDirectory>${project.build.directory}/generated-sources</outputDirectory>
      </configuration>
    </execution>
  </executions>
</plugin>

额外信息

我实际上尝试使用 Avro 为我的 Kafka 消息提供结构。我也在使用 Confluent Schema Registry 和 Confluent Avro Kafka Serializer。尽管如此，我认为我只会将 id 作为字符串，但如果我尝试将消息作为非 UUID 的东西发送到 Kafka，它稍后会失败。但是，我发现实际上没有任何约束，并且我设法将任何字符串发送到 Kafka。所以，Avro 中的“logicalType”根本没有强制执行。

问题

1. 如何将 Organization.class#id 生成为 UUID？
2. 如果在执行此操作时没有 Avro 支持，解决方法是什么（最好重用 org.apache.avro.Conversions.UUIDConversion）？

Answer 1

这是一个功能示例：

架构：

{
  "name": "pk",
  "type": {"type": "string", "logicalType": "uuid"}
},

Maven 配置：

            <plugin>
                <groupId>org.apache.avro</groupId>
                <artifactId>avro-maven-plugin</artifactId>
                <version>1.9.1</version>
                <executions>
                    <execution>
                        <phase>generate-sources</phase>
                        <goals>
                            <goal>schema</goal>
                        </goals>
                        <configuration>
                            <sourceDirectory>${project.basedir}/../avro/schemas/commands</sourceDirectory>
                            <outputDirectory>${project.build.directory}/generated-sources/java</outputDirectory>
                            <!-- TODO Enable this string type once we have 1.10.0 release, or 1.9.2-->
                            <!--<stringType>String</stringType>-->
                            <fieldVisibility>PRIVATE</fieldVisibility>
                            <customConversions>org.apache.avro.Conversions$UUIDConversion</customConversions>
                            <imports>
                                <import>${project.basedir}/../avro/schemas/common</import>
                                <import>${project.basedir}/../avro/schemas/commands/account</import>
                                <import>${project.basedir}/../avro/schemas/commands/rec</import>
                            </imports>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

需要注意的重要一点是，在当前版本的插件中 UUIDConversion 和 String 之间存在冲突，因此您需要选择哪个更重要，或者使用具有修复的 1.10.0-SNAPSHOT已合并，但尚未发布。