C# 英语纠错 LanguageTool

WPF中，对单词拼写错误，textbox有相应的附加属性可以设置。

<TextBox SpellCheck.IsEnabled="True" />

但是此属性只在WPF 4，即.netFramework 4.0，才有效。

并且只支持English、Spanish、French 和German

LanguageTool

单词纠错，有一个第三方开源资源可以使用。

1. 官方纠错页面：https://www.languagetool.org/

2. LanguageTool API 接口

3. LanguageTool Github源码

如何使用LanguageTool

准备环境

1. 下载最新版本（桌面离线版）

2.  解压后，点击languagetool-server.jar，启动服务器模式

启动前提：java环境  下载JavaSetup链接

如需要静默安装java环境，可以使用以下bat命令行：

@echo off
cls

set  jdkPath=JavaSetup8u211.exe
rem  设置jdk安装路径，jre安装路径
set  commonPath=C:Program Files (x86)
set  jreinstallPath="%commonPath%jre1.8.0_211"
 
echo.
echo 正在安装jre，需要二、三分钟，请不要执行其他操作
echo.
start /w %jdkPath% /L "%commonPath%installjava.log" /s 
ADDLOCAL="ToolsFeature,SourceFeature,PublicjreFeature"  
INSTALLDIR=%jreinstallPath%
WEB_JAVA=0 AUTO_UPDATE=0 
echo 安装完成，%jreinstallPath%

pause

启动服务模式的方式：以命令行的方式启动

java -cp languagetool-server.jar org.languagetool.server.HTTPServer --port 8081

如果需要静默启动，可以新建一个bat文件，放在languageTool离线包文件的外面，使用以下bat脚本：

@echo off

echo.
echo 正在启动language-tool-server...
cd LanguageTool-4.5
echo java -cp languagetool-server.jar org.languagetool.server.HTTPServer --port 8081
java -cp languagetool-server.jar org.languagetool.server.HTTPServer --port 8081

pause

英语纠错

1. 调用纠错API

拼接访问地址

访问的端口，是上面环境准备时设置的，也可以使用其它的端口。

接口必填参数：语言、请求文本

请求文本，需要转换为Url编码字符串。

    private static string GetRequestUrl(string queryText, string language = "en-US")
    {
        var requestUrl = "http://localhost:8081/v2/check?" +
                         $"language={language}&text={WebUtility.UrlEncode(queryText)}";

        return requestUrl;
    }

请求Api，返回纠错结果。（返回结果，相对应的，也需要将Url编码字符串，转换回文本字符串）

    public static async Task<CheckEnglishSentenceResponse> CheckEnglishSentenceAsync(string queryText)
    {
        var requestUrl = GetRequestUrl(queryText);
        var result = await RequestUrlAsync(requestUrl);

        var response = JsonConvert.DeserializeObject<CheckEnglishSentenceResponse>(result);
        return response;
    }

辅助方法：

    protected static async Task<string> RequestUrlAsync(string requestUrl)
    {
        if (string.IsNullOrWhiteSpace(requestUrl))
        {
            return string.Empty;
        }

        try
        {
            return await RequestDataAsync(requestUrl);
        }
        catch (Exception e)
        {
            if (e.Message.Contains("502"))
            {
                try
                {
                    await Task.Delay(TimeSpan.FromSeconds(10));
                    return await RequestUrlAsync(requestUrl);
                }
                catch (Exception exception)
                {
                }
            }
            return string.Empty;
        }
    }

    private static async Task<string> RequestDataAsync(string requestUrl)
    {
        WebRequest translationWebRequest = WebRequest.Create(requestUrl);

        var response = await translationWebRequest.GetResponseAsync();

        using (Stream stream = response.GetResponseStream())
        {
            using (StreamReader reader = new StreamReader(stream ?? throw new InvalidOperationException(),
                Encoding.GetEncoding("utf-8")))
            {
                string result = reader.ReadToEnd();
                var decodeResult = Unicode2String(result);
                return decodeResult;
            }
        }
    }

    /// <summary>
    /// Unicode转字符串
    /// </summary>
    /// <param name="source">经过Unicode编码的字符串</param>
    /// <returns>正常字符串</returns>
    protected static string Unicode2String(string source)
    {
        return new Regex(@"\u([0-9A-F]{4})", RegexOptions.IgnoreCase | RegexOptions.Compiled).Replace(
            source, x => string.Empty + Convert.ToChar(Convert.ToUInt16(x.Result("$1"), 16)));
    }

2. 解析纠错结果

 数据类：

    [DataContract]
    public class CheckEnglishSentenceResponse
    {
        [DataMember(Name = "matches")]
        public List<EnglishSentenceCheckMatchInfo> MatchInfos { get; set; }
    }
    [DataContract]
    public class EnglishSentenceCheckMatchInfo
    {
        [DataMember(Name = "message")]
        public string Message { get; set; }
        [DataMember(Name = "shortMessage")]
        public string ShortMessage { get; set; }

        [DataMember(Name = "context")]
        public CheckMatchContext CheckMatchContext { get; set; }

        [DataMember(Name = "replacements")]
        public List<CheckMatchReplacement> Replacements { get; set; }
    }
    [DataContract]
    public class CheckMatchContext
    {
        [DataMember(Name = "offset")]
        public int StartIndex { get; set; }
        [DataMember(Name = "length")]
        public int Length { get; set; }
        [DataMember(Name = "text")]
        public string Text { get; set; }
    }

    [DataContract]
    public class CheckMatchReplacement
    {
        [DataMember(Name = "value")]
        public string Replacement { get; set; }
    }

纠错展示：

    string matchString = string.Empty;
    int index = 1;
    if (MatchInfos != null)
    {
        foreach (var checkMatchInfo in MatchInfos)
        {
            var context = checkMatchInfo.CheckMatchContext;
            var message = string.IsNullOrEmpty(checkMatchInfo.ShortMessage)? checkMatchInfo.Message: checkMatchInfo.ShortMessage;
            matchString += $"{index++}. " + message + " :  " + context.Text.Substring(context.StartIndex, context.Length) + "
";
            if (checkMatchInfo.Replacements != null && checkMatchInfo.Replacements.Count > 0)
            {
                matchString += "Suggest :  " + checkMatchInfo.Replacements[0].Replacement + "

";
            }
        }
    }

    return matchString;

以下是案例：

请求本地的后台接口时，会有访问记录：

此案例的源代码，可参考Github-ErrorCorrection

使用指导

安装Java环境

进入文件夹LanguageTool，点击打开InstallJavaEnvironment.bat安装Java

启动本地服务LanguageTool

进入文件夹LanguageTool，点击打开StartLanguageToolServer.bat,启动本地离线英语纠错服务。
访问方式：http://localhost:8081/v2/check?language=en-Us&text=buttton