10_Searchkit一个优雅的搜索界面

内容简介:ES搜索服务搭建好,怎么再配一个界面呢?一个技术有时候不太好形容,那就剩下优雅这个词了,今天我们聊聊怎么使用React框架,构建一个ES的搜索界面,对看着要高大上点呦!那用什么工具呢?今天我们就介绍一个Github上面,3800颗星的searchkit项目,为啥选它?嘿嘿,你猜呢...

美国USGS对全球地震事件后的信息服务叫Eventpage,通过eventpage可以查找到每一个地震的各种参数信息,包括可能诱发的各种灾害风险,为美国政府灾后响应和决策提供了重要科技支撑(如图1)。

图1 USGS的Eventpage

那么,我们本套教材讨论了这么多的技术,前面还介绍了怎么把目录数据放到ES库里面,前端除了可视化,是否能实现类似Eventpage这种检索界面?是否能手动搭建一个类似的目录搜索服务呢?

如果你也有这个想法,但不知道技术上怎么实现,别急往下看。

1、连接ES

SearchKit作为ES数据库的前端界面技术,基于React设计,提供给用户常用的搜索界面。关于该库的详细信息可参考:https://github.com/searchkit

在配置好Node环境后,通过以下代码可以测试是否连接ES成功

const host = "http://10.2.14.251:9200/ispec/"
const searchkit = new SearchkitManager(host, {
    httpHeaders:{'Content-Type': 'application/json', 'Authorization':'Basic ' + btoa('elastic:******')},
    basicAuth:"elastic:******",
    withCredentials: 'True'
})

2、定制React代码

React 使创建交互式 UI 变得轻而易举。为你应用的每一个状态设计简洁的视图,当数据改变时 React 能有效地更新并正确地渲染组件。React是基于Javascript,以声明式编写 UI,可以让你的代码更加可靠,且方便调试。Searchkit的搜索界面效果如图2所示。

图2 一个典型的Searchkit检索界面效果

关于怎么安装React环境,可以查看本系列专辑“12_SandDance沙之舞”中的介绍。下面是一个完整的React代码,使用了Searchkit库的基本UI组建,包括:SearchBox、SearchkitManager、SearchkitProvider等。详细代码如下:

import React, { Component } from 'react'
import { get } from "lodash";
import extend from 'lodash/extend'
import {
  SearchBox,
  SearchkitManager,
  SearchkitProvider,
  Layout, TopBar, LayoutBody, LayoutResults,
  Hits, NoHits, HitsStats
} from "searchkit"
  
import './index.css'

const host = "http://10.2.14.251:9200/ispec/"

const searchkit = new SearchkitManager(host, {
    httpHeaders:{'Content-Type': 'application/json', 'Authorization':'Basic ' + btoa('elastic:*****')},
    basicAuth:"elastic:*****",
    withCredentials: 'True'
})

const HitItem = (props) => (
  <div className={props.bemBlocks.item().mix(props.bemBlocks.container("item"))}>
    <div className={props.bemBlocks.item("name")} dangerouslySetInnerHTML={{__html: get(props.result,"highlight.name",props.result._source.name)}}></div>
    <div className={props.bemBlocks.item("data")} dangerouslySetInnerHTML={{__html: get(props.result,"highlight.data",props.result._source.data)}}></div>   
  </div>
)   
   
class App extends Component {
  render(){
      return (
    <SearchkitProvider searchkit={searchkit}>
        <Layout>
          <TopBar>
            <div className="my-logo">中国地震信息库-ISPECv1.0</div>
            
            <SearchBox autofocus={true} 
            searchOnChange={true} 
            queryOptions={{analyzer:"standard"}}
            queryFields={["name"]}
            prefixQueryFields={["name"]}/>
          </TopBar>
          <LayoutBody>
          <LayoutResults>
          <Hits hitsPerPage={10} highlightFields={["name"]} sourceFilter={["name", "data"]} 
          mod="sk-hits-grid" itemComponent={HitItem}/>
          <NoHits/>       
          </LayoutResults>
          
          </LayoutBody>
         </Layout> 
    </SearchkitProvider>    
    )
  }
}

export default App;

3、常见问题

在调试Searchkit代码时,根据http返回的错误代码,可以大概判断问题来源,根据我们调试过程中遇到的问题,总结如下:

跨域的CORS问题

什么是跨域问题?跨域资源共享(CORS即Cross Origin Resource Sharing)机制允许Web服务器进行跨域访问控制,从而可以安全地进行跨域访问,览器支持在 API 容器中使用 CORS,以降低跨域 HTTP 请求所带来的风险。

在React搜索界面前端部署与ES服务不在一个域中的时候,会出现访问错误,因为ES默认不允许跨域访问(主要是安全考虑)。

如果出现该类问题,需要通过修改elasticsearch配置文件中http.cors.x字段

http.cors.enabled   是否支持跨域,默认为false
http.cors.allow-origin  当设置允许跨域,默认为*,表示支持所有域名,如果我们只是允许某些网站能访问,那么可以使用正则表达式。比如只允许本地地址。 /https?:\/\/localhost(:[0-9]+)?/
http.cors.max-age   浏览器发送一个“预检”OPTIONS请求,以确定CORS设置。最大年龄定义多久的结果应该缓存。默认为1728000(20天)
http.cors.allow-methods 允许跨域的请求方式,默认OPTIONS,HEAD,GET,POST,PUT,DELETE
http.cors.allow-headers 跨域允许设置的头信息,默认为X-Requested-With,Content-Type,Content-Length
http.cors.allow-credentials 是否返回设置的跨域Access-Control-Allow-Credentials头,如果设置为true,那么会返回给客户端。

最新的ES7.4.已经在免费授权中包含了x-pack功能*

当你不期望ES为非授权用户提供服务时,可以开启x-pack的基本认证。

方法时先找到/etc/elasticsearch/目录下修改elasticsearch.yml文件,找到下面的部分进行配置:

xpack.security.enabled: true
xpack.license.self_generated.type: basic
# 如果是basic license的话需要加入下面这一行,不然的话restart elasticsearch之后会报错。
xpack.security.transport.ssl.enabled: true

ES启动后,因为是后台服务,有时候可能不知道如何关闭和重启。方法如下:

Centos可以采用以下命令重启ES

systemctl start elasticsearch #启动
systemctl restart elasticsearch #重启
systemctl status elasticsearch #查看状态

ps:如果是系统内的盆友们,小哥已经把上面的简陋结果放到网上啦,直接戳这里瞧瞧http://10.2.14.70:8081/

一句话总结:SearchKit是比较优秀的ES界面库,但默认只支持单库检索,如果要进行跨库的检索或搜索,需要使用SearchKit Express来配置完成。最后想说的是:技术积累需要一步步来,不过最重要的是选对方向,小哥在技术调研和选型过程中,首先考虑的是社区活跃程度,技术成熟度和学习难度,综合评价后才会在这里给大家推荐。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,335评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,895评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,766评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,918评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,042评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,169评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,219评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,976评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,393评论 1 304
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,711评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,876评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,562评论 4 336
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,193评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,903评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,142评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,699评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,764评论 2 351

推荐阅读更多精彩内容