Java API [2.3] » Document APIs » Index API

翻译水平有限，仅供参考

Java API [2.3] » Document APIs » Index API

Index API

Index API让我们能够把一个特定类型的JSON文档索引到特定的index中，以供我们搜索

产生JSON文档

有四种方法产生一个JSON文档：

1、利用字节数组byte[]或字符数String手动产生

2、利用Map类型，Map类会自动转换成内容相同的JSON

3、利用第三方库来序列化实体，如jackson

4、利用内置的XContentFactory.jsonBuilder()

在ES内部，上面的方法都会转换到字节数组byte[]。因此，如果对象已经是字节数组，直接使用即可。

jsonBuilder是一个高度优化的JSON产生器，能够直接构造字节数组byte

1、利用字节数组byte[]或字符数String手动产生

下面这个例子中，需要注意把date手动编码成日期格式

String json = "{" +

        "\"user\":\"kimchy\"," +

        "\"postDate\":\"2013-01-30\"," +

        "\"message\":\"trying out Elasticsearch\"" +

    "}";

2、利用Map类型，Map类会自动转换成内容相同的JSON

Map是一个键值对集合。它代表JSON结构

Map<String, Object> json = new HashMap<String, Object>();

json.put("user","kimchy");

json.put("postDate",new Date());

json.put("message","trying out Elasticsearch");    

3、利用第三方库来序列化实体，如jackson

ES已经使用了jackson，因此你可以用它来序列化实体

import com.fasterxml.jackson.databind.*;

// instance a json mapper

ObjectMapper mapper = new ObjectMapper(); // create once, reuse

// generate json

byte[] json = mapper.writeValueAsBytes(yourbeaninstance);

4、利用内置的XContentFactory.jsonBuilder()

ES提供了内置的助手来产生JSON

import static org.elasticsearch.common.xcontent.XContentFactory.*;

XContentBuilder builder = jsonBuilder()

    .startObject()

        .field("user", "kimchy")

        .field("postDate", new Date())

        .field("message", "trying out Elasticsearch")

    .endObject()

注意，你也可以用startArray和endArray来添加数组。而且，field()可以接受多种

对象类型，包括JSON。

如果你需要看JSON的内容，可以使用string()方法。

String json = builder.string();

建立索引

下面是一个例子，把一个JSON文档索引到index为twitter,type为tweet，id为1中

import static org.elasticsearch.common.xcontent.XContentFactory.*;

IndexResponse response = client.prepareIndex("twitter", "tweet", "1")

        .setSource(jsonBuilder()

                    .startObject()

                        .field("user", "kimchy")

                        .field("postDate", new Date())

                        .field("message", "trying out Elasticsearch")

                    .endObject()

                  )

        .get();

你也可以利用String生成JSON建立索引，并不给定ID

String json = "{" +

        "\"user\":\"kimchy\"," +

        "\"postDate\":\"2013-01-30\"," +

        "\"message\":\"trying out Elasticsearch\"" +

    "}";

IndexResponse response = client.prepareIndex("twitter", "tweet")

        .setSource(json)

        .get();

IndexResponse对象会给你返回结果

// Index name

String _index = response.getIndex();

// Type name

String _type = response.getType();

// Document ID (generated or not)

String _id = response.getId();

// Version (if it's the first time you index this document, you will get: 1)

long _version = response.getVersion();

// isCreated() is true if the document is a new one, false if it has been updated

boolean created = response.isCreated();

想看更多索引操作，可以看REST的index文档

网页链接https://www.elastic.co/guide/en/elasticsearch/client/java-api/current/java-docs-index.html