快捷導(dǎo)航

elasticsearch插件開(kāi)發(fā)教程

更新時(shí)間：2017年06月28日 15:32:29 作者：wzjhoutai

這篇文章主要為大家詳細(xì)介紹了elasticsearch插件開(kāi)發(fā)教程，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下

檢索引擎Elasticsearch支持插件模式。有些時(shí)候你可能須要安裝一些插件。甚至自己開(kāi)發(fā)插件，這里就提供一個(gè)開(kāi)始ES插件開(kāi)發(fā)演示樣例，ES版本號(hào)為1.5.2。

一、插件類(lèi)繼承自org.elasticsearch.plugins.AbstractPlugin

package org.elasticsearch.plugin.helloworld;

import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;

import org.elasticsearch.common.component.LifecycleComponent;
import org.elasticsearch.common.inject.Module;
import org.elasticsearch.common.logging.ESLogger;
import org.elasticsearch.common.logging.Loggers;
import org.elasticsearch.common.settings.Settings;
import org.elasticsearch.plugins.AbstractPlugin;
import org.elasticsearch.rest.RestModule;

public class HelloWorldPlugin extends AbstractPlugin {
 final ESLogger logger = Loggers.getLogger(getClass());

 @Override
 public String name() {
 //插件名稱(chēng)
 return "HelloWorld";
 }

 @Override
 public String description() {
 //插件描寫(xiě)敘述
 return "Hello World Plugin";
 }
 
 //處理模塊，由于系統(tǒng)中有非常多種Module，所以須要對(duì)其類(lèi)型進(jìn)行推斷
 @Override
 public void processModule(Module module) {
 if(module instanceof RestModule) {
  ((RestModule)module).addRestAction(HelloWorldHandler.class);
 }
 
 if(module instanceof HelloModule) {
  logger.info("############## process hello module #####################");
 }
 }
 
 @Override
 public Collection<Module> modules(Settings settings) {
 //創(chuàng)建自己的模塊集合
 //假設(shè)沒(méi)有自己定義模塊，則能夠返回空
 HelloModule helloModule = new HelloModule();
 ArrayList<Module> list = new ArrayList<>();
 list.add(helloModule);
 Collections.unmodifiableList(list);
 return list;
 }
 
 @SuppressWarnings("rawtypes")
 @Override
 public Collection<Class<? extends LifecycleComponent>> services() {
 //創(chuàng)建自己的服務(wù)類(lèi)集合，服務(wù)類(lèi)須要繼承自LifecycleComponent。ES會(huì)自己主動(dòng)創(chuàng)建出服務(wù)類(lèi)實(shí)例，并調(diào)用其start方法
 //假設(shè)沒(méi)有自己定義服務(wù)類(lèi)。則能夠返回空
 Collection<Class<?
 extends LifecycleComponent>> list = new ArrayList<>();
 list.add(HelloService.class);
 return list;
 }
 
}

Module類(lèi)事實(shí)上就是定義了依賴(lài)注入規(guī)則。假設(shè)不清楚，能夠去查看Google Guice的文檔，基本上是一致的。如上例中的HelloModule：

package org.elasticsearch.plugin.helloworld;

import org.elasticsearch.common.inject.AbstractModule;
import org.elasticsearch.common.inject.Scopes;

public class HelloModule extends AbstractModule {

 @Override
 protected void configure() {
 //將InjectableService接口類(lèi)型綁定到InjectableServiceImpl實(shí)現(xiàn)類(lèi)
 //在須要注入InjectableService的地方，就會(huì)使用InjectableServiceImpl實(shí)例
 bind(InjectableService.class).to(InjectableServiceImpl.class);
 //使HelloService為單例狀態(tài)
 bind(HelloService.class).in(Scopes.SINGLETON);
 }
 
}

不同的模塊有不同的處理方式，比如樣例中對(duì)于RestModule，加入了一個(gè)Handler：

package org.elasticsearch.plugin.helloworld;

import org.elasticsearch.client.Client;
import org.elasticsearch.common.inject.Inject;
import org.elasticsearch.common.settings.Settings;
import org.elasticsearch.rest.BaseRestHandler;
import org.elasticsearch.rest.BytesRestResponse;
import org.elasticsearch.rest.RestChannel;
import org.elasticsearch.rest.RestController;
import org.elasticsearch.rest.RestRequest;
import org.elasticsearch.rest.RestStatus;
import org.elasticsearch.rest.RestRequest.Method;
import org.elasticsearch.rest.RestResponse;


public class HelloWorldHandler extends BaseRestHandler {

 //注入對(duì)象
  @Inject
  protected HelloWorldHandler(Settings settings, RestController controller, Client client) {
 super(settings, controller, client);
 //將該Handler綁定到某訪問(wèn)路徑
 controller.registerHandler(Method.GET, "/hello/", this);
 controller.registerHandler(Method.GET, "/hello/{name}", this);
 }

 //處理綁定路徑的請(qǐng)求訪問(wèn)
 @Override
 protected void handleRequest(RestRequest request, RestChannel channel, Client client) throws Exception {
 logger.debug("HelloWorldAction.handleRequest called");
 final String name = request.hasParam("name") ? request.param("name") : "world";
 
 String content = "{\"success\":true, \"message\":\"hello " +name+ "\"}";
 
 RestResponse response = new BytesRestResponse(RestStatus.OK, BytesRestResponse.TEXT_CONTENT_TYPE, content);
 channel.sendResponse(response);
 }
}

最后在類(lèi)路徑根文件夾下加入一個(gè)名為es-plugin.properties屬性文件，指定插件實(shí)現(xiàn)類(lèi)：

plugin=org.elasticsearch.plugin.helloworld.HelloWorldPlugin

二、將插件打成jar包后安裝

如果ES_HOME代表Elasticsearch安裝文件夾。在ES_HOME/plugins文件夾下創(chuàng)建一個(gè)名為HelloWorld的文件夾。該文件夾名稱(chēng)必須與插件名稱(chēng)同樣(區(qū)分大寫(xiě)和小寫(xiě)),然后將jar包拷貝至HelloWorld文件夾，又一次啟動(dòng)就可以，當(dāng)你運(yùn)行：
curl -GET localhost:9200/hello，就會(huì)返回對(duì)應(yīng)結(jié)果了。

三、為插件加入頁(yè)面

假設(shè)你想為你的插件加入訪問(wèn)頁(yè)面。則能夠在ES_HOME/plugins/HelloWorld文件夾下創(chuàng)建一個(gè)名為"_site"的文件夾，該文件夾名稱(chēng)必須為_(kāi)site，然后將對(duì)應(yīng)的html頁(yè)面放置進(jìn)_site文件夾就可以，假設(shè)放置了一個(gè)名為index.html文件，則能夠通過(guò)

localhost:9200/_plugin/HelloWorld/index.html進(jìn)行訪問(wèn)。
因?yàn)镋lasticsearch提供了jsclientAPI。所以使用html靜態(tài)頁(yè)面與js就能夠完畢對(duì)應(yīng)的功能了。

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

您可能感興趣的文章: