基于 Web 的程序版本检查

现在的很多程序都可以通过 Internet 进行版本更新，Windows 操作系统本身的“Windows Update”就是一个典型的例子。要实现这种特性，首先必须对应用程序的版本进行检查。那么如何通过

Internet 对自己的程序进行版本检查呢？本文将通过实际的例子程序来示范实现细节。

在进入正题之前，我想先罗嗦几句，说说与此文内容有关的个人好恶：我很讨厌程序显示那些必须让用户干预的消息框，这种消息框很烦人，尤其是问你要不要更新的那种对话框。碰到这种情况我总是回答“No”，然后选择“不要再来烦我”复选框（希望有一个这样的选择框）。

告诉用户进行程序版本更新本身并没有错，但是必须用一种适当的友好的方式通知用户，不要非得让用户来干预，除非是更新版本本身的行为。

但愿我的个人好恶没把你吓跑。其实，实现基于Web的版本检查有很多方法，2003年2月的 MSDN 杂志上有一篇标题为“使用.NET和后台智能传输服务API编写自动更新应用”的文章，此文的作者是

Jason Clark。文章描述了一种全新的专用协议 BITS 来解决自动更新问题。有兴趣的话可以仔细读一读。

但是，如果仅仅是为了检查程序的版本，那么可以将新的版本信息以文本形式保存在 Web 站点上，需要时通过 FTP 获取文件信息。下载

文件的操作可以通过现成的

Windows Internet API 来实现，也就是大家都熟悉的 WinInet，如果你没有用过它，没关系，本文会详细讲述如何用它来编写FTP程序。WinInet

的使用不难，他有固定的套路：第一步创建一个连接；第二步创建一个 FTP 会话；第三步打开文件；第四步读取文件数据，就这么简单。用代码表示就象下面这样：

HINTERNET h = InternetOpen(...);

HINTERNET hftp = InternetConnect(..,INTERNET_SERVICE_FTP,..);

HINTERNET hftpfile = FtpOpenFile(...);

InternetReadFile(...);

下面就让我们深入细节，享受精彩。为了方便代码的重用，我写了类 CWebVersion，这个类对所有细节进行了封装，实现的功能很简单：就是通过

Web 来获取程序版本信息，实现版本的检查。这个类的使用也很方便：

if (CWebVersion::Online()) {

CWebVersion ver("pub.chinafsdu.net");

if (ver.ReadVersion("version.txt"),"pub","pub") {

DWORD maj = ver.dwVersionMS;

DWORD min = ver.dwVersionLS;

}

下面是CWebVersion的声明：

////////////////////////////////////////////////////////////////

// WebVersion.h

#pragma once

class CWebVersion {

protected:

enum { BUFSIZE = 64 };

LPCTSTR m_lpServer; // server name

DWORD m_dwError; // most recent error code

TCHAR m_errInfo[256]; // extended error info

TCHAR m_version[BUFSIZ]; // version number as text

void SaveErrorInfo(); // helper to save error info

public:

DWORD dwVersionMS; // version number: most-sig 32 bits

DWORD dwVersionLS; // version number: least-sig 32 bits

CWebVersion(LPCTSTR server) : m_lpServer(server) { }

~CWebVersion() { }

static BOOL Online();

BOOL ReadVersion(LPCTSTR lpFileName,LPCSTR lpszUserName,LPCSTR lpszPassword);

LPCTSTR GetVersionText() { return m_version; }

DWORD GetError() { return m_dwError; }

LPCTSTR GetExtendedErrorInfo() { return m_errInfo; }

};

CWebVersion 的实现文件

////////////////////////////////////////////////////////////////

// WebVersion.cpp

#include "stdafx.h"

#include "WebVersion.h"

#include "InetHandle.h"

//////////////////

// Check if connected to Internet.

BOOL CWebVersion::Online()

{

DWORD dwState = 0;

DWORD dwSize = sizeof(DWORD);

return InternetQueryOption(NULL,

INTERNET_OPTION_CONNECTED_STATE, &dwState, &dwSize)

&& (dwState & INTERNET_STATE_CONNECTED);

}

//////////////////

// Read version number as string into buffer

BOOL CWebVersion::ReadVersion(LPCTSTR lpFileName,LPCSTR lpszUserName,LPCSTR lpszPassword)

{

CInternetHandle hInternet;

CInternetHandle hFtpSession;

CInternetHandle hFtpFile;

m_version[0] = 0;

m_dwError=0; // assume success

m_errInfo[0]=0; // ..

DWORD nRead=0;

hInternet = InternetOpen(NULL, INTERNET_OPEN_TYPE_DIRECT, NULL,

NULL, 0);

if (hInternet!=NULL) {

hFtpSession = InternetConnect(hInternet, m_lpServer,

INTERNET_DEFAULT_FTP_PORT, lpszUserName, lpszPassword, INTERNET_SERVICE_FTP,

0, NULL);

if (hFtpSession!=NULL) {

hFtpFile = FtpOpenFile(hFtpSession, lpFileName,

GENERIC_READ, FTP_TRANSFER_TYPE_ASCII, NULL);

if (hFtpFile!=NULL) {

InternetReadFile(hFtpFile, m_version, BUFSIZE, &nRead);

if (nRead0) {

m_version[nRead] = 0;

int Mhi,Mlo,mhi,mlo;

_stscanf(m_version, "%x,%x,%x,%x", &Mhi, &Mlo, &mhi, &mlo);

dwVersionMS = MAKELONG(Mlo,Mhi);

dwVersionLS = MAKELONG(mlo,mhi);

return TRUE;

}

// Failed: save error code and extended error info if any.

m_dwError = GetLastError();

if (m_dwError==ERROR_INTERNET_EXTENDED_ERROR) {

DWORD dwErr;

DWORD len = sizeof(m_errInfo)/sizeof(m_errInfo[0]);

InternetGetLastResponseInfo(&dwErr, m_errInfo, &len);

}

return FALSE;

}

WebVersion::Online 检查用户是否连接到

Internet。如果用户不在线，我会让你决定做什么——建议什么也别做。如果用户已经连接到

Internet，则显示一个“版本检查”按钮，这样用户可以明确地发起与FTP服务器的连接（使用 WinInet 的InternetAttemptConnect

函数）。不论做什么都要先询问，再连接，不要太粗鲁。现在很多人都是用猫上网，一定要有一个友好的用户界面。假设程序已经与 FTP

服务器连接上，为了读取版本信息，只要建立一个 CWebVersion 对象实例，同时将 FTP 服务器地址传入，然后用版本文件名作为参数调用

CWebVersion::ReadVersion 即可。ReadVersion 期望读到下面这样一行内容：

4,3,0,0

这是用逗号分隔的四个数字，格式与应用程序 VS_VERSION_INFO

资源中的 FILEVERSION 和 PRODUCTVERSION 版本号相同。ReadVersion 将这个数字读入两个32位的 DWORDs，dwVersionMS

和 dwVersionLS。Windows 使用64位的版本号，所以你可以发布 18,446,744,070,000,000,000 版本。在美国，这是

18 乘以一百万的三次方，而在欧洲这是 18 乘以一百万的五次方。如果每秒钟发布一个新版本，这些版本要八百万个程序员发布 75,000 年。这样的话，我们最好赶快练一下自己的打字速度。

图一是本文的控制台例子程序（cslVerChkApp.exe）运行画面，此程序使用 CWebVersion 通过 FTP 读取版本号。

图一控制台例子程序运行画面

下面我们来看看 CWebVersion 的工作原理。其大多数函数都是自解释的；为了检查系统是否连接，CWebVersion::Online调用了一个WinInet

函数 InternetQueryOption 来获取 INTERNET_OPTION_CONNECTED_STATE。如果返回的状态具备INTERNET_STATE_CONNECTED标志，说明有一个活动的连接。为了访问

Internet 并读取版本文件，CWebVersion 还用到了另外一个定制的C++类：CInternetHandle：

////////////////////////////////////////////////////////////////

// InternetHandle.h

#pragma once

class CInternetHandle {

protected:

HINTERNET m_handle; // underlying handle

public:

CInternetHandle() : m_handle(NULL) { }

CInternetHandle(HINTERNET h) : m_handle(h) { }

~CInternetHandle() { Close(); }

// Close handle and set to NULL so I don''t close again.

void Close() {

if (m_handle) {

InternetCloseHandle(m_handle);

m_handle = NULL;

}

// Assignment from HINTERNET

CInternetHandle& operator= (HINTERNET h)

{

ASSERT(m_handle==NULL); // only initial assignment, not copy

m_handle = h;

return *this;

}

// cast to HINTERNET

operator HINTERNET() {

return m_handle;

}

};

这个类主要是封装 HINTERNET。其作用是为了方便进行错误处理。如果某个WinInet 函数调用失败，调用 GetLastError 会获取失败原因么。但 CloseInternetHandle 会清除出错代码，所以，必须在

CloseInternetHandle 之前调用 GetLastError。看看下面的代码就会明白：

////////////////////////////////////////////////////////////////

// 如果没有 CInternetHandle 类。代码可能会是下面这个样子。

// 必须在几个地方调用 GetLastError ，否则CloseInternetHandle 会

// 清除出错代码.

DWORD err;

HINTERNET h = InternetOpen(...);

if (h!=NULL) {

HINTERNET hftp = InternetConnect(..,INTERNET_SERVICE_FTP,..);

if (hftp!=NULL) {

HINTERNET hftpfile = FtpOpenFile(...);

if (hftpfile!=NULL) {

InternetReadFile(...);

if (/* success */) {

// do something

} else {

err = GetLastError();

}

InternetCloseHandle(hftpfile);

} else {

err = GetLastError();

}

InternetCloseHandle(hftp);

} else {

err = GetLastError();

}

InternetCloseHandle(h);

} else {

err = GetLastError();

}

有了 CInternetHandle 类，一切都便得简单明了；ReadVersion

只需在最后检查出错情况。当控制流离开函数时，C++会自动关闭所有的 CInternetHandles。

MFC 程序员可能会问，MFC 都已经具备了 WinInet 封装类，为什么不用现成的东东，而要自己再做一个

CInternetHandle，原因很简单：为了使用区区几行代码而加载整个 MFC 是非常浪费资源的。谁都知道，代码越少越好。再者，不让 CWebVersion 依赖于 MFC 是明智之举。非 MFC 应用也能使用 CWebVersion

岂不是更好！不用担心用户是否加载了最新的DLLs。开发基于Web的应用尤其如此。

图二更新程序版本的对话框

为了进一步示范 CWebVersion 的使用，我写了一个对话框程序，如图二所示，每次启动程序时，都会对版本进行检查，读取新版本数据是在

InitInstance()函数中进行的：

// 从 Web 读取当前版本号

if (CWebVersion::Online()) {

CWebVersion ver(_T("pub.chinafsdu.net"));

if (ver.ReadVersion(_T("version.txt"),_T("pub"),_T("pub")))

m_dwNewVersion = ver.dwVersionMS;

}

将读取的版本号存储在 m_dwNewVersion 数据成员中，这里例子程序使用在32位的版本号。接着在对话框的 OnInitDialog()

例程中对版本号进行比较，当前的版本号存储在程序的 VS_VERSION_INFO

资源中，这个信息在编译程序时就已经产生了，获取它很容易，参见另外一个C++类：CMyVersionInfo。通过比较：

// 比较当前的程序版本与最新的程序版本

if (App.m_dwNewVersion && vi.dwProductVersionMS 如果Web版本较新，则对话框显示一个“更新版本 XXX”链接(如图二所示)，否则隐藏链接，什么也不显示。在程序启动时用FTP读取10个字节的文件应该是很快的，但实际情况往往与想象的并不一样，对话框的显示总是会有一个延时，延时的长短要看FTP服务器的位置以及繁忙状态。因此，要想用户界面的响应速度够快，可以考虑在单独的线程进行文件的下载。