1 JACOB

1.1 概述

jacob（java com bridge，java com桥）分为两个部分，jacob.jar,jacob.dll，使用时两个东西的版本要一致，而且还分32位和64位，它的位数和jdk的位数有关，与操作系统的位数无关。它的原理是通过java的jni功能，调用系统组件dll，通过这个com桥来操作com组件（windows的一种软件编程技术）

如果可以在 Java 中调用 COM 组件，就可以充分利用 Java 技能和现有的成熟 COM 工具包，大大简化应用开发的过程。
COM 组件提供了一种与其他语言的互操作方式，叫做自动化（Automation）。
现有的 Java COM 互操作的解决方案有很多种，由于设计目的的不同，在性能、易用性等方面都有很大的区别。本文介绍的 JACOB 开源项目，致力于简化 Java 操作 COM 组件，提供了一个虚拟机独立的自动化服务器实现，由于其通用性设计，您可以非常简单地完成对现有应用的集成。

1.2 JACOB 项目的由来

首先，我们将了解 JACOB 项目的基本情况，探讨在什么样的情况下选择它来完成任务调用 COM 中暴露出来的方法，主要有两种机制：早期绑定和晚期绑定。

• 早期绑定
  早期绑定显式的声明对象、数据类型等，编译器获取了足够的信息在编译期进行链接和优化，这样通常可以获得更好的性能，通过这种机制实现 Bridge 调用可以参考 IBM 的 RJCB 项目，它提供了一套高性能的解决方案。当然需要了解更多 COM 组件的细节，虽然框架完成了大部分的生成 Bridge 代码的工作，但是总体来说，编码工作量还是偏大，编码难度也比较高，而且 RJCB 仅支持那些提供早期绑定的 vtable 接口的 COM API
• 晚期绑定
  晚期绑定方式是通过 IDispatch接口来实现，类似 Java 的反射机制，可以按照名称或者 ID 进行方法调用，这种设计主要目的是支持脚本语言操作 COM，因为脚本是解释执行的，通常都不支持指针也就没有 C++ 中的 vtable 机制，无法实现早期绑定。这种方式的缺点是在一定程度上性能较差，由于是在运行时按照名字或者 ID 进行对象的调用，只有运行时才确切知道调用的是哪个对象，哪个方法，这样必然带来一定的开销和延迟。但是这种方式的优点也是非常明显的，简单、灵活，可以不必关注动态链接库的细节，可以非常快地完成代码开发工作。

JACOB 开源项目提供的是一个 JVM独立的自动化服务器实现，其核心是基于 JNI 技术实现的 Variant, Dispatch 等接口，设计参考了 Microsoft VJ++内置的通用自动化服务器，但是 Microsoft 的实现仅仅支持自身的 JVM。通过 JACOB，可以方便地在 Java 语言中进行晚期绑定方式的调用。
下图是一个对 JACOB 结构的简单说明

在这里插入图片描述

1.3 JACOB操作邮箱

1.3.1 使用背景

某开发团队要利用一个订单处理的工作流系统，对现有的业务方式进行集成、优化。原有的业务处理方式是基于邮件系统的半人工方式，业务人员将订单以邮件方式发送到特定邮箱，然后后续人员处理订单。
现在设计的集成方式是，处理引擎定期轮询订单邮箱，以特定命名规则区分订单，获取存储在邮件正文和命名属性中的订单信息，将订单放入处理队列进行进一步处理，最后将源邮件标记状态并移出订单目录。
开发工作中遇到的难点是，应用的核心部分是基于 Java 实现的工作流应用，而客户使用 Outlook/Exchange 邮件系统，开发团队并没有足够的人力和时间去为其开发纯 Java 实现的客户端，Java 程序也难以操作邮件命名属性的信息。
下面我们就尝试利用 JACOB 和一些成熟的 COM 组件来解决这个问题。

1.3.2 配置您的开发和运行环境

我们的例子是一个基于 Eclipse 的 Java 工程。首先，使用 JACOB 来搭桥，下载最新的 JACOB 相关类库，包括Jacob.jar和 Jacob.dll，将jar 文件添加到Eclipse工程的构建路径。

在这里插入图片描述

在这里插入图片描述

1.3.3 实现业务逻辑

完成上面的准备工作后，就开始实现具体的业务逻辑了。
首先，要获取邮件您需要登录到指定邮箱，Outlook profile 中存储了您的邮箱的基本信息，下面的例子是如何登录特定 profile：

public void logon(String profile, String password) { 
    // 登录到指定 Profile，并获取一个会话
    ActiveXComponent session = new ActiveXComponent("Redemption.RDOSession"); 
    Dispatch.call(session, "Logon", profile, password, false, true); 
}

现在已经能够访问用户邮箱，我们要做的是获取收件箱中的标题以ORDER NO:开始的邮件，把信息存储到订单管理系统之中

Dispatch items = Dispatch.call(folder, "Items").toDispatch(); 
int count = Dispatch.call(items, "Count").getInt(); 
// 轮询所有邮件，并检查符合标准的邮件
for (int x = 1; x <= count; x++) { 
    Dispatch item = Dispatch.call(items, "_Item", new Integer(x)).toDispatch(); 
    ActiveXComponent sMail = new ActiveXComponent("Redemption.SafeMailItem"); 
    sMail.setProperty("Item", item); 
    Variant vSubj = Dispatch.get(sMail, "Subject"); 
    String subj = vSubj.getString(); 
    if (subj.startWith(“ORDER NO”)){ 
        // 将获取的定单信息存储到订单处理队列之中
        OrderMail mail = new OrderMail(item); 
        mail.persistToOrderQueue(); 
    } 
}

获取订单之后，将订单标记为已处理，这里我们通过操作命名属性的方式来标记状态，然后移动邮件到放置已处理邮件的目录：

// 获取命名属性的 ID 
ActiveXComponent utils = new ActiveXComponent("Redemption.MAPIUtils"); 
Variant namedPropID = Dispatch.call(utils, "GetIDsFromNames", orderMail, 
    GUID_OF_USERPROP, ORDER_STATE_DONE, true ); 
// 将邮件标记处理状态
ActiveXComponent utils = new ActiveXComponent("Redemption.MAPIUtils"); 
Dispatch.call(utils, "HrSetOneProp", orderMail, namedPropID, "Done", true ); 
// 将处理过的邮件移出现在的目录
Dispatch.call(orderMail, "Move",  folderForProcessedMsg);

可以看到，无需关注太多类库的细节，只需要知道要使用的对象名称、方法和输入变量，就可以轻松的调用 COM 组件。JACOB 的准备工作非常简单，并且只需要非常有限的编码，就完成了现有业务系统和新应用的无缝集成。

1.4 JACOB操作word

现在的项目中操作word文件比较多，word文件的加密解密，转换为各种格式，插入图片，添加水印、html转word等等各种东西，大家也都知道，java语言是不能直接操作word或者excel的，不像C#，可以调用VBA的类来直接操作office

目前java也有一些操作office的开源框架，比如poi，这个没怎么研究过，估摸着它是通过解析office的xml文档模型来操作office的，因为office03和office07以及以上的文档模型结构不太一样，导致了poi处理不同版本office时要用不同的类，用的最多的是jacob，它对office03和office07的操作基本一致，高版本的还没有试过

1.4.1 环境配置

1、在工程中引入jar包
2、将dll文件放在jdk的path目录下面，通过System.getProperty("java.library.path");可以看到path路径，或者直接放到jdk/bin、jre/bin、system32/system64下面都放一份，总能找得到，版本要急着对应好。
3、附件为使用的组件，配合jdk使用。

1.4.2 常用类以及方法

常用类以及方法：

• ComThread：com组件管理，用来初始化com线程，释放线程，所以会在操作office之前使用，操作完成再使用。
• ActiveXComponent：创建office的一个应用，比如操作的是word还是excel
• Dispatch：调度处理类，封装了一些操作来操作office，里面所有的可操作对象基本都是这种类型，所以jacob是一种链式操作模式，就像StringBuilder对象，调用append()方法之后返回的还是StringBuilder对象
• Variant：封装参数数据类型，因为操作office是的一些方法参数，可能是字符串类型，可能是数字类型，虽然都是1，但是不能通过，可以通过Variant来进行转换通用的参数类型，new Variant(1),new Variant("1"),

Dispatch的几种静态方法：(这些方法就是要用来操作office的)

• call( )方法：调用COM对象的方法，返回Variant类型值。
• invoke( )方法：和call方法作用相同，但是不返回值。
• get( )方法：获取COM对象属性，返回variant类型值。
• put( )方法：设置COM对象属性。

以上方法中有的有很多重载方法，调用不同的方法时需要放置不同的参数，至于哪些参数代表什么意思，具体放什么值，就需要参考vba代码了，仅靠jacob是无法进行变成的。

Variant对象的toDispatch()方法：将以上方法返回的Variant类型转换为Dispatch，进行下一次链式操作。

1.4.3 初始化com线程

使用jacob之前使用下面的语句来初始化com线程，大概意思是打开冰箱门，准备放大象。。。

ComThread.InitSTA();  

使用完成后使用下面的语句来关闭现场,大概意思是关上冰箱门。。。

ComThread.Release();  

1.4.4 创建应用程序对象

创建应用程序对象，设置参数，得到文档集合
操作一个文档之前，我们必须要创建一个应用对应，比如是word还是excel，设置一些文档应用的参数，得到文档集合对象，（大家应该知道word是Documents，excel是WorkBooks）

ActiveXComponent wordApp = new ActiveXComponent("Word.Application");//word  
ActiveXComponent wordApp = new ActiveXComponent("Excel.Application");//excel  
wordApp.setProperty("Visible", new Variant(false));//设置应用操作是文档不在明面上显示，只在后台静默处理。  

这个操作就是模仿vba的写法，Application.Visible = False；vba代码中的对application的设置这里都可以用

Dispatch document = wordApp.getProperty("Documents").toDispatch();  

1.4.5 打开文档

有了文档对象集合，我们就可以来操作文档了，链式操作就此开始：
call方法，调用open方法，传递一个参数，返回一个我们的word文档对象，

Dispatch doc = Dispatch.call(document, "Open",new Variant("D:\\my.doc")).toDispatch();  

1.4.6 保存文档

Dispatch.call(doc, "Save");  

doc是我们打开的文档的对象

1.4.7 退出wordapplication

参数有很多个，我们一个都不传，执行完后winword进程关闭

wordApp.invoke("Quit", new Variant[] {});  

1.4.8 释放com线程

ComThread.Release();