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目标模式，我得到：

@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具有idUUID，而不是String（我现在拥有的）。

我确实看到了Avro的逻辑类型def，还有我实际上试图触发的Conversion类，但我无法连接这些点。

相关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模式注册表和Confluent Avro Kafka序列化程序。尽管如此，我认为我只能将id作为字符串，但如果我尝试将消息作为非UUID的内容发送给Kafka，它将在稍后失败。然而，我发现实际上没有约束，我设法将任何字符串发送给Kafka。因此，Avro中的“logicalType”根本不强制执行。

1. 如何生成Organization.class#idUUID？
2. 如果在这样做时没有Avro支持，什么是变通方法（最好是重用org.apache.avro.转换。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，它有一个已合并但尚未发布的修复程序。