java - 映射注释有什么用？我需要它吗？(Spring Data ElasticSearch)

Question

我正在使用 Spring Data ElasticSearch 3.1.0.RELEASE 来处理ElasticSearch，而且我对 ElasticSearch 本身相当陌生，对它了解不多。

Here(spring-data-elastic docs)我看到文档的映射(模式)是使用元数据(注释)自动生成的，与 Spring Data MongoDB 中的动态方式非常相似，但在我们的组织中，所有实体都用 @Mapping 进行注释。注释并引用反射(reflect)其结构的 JSON 文档，因此对于每个文档实体 - 尽管所有实体都有各自的注释，但仍会编写 JSON 文件。

示例类的一个小片段，用于提示我在说什么

@Document(indexName = "sampleIndex", type = "sample", shards = 16, createIndex = false)
@Mapping(mappingPath = "/elasticsearch/mappings/sample.json")
public final class Sample {

    @Id
    private String id;

    @Field(type = FieldType.Long)
    private long sampleId;

    @Field(type = FieldType.Keyword)
    private SampleObject sampleObject;

    @Field(type = FieldType.Nested)
    private Map<String, String> data;

以及相应的/elasticsearch/mappings/sample.json 文件

{
    "samples": {
        "mappings": {
            "sample": {
                "properties": {
                    "sampleId": {
                        "type": "long"
                    },
                    "sampleObject": {
                        "type": "string"
                    },
                    "data": {
                        "type": "nested"
                    },
....

大约，我可以理解这个注释背后的整个想法，尽管我什至没有在 (spring-data-elastic docs) 中看到任何提及它的内容。我没有看到任何有意义的JavaDocs .

不管怎样，我仍然不明白这个注释是如何工作的，用例是什么以及为什么需要它，从我的角度来看，我会完全删除它，因为模式可以根据Spring 的其他注释。还是我错了？

_{与问题相关的其他要点:我也不确定这一点:此映射 JSON 文件是否会覆盖实体中通过注释定义的结构？}

Answer 1

ElasticsearchOperations接口(interface)有一个方法putMapping(class<?>) 。此方法可用于将索引映射写入索引。默认的非响应式(Reactive)存储库实现在创建索引时执行此操作。

默认方法实现检查是否有 @Mapping类上的注释。如果是，则使用此映射定义。如果此注释不存在，则检查该类并检查 @Field属性上的注释。

因此，在您的情况下，属性上的注释不用于编写索引映射。

我建议使用类上的属性，因为您更有可能更改类中的某些映射属性并将其忘记在 json 文件中。

例如，在类 sampleObject 中的代码中定义为keyword但在映射中它是一个字符串。只看代码的人可能会错过不同的定义。