Jacob是一种Java库，它允许Java程序与COM组件进行交互，从而在Java中调用Windows的ActiveX组件。这种能力使得Java应用能够利用大量的Windows原生应用程序接口(API)，如Microsoft Office套件(Word, Excel, PowerPoint)、Internet Explorer、Outlook等。本文将深入探讨Jacob的基础语法，帮助初学者快速上手。
### 构建ActiveX组件实例
Jacob的核心功能之一是创建ActiveX组件的实例。这是通过`ActiveXComponent`类实现的，它需要一个字符串参数，这个参数对应于要调用的ActiveX控件。例如，如果你想操作Excel，可以这样创建：
```java
ActiveXComponent ax = new ActiveXComponent("Excel.Application");
```
下表列出了部分常用的ActiveX控件名称及其对应的字符串标识符：
| MS控件名 | a1的值 |
|------------------|------------------------------|
| InternetExplorer | InternetExplorer.Application |
| Excel | Excel.Application |
| Word | Word.Application |
| Powerpoint | Powerpoint.Application |
| vb/javaScript | ScriptControl |
| windowsmediaPlayer | WMPlayer.OCX |
| Outlook | Outlook.Application |
| Visio | Visio.Application |
| DAO | DAO.PrivateDBEngine.35 |
| MultiFace | MultiFace.Face |
### 获取Dispatch对象
一旦ActiveX组件实例被创建，接下来需要通过`getObject()`方法来获取一个`Dispatch`对象。`Dispatch`对象提供了与ActiveX控件交互的手段，允许你调用其方法或访问其属性。例如：
```java
Dispatch ds = ax.getObject().toDispatch();
```
### 访问属性与方法
在获得了`Dispatch`对象后，你可以使用`Dispatch.get()`方法来获取ActiveX对象的属性，或者使用`Dispatch.invoke()`来调用其方法。例如，要获取Excel版本信息，可以这样做：
```java
System.out.println("version=" + xl.getProperty("Version"));
```
或者使用`Dispatch.get()`：
```java
System.out.println("version=" + Dispatch.get(xl, "Version"));
```
### 设置属性
要修改ActiveX对象的属性，可以使用`Dispatch.put()`方法。例如，让Excel可见：
```java
Dispatch.put(xl, "Visible", new Variant(true));
```
### 调用方法
`Dispatch.invoke()`方法也可以用于调用ActiveX对象的方法。它接受多个参数，包括要调用的方法名、调用类型（`Dispatch.Invoke`或`Dispatch.Put`）、输入参数以及一个可选的错误参数数组。例如，添加一个新的工作簿：
```java
Dispatch workbooks = xl.getProperty("Workbooks").toDispatch();
Dispatch workbook = Dispatch.get(workbooks, "Add").toDispatch();
```
### 实例代码分析
下面是一个更具体的例子，演示如何使用Jacob打开Excel并进行基本操作：
```java
public class ExcelDispatchTest {
public static void main(String[] args) {
ComThread.InitSTA();
ActiveXComponent xl = new ActiveXComponent("Excel.Application");
try {
System.out.println("version=" + xl.getProperty("Version"));
System.out.println("version=" + Dispatch.get(xl, "Version"));
Dispatch.put(xl, "Visible", new Variant(true));
Dispatch workbooks = xl.getProperty("Workbooks").toDispatch();
Dispatch workbook = Dispatch.get(workbooks, "Add").toDispatch();
Dispatch sheet = Dispatch.get(workbook, "ActiveSheet").toDispatch();
// 进行更多操作...
} catch (Exception e) {
e.printStackTrace();
}
}
}
```
这段代码展示了如何初始化Excel、显示其版本、使Excel窗口可见、添加新的工作簿以及获取活动工作表。通过这些基础操作，你可以进一步探索和开发复杂的自动化脚本，以满足特定的业务需求。
