Adobe 38043740 - ColdFusion Standard - Mac Development Manual page 1185

DEVELOPING COLDFUSION 9 APPLICATIONS
Using Web Elements and External Objects
Where cf_root is the directory where ColdFusion is installed and directoryName is the name of the directory that
contains the class files. For the OutlookXP example, enter the following line:
jar -uvf C:\CFusion\lib\msapps.jar outlookXP\*.class
7 Update the cf_root /lib/neo-comobjmap.xml file by appending your object definition to the list. The object
definition consists of the following lines:
<var name="progID">
<string>PackageName.mainClass</string>
</var>
Use the following values in these lines:
The COM object ProgID, as displayed in the OLE/COM object viewer.
ProgID
The package name you specified in step 3c.
PackageName
The main class of the COM object. The main class contains the methods you invoke. For many
mainClass
Microsoft applications, this class is Application. In general, the largest class file created in step 4 is the main class.
For example, to add outlookXP to neo-comobjmap.xml, add the lines in bold text above the
<var name="access.application.9">
<string>coldfusion.runtime.com.com2java.access2k.Application</string>
</var>
<var name="outlook.application.10">
<string>outlookXP.Application</string>
</var>
</struct>
In this example, outlook.application.10 is the ProgID of the Outlook COM object, outlookXP is the package name
you specified in step 3c, and Application is the main class of the COM object.
Restart the ColdFusion server: Open the Services control panel, select ColdFusion application server, and click
8
Start.
After you have installed the stubs, you can delete the directory you created in step 2., including all its contents.
9
Using the Application Scope to improve COM performance
The Java call to create a COM object instance can take substantial time. As a result, creating COM objects in
ColdFusion can be substantially slower than in ColdFusion 5. For example, on some systems, creating a Microsoft
Word application object could take over one second using ColdFusion, while on the same system, the overhead of
creating the Word object could be about 200 milliseconds.
Therefore, in ColdFusion, you can improve COM performance substantially if you can share a single COM object in
the Application scope among all pages.
Use this technique only if the following are true:
• The COM object need not be created for every request or session. (For session-specific objects, consider using the
technique described here with the Session scope in place of the Application scope.)
• The COM object is designed for sharing.
Because the object can be accessed from multiple pages and sessions simultaneously, also consider the following
threading and locking issues:
• For best performance, make the object multi-threaded. Otherwise, only one request can access the object at a time.
Last updated 1/20/2012
1180
end tag:
</struct>