elasticsearch的restful API和Java API

本文涉及的产品
检索分析服务 Elasticsearch 版,2核4GB开发者规格 1个月
简介:

本人现在使用的是elasticsearch 5.2.1的,服务器IP为192.168.5.182.所以在Java API和jar包中会有所不同.

常用的restful API如下:

http://192.168.5.182:9200/_cat/health?v 健康检查
http://192.168.5.182:9200/_cat/indices?v 查看索引
PUT http://192.168.5.182:9200/test_index?pretty 添加索引
DELETE http://192.168.5.182:9200/test_index 删除索引
PUT http://192.168.5.182:9200/ecommerce/product/1
BODY {

"name":"zhonghua yagao",
"desc":"caoben zhiwu",
"price":40,
"producer":"zhonghua producer",
"tags":["qingxin"]

} 为索引添加数据,ecommerce索引,product type,1 ID
GET http://192.168.5.182:9200/ecommerce/product/1 查询数据
PUT http://192.168.5.182:9200/ecommerce/product/1
BODY {

"name":"jiaqiangban zhonghua yagao",
"desc":"caoben zhiwu",
"price":40,
"producer":"zhonghua producer",
"tags":["qingxin"]

} 更新索引数据,方式一,必须带上所有数据
POST http://192.168.5.182:9200/ecommerce/product/1/_update
BODY {

"doc": {
    "name":"gaolujie yagao"
}

} 更新索引数据,方式二
DELETE http://192.168.5.182:9200/ecommerce/product/1 删除索引数据
GET http://192.168.5.182:9200/ecommerce/product/_search 搜索所有
GET http://192.168.5.182:9200/ecommerce/product/_search?q=name:yagao&sort=price:desc
curl -XGET 'http://192.168.5.182:9200/ecommerce/product/_search' -d'

{
"query":{

 "match_all":{}

}
}'
curl -XGET 'http://192.168.5.182:9200/ecommerce/product/_search' -d'
{

"query":{
    "match":{
         "name":"yagao"
    }
},
"sort":[
    {"price":"desc"}
]

}' 排序查询

curl -XGET 'http://192.168.5.182:9200/ecommerce/product/_search' -d'

{
"query":{

    "match_all":{}

},
"from":1,
"size":1
}' 分页查询

curl -XGET 'http://192.168.5.182:9200/ecommerce/product/_search' -d'
{
"query":{

    "match_all":{}

},
"_source":["name","price"]
}' 只查询指定的字段
curl -XGET 'http://192.168.5.182:9200/ecommerce/product/_search' -d'
{

"query":{

 "bool":{
    "must":{
       "match":{
          "name":"yagao"
       }
    },
    "filter":{
       "range":{
          "price":{
             "gt":25
          }
       }
    }
 }

}
}' 查询yagao的price范围,大于25
curl -XGET 'http://192.168.5.182:9200/ecommerce/product/_search' -d'
{
"query":{

  "match":{
     "producer":"yagao producer"
  }

}
}' 全文检索

curl -XGET 'http://192.168.5.182:9200/ecommerce/product/_search' -d'
{
"query":{

  "match_phrase":{
     "producer":"yagao producer"
  }

}
}' 短语搜索
curl -XGET 'http://192.168.5.182:9200/ecommerce/product/_search' -d'

{

"query":{
   "match":{
      "producer":"producer"
   }
},
"highlight":{
   "fields":{
      "producer":{}
   }
}

}' 高亮显示
PUT http://192.168.5.182:9200/ecommerce/_mapping/product

BODY {

"properties":{
    "tags":{
        "type":"text",
        "fielddata":true
    }
}

} 将文本field的fielddata属性设置为true
curl -XGET 'http://192.168.5.182:9200/ecommerce/product/_search' -d'

{

"aggs":{
    "group_by_tags":{
          "terms":{
               "field":"tags"
          }
    }
}

}' 对tags聚合,会显示明细
curl -XGET 'http://192.168.5.182:9200/ecommerce/product/_search' -d'

{ "size":0,

"aggs":{
    "group_by_tags":{
          "terms":{
               "field":"tags"
          }
    }
}

}' 对tags聚合,不显示明细,只显示聚合
curl -XGET 'http://192.168.5.182:9200/ecommerce/product/_search' -d'

{
"size":0,
"query":{

   "match":{
       "name":"yagao"
   }

},
"aggs":{

   "group_by_tags":{
       "terms":{
            "field":"tags"
       }
   }

}
}' 搜索包含条件的聚合
curl -XGET 'http://192.168.5.182:9200/ecommerce/product/_search' -d'
{

"size":0,
"aggs":{
     "group_by_tags":{
          "terms":{
               "field":"tags"
          },
          "aggs":{
               "avg_price":{
                     "avg":{
                           "field":"price"
                     }
               }
          }
     }
}

}' 聚合计算平均值

curl -XGET 'http://192.168.5.182:9200/ecommerce/product/_search' -d'

{

"size":0,
"aggs":{
   "group_by_tags":{
       "terms":{
           "field":"tags",
           "order":{
                "avg_price":"desc"
           }
       },
       "aggs":{
           "avg_price":{
                "avg":{
                      "field":"price"
                }
           }
       }
   }
}

}' 聚合后降序排序

curl -XGET 'http://192.168.5.182:9200/ecommerce/product/_search' -d'
{
"size":0,
"aggs":{

  "group_by_price":{
      "range":{
          "field":"price",
          "ranges":[
            {      
               "from":0,
               "to":20
            },        
            {      
               "from":20,
               "to":40
            },        
            {      
               "from":40,
               "to":60
            }
          ]
       },
       "aggs":{
          "group_by_tags":{
             "terms":{
                 "field":"tags"
             },
             "aggs":{
                 "average_price":{
                     "avg":{
                         "field":"price"
                     }
                 }
             }
          }
       }
  }

}
}' 按照价格区间分组后再聚合tags平均价格
PUT http://192.168.5.182:9200/company
BODY {

"mappings": {
        "employee": {
            "properties": {
                "age": {
                    "type": "long"
                },
                "country": {
                    "type": "text",
                    "fields": {
                        "keyword": {
                            "type": "keyword",
                            "ignore_above": 256
                        }
                    },
                    "fielddata":true
                },
                "join_date": {
                    "type": "date"
                },
                "name": {
                    "type": "text",
                    "fields": {
                        "keyword": {
                            "type": "keyword",
                            "ignore_above": 256
                        }
                    }
                },
                "position": {
                    "type": "text",
                    "fields": {
                        "keyword": {
                            "type": "keyword",
                            "ignore_above": 256
                        }
                    }
                },
                "salary": {
                    "type": "long"
                }
            }
        }
    }

} 给country建立正排索引

在Java API中,我们需要先找到相应的jar包,maven中的配置如下(开始之前请先执行上面的给country建立正排索引的restful API)


org.elasticsearch.client
transport
5.2.1

5.2.1中只需要配这一个就可以了,当然不同的版本配置的都不同,高版本的需要配


org.elasticsearch
elasticsearch

我们依然在resources文件中做如下配置(注意restful API中使用的是9200端口,而Java API使用的是9300端口)

elasticsearch:
clusterName: aubin-cluster
clusterNodes: 192.168.5.182:9300
配置类如下

@Getter
@Setter
@Configuration
@ConfigurationProperties(prefix = "elasticsearch")
public class ElasticSearchConfig {

private String clusterName;

private String clusterNodes;

/**
 * 使用elasticsearch实现类时才触发
 *
 * @return
 */

@Bean
public TransportClient transportClient() {

  // 设置集群名字
  Settings settings = Settings.builder().put("cluster.name", this.clusterName).build();
  TransportClient client = new PreBuiltTransportClient(settings);
  try {
     // 读取的ip列表是以逗号分隔的
     for (String clusterNode : this.clusterNodes.split(",")) {
        String ip = clusterNode.split(":")[0];
        String port = clusterNode.split(":")[1];
        client.addTransportAddress(new InetSocketTransportAddress(InetAddress.getByName(ip), Integer.parseInt(port)));
     }
  } catch (UnknownHostException e) {
     e.printStackTrace();
  }

  return client;

}
}
在5.2.1中使用的是InetSocketTransportAddress,这是一个具体的类,而在高版本中此处为TransportAddress,这是一个接口.

我们做一个数据类

@Component
public class DataEs {

@Autowired
private TransportClient transportClient;

/**
 * 添加原始数据
 * @throws IOException
 */
@PostConstruct
private void init() throws IOException {
    transportClient.prepareIndex("company","employee","1").setSource(XContentFactory.jsonBuilder().startObject()
            .field("name","jack")
            .field("age",27)
            .field("position","technique software")
            .field("country","China")
            .field("join_date","2018-01-01")
            .field("salary",10000)
            .endObject()).get();
    transportClient.prepareIndex("company","employee","2").setSource(XContentFactory.jsonBuilder().startObject()
            .field("name","marry")
            .field("age",35)
            .field("position","technique manager")
            .field("country","China")
            .field("join_date","2018-01-01")
            .field("salary",12000)
            .endObject()).get();
    transportClient.prepareIndex("company","employee","3").setSource(XContentFactory.jsonBuilder().startObject()
            .field("name","tom")
            .field("age",32)
            .field("position","senior technique software")
            .field("country","China")
            .field("join_date","2017-01-01")
            .field("salary",11000)
            .endObject()).get();
    transportClient.prepareIndex("company","employee","4").setSource(XContentFactory.jsonBuilder().startObject()
            .field("name","jen")
            .field("age",25)
            .field("position","junior finance")
            .field("country","USA")
            .field("join_date","2017-01-01")
            .field("salary",7000)
            .endObject()).get();
    transportClient.prepareIndex("company","employee","5").setSource(XContentFactory.jsonBuilder().startObject()
            .field("name","mike")
            .field("age",37)
            .field("position","finance manager")
            .field("country","USA")
            .field("join_date","2016-01-01")
            .field("salary",15000)
            .endObject()).get();
}

/**
 * 员工搜索应用程序
 * 搜索职位中包含technique的员工
 * 同时要求age在30到40岁之间
 * 分页查询,查找第一页
 */
public void executeSearch() {
    SearchResponse searchResponse = transportClient.prepareSearch("company")
            .setTypes("employee")
            .setQuery(QueryBuilders.matchQuery("position", "technique"))
            .setPostFilter(QueryBuilders.rangeQuery("age").from(30).to(40))
            .setFrom(0).setSize(1)
            .get();
    SearchHit[] hits = searchResponse.getHits().getHits();
    for (int i = 0;i < hits.length;i++) {
        System.out.println(hits[i].getSourceAsString());
    }
}

/**
 * 员工聚合分析应用程序
 * 首先按照country国家来进行分组
 * 然后在每个country分组内,再按照入职年限进行分组
 * 最后计算每个分组内的平均薪资
 */
public void executeAggregation() {
    SearchResponse searchResponse = transportClient.prepareSearch("company")
            .addAggregation(AggregationBuilders.terms("group_by_country").field("country")
            .subAggregation(AggregationBuilders.dateHistogram("group_by_join_date")
            .field("join_date").dateHistogramInterval(DateHistogramInterval.YEAR)
            .subAggregation(AggregationBuilders.avg("avg_salary").field("salary"))))
            .execute().actionGet();
    Map<String,Aggregation> aggrMap = searchResponse.getAggregations().asMap();
    StringTerms groupByCountry = (StringTerms) aggrMap.get("group_by_country");
    Iterator<StringTerms.Bucket> groupByCountryBucketIterator = groupByCountry.getBuckets().iterator();
    while (groupByCountryBucketIterator.hasNext()) {
        StringTerms.Bucket groupByCountryBucket = groupByCountryBucketIterator.next();
        System.out.println(groupByCountryBucket.getKey() + ":" + groupByCountryBucket.getDocCount());
        Histogram groupByJoinDate = (Histogram) groupByCountryBucket.getAggregations().asMap().get("group_by_join_date");
        Iterator<? extends Histogram.Bucket> groupByJoinDateIterator = groupByJoinDate.getBuckets().iterator();
        while (groupByJoinDateIterator.hasNext()) {
            Histogram.Bucket groupByJoinDateBucket = groupByJoinDateIterator.next();
            System.out.println(groupByJoinDateBucket.getKey() + ":" + groupByJoinDateBucket.getDocCount());
            Avg avg = (Avg) groupByJoinDateBucket.getAggregations().asMap().get("avg_salary");
            System.out.println(avg.getValue());
        }
    }
}
public void close() {
    transportClient.close();
}

}
在主程序中调用如下(一般我们可以先不执行搜索操作,先注入数据,因为elasticsearch本身有一个秒级写读的问题,如果数据写入,得需要1秒的时间才能读取出来)

@SpringBootApplication
public class EsApplication {
public static void main(String[] args) {

  ApplicationContext applicationContext = SpringApplication.run(EsApplication.class, args);
  DataEs dataEs = (DataEs) applicationContext.getBean(DataEs.class);
  dataEs.executeSearch();
  dataEs.executeAggregation();
  dataEs.close();

}
}

相关实践学习
使用阿里云Elasticsearch体验信息检索加速
通过创建登录阿里云Elasticsearch集群,使用DataWorks将MySQL数据同步至Elasticsearch,体验多条件检索效果,简单展示数据同步和信息检索加速的过程和操作。
ElasticSearch 入门精讲
ElasticSearch是一个开源的、基于Lucene的、分布式、高扩展、高实时的搜索与数据分析引擎。根据DB-Engines的排名显示,Elasticsearch是最受欢迎的企业搜索引擎,其次是Apache Solr(也是基于Lucene)。 ElasticSearch的实现原理主要分为以下几个步骤: 用户将数据提交到Elastic Search 数据库中 通过分词控制器去将对应的语句分词,将其权重和分词结果一并存入数据 当用户搜索数据时候,再根据权重将结果排名、打分 将返回结果呈现给用户 Elasticsearch可以用于搜索各种文档。它提供可扩展的搜索,具有接近实时的搜索,并支持多租户。
相关文章
|
2天前
|
存储 API 数据库
深入浅出后端开发:从零到一搭建RESTful API
在数字化的浪潮中,后端开发如同一座桥梁,连接着用户界面与数据存储。本文将引导你理解后端开发的核心概念,并通过实践案例,展示如何从零开始构建一个RESTful API。我们将探索设计原则、选择合适的编程语言和框架、数据库交互以及API测试等方面。无论你是初学者还是希望巩固知识的开发者,这篇文章都将为你提供一条清晰的学习路径。
|
4天前
|
存储 JSON JavaScript
探索后端开发:从零构建简易RESTful API
【9月更文挑战第35天】在数字时代的浪潮中,了解如何搭建一个后端服务变得至关重要。本文将通过构建一个简易的RESTful API来揭开后端开发的神秘面纱。我们将使用Node.js和Express框架,逐步引导你理解并实践API的设计、实现与测试过程。无论你是编程新手还是希望扩展技能边界的开发者,这篇文章都将为你提供一次深入浅出的学习旅程。
|
8天前
|
XML JSON API
深入浅出:RESTful API 设计实践与最佳应用
【9月更文挑战第32天】 在数字化时代的浪潮中,RESTful API已成为现代Web服务通信的黄金标准。本文将带您一探究竟,了解如何高效地设计和维护一个清晰、灵活且易于扩展的RESTful API。我们将从基础概念出发,逐步深入到设计原则和最佳实践,最终通过具体案例来展示如何将理论应用于实际开发中。无论您是初学者还是有经验的开发者,这篇文章都将为您提供宝贵的指导和灵感。
|
4天前
|
安全 API UED
探索RESTful API设计之道
【9月更文挑战第36天】在数字化浪潮中,后端开发扮演着枢纽角色。本文将通过实战案例,揭示如何构建高效、易于维护的RESTful API,同时分享代码示例和设计最佳实践,旨在为开发者提供一套完整的解决方案,助其在API设计之路上乘风破浪。
|
7天前
|
API 开发者 UED
构建高效RESTful API的最佳实践
【9月更文挑战第33天】在数字化时代,后端开发不仅仅是关于代码的编写。它是一场架构艺术的演绎,是性能与可维护性之间的舞蹈。本文将带你深入理解RESTful API设计的精髓,探索如何通过最佳实践提升API的效率和可用性,最终实现后端服务的优雅蜕变。我们将从基础原则出发,逐步揭示高效API设计背后的哲学,并以实际代码示例为路标,指引你走向更优的后端开发之路。
|
13天前
|
JSON Go API
使用Go语言和Gin框架构建RESTful API:GET与POST请求示例
使用Go语言和Gin框架构建RESTful API:GET与POST请求示例
|
13天前
|
安全 Java API
时间日期API(Date,SimpleDateFormat,Calendar)+java8新增日期API (LocalTime,LocalDate,LocalDateTime)
这篇文章介绍了Java中处理日期和时间的API,包括旧的日期API(Date、SimpleDateFormat、Calendar)和Java 8引入的新日期API(LocalTime、LocalDate、LocalDateTime)。文章详细解释了这些类/接口的方法和用途,并通过代码示例展示了如何使用它们。此外,还讨论了新旧API的区别,新API的不可变性和线程安全性,以及它们提供的操作日期时间的灵活性和简洁性。
|
14天前
|
缓存 监控 测试技术
深入理解RESTful API设计原则与最佳实践
【9月更文挑战第26天】在数字化时代,API(应用程序编程接口)已成为连接不同软件和服务的桥梁。本文将深入浅出地介绍RESTful API的设计哲学、六大约束条件以及如何将这些原则应用到实际开发中,以实现高效、可维护和易于扩展的后端服务。通过具体实例,我们将探索如何避免常见设计陷阱,确保API设计的优雅与实用性并存。无论你是API设计的新手还是经验丰富的开发者,这篇文章都将为你提供宝贵的指导和启示。
|
16天前
|
Java 程序员 API
Java 8新特性之Lambda表达式与Stream API的探索
【9月更文挑战第24天】本文将深入浅出地介绍Java 8中的重要新特性——Lambda表达式和Stream API,通过实例解析其语法、用法及背后的设计哲学。我们将一探究竟,看看这些新特性如何让Java代码变得更加简洁、易读且富有表现力,同时提升程序的性能和开发效率。
|
15天前
|
缓存 前端开发 API
深入浅出:RESTful API设计的最佳实践
【9月更文挑战第24天】在数字化浪潮中,API作为连接不同软件组件的桥梁,其设计质量直接影响到系统的可维护性、扩展性及用户体验。本文将通过浅显易懂的语言,结合生动的比喻和实例,带领读者深入理解RESTful API设计的核心原则与最佳实践,旨在帮助开发者构建更加健壮、灵活且用户友好的后端服务。