• 因此，再使用API返回的集合时，集合对象自身始终非空

variant type

• variant type是Java API Client中常见的对象类型，这个该如何翻译呢，个人觉得是不确定类型的意思，不专业，期待您的指正
• 举个例子，查询是最常见的操作了，下面列举三种查询，第一个是普通的不分词查询

{
  "query":{"term":{ "interests":"youyong"}}
}

• 分词查询

{
  "query":{"match":{"interests": "changge"}}
}

• 以及复杂的全文本查询

{
  "query": {
    "intervals" : {
      "my_text" : {
        "all_of" : {
          "ordered" : false,
          "intervals" : [
            {
              "match" : {
                "query" : "my favorite books",
                "max_gaps" : 0,
                "ordered" : true
              }
            },
            {
              "any_of" : {
                "intervals" : [
                  { "match" : { "query" : "java tutorials" } },
                  { "match" : { "query" : "cold porridge" } }
                ]
              }
            }
          ]
        }
      }
    }
  }
}

• 对查询来说，在Java API Client中，有个Query对象代表了查询行为，这就是个典型的variant type，至于对应的真实query是哪种，可以在builder时指定，例如下面指定了类型是term

Query query = new Query.Builder()
    .term(t -> t                          
        .field("name")                    
        .value(v -> v.stringValue("foo"))
    )
    .build();  

• 上述query有对应的方法返回其值，例如上面的value可以这样获取

query.term().value().stringValue()

• 如果在设置的时候，并非用stringValue方法，而是其他类型，那么上面的代码在获取String类型的值时会抛出IllegalStateException异常

• variant type配有对应的isXXX方法返回其是否属于某个类型，例如Query就有query.isTerm()表示自己是不是term查询

• 还可以用_kind()返回当前类型，下面是示例

switch(query._kind()) { 
    case Term:
        doSomething(query.term());
        break;
    case Intervals:
        doSomething(query.intervals());
        break;
    default:
        doSomething(query._kind(), query._get()); 
}

• 可见有了variant type，在 queries, aggregations, field mappings, analyzers等多种场景下，我们不需要使用各种具体的类，只要用最抽象的variant type，再配置builder pattern即可，这对服务提供者和服务消费者都是有效的简化

通过JSON字符串创建API对象

• 下面是kibana页面上，用JSON创建索引的操作截图
  
• 如果要在代码中实现上述效果，该如何做呢？一层一层的创建mapping、proterties、field对象？那可真是麻烦...
• 在Java API Client中，可以通过json字符串反序列化为API对象，首先，将上述JSON放入名为some-index.json的文件中，然后执行以下代码，即可用json文件创建req对象

InputStream input = this.getClass()
    .getResourceAsStream("some-index.json"); 

CreateIndexRequest req = CreateIndexRequest.of(b -> b
    .index("some-index")
    .withJson(input) 
);

boolean created = client.indices().create(req).acknowledged();

• 再来段更复杂的，一个API对象，既通过JSON反序列化生成，同时又能调用对象的方法设置一些属性