一、介绍

   Jacob 是Java-COM Bridge的缩写,它在Java与微软的COM组件之间构建一座桥梁。使用Jacob自带的DLL动态链接库,并通过JNI的方式实现了在Java平台上对COM程序的调用。

二、安装和配置

   Jacob是一个开源软件,它的官方站点是:http://danadler.com/jacob/ 大家可以到上面下载源代码研究,也可以直接下载编译后的二进制文件。

  • 下载包jacob_x.x.zip,解压后有几个文件:jacob.jar、jacob.dll

  • 把jacob.dll拷贝到%JAVA_HOME%\jre\bin目录下,%JAVA_HOME%就是JDK的安装目录或是C:\Windows\System32下面

  • 接着直接在java IDE中引用jacob.jar就可以使用了

三、jacob.jar的结构

jacob包括两个部分:

  • com.jacob.activeX: ActiveXComponent类

  • com.jacob.com: 其它类和元素

四、Jacob类

Jacob的结构很简单,包含以下几个类:

  • ActiveXComponent Class:封装了Dispatch对象,用于创建一个封装了COM组件对象的Java Object

  • Dispatch Class:用于指向封装后的MS数据结构。常用的方法有call,subcall,get,invoke…后面会介绍使用方法。

  • Variant Class:用于映射COM的Variant数据类型。提供Java和COM的数据交换。

  • ComException Class:异常类

五、Jacob方法

用于访问COM/DLL对象的方法,读取、修改COM/DLL对象的属性。

  • call method:属于Dispatch类。用于访问COM/DLL对象的方法。方法进行了重载,方便不同场合调用。返回一个Variant类型的值。

  • callSub method:使用方法和call一样,不过它不返回值。

  • get method:读取COM对象的属性值,返回一个Variant类型值。

  • put method:设置COM对象的属性值。

  • invoke method:call的另一种用法,更复杂一些。

  • invokesub method:subcall的另一种用法

  • getProperty method:属于ActiveXComponent类,读取属性值,返回一个Variant类型值。

  • setProperty method:属于ActiveXComponent类,设置属性值。

六、实例

package cn.jcl.test;

import com.jacob.activeX.ActiveXComponent;

import com.jacob.com.ComThread;

import com.jacob.com.Dispatch;

import com.jacob.com.Variant;

public class exportPicToWord {

   ActiveXComponent msWordApp = null;

   Dispatch document = null;    

   public exportPicToWord() {

       if (msWordApp == null) {

           ComThread.InitSTA();

           msWordApp = new ActiveXComponent(“Word.Application”);

       }

   }

   //TODO 设置文档是否前台打开word

   public void setVisible(boolean visible) {

       msWordApp.setProperty(“Visible”, new Variant(visible));

       // 与上一句作用相同

       // Dispatch.put(msWordApp, “Visible”, new Variant(visible));

   }

   //TODO 创建一个新的文档

   public void createNewDocument() {

       // document表示word的所有文档窗口,(word是多文档窗口应用程序)

       Dispatch documents = Dispatch.get(msWordApp, “Documents”).toDispatch();

       // 调用add方法来创建一个新的文档

       document = Dispatch.call(documents, “Add”).toDispatch();

   }

   //TODO 向文档中插入格式化文档

   public void insertFormatStr() {

Dispatch selection = Dispatch.get(msWordApp, “Selection”).toDispatch();    

       // 得到段落格式对象

       Dispatch paragraphFormat = Dispatch.get(selection, “ParagraphFormat”).toDispatch();

       // 设置正文的对齐方式:1.置中,2.靠右,3.靠左

       Dispatch.put(paragraphFormat, “Alignment”, “1”);

       // 得到字体对象

       Dispatch font = Dispatch.get(selection, “Font”).toDispatch();

       // 设置黑体

       Dispatch.put(font, “Bold”, new Variant(true));

       // 字型颜色(1,0,0,0=>红色  1,1,0,0=>棕色)

       Dispatch.put(font, “Color”, “1,0,0,0”);

       // 设置斜体

       Dispatch.put(font, “Italic”, new Variant(true));

       // 设置宋体

       Dispatch.put(font, “Name”, new Variant(“宋体”));

       // 设置大小

       Dispatch.put(font, “Size”, new Variant(12));

       // 写入标题内容

       Dispatch.call(selection, “TypeText”, “标题”);

       // 空一行段落

       Dispatch.call(selection, “TypeParagraph”);

       Dispatch.put(paragraphFormat, “Alignment”, “3”);

       Dispatch.put(font, “Color”, “1,1,0,0”);

       Dispatch.put(selection, “Text”, ”  第一段内容”);

       Dispatch.call(selection,”MoveRight”);

       // 空一行段落

       Dispatch.call(selection, “TypeParagraph”);

       Dispatch.put(selection, “Text”, ”  第二段内容”);

       Dispatch.call(selection,”MoveRight”);

   }

   //TODO 向文档中添加文字.

   public void insertText(String text) {

       // 得到选中的内容,如果创建一个新的文档,因里面没有内容,光标应在开头.

       Dispatch selection = Dispatch.get(msWordApp, “Selection”).toDispatch();

       // 空一行段落

       Dispatch.call(selection, “TypeParagraph”);

       Dispatch font = Dispatch.get(selection, “Font”).toDispatch();

       Dispatch.put(font, “Color”, “0,1,1,0”);

       Dispatch.put(selection, “Text”, text);

       Dispatch.call(selection,”MoveRight”);

   }

   //TODO 向文档中添加表格.

   public void insertTable(int row, int column) {

Dispatch selection = Dispatch.get(msWordApp, “Selection”).toDispatch();

// 空一行段落

       Dispatch.call(selection, “TypeParagraph”);

// 建立表格

       Dispatch tables = Dispatch.get(document, “Tables”).toDispatch();

       // 当前光标位置或者选中的区域

       Dispatch range = Dispatch.get(selection, “Range”).toDispatch();

       Dispatch newTable = Dispatch.call(tables, “Add”, range,  

               new Variant(row), new Variant(column), new Variant(1)) // 设置row,column,表格外框宽度

               .toDispatch();

       Dispatch cols = Dispatch.get(newTable, “Columns”).toDispatch(); // 此表的所有列  

       int colCount = Dispatch.get(cols, “Count”).toInt(); // 一共有多少列 实际上这个数==column

       for (int i = 1; i <= colCount; i++) { // 循环取出每一列  

           Dispatch col = Dispatch.call(cols, “Item”, new Variant(i)).toDispatch();  

           Dispatch cells = Dispatch.get(col, “Cells”).toDispatch(); // 当前列中单元格  

           int cellCount = Dispatch.get(cells, “Count”).toInt(); // 当前列中单元格数 实际上这个数等于row  

           for (int j = 1; j <= cellCount; j++) { // 每一列中的单元格数

putTxtToCell(newTable, j, i, “第” + j + “行,第” + i + “列”);// 与上面四句的作用相同

           }

       }

       Dispatch.call(selection,”MoveRight”);

       Dispatch.call(selection, “TypeParagraph”);

       Dispatch.call(selection,”MoveRight”);

   }

   //TODO 在指定的单元格里填写数据

   public void putTxtToCell(Dispatch table, int cellRowIdx, int cellColIdx, String txt) {

       Dispatch cell = Dispatch.call(table, “Cell”, new Variant(cellRowIdx),

               new Variant(cellColIdx)).toDispatch();

       Dispatch.call(cell, “Select”);

       Dispatch selection = Dispatch.get(msWordApp, “Selection”).toDispatch(); // 输入内容需要的对象

       Dispatch.put(selection, “Text”, txt);

   }

   //TODO 在指定的单元格里填写数据

   public void putTxtToCell(int tableIndex, int cellRowIdx, int cellColIdx, String txt) {  

       // 所有表格  

       Dispatch tables = Dispatch.get(document, “Tables”).toDispatch();  

       // 要填充的表格  

       Dispatch table = Dispatch.call(tables, “Item”, new Variant(tableIndex)).toDispatch();  

       Dispatch cell = Dispatch.call(table, “Cell”, new Variant(cellRowIdx),  

               new Variant(cellColIdx)).toDispatch();  

       Dispatch.call(cell, “Select”);  

       Dispatch selection = Dispatch.get(msWordApp, “Selection”).toDispatch(); // 输入内容需要的对象  

       Dispatch.put(selection, “Text”, txt);  

   }

   /**

    * 设置图片水印

    * @param waterMarkPath 水印路径

    */

   public void setWaterMark(String waterMarkPath) {

       Dispatch activeWindow = Dispatch.get(msWordApp, “ActiveWindow”).toDispatch();

       // 取得活动窗格对象

       Dispatch activePan = Dispatch.get(activeWindow, “ActivePane”).toDispatch();

       // 取得视窗对象

       Dispatch view = Dispatch.get(activePan, “View”).toDispatch();

       // 打开页眉,值为9,页脚为10

       Dispatch.put(view, “SeekView”, new Variant(9));

       Dispatch docSelection = Dispatch.get(activeWindow, “Selection”).toDispatch();

       // 获取页眉和页脚

       Dispatch headfooter = Dispatch.get(docSelection, “HeaderFooter”).toDispatch();

       // 获取水印图形对象

       Dispatch shapes = Dispatch.get(headfooter, “Shapes”).toDispatch();

       // 给文档全部加上水印,设置了水印效果,内容,字体,大小,是否加粗,是否斜体,左边距,上边距。

       // 调用shapes对象的AddPicture方法将全路径为picname的图片插入当前文档

       Dispatch picture = Dispatch.call(shapes, “AddPicture”, waterMarkPath).toDispatch();    

       // 选择当前word文档的水印

       Dispatch.call(picture, “Select”);

       Dispatch.put(picture, “Left”, new Variant(100));

       Dispatch.put(picture, “Top”, new Variant(300));

       Dispatch.put(picture, “Width”, new Variant(100));

       Dispatch.put(picture, “Height”, new Variant(30));        

       // 关闭页眉

       Dispatch.put(view, “SeekView”, new Variant(0));        

   }

   //TODO 向文档中添加图片

   public void insertPic(String jpegFilePath) {

       Dispatch selection = Dispatch.get(msWordApp, “Selection”).toDispatch();

       // 空一行段落

       Dispatch.call(selection, “TypeParagraph”);

       // 得到段落格式对象

       Dispatch paragraphFormat = Dispatch.get(selection, “ParagraphFormat”).toDispatch();

       // 设置正文的对齐方式:1.置中,2.靠右,3.靠左

       Dispatch.put(paragraphFormat, “Alignment”, “1”);        

       Dispatch p_w_picpath = Dispatch.get(selection, “InLineShapes”).toDispatch();

       Dispatch.call(p_w_picpath, “AddPicture”, jpegFilePath);

       Dispatch.call(selection, “MoveRight”);

   }

   public void saveFileAs(String fileName) {

       Dispatch.call(document, “SaveAs”, fileName);

   }

   public void closeDocument() {

       Dispatch.call(document, “Close”, “-1”);

       document = null;

   }

   public void closeWord() {

       Dispatch.call(msWordApp, “Quit”);

       ComThread.Release();

       msWordApp = null;

       document = null;

   }

//TODO 打开一个word文档

   public void openFile(String wordFilePath) {

       Dispatch documents = Dispatch.get(msWordApp, “Documents”).toDispatch();

       document = Dispatch.call(documents, “Open”, wordFilePath, new Variant(true) // 是否进行版本转换        

       , new Variant(false) // 是否是只读        

       ).toDispatch();

   }

   //TODO 读出一个word文档

   public void readWord() {

// 取得word文档的内容

       Dispatch wordContent = Dispatch.get(document, “Content”).toDispatch();

Dispatch paragraphs = Dispatch.get(wordContent, “Paragraphs”).toDispatch(); // 所有段落

int paragraphCount = Dispatch.get(paragraphs, “Count”).toInt(); // 一共的段落数

for(int i =1;i<=paragraphCount;i++) {

Dispatch paragraph = Dispatch.call(paragraphs, “Item”, new Variant(i)).toDispatch();

Dispatch range = Dispatch.call(paragraph,”Range”).toDispatch();

String ptext = Dispatch.get(range, “text”).getString();

System.out.println(ptext);

}

   }

   public void save() {

       Dispatch.call(document, “Save”);

   }    

   public static void main(String[] args) {

       exportPicToWord bean = new exportPicToWord();

       bean.setVisible(false);

       bean.createNewDocument();        

       bean.insertFormatStr();

       bean.insertText(“1、第一次添加的文字!”);

       bean.insertText(“2、第二次添加的文字!”);

       bean.insertTable(3, 5);

       bean.setWaterMark(“c:\\ztest\\pic.jpg”);

       bean.insertPic(“c:\\ztest\\pic2.jpg”);

       bean.insertPic(“c:\\ztest\\pic.jpg”);

       //bean.readWord();

       bean.saveFileAs(“c:\\ztest\\test.doc”);        

       bean.closeDocument();

       bean.closeWord();

   }

}

// JDK1.6使用jacob_1.9没问题

// jacob_1.9.zip