3.2. Использование com-объектов
Использование в среде Visual J++ созданного в ней же объекта не сложнее, чем любого другого COM-объекта, и строится на разборе библиотеки типов. Обратимся к примеру. Командой File•New Project•New•Applications доберемся до мастеров создания оконных приложений. Нас интересует Windows Application. После создания такого проекта в форму окна приложения помещаются две кнопки: «Запустить Word» и «Закончить сеанс Windows». Как вы, наверное, уже догадались, в обработчиках нажатий этих кнопок и будут вызываться методы объекта. Но об этом чуть позже.
Главный вопрос: как обратиться к COM-объекту? Для этого мы должны создать «обертки», которые позволят обратиться из класса Java в сущность, нейтральную к языку программирования. И для этого в среде разработчика в меню Project есть специальная команда Add COM Wrapper. Вызовем ее и увидим, что в списке компонент COM есть и творение наших рук. Нужно только отметить его галочкой (рис. 6).
Рис. 3.6.
В результате будет сгенерирован новый пакет com_object, названный так по имени проекта, в котором COM-объект создавался. В этом пакете есть пара новых файлов. Вот первый из них (класс CoMirPK), являющийся шлюзом к двоичному коду компоненты:
package com_object;
import com.ms.com.*;
import com.ms.com.IUnknown;
import com.ms.com.Variant;
/** @com.class(classid=C0038C80-C7ED-4D8E-9E18-C90AA7EF1C67,
DynamicCasts)
@com.interface(iid=1127D7AF-52C0-4547-8C7D-4E492C5130D2,
thread=AUTO, type=DISPATCH) */
public class CoMirPK implements IUnknown,com.ms.com.
NoAutoScripting,com_object.CoMirPK_Dispatch
{
/** @com.method(dispid=100, type=METHOD, name=”wait”,
returntype=VOID)
@com.parameters([in,out,elementType=VARIANT,type=PTR]
Parameter0, [in,out,elementType=VARIANT,type=PTR]
Parameter1, [type=VARIANT] return) */
public native Variant wait(Variant Parameter0, Variant
Parameter1);
/** @com.method(dispid=101, type=METHOD, name=”runWord”,
returntype=VOID)
@com.parameters([in,type=STRING] Parameter0) */
public native void runWord(String Parameter0);
// hashCode UNMAPPABLE: Name is a keyword or conflicts
with another member.
// public native int hashCode();
// toString UNMAPPABLE: Name is a keyword or conflicts
with another member.
// public native String toString();
// equals UNMAPPABLE: Name is a keyword or conflicts
with another member.
// public native boolean equals(Object Parameter0);
/** @com.method(dispid=105, type=METHOD, name=”userLogOff”,
returntype=VOID)
@com.parameters() */
public native void userLogOff();
// notify UNMAPPABLE: Name is a keyword or conflicts
with another member.
// public native void notify();
// getClass UNMAPPABLE: Name is a keyword or conflicts
with another member.
// public native Object getClass();
// notifyAll UNMAPPABLE: Name is a keyword or conflicts
with another member.
// public native void notifyAll();
public static final com.ms.com._Guid iid = new com.ms.com.
_Guid((int)0x1127d7af, (short)0x52c0, (short)0x4547,
(byte)0x8c, (byte)0x7d, (byte)0x4e, (byte)0x49,
(byte)0x2c, (byte)0x51, (byte)0x30, (byte)0xd2);
public static final com.ms.com._Guid clsid = new com.ms.com.
_Guid((int)0xc0038c80, (short)0xc7ed, (short)0x4d8e,
(byte)0x9e, (byte)0x18, (byte)0xc9, (byte)0xa,
(byte)0xa7, (byte)0xef, (byte)0x1c, (byte)0x67);
}
Второй интерфейс, CoMirPK_Dispatch, нужен для установки связи посредством автоматизации OLE и поддерживает вызов методов компоненты с помощью интерфейса IDispatch, за что и получил свое имя:
package com_object;
import com.ms.com.*;
import com.ms.com.IUnknown;
import com.ms.com.Variant;
// Dispatch-only interface CoMirPK_Dispatch
/** @com.interface(iid=1127D7AF-52C0-4547-8C7D-4E492C5130D2,
thread=AUTO, type=DISPATCH) */
public interface CoMirPK_Dispatch extends IUnknown
{
/** @com.method(dispid=100, type=METHOD, name=”wait”,
returntype=VOID)
@com.parameters([in,out,elementType=VARIANT,type=PTR]
Parameter0, [in,out,elementType=VARIANT,type=PTR]
Parameter1, [type=VARIANT] return) */
public Variant wait(Variant Parameter0, Variant
Parameter1);
/** @com.method(dispid=101, type=METHOD, name=”runWord”,
returntype=VOID)
@com.parameters([in,type=STRING] Parameter0) */
public void runWord(String Parameter0);
/** @com.method(dispid=105, type=METHOD, name=”userLogOff”,
returntype=VOID)
@com.parameters() */
public void userLogOff();
public static final com.ms.com._Guid iid = new com.ms.com.
_Guid((int)0x1127d7af, (short)0x52c0, (short)0x4547,
(byte)0x8c, (byte)0x7d, (byte)0x4e, (byte)0x49,
(byte)0x2c, (byte)0x51, (byte)0x30, (byte)0xd2);
}
Директивы, начинающиеся с @com, описывают мета-информацию о компоненте, взятую из библиотеки типов: числовой идентификатор метода, его параметры, имя и т. д.
Программа, которая использует COM-компоненту, обязательно должна содержать строку импорта всех классов пакета com_object:
import com_object.*;
Одно из полей класса программы описывает ссылку на интерфейс автоматизации:
. . .
CoMirPK_Dispatch component;
. . .
а значение присваивается ей внутри конструктора класса:
. . .
// TODO: Add any constructor code after initForm call
component = new CoMirPK();
. . .
Теперь перейдем к обработчикам, из которых вызываются методы COM-объекта. Тот, что вызывается в ответ на нажатие кнопки «Запустить Word», выглядит следующим образом:
private void button1_click(Object source, Event e)
{
// Запустить Word
component.runWord(null);
}
Приведем исходный текст обработчика нажатия кнопки «Закончить сеанс Windows»:
private void button2_click(Object source, Event e)
{
// Закончить сеанс Windows
component.userLogOff();
}
Попробуйте готовую тестовую программу в деле. Заодно испытайте компоненту в других средах, например, в Borland C++Builder.