org.jbpm.ejb.impl
Class CommandListenerBean

java.lang.Object
  org.jbpm.ejb.impl.CommandListenerBean

All Implemented Interfaces:

java.io.Serializable, javax.ejb.EnterpriseBean, javax.ejb.MessageDrivenBean, javax.jms.MessageListener

Direct Known Subclasses:

JobListenerBean

public class CommandListenerBean
extends java.lang.Object
implements javax.ejb.MessageDrivenBean, javax.jms.MessageListener

This message-driven bean listens for object messages containing a command instance. The received commands are executed by the command service bean, using the local interface. The body of the message must be a Java object that implements the Command interface. The message properties, if any, are ignored.

Environment

The environment entries and resources available for customization are summarized in the table below.

Name	Type	Description
ejb/LocalCommandServiceBean	EJB Reference	Link to the local session bean that executes commands on a separate jBPM context.
jms/JbpmConnectionFactory	Resource Manager Reference	Logical name of the factory that provides JMS connections for producing result messages. Required for command messages that indicate a reply destination.
jms/DeadLetterQueue	Message Destination Reference	Messages which do not contain a command are sent to the queue referenced here. Optional; if absent, such messages are rejected, which may cause the container to redeliver.

Author:

Jim Rigsbee, Tom Baeyens, Alejandro Guizar

See Also:

Serialized Form

Constructor Summary

CommandListenerBean()

Method Summary

void	ejbCreate()
void	ejbRemove()
protected org.jbpm.command.Command	extractCommand(javax.jms.Message message)
void	onMessage(javax.jms.Message message)
void	setMessageDrivenContext(javax.ejb.MessageDrivenContext messageDrivenContext)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CommandListenerBean

public CommandListenerBean()

Method Detail

onMessage

public void onMessage(javax.jms.Message message)

Specified by:

onMessage in interface javax.jms.MessageListener

extractCommand

protected org.jbpm.command.Command extractCommand(javax.jms.Message message)
                                           throws javax.jms.JMSException

Throws:

javax.jms.JMSException

setMessageDrivenContext

public void setMessageDrivenContext(javax.ejb.MessageDrivenContext messageDrivenContext)

Specified by:

setMessageDrivenContext in interface javax.ejb.MessageDrivenBean

ejbRemove

public void ejbRemove()

Specified by:

ejbRemove in interface javax.ejb.MessageDrivenBean

ejbCreate

public void ejbCreate()