SSM(二)Lucene全文检索_analyzer

前言

大家平时肯定都有用过全文检索工具,最常用的百度谷歌就是其中的典型。如果自己能够做一个那是不是想想就逼格满满呢。Apache就为我们提供了这样一个框架,以下就是在实际开发中加入Lucene的一个小Demo。


获取Maven依赖

首先看一下实际运行的效果图:

SSM(二)Lucene全文检索_analyzer_02

SSM(二)Lucene全文检索_lucene_03

这个项目是基于之前使用IDEA搭建的SSM的基础上进行增加的,建议小白先看下一我。上一篇博客,以及共享在Github上的源码。 以下是Lucene所需要的依赖:

  1. <!--加入lucene-->
  2.        <!-- https://mvnrepository.com/artifact/org.apache.lucene/lucene-core -->
  3.        <dependency>
  4.            <groupId>org.apache.lucene</groupId>
  5.            <artifactId>lucene-core</artifactId>
  6.            <version>${lucene.version}</version>
  7.        </dependency>
  8.        <!-- https://mvnrepository.com/artifact/org.apache.lucene/lucene-queryparser -->
  9.        <dependency>
  10.            <groupId>org.apache.lucene</groupId>
  11.            <artifactId>lucene-queryparser</artifactId>
  12.            <version>${lucene.version}</version>
  13.        </dependency>
  14.        <!-- https://mvnrepository.com/artifact/org.apache.lucene/lucene-analyzers-common -->
  15.        <dependency>
  16.            <groupId>org.apache.lucene</groupId>
  17.            <artifactId>lucene-analyzers-common</artifactId>
  18.            <version>${lucene.version}</version>
  19.        </dependency>

  20.        <!--lucene中文分词-->
  21.        <!-- https://mvnrepository.com/artifact/org.apache.lucene/lucene-analyzers-smartcn -->
  22.        <dependency>
  23.            <groupId>org.apache.lucene</groupId>
  24.            <artifactId>lucene-analyzers-smartcn</artifactId>
  25.            <version>${lucene.version}</version>
  26.        </dependency>

  27.        <!--lucene高亮-->
  28.        <!-- https://mvnrepository.com/artifact/org.apache.lucene/lucene-highlighter -->
  29.        <dependency>
  30.            <groupId>org.apache.lucene</groupId>
  31.            <artifactId>lucene-highlighter</artifactId>
  32.            <version>${lucene.version}</version>
  33.        </dependency>

具体的用途我都写有注释。

在IDEA中修改了Pom.xml文件之后只需要点击如图所示的按钮即可重新获取依赖:

SSM(二)Lucene全文检索_analyzer_04


编写Lucene工具类

这个工具类中的具体代码我就不单独提出来说了,每个关键的地方我都写有注释,不清楚的再讨论。



  1. /**
  2. * 博客索引类
  3. * @author Administrator
  4. *
  5. */
  6. public class LuceneIndex {

  7.    private Directory dir=null;


  8.    /**
  9.     * 获取IndexWriter实例
  10.     * @return
  11.     * @throws Exception
  12.     */
  13.    private IndexWriter getWriter()throws Exception{
  14.        /**
  15.         * 生成的索引我放在了C盘,可以根据自己的需要放在具体位置
  16.         */
  17.        dir= FSDirectory.open(Paths.get("C://lucene"));
  18.        SmartChineseAnalyzer analyzer=new SmartChineseAnalyzer();
  19.        IndexWriterConfig iwc=new IndexWriterConfig(analyzer);
  20.        IndexWriter writer=new IndexWriter(dir, iwc);
  21.        return writer;
  22.    }

  23.    /**
  24.     * 添加博客索引
  25.     * @param user
  26.     */
  27.    public void addIndex(User user)throws Exception{
  28.        IndexWriter writer=getWriter();
  29.        Document doc=new Document();
  30.        doc.add(new StringField("id",String.valueOf(user.getUserId()), Field.Store.YES));
  31.        /**
  32.         * yes是会将数据存进索引,如果查询结果中需要将记录显示出来就要存进去,如果查询结果
  33.         * 只是显示标题之类的就可以不用存,而且内容过长不建议存进去
  34.         * 使用TextField类是可以用于查询的。
  35.         */
  36.        doc.add(new TextField("username", user.getUsername(), Field.Store.YES));
  37.        doc.add(new TextField("description",user.getDescription(), Field.Store.YES));
  38.        writer.addDocument(doc);
  39.        writer.close();
  40.    }

  41.    /**
  42.     * 更新博客索引
  43.     * @param user
  44.     * @throws Exception
  45.     */
  46.    public void updateIndex(User user)throws Exception{
  47.        IndexWriter writer=getWriter();
  48.        Document doc=new Document();
  49.        doc.add(new StringField("id",String.valueOf(user.getUserId()), Field.Store.YES));
  50.        doc.add(new TextField("username", user.getUsername(), Field.Store.YES));
  51.        doc.add(new TextField("description",user.getDescription(), Field.Store.YES));
  52.        writer.updateDocument(new Term("id", String.valueOf(user.getUserId())), doc);
  53.        writer.close();
  54.    }

  55.    /**
  56.     * 删除指定博客的索引
  57.     * @param userId
  58.     * @throws Exception
  59.     */
  60.    public void deleteIndex(String userId)throws Exception{
  61.        IndexWriter writer=getWriter();
  62.        writer.deleteDocuments(new Term("id", userId));
  63.        writer.forceMergeDeletes(); // 强制删除
  64.        writer.commit();
  65.        writer.close();
  66.    }

  67.    /**
  68.     * 查询用户
  69.     * @param q 查询关键字
  70.     * @return
  71.     * @throws Exception
  72.     */
  73.    public List<User> searchBlog(String q)throws Exception{
  74.        /**
  75.         * 注意的是查询索引的位置得是存放索引的位置,不然会找不到。
  76.         */
  77.        dir= FSDirectory.open(Paths.get("C://lucene"));
  78.        IndexReader reader = DirectoryReader.open(dir);
  79.        IndexSearcher is=new IndexSearcher(reader);
  80.        BooleanQuery.Builder booleanQuery = new BooleanQuery.Builder();
  81.        SmartChineseAnalyzer analyzer=new SmartChineseAnalyzer();
  82.        /**
  83.         * username和description就是我们需要进行查找的两个字段
  84.         * 同时在存放索引的时候要使用TextField类进行存放。
  85.         */
  86.        QueryParser parser=new QueryParser("username",analyzer);
  87.        Query query=parser.parse(q);
  88.        QueryParser parser2=new QueryParser("description",analyzer);
  89.        Query query2=parser2.parse(q);
  90.        booleanQuery.add(query, BooleanClause.Occur.SHOULD);
  91.        booleanQuery.add(query2, BooleanClause.Occur.SHOULD);
  92.        TopDocs hits=is.search(booleanQuery.build(), 100);
  93.        QueryScorer scorer=new QueryScorer(query);
  94.        Fragmenter fragmenter = new SimpleSpanFragmenter(scorer);
  95.        /**
  96.         * 这里可以根据自己的需要来自定义查找关键字高亮时的样式。
  97.         */
  98.        SimpleHTMLFormatter simpleHTMLFormatter=new SimpleHTMLFormatter("<b><font color='red'>","</font></b>");
  99.        Highlighter highlighter=new Highlighter(simpleHTMLFormatter, scorer);
  100.        highlighter.setTextFragmenter(fragmenter);
  101.        List<User> userList=new LinkedList<User>();
  102.        for(ScoreDoc scoreDoc:hits.scoreDocs){
  103.            Document doc=is.doc(scoreDoc.doc);
  104.            User user=new User();
  105.            user.setUserId(Integer.parseInt(doc.get(("id"))));
  106.            user.setDescription(doc.get(("description")));
  107.            String username=doc.get("username");
  108.            String description=doc.get("description");
  109.            if(username!=null){
  110.                TokenStream tokenStream = analyzer.tokenStream("username", new StringReader(username));
  111.                String husername=highlighter.getBestFragment(tokenStream, username);
  112.                if(StringUtil.isEmpty(husername)){
  113.                    user.setUsername(username);
  114.                }else{
  115.                    user.setUsername(husername);
  116.                }
  117.            }
  118.            if(description!=null){
  119.                TokenStream tokenStream = analyzer.tokenStream("description", new StringReader(description));
  120.                String hContent=highlighter.getBestFragment(tokenStream, description);
  121.                if(StringUtil.isEmpty(hContent)){
  122.                    if(description.length()<=200){
  123.                        user.setDescription(description);
  124.                    }else{
  125.                        user.setDescription(description.substring(0, 200));
  126.                    }
  127.                }else{
  128.                    user.setDescription(hContent);
  129.                }
  130.            }
  131.            userList.add(user);
  132.        }
  133.        return userList;
  134.    }
  135. }

查询Controller的编写

接下来是查询Controller:

  1.    @RequestMapping("/q")
  2.    public String search(@RequestParam(value = "q", required = false,defaultValue = "") String q,
  3.                         @RequestParam(value = "page", required = false, defaultValue = "1") String page,
  4.                         Model model,
  5.                         HttpServletRequest request) throws Exception {
  6.        LuceneIndex luceneIndex = new LuceneIndex() ;
  7.        List<User> userList = luceneIndex.searchBlog(q);
  8.        /**
  9.         * 关于查询之后的分页我采用的是每次分页发起的请求都是将所有的数据查询出来,
  10.         * 具体是第几页再截取对应页数的数据,典型的拿空间换时间的做法,如果各位有什么
  11.         * 高招欢迎受教。
  12.         */
  13.        Integer toIndex = userList.size() >= Integer.parseInt(page) * 5 ? Integer.parseInt(page) * 5 : userList.size();
  14.        List<User> newList = userList.subList((Integer.parseInt(page) - 1) * 5, toIndex);
  15.        model.addAttribute("userList",newList) ;
  16.        String s = this.genUpAndDownPageCode(Integer.parseInt(page), userList.size(), q, 5, request.getServletContext().
  17.                getContextPath());
  18.        model.addAttribute("pageHtml",s) ;
  19.        model.addAttribute("q",q) ;
  20.        model.addAttribute("resultTotal",userList.size()) ;
  21.        model.addAttribute("pageTitle","搜索关键字'" + q + "'结果页面") ;

  22.        return "queryResult";
  23.    }

其中有用到一个 ​genUpAndDownPageCode()​方法来生成分页的Html代码,如下:

  1.    /**
  2.     * 查询之后的分页
  3.     * @param page
  4.     * @param totalNum
  5.     * @param q
  6.     * @param pageSize
  7.     * @param projectContext
  8.     * @return
  9.     */
  10.    private String genUpAndDownPageCode(int page,Integer totalNum,String q,Integer pageSize,String projectContext){
  11.        long totalPage=totalNum%pageSize==0?totalNum/pageSize:totalNum/pageSize+1;
  12.        StringBuffer pageCode=new StringBuffer();
  13.        if(totalPage==0){
  14.            return "";
  15.        }else{
  16.            pageCode.append("<nav>");
  17.            pageCode.append("<ul class='pager' >");
  18.            if(page>1){
  19.                pageCode.append("<li><a href='"+projectContext+"/q?page="+(page-1)+"&q="+q+"'>上一页</a></li>");
  20.            }else{
  21.                pageCode.append("<li class='disabled'><a href='#'>上一页</a></li>");
  22.            }
  23.            if(page<totalPage){
  24.                pageCode.append("<li><a href='"+projectContext+"/q?page="+(page+1)+"&q="+q+"'>下一页</a></li>");
  25.            }else{
  26.                pageCode.append("<li class='disabled'><a href='#'>下一页</a></li>");
  27.            }
  28.            pageCode.append("</ul>");
  29.            pageCode.append("</nav>");
  30.        }
  31.        return pageCode.toString();
  32.    }

代码比较简单,就是根据的页数、总页数来生成分页代码,对了我前端采用的是现在流行的Bootstrap,这个有不会的可以去他官网看看,比较简单易上手。接下来只需要编写显示界面就大功告成了。

SSM(二)Lucene全文检索_lucene_05


显示界面

我只贴关键代码,具体的可以去Github上查看。

  1. <c:choose>
  2.                    <c:when test="${userList.size()==0 }">
  3.                        <div align="center" style="padding-top: 20px"><font color="red">${q}</font>未查询到结果,请换个关键字试试!</div>
  4.                    </c:when>
  5.                    <c:otherwise>
  6.                        <div align="center" style="padding-top: 20px">
  7.                            查询<font color="red">${q}</font>关键字,约${resultTotal}条记录!
  8.                        </div>
  9.                        <c:forEach var="u" items="${userList }" varStatus="status">
  10.                            <div class="panel-heading ">

  11.                                <div class="row">
  12.                                    <div class="col-md-6">
  13.                                        <div class="row">
  14.                                            <div class="col-md-12">
  15.                                                <b>
  16.                                                    <a href="<%=path %>/user/showUser/${u.userId}">${u.username}</a>
  17.                                                </b>
  18.                                                <br/>
  19.                                                    ${u.description}
  20.                                            </div>
  21.                                        </div>
  22.                                    </div>
  23.                                    <div class="col-md-4 col-md-offset-2">
  24.                                        <p class="text-muted text-right">
  25.                                                ${u.password}
  26.                                        </p>
  27.                                    </div>
  28.                                </div>
  29.                            </div>
  30.                            <div class="panel-footer">
  31.                                <p class="text-right">
  32.                            <span class="label label-default">
  33.                            <span class="glyphicon glyphicon-comment" aria-hidden="true"></span>
  34.                             ${u.password}
  35.                            </span>
  36.                                </p>
  37.                            </div>
  38.                        </c:forEach>
  39.                    </c:otherwise>
  40.                </c:choose>

利用 ​JSTL​标签即可将数据循环展示出来,关键字就不需要单独做处理了,在后台查询的时候已经做了修改了。


总结

关于全文检索的框架不止 ​Lucene​​还有 ​solr​​,具体谁好有什么区别我也不太清楚,准备下来花点时间研究下。哦对了,最近又有点想做 ​Android​开发了,感觉做点东西能够实实在在的摸得到逼格确实要高些(现在主要在做后端开发),感兴趣的朋友可以关注下。哦对了,直接运行我代码的朋友要下注意:

  • 首先要将数据库倒到自己的MySQL上

    SSM(二)Lucene全文检索_lucene_06

  • 之后在首次运行的时候需要点击SSM(二)Lucene全文检索_lucene_07重新生成索引按钮生成一遍索引之后才能进行搜索,因为现在的数据是直接存到数据库中的,并没有在新增的时候就增加索引,在实际开发的时候需要在新增数据那里再生成一份索引,就直接调用 ​​LuceneIndex​​类中的 ​​addIndex​​方法传入实体即可,再做更新、删除操作的时候也同样需要对索引做操作。