TeamDev Support : Document List - ComfyJ

ComfyJ Installation Instructions

roman.kazmin@teamdev.com — Tue, 23 Dec 2008 14:45:21 GMT

Installing Library JAR File

ComfyJ JAR files should be on the program's class path. The library files can also be placed on the boot class path or in the extension directory of Java runtime, but this is not required.

Installing License File

The ComfyJ library requires valid license file(s): comfyj.lic and jniwrap.lic.
Visit TeamDev site (http://www.teamdev.com) to purchase the product or get an evaluation license.

License file(s) has to be installed in the same directory as the native code library or in the META-INF subfolder of any jar library from the application's classpath.

Warning: Do NOT rename the license file or it will not be recognized.

Mapping COM Types to ComfyJ Classes

roman.kazmin@teamdev.com — Thu, 29 Jan 2009 16:08:17 GMT

Please find below the mappings table for most of the existing COM data types.

COM Type	ComfyJ Class
ADVF	AdviceFlags
ARRAYDESC	ArrayDesc
BINDPTR	BindPtr
BIND_FLAGS	BindFlags
BIND_OPTS	BindOptions
BOOL	VariantBool
BSTR	BStr
CALLCONV	CallConv
CLSCTX	ClsCtx
CLSID	CLSID
CONNECTDATA	ConnectData
CONTROLINFO	ControlInfo
CY	CY
DATADIR	DataDir
DATE	Date
DECIMAL	Decimal
DESCKIND	DescKind
DISPID	DispID
DISPPARAMS	DispParams
DOCHOSTUIDBLCLK	DocHostUIDblClk
DOCHOSTUIFLAG	DocHostUIFlag
DOCHOSTUIINFO	DocHostUIInfo
DOCMISC	DocMisc
DROPEFFECT	DropEffect
DVASPECT	DvAspect
DVASPECTINFO	DvAspectInfo
DVTARGETDEVICE	DvTargetDevic
ELEMDESC	ElemDesc
EXCEPINFO	ExcepInfo
FORMATETC	FormatEtc
FUNCDESC	FuncDesc
FUNCFLAGS	FuncFlags
FUNCKIND	FuncKind
GUID	GUID
HREFTYPE	HRefType
IDLDESC	IDLDesc
IID	IID
IMPLTYPEFLAGS	ImplTypeFlags
INVOKEKIND	InvokeKind
KEYMODIFIERS	KeyModifiers
LCID	LocaleID
LOCKTYPE	LockType
LONG_PTR	LongPtr
MEMBERID	MemberID
OBJECTDESCRIPTOR	ObjectDescriptor
OLECLOSE	OleClose
OLECMD	OleCmd
OLECMDEXECOPT	OleCmdExecOpt
OLECMDF	OleCmdFlags
OLECMDID	OleCmdID
OLECMDTEXT	OleCmdText
OLECMDTEXTF	OleCmdTextFlags
OLECONTF	OleContf
OLECREATE	OleCreate
OLEGETMONIKER	OleGetMoniker
OLEINPLACEFRAMEINFO	OleInplaceFrameInfo
OLELINKBIND	OleLinkBind
OLEMENUGROUPWIDTHS	OleMenuGroupWidths
OLEMISC	OleMisc
OLERENDER	OleRender
OLEUIBUSY	OleUIBusy
OLEUICHANGEICON	OleUIChangeIcon
OLEUICHANGESOURCE	OleUIChangeSource
OLEUICONVERT	OleUIConvert
OLEUIEDITLINKS	OleUIEditLinks
OLEUIINSERTOBJECT	OleUIInsertObject
OLEUIPASTEENTRY	OleUIPasteEntry
OLEUIPASTEFLAG	OleUIPasteFlag
OLEUIPASTESPECIAL	OleUIPasteSpecial
OLEUPDATE	OleUpdate
OLEVERB	OleVerb
OLEVERBATTRIB	OleVerbAttrib
OLEWHICHMK	OleWhichMk
PARAMDESC	ParamDesc
PARAMDESCEX	ParamDescEx
PARAMFLAGS	ParamFlags
POINTF	PointF
POINTL	PointL
REGCLS	RegCls
REGKIND	RegKind
SAFEARRAY	SafeArray
SAFEARRAYBOUND	SafeArrayBound
SCODE	SCode
SIZEL	Size
STATDATA	StatData
STATFLAG	StatFlag
STATSTG	StatStg
STGC	StgCommit
STGFMT	StgFmt
STGM	StgMode
STGMEDIUM	StgMedium
STGOPTIONS	StgOptions
STREAM_SEEK	StreamSeek
SYSKIND	SysKind
TLIBATTR	TLibAttr
TYMED	TyMed
TYPEATTR	TypeAttr
TYPEDESC	TypeDesc
TYPEFLAGS	TypeFlags
TYPEKIND	TypeKind
USERCLASSTYPE	UserClassType
VARDESC	VarDesc
VARFLAGS	VarFlags
VARIANT	Variant
VARIANTARG	VariantArg
VARIANT_BOOL	VariantBool
VARKIND	VarKind
VARTYPE	VarType
_RemotableHandle	_RemotableHandle
__MIDL_IWinTypes_0009	__MIDL_IWinTypes_0009

ComfyJ Technical Questions and Answers

forum-admin@teamdev.com — Mon, 22 Dec 2008 18:48:46 GMT

Get answers to most commonly asked technical questions about ComfyJ. If you can’t find the answer here, please send us your question using the support request form , and we will add it to this FAQ after answering you.

1. Why is the "IllegalStateException: The ClassName object is null (not initialized)." exception thrown on attempt to invoke methods of the ClassName object?
Answer: This exception is thrown if a COM object was not initialized before its methods are invoked. A COM object is not initialized when there is no valid COM object that corresponds to its Java wrapper. COM objects are usually initialized by the appropriate CoClasses, ComFunctions.coCreateInstance() method or by other COM objects. For more details, please refer to ComfyJ Programmer's Guide.

2. A COM object method throws ComException with the error code like 0x800401f0. How can I get the error description?
Answer: ComfyJ provides messages for all standard HResult error codes. If ComException is thrown without any message, but with the error code, then this error is COM object specific and you should refer to the appropriate documentation for the error's details.

3. Is it necessary to call the .addRef() method of a COM object?
Answer: No, it is not. This method is called automatically when a COM object is created.

4. Is it necessary to release a COM object using the .release() method?
Answer: No, it is not. By default, this method is called automatically by ComfyJ.

5. What does the AutoDelete property of the IUknown class mean?
Answer: This property instructs ComfyJ's NativeResourceCollector whether to release the COM object automatically or not. By default, this property is set to true. When this property is set to false, the .release() method should be called.

6. How to query a necessary COM interface from a COM object?
Answer: A COM interface can be queried using the .queryInterface() method.

For example:

  IOleObjectImpl oleObject = new IOleObjectImpl();
  comObject.queryInterface(oleObject.getIID(), oleObject);

The alternative way is:

IOleObjectImpl oleObject = new IOleObjectImpl(comObject);

7. Does ComfyJ also work from an applet? [new]
Answer: Yes, it does work from an applet.

8. Can I embed visual ActiveX Controls (OleContainer) into JInternalFrame? [new]
Answer: OleContainer is a "heavyweight" component and the JInternalFrame is a "lightweight" one. It is not recommended to embed "heavyweight" components into "lightweight" ones.

See http://java.sun.com/products/jfc/tsc/articles/mixing/index.html for more information. It's better to use one of the "heavyweight" components instead of the JInternalFrame.

9. Why do I get the E_UNEXPECTED exception while trying to register an event handler for an ActiveX component? [new]
Answer: If you use an inner class as an event handler, make sure it is static. In other case, please compare your code with the one from ComfyJ Programmer's Guide.

10. Why do I get the CONNECT_E_ADVISELIMIT exception while trying to register an event handler for an ActiveX component? [new]
Answer: You need to register the event handler interface and the IDispatch interface in the instance of the IClassFactoryServer class with the registerInterface() method. Both the event handler interface and the IDispatch interface should be registered using a new IDispatchVTBL object like this:

IClassFactoryServer server = new IClassFactoryServer(MyEventHandler.class);
server.registerInterface(IDispatch.class, new IDispatchVTBL(server));
server.registerInterface(MyEventHandler.class, new IDispatchVTBL(server));