LogAnalysiser软件诞生始末

万恶的加班还在延续着，分析软件日志分析的头疼还是没有能够找到问题的症结所在。 五十多兆的日志文件中，很多都是没用的，有用的信息都被这些无用的信息给推攘到了不知名的角落里。我愣是找了一个小时，找到的有用的信息寥寥无几，抬头望望远处，已经感觉到有些眼晕了。 考虑到每天都要进行这样的诊断工作，于是决定写一个日志分析的小软件，要求能够过滤掉带有指定关键字的行，并且能够高亮某些关键字。于是，LogAnalysiser这个小工具诞生了。

程序运行效果图

下面是具体的截图：

启动界面(采用了Slash窗体，在程序启动时会自动检测缺失的配置文件或者程序集)：



然后启动到主界面(主界面包含了配置窗体，着色窗体，更新窗体)：



这个是配置窗体，多个关键字或者子句，利用竖线分隔开，程序会自动过滤掉含有这些关键字的文本行：



下面的这个是着色窗体，输入关键字，以数显隔开，点击确定按钮可以实时实现关键字高亮：



下面这个是更新窗体，主要负责软件更新工作：



然后这里是帮助文档：



这就是这个软件的大概，虽然很小，但是算是比较的全面。

下面来说下在制作过程中使用到的技术：

技术一： 异步操作(采用APM模式)

关于这个模式的具体讲解，可以参见我之前的博客文章：我所知道的.net异步

在软件Slash窗体加载,关键字过滤以及软件更新的时候，由于这三个操作比较耗时，所以采用了异步方式来进行，即使用BeginInvoek和与之配对的EndInvoke方式来达到目的。 比如说软件中的LoadAppendingText()函数主要是用来循环过滤关键字来达到简化日志的目的，一旦日志文件体积非常大的情况下，这个函数将会阻塞主界面，导致假死状况。针对这种情况，我利用异步方式来处理，也就是利用下面代码进行了封装，从而产生异步效果：

#region Begin and End Invoke of Async mode
/// <summary>
/// 异步开始
/// </summary>
private void BeginInvokeAppending()
{
Action action = new Action(LoadAppendingText);
IAsyncResult result = action.BeginInvoke(new AsyncCallback(EndInvokeAppending),action);
pPrograss.Maximum = GetTotalCounts();
tTick.Enabled = true;
}

/// <summary>
/// 异步结束
/// </summary>
/// <param name="iar"></param>
private void EndInvokeAppending(IAsyncResult iar)
{
btnAnalysis.Invoke(new Action(delegate
{
btnAnalysis.Enabled = false;
}));
tTick.Enabled = false;
notificationIcon.Image = (Image)WinRes.Complete;
Action action = (Action)iar.AsyncState;
action.EndInvoke(iar);
}
#endregion

这样，当软件运行的时候，界面不会卡死，一切都很流畅：



所以，从上面的异步方式看来，这种模式下，我们只需要对耗时函数利用BeginInvoke和EndInvoke进行一下简单的封装即可，省时也省力。

需要说明的是，利用异步和界面交互，不得不遇到一个跨线程的问题，不过我们可以通过Form控件的Invoke方式来进行，也就是类似如下的操作：

lblStatus.Invoke(new Action(delegate
{
lblStatus.Text = "更新完毕。";
}));

技术二： 委托事件传值。

关于委托的更多详细情况，请参见我之前的博客：浅谈C#中常见的委托

在制作本软件的过程中，着色的字体需要实时的显示；Slash窗体检测完毕，也需要传值给主窗体，然后自己关闭掉。 这两个地方都使用了委托事件来进行，具体怎么用呢，请看下面的步骤：

首先，声明全局委托：

/// <summary>
/// 全局委托，用于着色
/// </summary>
/// <param name="text">待着色文本</param>
public delegate void ColorDaemonDelegate(string text);

然后再DaemonFrm窗体中（也就是进行着色配置的窗体中），声明一个OnColorDaemonEventHandler事件，用于抛出通知：

public event ColorDaemonDelegate OnColorDaemonEventHandler;

那么，这个通知如何抛出呢？

当然是在点击着色按钮的时候抛出去，它向外界宣布：我现在要着色啦，于是它在以下的代码中将着色事件抛了出去：

private void btnColor_Click(object sender, EventArgs e)
{
string text = txtWordDaemon.Text;
OnColorDaemonEventHandler(text);  //抛出事件
}

可以看出，这个事件抛出的时候，带有一个参数，这个参数就是需要高亮的关键字。 那么事件抛出来了，抛给谁了？谁接收到了呢？ 之后的内容估计就是我们非常常见的了，即事件注册：

/// <summary>
/// 点击主窗体中的着色按钮，可以对当前文档进行关键字高亮
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void tsBtnColor_Click(object sender, EventArgs e)
{
if (daemonFrm == null || daemonFrm.IsDisposed == true)
{
daemonFrm = new DaemonFrm();
}
daemonFrm.OnColorDaemonEventHandler += new ColorDaemonDelegate(daemonFrm_OnColorDaemonEventHandler);
daemonFrm.Show();
}

利用上面的+=号，就把刚才抛出的事件给接住了，并且这个抛出的事件被主窗体给接住了。

下面是针对这个抛出的事件进行处理：

/// <summary>
/// 着色委托事件，可以实时高亮关键字
/// </summary>
/// <param name="text"></param>
private void daemonFrm_OnColorDaemonEventHandler(string text)
{
RichTextBoxEx.SetColorBox(richTextBox1,richTextBox1.Text, text, Color.Red);
}

上面的RichTextBoxEx.SetColorBox是一个利用扩展方法实现的函数，就可以实现关键字的实时高亮，看看效果：



这样就可以非常方便的分析日志了。

技术三：更新组件的编写。

更新组件是软件最常用的组件之一，本软件的更新组件主要采用HttpWebRequest和HttpWebResponse进行数据获取并结合异步机制完成。

首先，来看看下载数据的函数：

private void DownLoadVersion(string url,string filename,ProgressBar progress,Label label)
{
int percent = 0;
HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(url);
request.ContentType = @"application/octet-stream";
request.Credentials = CredentialCache.DefaultCredentials;

HttpWebResponse response = (HttpWebResponse)request.GetResponse();

long totalBytes = response.ContentLength;  //获取文件字节数

progress.Invoke(new Action(delegate
{
progress.Maximum = (int)totalBytes;
}));

Stream responseStream = response.GetResponseStream(); //保存到内存
Stream fileStream = new FileStream(filename, FileMode.Create);

long totalDownloadBytes = 0;
byte[] bytes = new byte[1024];
int paragraphByteSize = responseStream.Read(bytes, 0, (int)bytes.Length); //一次性读取1024个字节
while (paragraphByteSize > 0)
{
totalDownloadBytes += paragraphByteSize;  //当前已经读取的字节数
fileStream.Write(bytes, 0, paragraphByteSize); //写入到文件
progress.Invoke(new Action(delegate
{
progress.Value = (int)totalDownloadBytes;
}));

paragraphByteSize = responseStream.Read(bytes, 0, (int)bytes.Length); //继续读取下一段

percent = (int)((float)totalDownloadBytes / (float)totalBytes * 100);  //进度百分比

label.Invoke(new Action(delegate
{
label.Text = "当前已经更新：" + percent.ToString() + "%";
}));
}
responseStream.Close();
fileStream.Close();
}

这里我已经做了不少的注释了，其主体的逻辑就是得到请求数据，然后1字节1字节的写入，直到下载完毕为止。

如果直接运行这个函数进行更新的话，会造成界面假死，所以在这里我采用了和之前一样的异步处理方式，即利用BeginInvoke和EndInvoke方式来进行。这样就保证了界面的流畅性。

 /// <summary>
/// 开始进行异步更新
/// </summary>
/// <param name="url">软件地址</param>
/// <param name="filename">软件名称</param>
/// <param name="progress">PrograssBar进度条</param>
/// <param name="label">Label状态标签</param>
private void BeginDownload(string url,string filename,ProgressBar progress,Label label)
{
//利用Action委托进行代理
Action<string, string, ProgressBar, Label> action = new Action<string, string, ProgressBar, Label>(DownLoadVersion);
//开始进行异步
action.BeginInvoke(url, filename, progress, label, new AsyncCallback(EndDownload), action);
}

/// <summary>
/// 异步更新结束
/// </summary>
/// <param name="iar">异步状态</param>
private void EndDownload(IAsyncResult iar)
{
//还原对象
Action<string, string, ProgressBar, Label> action = (Action<string, string, ProgressBar, Label>)iar.AsyncState;
//得到异步结果
action.EndInvoke(iar);
//更新异步操作状态
lblStatus.Invoke(new Action(delegate
{
lblStatus.Text = "更新完毕。";
}));
//暂停
System.Threading.Thread.Sleep(1000);

string fileName = Application.StartupPath + "\\LogAnalysiser.exe";
//异步更新结束，启动主程序
Process.Start(fileName);
//退出异步更新程序
Application.Exit();
}

其次，需要说明的是，既然我们是更新软件，那么肯定需要一个网络地址存储更高版本的文件，这里我专门创建了一个WebService用来处理更新程序所发出的请求。

在这个WebService中，我在web.cong文件中的configurations节点下新添加了一个子节点（这个涉及到在Web.config中进行自定义节点的设置方面的知识，可以参见我的文章:Asp.net配置文件中自定义节点详解）：

<section name="MySection" type="UpgradeServer.MySection,UpgradeServer"/>

然后在CONFIGSECTIONS节点外面加入如下配置的节点：

<MySection>
<add version ="1.2.0.0" fileName="http://localhost:2187/DownLoadVersion/LogAnalysiser.exe"></add>
</MySection>

其中 version代表版本号，fileName代表待更新的文件的网络地址。

这样配置完成之后，在代码中，我们就可以使用两个函数暴露出待更新的软件的版本号和更新地址：

[WebMethod]
public string GetUpgradeVersion()
{
MySection section = (MySection)ConfigurationManager.GetSection("MySection");
MySectionItem item = section.Item;

return item.Version;
}

[WebMethod]
public string GetUpgradeFileName()
{
MySection section = (MySection)ConfigurationManager.GetSection("MySection");
MySectionItem item = section.Item;

return item.FileName;
}

那么当程序检测到目前版本号和WEBSERVER暴露出来的版本号一样的时候，表明服务器上面没有最新版本，当二者不一致的时候，则证明服务器上面有最新的版本，于是启动更新组件，进行更新。

代码如下：

public bool CheckVersionAndUpgrade()
{
try
{
if (client == null)
{
client = new UpgradeFormApplication.UpgradeWebService.Service1SoapClient();
}

string upgradeVersion = client.GetUpgradeVersion(); //获取版本号
string upgradeFileName = client.GetUpgradeFileName(); //获取更新文件的网络路径

string currentVersion = CommonUntil.GetApplicationVersionFromExeFile(); //获取当前主程序的版本号

if (String.IsNullOrEmpty(upgradeVersion))
{
lblStatus.Invoke(new Action(delegate
{
lblStatus.Text = "当前没有最新版本。";
}));
btnUpgrade.Invoke(new Action(delegate
{
btnUpgrade.Enabled = false;
}));
return false;
}
if (String.IsNullOrEmpty(currentVersion))
{
return false;
}

if (currentVersion.Equals(upgradeVersion)) //如果没有更高的版本号
{
lblStatus.Invoke(new Action(delegate
{
lblStatus.Text = "当前没有最新版本。";
}));
btnUpgrade.Invoke(new Action(delegate
{
btnUpgrade.Enabled = false;
}));
return false;
}

lblStatus.Invoke(new Action(delegate
{
lblStatus.Text = "当前存在最新版本" + upgradeVersion + "，点击更新。。。";
}));

return true;
}
catch
{
lblStatus.Invoke(new Action(delegate{lblStatus.Text = "不能连接远程主机获取更新，请检查网络连接！";}));
btnUpgrade.Invoke(new Action(delegate { btnUpgrade.Enabled = false; }));
return false;
}
}

那么一旦我们有新的版本需要更新的时候，我们只需要在把这个新的版本放到IIS的形如 http://*******/DownLoadVersion/的路径下，并且修改web.config文件中的version的值为新版本号即可。当软件更新组件运行的时候，一旦发现version值改变，就会立即启动更新程序进行更新。

技术之四：帮助文档自动生成。

其实这个并不能称为技术，应为我们应用的是自动生成软件，但是这个帮助文档也确实是必不可少的，它可以让开发人员对软件的功能一目了然。 说到自动文档生成，这里我推荐使用.NET文档生成工具ADB，作者博客为：HTTP://WWW.CNBLOGS.COM/LUCC/ARCHIVE/2008/09/01/1281085.HTML

这个软件支持多种注释的智能识别模式，并且支持多程序集合并功能。在使用本软件之前，强烈建议为程序集生成XML文档，具体做法是在项目上右击，选择“生成标签”，然后勾选上”XML文档文件”选项。

当我用ADB加载我的LOGANALYSISER.EXE文件的时候，我们可以看到软件界面列出了如下的各种公共方法，公共属性等等。 当我们最后点击创建文档按钮的时候，就得到了一个看上去非常专业的帮助文档：



好了，这个软件的介绍就到了这里，如果觉得有帮助，还请帮助顶一下，谢谢。

源码下载

点击这里下载源码