SIP

SIP

Scheme: sip
Syntax: sip:uri
Alternative Schemes: sip,sips
Description: To send and receive messages using the SIP protocol (used in telco and mobile).
Deprecated:false
Async:false
Maven: org.apache.camel/camel-sip/2.18.1.redhat-000015

To send and receive messages using the SIP protocol (used in telco and mobile).

Name Kind Group Required Default Type Enum Description
uri path common true java.net.URI URI of the SIP server to connect to (the username and password can be included such as: john:secret@myserver:9999)
cacheConnections parameter common boolean Should connections be cached by the SipStack to reduce cost of connection creation. This is useful if the connection is used for long running conversations.
contentSubType parameter common plain java.lang.String Setting for contentSubType can be set to any valid MimeSubType.
contentType parameter common text java.lang.String Setting for contentType can be set to any valid MimeType.
eventHeaderName parameter common java.lang.String Setting for a String based event type.
eventId parameter common java.lang.String Setting for a String based event Id. Mandatory setting unless a registry based FromHeader is specified
fromHost parameter common java.lang.String Hostname of the message originator. Mandatory setting unless a registry based FromHeader is specified
fromPort parameter common int Port of the message originator. Mandatory setting unless a registry based FromHeader is specified
fromUser parameter common java.lang.String Username of the message originator. Mandatory setting unless a registry based custom FromHeader is specified.
msgExpiration parameter common 3600 int The amount of time a message received at an endpoint is considered valid
receiveTimeoutMillis parameter common 10000 long Setting for specifying amount of time to wait for a Response and/or Acknowledgement can be received from another SIP stack
stackName parameter common NAME_NOT_SET java.lang.String Name of the SIP Stack instance associated with an SIP Endpoint.
toHost parameter common java.lang.String Hostname of the message receiver. Mandatory setting unless a registry based ToHeader is specified
toPort parameter common int Portname of the message receiver. Mandatory setting unless a registry based ToHeader is specified
toUser parameter common java.lang.String Username of the message receiver. Mandatory setting unless a registry based custom ToHeader is specified.
transport parameter common tcp java.lang.String tcp
udp
Setting for choice of transport protocol. Valid choices are "tcp" or "udp".
bridgeErrorHandler parameter consumer boolean Allows for bridging the consumer to the Camel routing Error Handler, which mean any exceptions occurred while the consumer is trying to pickup incoming messages, or the likes, will now be processed as a message and handled by the routing Error Handler. By default the consumer will use the org.apache.camel.spi.ExceptionHandler to deal with exceptions, that will be logged at WARN/ERROR level and ignored.
consumer parameter consumer boolean This setting is used to determine whether the kind of header (FromHeader,ToHeader etc) that needs to be created for this endpoint
presenceAgent parameter consumer boolean This setting is used to distinguish between a Presence Agent & a consumer. This is due to the fact that the SIP Camel component ships with a basic Presence Agent (for testing purposes only). Consumers have to set this flag to true.
exceptionHandler parameter consumer (advanced) org.apache.camel.spi.ExceptionHandler To let the consumer use a custom ExceptionHandler. Notice if the option bridgeErrorHandler is enabled then this options is not in use. By default the consumer will deal with exceptions, that will be logged at WARN/ERROR level and ignored.
exchangePattern parameter consumer (advanced) org.apache.camel.ExchangePattern InOnly
RobustInOnly
InOut
InOptionalOut
OutOnly
RobustOutOnly
OutIn
OutOptionalIn
Sets the exchange pattern when the consumer creates an exchange.
addressFactory parameter advanced javax.sip.address.AddressFactory To use a custom AddressFactory
callIdHeader parameter advanced javax.sip.header.CallIdHeader A custom Header object containing call details. Must implement the type javax.sip.header.CallIdHeader
contactHeader parameter advanced javax.sip.header.ContactHeader An optional custom Header object containing verbose contact details (email, phone number etc). Must implement the type javax.sip.header.ContactHeader
contentTypeHeader parameter advanced javax.sip.header.ContentTypeHeader A custom Header object containing message content details. Must implement the type javax.sip.header.ContentTypeHeader
eventHeader parameter advanced javax.sip.header.EventHeader A custom Header object containing event details. Must implement the type javax.sip.header.EventHeader
expiresHeader parameter advanced javax.sip.header.ExpiresHeader A custom Header object containing message expiration details. Must implement the type javax.sip.header.ExpiresHeader
extensionHeader parameter advanced javax.sip.header.ExtensionHeader A custom Header object containing user/application specific details. Must implement the type javax.sip.header.ExtensionHeader
fromHeader parameter advanced javax.sip.header.FromHeader A custom Header object containing message originator settings. Must implement the type javax.sip.header.FromHeader
headerFactory parameter advanced javax.sip.header.HeaderFactory To use a custom HeaderFactory
listeningPoint parameter advanced javax.sip.ListeningPoint To use a custom ListeningPoint implementation
maxForwardsHeader parameter advanced javax.sip.header.MaxForwardsHeader A custom Header object containing details on maximum proxy forwards. This header places a limit on the viaHeaders possible. Must implement the type javax.sip.header.MaxForwardsHeader
maxMessageSize parameter advanced 1048576 int Setting for maximum allowed Message size in bytes.
messageFactory parameter advanced javax.sip.message.MessageFactory To use a custom MessageFactory
sipFactory parameter advanced javax.sip.SipFactory To use a custom SipFactory to create the SipStack to be used
sipStack parameter advanced javax.sip.SipStack To use a custom SipStack
sipUri parameter advanced javax.sip.address.SipURI To use a custom SipURI. If none configured, then the SipUri fallback to use the options toUser toHost:toPort
synchronous parameter advanced false boolean Sets whether synchronous processing should be strictly used, or Camel is allowed to use asynchronous processing (if supported).
toHeader parameter advanced javax.sip.header.ToHeader A custom Header object containing message receiver settings. Must implement the type javax.sip.header.ToHeader
viaHeaders parameter advanced java.util.List List of custom Header objects of the type javax.sip.header.ViaHeader. Each ViaHeader containing a proxy address for request forwarding. (Note this header is automatically updated by each proxy when the request arrives at its listener)
implementationDebugLogFile parameter logging java.lang.String Name of client debug log file to use for logging
implementationServerLogFile parameter logging java.lang.String Name of server log file to use for logging
implementationTraceLevel parameter logging 0 java.lang.String Logging level for tracing
maxForwards parameter proxy int Number of maximum proxy forwards
useRouterForAllUris parameter proxy boolean This setting is used when requests are sent to the Presence Agent via a proxy.