org.apache.camel.component.xmpp

Class XmppEndpoint

java.lang.Object

org.apache.camel.support.ServiceSupport

org.apache.camel.impl.DefaultEndpoint

org.apache.camel.component.xmpp.XmppEndpoint

All Implemented Interfaces:

org.apache.camel.CamelContextAware, org.apache.camel.Endpoint, org.apache.camel.IsSingleton, org.apache.camel.Service, org.apache.camel.ShutdownableService, org.apache.camel.spi.HasId, org.apache.camel.spi.HeaderFilterStrategyAware, org.apache.camel.StatefulService, org.apache.camel.SuspendableService

@UriEndpoint(scheme="xmpp",
             title="XMPP",
             syntax="xmpp:host:port/participant",
             alternativeSyntax="xmpp:user:password@host:port/participant",
             consumerClass=XmppConsumer.class,
             label="chat,messaging")
public class XmppEndpoint
extends org.apache.camel.impl.DefaultEndpoint
implements org.apache.camel.spi.HeaderFilterStrategyAware

To send and receive messages from a XMPP (chat) server.

Field Summary

Fields inherited from class org.apache.camel.support.ServiceSupport

shutdown, shuttingdown, started, starting, stopped, stopping, suspended, suspending

Constructor Summary

Constructors

Constructor and Description
XmppEndpoint()
XmppEndpoint(String endpointUri) Deprecated.
XmppEndpoint(String uri, XmppComponent component)

Method Summary

Modifier and Type	Method and Description
org.jivesoftware.smack.XMPPConnection	createConnection()
org.apache.camel.Consumer	createConsumer(org.apache.camel.Processor processor)
protected String	createEndpointUri()
org.apache.camel.Exchange	createExchange(org.jivesoftware.smack.packet.Packet packet)
org.apache.camel.Producer	createGroupChatProducer()
org.apache.camel.Producer	createPrivateChatProducer(String participant)
org.apache.camel.Producer	createProducer()
org.apache.camel.Producer	createPubSubProducer()
protected void	doStop()
XmppBinding	getBinding()
String	getChatId()
org.jivesoftware.smack.ConnectionConfiguration	getConnectionConfig()
String	getConnectionDescription()
static String	getConnectionMessage(org.jivesoftware.smack.XMPPConnection connection)
int	getConnectionPollDelay()
org.apache.camel.spi.HeaderFilterStrategy	getHeaderFilterStrategy()
String	getHost()
String	getNickname()
String	getParticipant()
String	getPassword()
int	getPort()
String	getResource()
String	getRoom()
String	getServiceName()
String	getUser()
boolean	isCreateAccount()
boolean	isDoc()
boolean	isLogin()
boolean	isPubsub()
boolean	isSingleton()
boolean	isTestConnectionOnStartup()
String	resolveRoom(org.jivesoftware.smack.XMPPConnection connection)
void	setBinding(XmppBinding binding) Sets the binding used to convert from a Camel message to and from an XMPP message
void	setConnectionConfig(org.jivesoftware.smack.ConnectionConfiguration connectionConfig) To use an existing connection configuration
void	setConnectionPollDelay(int connectionPollDelay) The amount of time in seconds between polls (in seconds) to verify the health of the XMPP connection, or between attempts to establish an initial consumer connection.
void	setCreateAccount(boolean createAccount) If true, an attempt to create an account will be made.
void	setDoc(boolean doc) Set a doc header on the IN message containing a Document form of the incoming packet; default is true if presence or pubsub are true, otherwise false
void	setHeaderFilterStrategy(org.apache.camel.spi.HeaderFilterStrategy headerFilterStrategy) To use a custom HeaderFilterStrategy to filter header to and from Camel message.
void	setHost(String host) Hostname for the chat server
void	setLogin(boolean login) Whether to login the user.
void	setNickname(String nickname) Use nickname when joining room.
void	setParticipant(String participant) JID (Jabber ID) of person to receive messages.
void	setPassword(String password) Password for login
void	setPort(int port) Port number for the chat server
void	setPubsub(boolean pubsub) Accept pubsub packets on input, default is false
void	setResource(String resource) XMPP resource.
void	setRoom(String room) If this option is specified, the component will connect to MUC (Multi User Chat).
void	setServiceName(String serviceName) The name of the service you are connecting to.
void	setTestConnectionOnStartup(boolean testConnectionOnStartup) Specifies whether to test the connection on startup.
void	setUser(String user) User name (without server name).

Methods inherited from class org.apache.camel.impl.DefaultEndpoint

configureConsumer, configurePollingConsumer, configureProperties, createEndpointConfiguration, createExchange, createExchange, createExchange, createPollingConsumer, doStart, equals, getCamelContext, getComponent, getConsumerProperties, getEndpointConfiguration, getEndpointKey, getEndpointUri, getExceptionHandler, getExchangePattern, getId, getPollingConsumerBlockTimeout, getPollingConsumerQueueSize, hashCode, isBridgeErrorHandler, isLenientProperties, isPollingConsumerBlockWhenFull, isSynchronous, setBridgeErrorHandler, setCamelContext, setConsumerProperties, setEndpointConfiguration, setEndpointUri, setEndpointUriIfNotSpecified, setExceptionHandler, setExchangePattern, setPollingConsumerBlockTimeout, setPollingConsumerBlockWhenFull, setPollingConsumerQueueSize, setProperties, setSynchronous, toString

Methods inherited from class org.apache.camel.support.ServiceSupport

doResume, doShutdown, doSuspend, getStatus, getVersion, isRunAllowed, isStarted, isStarting, isStopped, isStopping, isStoppingOrStopped, isSuspended, isSuspending, isSuspendingOrSuspended, resume, shutdown, start, stop, suspend

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.camel.Service

start, stop

Constructor Detail

XmppEndpoint

public XmppEndpoint()

XmppEndpoint

public XmppEndpoint(String uri,
                    XmppComponent component)

XmppEndpoint

@Deprecated
public XmppEndpoint(String endpointUri)

Deprecated.

Method Detail

createProducer

public org.apache.camel.Producer createProducer()
                                         throws Exception

Specified by:

createProducer in interface org.apache.camel.Endpoint

Throws:

Exception

createGroupChatProducer

public org.apache.camel.Producer createGroupChatProducer()
                                                  throws Exception

Throws:

Exception

createPrivateChatProducer

public org.apache.camel.Producer createPrivateChatProducer(String participant)
                                                    throws Exception

Throws:

Exception

createPubSubProducer

public org.apache.camel.Producer createPubSubProducer()
                                               throws Exception

Throws:

Exception

createConsumer

public org.apache.camel.Consumer createConsumer(org.apache.camel.Processor processor)
                                         throws Exception

Specified by:

createConsumer in interface org.apache.camel.Endpoint

Throws:

Exception

createExchange

public org.apache.camel.Exchange createExchange(org.jivesoftware.smack.packet.Packet packet)

createEndpointUri

protected String createEndpointUri()

Overrides:

createEndpointUri in class org.apache.camel.impl.DefaultEndpoint

isSingleton

public boolean isSingleton()

Specified by:

isSingleton in interface org.apache.camel.IsSingleton

createConnection

public org.jivesoftware.smack.XMPPConnection createConnection()
                                                       throws org.jivesoftware.smack.XMPPException,
                                                              org.jivesoftware.smack.SmackException,
                                                              IOException

Throws:

org.jivesoftware.smack.XMPPException

org.jivesoftware.smack.SmackException

IOException

resolveRoom

public String resolveRoom(org.jivesoftware.smack.XMPPConnection connection)
                   throws org.jivesoftware.smack.XMPPException,
                          org.jivesoftware.smack.SmackException

Throws:

org.jivesoftware.smack.XMPPException

org.jivesoftware.smack.SmackException

getConnectionDescription

public String getConnectionDescription()

getConnectionMessage

public static String getConnectionMessage(org.jivesoftware.smack.XMPPConnection connection)

getChatId

public String getChatId()

getBinding

public XmppBinding getBinding()

setBinding

public void setBinding(XmppBinding binding)

Sets the binding used to convert from a Camel message to and from an XMPP message

getHost

public String getHost()

setHost

public void setHost(String host)

Hostname for the chat server

getPort

public int getPort()

setPort

public void setPort(int port)

Port number for the chat server

getUser

public String getUser()

setUser

public void setUser(String user)

User name (without server name). If not specified, anonymous login will be attempted.

getPassword

public String getPassword()

setPassword

public void setPassword(String password)

Password for login

getResource

public String getResource()

setResource

public void setResource(String resource)

XMPP resource. The default is Camel.

isLogin

public boolean isLogin()

setLogin

public void setLogin(boolean login)

Whether to login the user.

isCreateAccount

public boolean isCreateAccount()

setCreateAccount

public void setCreateAccount(boolean createAccount)

If true, an attempt to create an account will be made. Default is false.

getRoom

public String getRoom()

setRoom

public void setRoom(String room)

If this option is specified, the component will connect to MUC (Multi User Chat). Usually, the domain name for MUC is different from the login domain. For example, if you are superman@jabber.org and want to join the krypton room, then the room URL is krypton@conference.jabber.org. Note the conference part. It is not a requirement to provide the full room JID. If the room parameter does not contain the @ symbol, the domain part will be discovered and added by Camel

getParticipant

public String getParticipant()

setParticipant

public void setParticipant(String participant)

JID (Jabber ID) of person to receive messages. room parameter has precedence over participant.

getNickname

public String getNickname()

setNickname

public void setNickname(String nickname)

Use nickname when joining room. If room is specified and nickname is not, user will be used for the nickname.

setServiceName

public void setServiceName(String serviceName)

The name of the service you are connecting to. For Google Talk, this would be gmail.com.

getServiceName

public String getServiceName()

getHeaderFilterStrategy

public org.apache.camel.spi.HeaderFilterStrategy getHeaderFilterStrategy()

Specified by:

getHeaderFilterStrategy in interface org.apache.camel.spi.HeaderFilterStrategyAware

setHeaderFilterStrategy

public void setHeaderFilterStrategy(org.apache.camel.spi.HeaderFilterStrategy headerFilterStrategy)

To use a custom HeaderFilterStrategy to filter header to and from Camel message.

Specified by:

setHeaderFilterStrategy in interface org.apache.camel.spi.HeaderFilterStrategyAware

getConnectionConfig

public org.jivesoftware.smack.ConnectionConfiguration getConnectionConfig()

setConnectionConfig

public void setConnectionConfig(org.jivesoftware.smack.ConnectionConfiguration connectionConfig)

To use an existing connection configuration

isTestConnectionOnStartup

public boolean isTestConnectionOnStartup()

setTestConnectionOnStartup

public void setTestConnectionOnStartup(boolean testConnectionOnStartup)

Specifies whether to test the connection on startup. This is used to ensure that the XMPP client has a valid connection to the XMPP server when the route starts. Camel throws an exception on startup if a connection cannot be established. When this option is set to false, Camel will attempt to establish a "lazy" connection when needed by a producer, and will poll for a consumer connection until the connection is established. Default is true.

getConnectionPollDelay

public int getConnectionPollDelay()

setConnectionPollDelay

public void setConnectionPollDelay(int connectionPollDelay)

The amount of time in seconds between polls (in seconds) to verify the health of the XMPP connection, or between attempts to establish an initial consumer connection. Camel will try to re-establish a connection if it has become inactive. Default is 10 seconds.

setPubsub

public void setPubsub(boolean pubsub)

Accept pubsub packets on input, default is false

isPubsub

public boolean isPubsub()

setDoc

public void setDoc(boolean doc)

Set a doc header on the IN message containing a Document form of the incoming packet; default is true if presence or pubsub are true, otherwise false

isDoc

public boolean isDoc()

doStop

protected void doStop()
               throws Exception

Overrides:

doStop in class org.apache.camel.impl.DefaultEndpoint

Throws:

Exception