Welcome!

Adobe Flex Authors: Jason Dolinger, Yeshim Deniz, Liz McMillan, John Ryan, Maureen O'Gara

Related Topics: Adobe Flex

Adobe Flex: Article

How to Create a Multi User Flex Application Using JMS

Passing connection-level credentials to the JMSAdapter of BlazeDS

Marco Casario's "RIAvolutionize the Web" Blog

In order to create a multi user Flex application, you can take advantage of one of the features of LiveCycle Data Services: the Messaging Services. The Messaging Services allows you to connect your Flex application to a message destination and send/receive messages to it from other clients.

You use the JMS adapter to subscribe to JMS queues configured on an implementation of the Java Message Service. The Java Message Service (JMS) API is a Java Message Oriented Middleware  API for sending messages between two or more clients.

The LiveCycle Data Services 2.5.1 uses the JMS message adapter to communicate with messaging systems and to transport messages to and from a destination over a message channel. A destination specifies an id attribute to provide a public name for clients to use when sending messages.

The Flex application can use as message channel one of the protocol supported by the Flash Player: Action Message Format (AMF3), Realtime Message Protocol (RTMP), and XMLSocket.

Marco Casario's Upcoming AJAXWorld 2008 East Session: "Using AJAX Data Services in Enterprise Applications"

When working with the Messaging Services you have to configure message destinations, apply security to message destinations, and modify logging settings. You configure the JMS adapter individually for the destinations that use it.

One of the limit if the Messagin Services of Livecycle Data Services is the inability to define a username and password in the configuration file to pass them to the JMS.

I discovered that in BlazeDS there is a new JMSAdapter that allows you to set the connection-level credentials passing the username and password.
The new connection-credentials XML node sets the the username and password used while creating the JMS connection.As the documentation said, use only if JMS connection level authentication is being used :

<destination id="chat-topic-jms">
    <properties>
...
        <jms>
            <destination-type>Topic</destination-type>
            <message-type>javax.jms.TextMessage</message-type>
            <connection-factory>jms/flex/TopicConnectionFactory
            </connection-factory>
            <destination-jndi-name>jms/topic/flex/simpletopic
            </destination-jndi-name>
            <delivery-mode>NON_PERSISTENT</delivery-mode>
            <message-priority>DEFAULT_PRIORITY</message-priority>
            <preserve-jms-headers>"true"</preserve-jms-headers>
            <acknowledge-mode>AUTO_ACKNOWLEDGE</acknowledge-mode>
            <connection-credentials username="sampleuser" password="samplepassword"/>
            <max-producers>1</max-producers>
        </jms>
    </properties>

For many developers this new features supported by the JMSAdapter could be very appreciated and could solve problems in many different scenarios where the authentication is required in JMS.

From the Adobe Livecycle Data Services documentation :

Messaging systems let separate applications communicate asynchronously as peers by passing packets of data called messages back and forth through a message service. A message usually consists of a header and a body. The header contains an identifier and routing information. The body contains application data.

Applications that send messages are called producers. Applications that receive messages are called consumers. In most messaging systems, producers and consumers do not need to know anything about each other. Producers send messages to specific message destinations, and the message service routes the messages to the appropriate consumers.

A message channel connects producers and consumers to message destinations. To send messages over a particular channel, an application connects to the message endpoint associated with the message channel. A message endpoint is the code responsible for encoding data into messages, and decoding messages into a format that consumers can use. In some messaging systems, an endpoint can pass decoded messages to a message broker, which routes them to appropriate destinations.

A message adapter is code that acts as a conduit between the LiveCycle Data Services Message Service and other messaging systems. For example, the Java Message Service (JMS) adapter is a message adapter that lets Flex applications subscribe to JMS topics and queues. This adapter lets a pure Java JMS message application share the same destination as a Flex application: Java applications can publish messages to LiveCycle Data Services destinations, and Java code can respond to messages that Flex applications send.

Last Chance to Register for AJAXWorld 2008 East and Save $100 !


About Marco Casario

Marco Casario is CEO of Comtaste, a company devoted to develop Rich Internet Applications on the Web and for mobile devices.

He collaborates intensively with Adobe Italy as a speaker at conferences and as a consultant for Flash, Flex, and Flash Lite.

Learn more about Marco Casario at his blog http://casario.blogs.com. In 2005, Marco has founded Comtaste, a company dedicated to exploring new frontiers in Rich Internet Applications and the convergence between the web and the world of mobile devices — MobyMobile and YouThru are representative of their recent work. He is founder of the biggest worldwide Flash Lite User Group and of www.augitaly.com, a reference point for the Italian community of Adobe users, in which he carries out the role of Channel Manager for the section dedicated to Flex.

Comments (0)

Share your thoughts on this story.

Add your comment
You must be signed in to add a comment. Sign-in | Register

In accordance with our Comment Policy, we encourage comments that are on topic, relevant and to-the-point. We will remove comments that include profanity, personal attacks, racial slurs, threats of violence, or other inappropriate material that violates our Terms and Conditions, and will block users who make repeated violations. We ask all readers to expect diversity of opinion and to treat one another with dignity and respect.