elastic

elastic 是一个高效的、模块化的 Elasticsearch API 客户端，用 Rust 编写。该 API 面向 Elastic Stack 7.x。

elastic 提供强类型文档和弱类型查询。

快速参考

• 简单示例
• 示例应用

还可以查看官方的 elasticsearch crate！

稳定性

此 crate 仍然相当不稳定，预计在不久的将来将继续发布破坏性版本，变更日志不够详细。

如果您在自己的开源项目中遇到升级问题，请随时 提交问题，我们将提供帮助。我们的目标是最终提供稳定的 API。

构建状态

平台	频道	状态 (master)
Linux / macOS	稳定/夜间
Windows	夜间

文档

版本	文档
当前 (master)

示例

将 elastic 添加到您的 Cargo.toml

[dependencies]
elastic = "0.21.0-pre.5"
elastic_derive = "0.21.0-pre.5"
serde_json = "1"

创建一个 SyncClient 并开始发送请求

#[macro_use]
extern crate elastic_derive;
#[macro_use]
extern crate serde_json;
extern crate elastic;

use serde_json::Value;
use elastic::prelude::*;

// A reqwest HTTP client and default parameters.
// The builder includes the base node url (https://127.0.0.1:9200).
let client = SyncClient::builder().build()?;

let query = "some query string";

// A search request with a freeform body.
let res = client.search::<Value>()
                .index("_all")
                .body(json!({
                    "query": {
                        "query_string": {
                            "query": query
                        }
                    }
                }))
                .send()?;

// Iterate through the hits in the response.
for hit in res.hits() {
    println!("{:?}", hit);
}

elastic 还提供用于与 tokio 异步 IO 栈一起使用的 AsyncClient。请参阅 示例 文件夹以获取完整示例。

#[derive(ElasticType, Serialize, Deserialize)]
struct MyDocument {
	#[elastic(id)]
	pub id: String,
	pub title: String,
	pub timestamp: Date<DefaultDateMapping<EpochMillis>>,
	pub content: Text<DefaultTextMapping>,
}