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(""))
             {
                 try
                 {
                     await Task.Delay(TimeSpan.FromSeconds());
                     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"), )));
     }

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 = ;
     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) + "\r\n";
             if (checkMatchInfo.Replacements != null && checkMatchInfo.Replacements.Count > )
             {
                 matchString += "Suggest :  " + checkMatchInfo.Replacements[].Replacement + "\r\n\r\n";
             }
         }
     }

     return matchString;

以下是案例：

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

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

使用指导

安装Java环境

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

启动本地服务LanguageTool

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