Table of Contents
Advertisement
DEVELOPING COLDFUSION 9 APPLICATIONS
Using External Resources
Application development and deployment process
The following is a typical process for developing and deploying an IM application:
1
Design your application.
Configure an IM event gateway instance to use an available XMPP or Lotus Sametime server.
2
Write your CFCs, CFM pages, and any other application elements.
3
4
Test your application using your XMPP or Lotus Sametime server and an appropriate client application.
Deploy the application (see
5
How the IM event gateway and provider interact
Each IM event gateway instance has a single instant messaging ID. Establish the ID and its related password on the IM
server using server-specific tools, such as a standard instant messaging client. In ColdFusion, you set the ID, password, and
other gateway-specific information in a gateway configuration file, and you create a gateway instance that uses this file.
When you start the gateway, it logs on to the IM server with the ID and password, and receives and sends the messages
for the ID. The gateway sends incoming messages to a CFC, which you specify when you configure the gateway
instance in the ColdFusion Administrator. The gateway passes outgoing messages from this CFC and from other
CFML code to the IM server.
The IM event gateway also provides several helper methods for managing the gateway and its configuration
information.
Incoming message handling
You write the following ColdFusion CFC methods to handle incoming messages and requests from the IM event
gateway. These CFCs receive messages from the IM server and can respond to them by setting a return value.
CFC method
onIncomingMessage
onAddBuddyRequest
onAddBuddyResponse
onBuddyStatus
onIMServerMessage
For more information on these methods, see
Outgoing message handling
Applications send outgoing instant messages using the CFML
handling CFC methods can also send messages, including responses to requests from others to add the ColdFusion
gateway's ID to their buddy list. For more information on sending messages, see
page 1281.
"Deploying event gateways and
Message type
Standard message from IM users.
Requests from others to add the gateway ID to their buddy list.
Responses from others to requests from your gateway to add them to your buddy lists. Also used by
buddies to ask to be removed from your list.
Presence status messages from other users.
Error and status messages from the IM server.
"Handling incoming
Last updated 8/5/2010
applications" on page 1269).
messages" on page 1280.
method. Incoming message-
SendGatewayMessage
"Sending outgoing
1278
messages" on
Advertisement
Table of Contents
