基于Java语言开发的一个高效的敏感词过滤工具

package com.wgh.common.utils;

import com.google.common.collect.Lists;
import java.util.*;

/**
 * @desc 一个用于敏感词检测的高效工具类
 * @author 王冠华
 * @date 2024-07-17
 */
public class SensitiveWordFilter {

    private static class TrieNode {
        Map<Character, TrieNode> children; // 使用 Map 来存储子节点
        TrieNode fail; // 失败指针
        boolean isEndOfWord; // 标记是否是敏感词的结尾
        String word; // 存储完整的敏感词

        public TrieNode() {
            this.children = new HashMap<>(); // 使用 HashMap 存储子节点
            this.fail = null;
            this.isEndOfWord = false;
            this.word = null;
        }
    }

    private TrieNode root;

    /**
     * 构造函数，用于初始化敏感词库。
     * @param words 敏感词集合，集合确保敏感词不会重复
     */
    public SensitiveWordFilter(Set<String> words) {
        root = new TrieNode();
        addWords(words);
        buildFailurePointers();
    }

    /**
     * 将敏感词集合添加到 Trie 树中。
     * @param words 敏感词集合
     */
    private void addWords(Set<String> words) {
        for (String word : words) {
            addWord(word.toLowerCase()); // 转换为小写
        }
    }

    /**
     * 将单个敏感词添加到 Trie 树中。
     * @param word 敏感词
     */
    private void addWord(String word) {
        TrieNode current = root;
        for (char c : word.toCharArray()) {
            current.children.putIfAbsent(c, new TrieNode());
            current = current.children.get(c);
        }
        current.isEndOfWord = true; // 标记敏感词的结尾
        current.word = word; // 存储完整的敏感词
    }

    /**
     * 构建失败指针，用于加速匹配过程。
     */
    private void buildFailurePointers() {
        Queue<TrieNode> queue = new LinkedList<>();
        root.fail = null; // 根节点的失败指针应为 null
        queue.add(root);

        while (!queue.isEmpty()) {
            TrieNode current = queue.poll();
            for (Map.Entry<Character, TrieNode> entry : current.children.entrySet()) {
                char c = entry.getKey();
                TrieNode child = entry.getValue();

                TrieNode fail = current.fail;
                while (fail != null && !fail.children.containsKey(c)) {
                    fail = fail.fail;
                }
                if (fail == null) {
                    child.fail = root;
                } else {
                    child.fail = fail.children.get(c);
                }

                queue.add(child);
            }
        }
    }

    /**
     * 检查文本中是否包含敏感词，并返回 true 或 false。
     * @param text 要检查的文本
     * @return 如果包含敏感词，返回 true；否则返回 false
     */
    public boolean containsSensitiveWord(String text) {
        TrieNode current = root;
        TrieNode node;
        for (int i = 0; i < text.length(); i++) {
            node = current;
            for (int j = i; j < text.length(); j++) {
                char c = Character.toLowerCase(text.charAt(j)); // 转换为小写
                while (node != null && !node.children.containsKey(c)) {
                    node = node.fail; // 使用失败指针进行跳转
                }
                if (node == null) {
                    break;
                } else {
                    node = node.children.get(c); // 跳转到匹配的子节点
                }

                // 直接在当前节点判断是否为敏感词结尾
                if (node != null && node.isEndOfWord) {
                    return true;
                }
            }
        }
        return false; // 未找到敏感词
    }

    /**
     * 检查文本中是否包含敏感词，并返回命中的第一个敏感词及其位置。
     * @param text 要检查的文本
     * @return 包含敏感词及其位置的 Map.Entry 对象
     */
    public Map.Entry<String, Integer> findSensitiveWord(String text) {
        TrieNode current = root;
        TrieNode node;
        for (int i = 0; i < text.length(); i++) {
            node = current;
            for (int j = i; j < text.length(); j++) {
                char c = Character.toLowerCase(text.charAt(j)); // 转换为小写
                while (node != null && !node.children.containsKey(c)) {
                    node = node.fail; // 使用失败指针进行跳转
                }
                if (node == null) {
                    break;
                } else {
                    node = node.children.get(c); // 跳转到匹配的子节点
                }

                // 直接在当前节点判断是否为敏感词结尾
                if (node != null && node.isEndOfWord) {
                    return new AbstractMap.SimpleEntry<>(node.word, i);
                }
            }
        }
        return null; // 未找到敏感词
    }

    /**
     * 检查文本中是否包含敏感词，并返回所有命中的敏感词及其位置。
     * @param text 要检查的文本
     * @return 包含敏感词及其位置的列表
     */
    public List<Map.Entry<String, Integer>> findAllSensitiveWords(String text) {
        List<Map.Entry<String, Integer>> result = new ArrayList<>();
        TrieNode current = root;
        TrieNode node;
        for (int i = 0; i < text.length(); i++) {
            node = current;
            for (int j = i; j < text.length(); j++) {
                char c = Character.toLowerCase(text.charAt(j)); // 转换为小写
                while (node != null && !node.children.containsKey(c)) {
                    node = node.fail; // 使用失败指针进行跳转
                }
                if (node == null) {
                    break;
                } else {
                    node = node.children.get(c); // 跳转到匹配的子节点
                }

                // 直接在当前节点判断是否为敏感词结尾
                if (node != null && node.isEndOfWord) {
                    result.add(new AbstractMap.SimpleEntry<>(node.word, i));
                    // Continue searching in this segment to find all overlapping sensitive words
                }
            }
        }
        return result; // 返回所有找到的敏感词
    }


    public static void main(String[] args) {
        // 初始化含有5000个敏感词的HashSet
        ArrayList<String> list = Lists.newArrayList("敏感词1","敏感词2","敏感词3"));
        Set<String> set = new HashSet<>(list);
        // 创建 SensitiveWordFilter 对象
        SensitiveWordFilter filter = new SensitiveWordFilter(set);

        // 要检查的文本
        String text1 = "位于固原市原州区开城镇的中庄水库，敏感词1是宁夏中南部城乡敏感词2饮水安全工程的主敏感词3调节水库";
        String text2 = "位于固原市原州区开城镇的中庄水库，是宁夏中南部城乡饮水安全工程的主调节水库";

        // 使用过滤器进行检查
        boolean containsSensitiveWord1 = filter.containsSensitiveWord(text1);
        boolean containsSensitiveWord2 = filter.containsSensitiveWord(text2);

        System.out.println("检测结果1: " + containsSensitiveWord1); // true
        System.out.println("检测结果2: " + containsSensitiveWord2); // false


        Map.Entry<String, Integer> sensitiveWord1 = filter.findSensitiveWord(text1);
        Map.Entry<String, Integer> sensitiveWord2 = filter.findSensitiveWord(text2);

        System.out.println("查找结果1: " + sensitiveWord1); // true
        System.out.println("查找结果2: " + sensitiveWord2); // false

        List<Map.Entry<String, Integer>> allSensitiveWords = filter.findAllSensitiveWords(text1);

        System.out.println("查找所有结果: " + allSensitiveWords);

    }
}

package web.filter;

import javax.servlet.*;
import javax.servlet.annotation.WebFilter;
import java.io.BufferedReader;
import java.io.FileReader;
import java.io.IOException;
import java.lang.reflect.InvocationHandler;
import java.lang.reflect.Method;
import java.lang.reflect.Proxy;
import java.util.ArrayList;
import java.util.List;

/**
 * 敏感词汇过滤器
 */
@WebFilter("/*")
public class SensitiveWordsFilter implements Filter {


    public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws ServletException, IOException {
        //1.创建代理对象，增强getParameter方法

        ServletRequest proxy_req = (ServletRequest) Proxy.newProxyInstance(req.getClass().getClassLoader(), req.getClass().getInterfaces(), new InvocationHandler() {
            @Override
            public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
                //增强getParameter方法
                //判断是否是getParameter方法
                if(method.getName().equals("getParameter")){
                    //增强返回值
                    //获取返回值
                    String value = (String) method.invoke(req,args);
                    System.out.println("method："+method.getName());
                    if(value != null){
                        for (String str : list) {
                            if(value.contains(str)){
                                value = value.replaceAll(str,"***");
                            }
        
                        }
                    }
                    
                    return  value;
                }

                //判断方法名是否是 getParameterMap

                //判断方法名是否是 getParameterValue

                return method.invoke(req,args);
            }
        });

        //2.放行
        chain.doFilter(proxy_req, resp);
    }
    private List<String> list = new ArrayList<String>();//敏感词汇集合
    public void init(FilterConfig config) throws ServletException {

        try{
            //1.获取文件真实路径
            ServletContext servletContext = config.getServletContext();
            String realPath = servletContext.getRealPath("/WEB-INF/classes/敏感词汇.txt");
            //2.读取文件
            BufferedReader br = new BufferedReader(new FileReader(realPath));
            //3.将文件的每一行数据添加到list中
            String line = null;
            while((line = br.readLine())!=null){
                list.add(line);
            }

            br.close();

            System.out.println(list);

        }catch (Exception e){
            e.printStackTrace();
        }

    }

    public void destroy() {
    }

}

package web.servlet;

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

@WebServlet("/testServlet")
public class TestServlet extends HttpServlet {
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        String name = request.getParameter("name");
        String msg = request.getParameter("msg");

        System.out.println(name+":"+msg);
    }

    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        this.doPost(request, response);
    }
}

import java.util.*;
 
public class SensitiveWordUtil {
    /**
     * 敏感词匹配规则
     */
    public static final int MinMatchTYpe = 1;      //最小匹配规则，如：敏感词库["中国","中国人"]，语句："我是中国人"，匹配结果：我是[中国]人
    public static final int MaxMatchType = 2;      //最大匹配规则，如：敏感词库["中国","中国人"]，语句："我是中国人"，匹配结果：我是[中国人]
 
    /**
     * 敏感词集合
     */
    public static HashMap sensitiveWordMap;
 
    /**
     * 初始化敏感词库，构建DFA算法模型
     *
     * @param sensitiveWordSet 敏感词库
     */
    public static synchronized void init(Set<String> sensitiveWordSet) {
        initSensitiveWordMap(sensitiveWordSet);
    }
 
    /**
     * 初始化敏感词库，构建DFA算法模型
     *
     * @param sensitiveWordSet 敏感词库
     */
    private static void initSensitiveWordMap(Set<String> sensitiveWordSet) {
        //初始化敏感词容器，减小扩容操做
        sensitiveWordMap = new HashMap(sensitiveWordSet.size());
        String key;
        Map nowMap;
        Map<String, String> newWorMap;
        //迭代sensitiveWordSet
        Iterator<String> iterator = sensitiveWordSet.iterator();
        while (iterator.hasNext()) {
            //关键字
            key = iterator.next();
            nowMap = sensitiveWordMap;
            for (int i = 0; i < key.length(); i++) {
                //转换成char型
                char keyChar = key.charAt(i);
                //库中获取关键字
                Object wordMap = nowMap.get(keyChar);
                //若是存在该key，直接赋值，用于下一个循环获取
                if (wordMap != null) {
                    nowMap = (Map) wordMap;
                } else {
                    //不存在则，则构建一个map，同时将isEnd设置为0，由于他不是最后一个
                    newWorMap = new HashMap<>();
                    //不是最后一个
                    newWorMap.put("isEnd", "0");
                    nowMap.put(keyChar, newWorMap);
                    nowMap = newWorMap;
                }
 
                if (i == key.length() - 1) {
                    //最后一个
                    nowMap.put("isEnd", "1");
                }
            }
        }
    }
 
    /**
     * 判断文字是否包含敏感字符
     *
     * @param txt       文字
     * @param matchType 匹配规则 1：最小匹配规则，2：最大匹配规则
     * @return 若包含返回true，不然返回false
     */
    public static boolean contains(String txt, int matchType) {
        boolean flag = false;
        for (int i = 0; i < txt.length(); i++) {
            int matchFlag = checkSensitiveWord(txt, i, matchType); //判断是否包含敏感字符
            if (matchFlag > 0) {    //大于0存在，返回true
                flag = true;
            }
        }
        return flag;
    }
 
    /**
     * 判断文字是否包含敏感字符
     *
     * @param txt 文字
     * @return 若包含返回true，不然返回false
     */
    public static boolean contains(String txt) {
        return contains(txt, MaxMatchType);
    }
 
    /**
     * 获取文字中的敏感词
     *
     * @param txt       文字
     * @param matchType 匹配规则 1：最小匹配规则，2：最大匹配规则
     * @return
     */
    public static Set<String> getSensitiveWord(String txt, int matchType) {
        Set<String> sensitiveWordList = new HashSet<>();
 
        for (int i = 0; i < txt.length(); i++) {
            //判断是否包含敏感字符
            int length = checkSensitiveWord(txt, i, matchType);
            if (length > 0) {//存在,加入list中
                sensitiveWordList.add(txt.substring(i, i + length));
                i = i + length - 1;//减1的缘由，是由于for会自增
            }
        }
 
        return sensitiveWordList;
    }
 
    /**
     * 获取文字中的敏感词
     *
     * @param txt 文字
     * @return
     */
    public static Set<String> getSensitiveWord(String txt) {
        return getSensitiveWord(txt, MaxMatchType);
    }
 
    /**
     * 替换敏感字字符
     *
     * @param txt         文本
     * @param replaceChar 替换的字符，匹配的敏感词以字符逐个替换，如 语句：我爱中国人 敏感词：中国人，替换字符：*， 替换结果：我爱***
     * @param matchType   敏感词匹配规则
     * @return
     */
    public static String replaceSensitiveWord(String txt, char replaceChar, int matchType) {
        String resultTxt = txt;
        //获取全部的敏感词
        Set<String> set = getSensitiveWord(txt, matchType);
        Iterator<String> iterator = set.iterator();
        String word;
        String replaceString;
        while (iterator.hasNext()) {
            word = iterator.next();
            replaceString = getReplaceChars(replaceChar, word.length());
            resultTxt = resultTxt.replaceAll(word, replaceString);
        }
 
        return resultTxt;
    }
 
    /**
     * 替换敏感字字符
     *
     * @param txt         文本
     * @param replaceChar 替换的字符，匹配的敏感词以字符逐个替换，如 语句：我爱中国人 敏感词：中国人，替换字符：*， 替换结果：我爱***
     * @return
     */
    public static String replaceSensitiveWord(String txt, char replaceChar) {
        return replaceSensitiveWord(txt, replaceChar, MaxMatchType);
    }
 
    /**
     * 替换敏感字字符
     *
     * @param txt        文本
     * @param replaceStr 替换的字符串，匹配的敏感词以字符逐个替换，如 语句：我爱中国人 敏感词：中国人，替换字符串：[屏蔽]，替换结果：我爱[屏蔽]
     * @param matchType  敏感词匹配规则
     * @return
     */
    public static String replaceSensitiveWord(String txt, String replaceStr, int matchType) {
        String resultTxt = txt;
        //获取全部的敏感词
        Set<String> set = getSensitiveWord(txt, matchType);
        Iterator<String> iterator = set.iterator();
        String word;
        while (iterator.hasNext()) {
            word = iterator.next();
            resultTxt = resultTxt.replaceAll(word, replaceStr);
        }
 
        return resultTxt;
    }
 
    /**
     * 替换敏感字字符
     *
     * @param txt        文本
     * @param replaceStr 替换的字符串，匹配的敏感词以字符逐个替换，如 语句：我爱中国人 敏感词：中国人，替换字符串：[屏蔽]，替换结果：我爱[屏蔽]
     * @return
     */
    public static String replaceSensitiveWord(String txt, String replaceStr) {
        return replaceSensitiveWord(txt, replaceStr, MaxMatchType);
    }
 
    /**
     * 获取替换字符串
     *
     * @param replaceChar
     * @param length
     * @return
     */
    private static String getReplaceChars(char replaceChar, int length) {
        String resultReplace = String.valueOf(replaceChar);
        for (int i = 1; i < length; i++) {
            resultReplace += replaceChar;
        }
 
        return resultReplace;
    }
 
    /**
     * 检查文字中是否包含敏感字符，检查规则以下：<br>
     *
     * @param txt
     * @param beginIndex
     * @param matchType
     * @return 若是存在，则返回敏感词字符的长度，不存在返回0
     */
    private static int checkSensitiveWord(String txt, int beginIndex, int matchType) {
        //敏感词结束标识位：用于敏感词只有1位的状况
        boolean flag = false;
        //匹配标识数默认为0
        int matchFlag = 0;
        char word;
        Map nowMap = sensitiveWordMap;
        for (int i = beginIndex; i < txt.length(); i++) {
            word = txt.charAt(i);
            //获取指定key
            nowMap = (Map) nowMap.get(word);
            if (nowMap != null) {//存在，则判断是否为最后一个
                //找到相应key，匹配标识+1
                matchFlag++;
                //若是为最后一个匹配规则,结束循环，返回匹配标识数
                if ("1".equals(nowMap.get("isEnd"))) {
                    //结束标志位为true
                    flag = true;
                    //最小规则，直接返回,最大规则还需继续查找
                    if (MinMatchTYpe == matchType) {
                        break;
                    }
                }
            } else {//不存在，直接返回
                break;
            }
        }
        if (matchFlag < 2 || !flag) {//长度必须大于等于1，为词
            matchFlag = 0;
        }
        return matchFlag;
    }
 
 
    public static void main(String[] args) {
 
        Set<String> sensitiveWordSet = new HashSet<>();
        sensitiveWordSet.add("成人电影");
        sensitiveWordSet.add("爱恋");
        sensitiveWordSet.add("静静");
        sensitiveWordSet.add("哈哈");
        sensitiveWordSet.add("啦啦");
        sensitiveWordSet.add("感动");
        sensitiveWordSet.add("发呆");
        //初始化敏感词库
        SensitiveWordUtil.init(sensitiveWordSet);
 
        System.out.println("敏感词的数量：" + SensitiveWordUtil.sensitiveWordMap.size());
        String string = "成人太多的伤感情怀也许只局限于饲养基地 荧幕中的情节。"
                + "而后咱们的扮演的角色就是跟随着主人公的喜红客联盟 怒哀乐而过于牵强的把本身的情感也附加于银幕情节中，而后感动就流泪，"
                + "难过就躺在某一我的的怀里尽情的阐述心扉或者手机卡复制器一个贱人一杯红酒一部电影在夜 深人静的晚上，关上电话静静的发呆着。";
        System.out.println("待检测语句字数：" + string.length());
 
        //是否含有关键字
        boolean result = SensitiveWordUtil.contains(string);
        System.out.println(result);
        result = SensitiveWordUtil.contains(string, SensitiveWordUtil.MinMatchTYpe);
        System.out.println(result);
 
        //获取语句中的敏感词
        Set<String> set = SensitiveWordUtil.getSensitiveWord(string);
        System.out.println("语句中包含敏感词的个数为：" + set.size() + "。包含：" + set);
        set = SensitiveWordUtil.getSensitiveWord(string, SensitiveWordUtil.MinMatchTYpe);
        System.out.println("语句中包含敏感词的个数为：" + set.size() + "。包含：" + set);
 
        //替换语句中的敏感词
        String filterStr = SensitiveWordUtil.replaceSensitiveWord(string, '*');
        System.out.println(filterStr);
        filterStr = SensitiveWordUtil.replaceSensitiveWord(string, '*', SensitiveWordUtil.MinMatchTYpe);
        System.out.println(filterStr);
 
        String filterStr2 = SensitiveWordUtil.replaceSensitiveWord(string, "[*敏感词*]");
        System.out.println(filterStr2);
        filterStr2 = SensitiveWordUtil.replaceSensitiveWord(string, "[*敏感词*]", SensitiveWordUtil.MinMatchTYpe);
        System.out.println(filterStr2);
    }
}