如何使用新版Elasticsearch Java API设置映射并定义keyword类型字段

我完全懂你的困扰——新版Elasticsearch Java Client的流式API确实语法流畅，但文档跟不上的问题真的很让人头疼，尤其是想把常见的JSON映射转换成Java代码的时候。你找不到putMappings方法是因为它的位置变了，而且方法名也有细微调整，下面给你详细的示例：

两种常见场景的实现 #

1. 创建索引时直接定义keyword字段映射 #

如果是新索引，你可以在创建索引的同时指定字段类型，不需要单独调用映射接口：

ElasticsearchClient client = // 这里是你的Client初始化逻辑，比如通过RestClient构建

CreateIndexResponse response = client.indices().create(c -> c
    .index("your-target-index")
    .mappings(m -> m
        // 定义单个keyword字段
        .properties("product_id", p -> p
            .keyword(k -> k)
        )
        // 带额外参数的keyword字段（比如忽略超过256长度的内容）
        .properties("short_tag", p -> p
            .keyword(k -> k
                .ignoreAbove(256)
            )
        )
        // 给text字段添加keyword子字段（常见的多字段场景）
        .properties("product_name", p -> p
            .text(t -> t
                .fields(f -> f
                    .keyword(k -> k
                        .ignoreAbove(100)
                    )
                )
            )
        )
    )
);

2. 给已存在的索引添加keyword字段映射 #

如果要给已有的索引新增字段映射，需要调用indices().putMapping()方法（注意是单数的putMapping，不是你之前找的putMappings）：

PutMappingResponse response = client.indices().putMapping(p -> p
    .index("your-existing-index")
    .properties("new_keyword_field", prop -> prop
        .keyword(keyword -> keyword)
    )
);

关键提示 #

• 新版API的putMapping方法属于IndicesClient，必须先通过client.indices()获取这个客户端实例才能调用，这就是你之前找不到它的原因。
• 流式API的结构和JSON映射完全对应：JSON里的"type": "keyword"对应Java里的.keyword(k -> k)，如果需要设置额外属性（比如normalizer、ignore_above），直接在keyword()的链式调用里添加即可。
• 虽然官方文档的Java示例偏少，但你可以对照JSON格式的映射文档，通过IDE的自动补全功能一步步推导流式API的写法——每个JSON层级基本都对应一个Java方法。

内容的提问来源于stack exchange，提问作者Alain Désilets