delphi开发activaxform

在C/S开发主导的时代，delphi无疑是windows开发的佼佼者，号称 vb killer，随着 java 和 C#的崛起，互联网开发时代来到，delphi也就失去了往日的光环，虽然现在绝大部分项目工作都是java web项目，但众所周知，web应用，要跟硬件打交道，特别是在浏览器中，单纯的jsp或者html、js，都无法实现，由于企业应用开发少不了要与硬件对接，如考勤机（人脸识别或指纹机）、门禁机、PDA（盘点机）等等，要实现在浏览器中对接硬件，其中一个可行方案就是开发IE浏览器下的OCX插件，OCX的本质就是一个C/S程序，可以访问浏览器所在电脑的资源，最常见的就是dll，通过dll操作与电脑相连的硬件。因为delphi太久没用，而ocx插件的开发也不是经常需要，导致每次开发都要翻看 以前的项目或资料重温技术实现，最近又有一个项目，即使用便携式指纹机实现硬件控制集团查看薪金权限，薪资管理员除了有系统功能操作权限外，还需要到人事部登记指纹，领取指纹机，在操作工资相关功能前，进行指纹认证，认证通过才能正常操作系统，趁着这次项目，把ocx开发过程记录下来，以备以后的不时之需，也供其他同行参考。

闲话少说，直入正题，本文提及的项目，使用delphi 7，下面从新建一个ocx项目开始，一步一步指引如何用delph 7开发一个可以在 IE 上运行的OCX插件；

一、插件ACTIVEX工程

1、启动Delphi，点击菜单 File->New->Other：

2、选择【ActiveX】标签页，选中Active Form图标：

注：本案例中的OCX插件有用户交互界面，所以使用 ActiveX Form。

3、为ActiveX项目和窗体对象命名：

由上图可见，只需修改ActiveX窗体名称、窗体实现代码文件名、项目名即可，其他选项默认。

点击【ok】按钮完成项目创建，完成创建后的界面如下图：

4、保存项目

点击菜单 File->Save All，在弹出的保存框，选择一个保存的目录，然后一直点击【保存】即可：

 至此已完成一个ActiveX项目的创建，可以点击菜单 View->Units浏览delphi创建的相关代码文件：

上面三个文件是delphi自动产生的，其概要作用是：

FingerEnrollFormImpl：Ocx的实现类，编写代码基本都在这个文件中进行；

OfficeOcx：项目组织文件，一般不需要手工修改，由delphi自动维护；

OfficeOcx_TLB：OCX类库代码文件，一般也不需要手工修改；

二、设计OCX接口方法

应用程序（本例即浏览器中的js代码）通过OCX提供的接口与OCX进行交互，Delphi会自动为OCX插件创建接口，我们只需跟进实际业务需要，为OCX接口增加相应的方法即可，如本案例需要添加5个接口方法：

InitDevice：链接指纹机；

SetUser：设置当前登记指纹的用户资料；

GetResult：获取指纹登记结果，0 失败，1成功；

GetFinger1：获取已登记的第一枚指纹数据；（每个用户登记两枚指纹，此款指纹机可以将采集的指纹信息转换成字符串，以便存储在数据库中）

GetFinger2：获取已登记的第二枚指纹数据；

下面介绍如何添加接口；

1、点击菜单 View->Type Libraly：

注：Type Libraly 是Delphi中一个很重要的工具，尤其是开发类库这一类的项目，必不可少。

2、在弹出的对话框中，右键左边目录树中的，然后选择 New->Method：

3、为新的方法命名为：InitDevice，然后为方法添加参数：

4、完成以上操作后，点击菜单栏的刷新图标：

刷新后可查看FingerEnrollFormImpl代码中是否已包含此方法：

注：如找不到FingerEnrollFormImpl文件，可以点击菜单 View->Units进行选择并打开；

5、重复2-4步骤添加其他方法，下面只列出SetUser方法截图说明，其他方法的创建类似，记得每个方法改名和添加完参数后，要点击刷新图标：

5个方法创建后显示如下：

三、为接口方法添加代码

这一部分是常规的Delphi开发，跟OCX插件开发技术本身并没有直接关系，所以如果使用Delphi开发OCX插件，需要有一定的Delphi开发基础，本案例并不会细谈如何使用delphi进行软件开发，接口方法都是根据实际业务需要进行代码开的，这里只展示OCX窗体界面最终的效果：

窗体上有一个特殊的控件：，这个控件在安装了厂家提供的指纹机驱动程序后，可以导入到Delphi中进行使用，所以非常方便，下面顺带介绍一下如何导入操作系统中已安装的控件：

点击菜单 Component->Import ActiveX Control...：

在弹出的对话框中：

点击【Install】后，可以在【ActiveX】中看到这个控件：

已安装的第三方控件，可以像其他常规控件一下，拖拽到窗体上进行开发，非常方便！

四、编译OCX插件

编译之后，在项目代码保存路径下可以看到已生成OCX插件：

把这个OCX文件拷贝到web项目下，就可以发布了。

五、发布并访问OCX插件：

 有了以上的OCX文件，就可以将它拷贝到web项目下，在页面中引入并使用它；

本案例为java web项目，服务器环境是tomcat 6和jdk 1.6；

1、将 FtnFingerEnrollForm.ocx 文件拷贝到web项目某目录下，如：

注：WebRoot 为web 项目代码根目录；

2、新建一个jsp文件 ocxTest.jsp：

注：jsp文件的存放目录没有特别要求，只要tomcat启动后，能通过IE浏览器访问到即可；

jsp文件代码如下：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23

<%@page language="java" cOntentType="text/html;charset=UTF-8"%> <%     String path = request.getContextPath();     String basePath = request.getScheme() + "://"         + request.getServerName() + ":" + request.getServerPort()         + path;  %>

 object标签的 classid 值来自delphi项目的 FtnFingerEnrollForm_TLB.pas：

codebase属性值为 ocx 文件在 web 项目中的 url，#version=1,0,0,0 为 ocx 控件的版本号，可以在delphi中进行查看：

点击菜单 Project->Options...：

3、启动tomcat，在IE中输入jsp文件的url：

可见OCX插件被成功加载了；

在IE中加载ActiveX插件，需要做一系列的配置，如果发布到外网使用，可能还需要证书和签名，由于平常的项目都是企业内部的应用系统，所以一般将IE安全级别降低，并将服务器IP设置为信任站点，具体的配置可以百度一下，网上有很多相关资料。

 六、调用OCX接口方法

接下来演示如何在js中调用OCX接口方法，这点很重要，如果js能调用OCX接口方法，就意味着可以在浏览器中操作电脑上的所有资源，这在纯浏览器环境中是做不到的。

1、修改OCX代码

在修改OCX代码之前，需要修改OCX项目的一些属性，由于HTML页面装载OCX插件时需要指定文件版本号，浏览器第一次加载之后，就算OCX代码被修改了，但是版本号没有改，浏览器是不会加载新的OCX插件的。

在Delphi中打开OCX项目，点击菜单 Project->Options...：

参照以上红框的选项进行设置，点击【OK】按钮，以后修改代码后，点击 Project->Build FtnFingerEnrollForm时，Delphi会自动为版本号加1，可以右键生成的 FtnFingerEnrollForm.ocx文件进行查看：

在Delphi中修改 GetResult 方法，简单的返回一个数值10，返回到jsp的js脚本调用中，如果js能正确显示该数值，证明接口调用成功。

下面是 GetResult 方法代码：

1 2 3 4

function TFingerEnrollForm.GetResult: SYSINT; begin   Result:= 10; end;

2、重新构建OCX项目，点击菜单 Project->Build FtnFingerEnrollForm，将新生成的 FtnFingerEnrollForm.ocx 重新拷到web项目发布目录下，覆盖原来的文件；

3、修改jsp文件，增加一个按钮，点击调用 GetResult 方法，将该方法返回的值 alert 出来：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32

<%@page language="java" cOntentType="text/html;charset=UTF-8"%> <%     String path = request.getContextPath();     String basePath = request.getScheme() + "://"         + request.getServerName() + ":" + request.getServerPort()         + path;  %>     "button" value="test GetResult" Onclick="testGetResult();"/>

 注意 version=1,0,0,4要跟OCX文件的版本号一致；

4、在IE浏览器中验证结果：

 

七、OCX控件最终效果测试

jsp代码：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65

<%@page language="java" cOntentType="text/html;charset=UTF-8"%> <%     String path = request.getContextPath();     String basePath = request.getScheme() + "://"         + request.getServerName() + ":" + request.getServerPort()         + path;  %>     "button" value="连接设备" Onclick="initDevice();"/> 工号："text" value="TX8888" id="userCode"/> 姓名："text" value="张三" id="userName"/> 部门："text" value="人事部" id="deptName"/> 公司："text" value="DMP" id="compName"/> "button" value="写入用户信息" Onclick="setUser();"/> "button" value="读取指纹" Onclick="getFinger();"/> 指纹1： <code>"3"</code> <code>cols=</code><code>"100"</code> <code>id=</code><code>"finger1"</code><code>> 指纹2： <code>"3"</code> <code>cols=</code><code>"100"</code> <code>id=</code><code>"finger2"</code><code>>