elasticsearch client接口详解.docx

elasticsearch java api——客户端 org.elasticsearch.client org.elasticsearch.client.AdminClient接口AdminClient下有两个方法：1) cluster()，产生一个允许从集群中执行action或操作的client；2) indices()，产生一个允许从索引中执行action或操作的client。AdminClient接口有两个实现类，分别为 org.elasticsearch.client.AdminClient.NodeAdminClient和 org.elasticsearch.client.transport.support.InternalTransportAdminClient。1.1 org.elasticsearch.client.AdminClient.NodeAdminClient类NodeAdminClient有一个带有@Inject注解的构造器，并实现了接口AdminClient的两个方法，如下所示：[java]?view plaincopy@Inject??public?NodeAdminClient(Settings?settings,?NodeClusterAdminClient?clusterAdminClient,?NodeIndicesAdminClient?indicesAdminClient)?{??????super(settings);??????this.indicesAdminClient?=?indicesAdminClient;??????this.clusterAdminClient?=?clusterAdminClient;??}????@Override??public?IndicesAdminClient?indices()?{??????return?indicesAdminClient;??}????@Override??public?ClusterAdminClient?cluster()?{??????return?this.clusterAdminClient;??}??@Inject导致了一个直接的后果：你只能通过被@Inject标注的构造器生成实例。indices()和cluster()覆盖了AdminClient的同名方法，分别返回NodeIndicesAdminClient和NodeClusterAdminClient对象。NodeAdminClient会继承父类ponent.AbstractComponent的nodeName()方法用以获取当前节点的名称。1.2 org.elasticsearch.client.transport.support.InternalTransportAdminClient类InternalTransportAdminClient其实与NodeAdminClient类似，只是它的indices()和cluster() 分别返回的是InternalTransportIndicesAdminClient和 InternalTransportClusterAdminClient。NodeAdminClient和InternalTransportAdminClient均没有子类，所以只有当我们需要用到 NodeIndicesAdminClient、NodeClusterAdminClient、 InternalTransportIndicesAdminClient或InternalTransportClusterAdminClient 时，才考虑创建这两个类的实体。2 org.elasticsearch.client.Client接口Client为从集群中执行action或operation提供了一站式接口，这里的所有操作都是自然而然地异步执行的，每个action或 operation都有两种风格，一种是简单地返回一个org.elasticsearch.action.ActionFuture，另一种是访问一个 org.elasticsearch.action.ActionListener。你可以在org.elasticsearch.node.Node启动时取得一个Client，也可以使用org.elasticsearch.client.transport.TransportClient远程连接一个或多个节点。Client有以下方法：1) close()，关闭客户端；2) admin()，返回一个可以执行管理性操作的客户端；3) 两个execute，用于执行一般性操作，这里的一般性与上文提到的管理性相对；4) prepareExecute，