Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

...

The SIP Component offers an extensive set of configuration options & capability to create custom stateful headers needed to propagate state via the SIP protocol.

Div
classconfluenceTableSmall
Wiki Markup
{div:class=confluenceTableSmall} || Name || Default Value || Description || | {{stackName}} | {{

Name

Default Value

Description

stackName

NAME_NOT_SET

}} |

Name

of

the

SIP

Stack

instance

associated

with

an

SIP

Endpoint.

| | {{transport}} | {{tcp}} | Setting for choice of transport potocol. Valid choices are "tcp" or "udp". | | {{fromUser}} | | Username of the message originator. *Mandatory setting unless a registry based custom FromHeader is specified.* | | {{fromHost}} | | Hostname of the message originator. *Mandatory setting unless a registry based FromHeader is specified* | | {{fromPort}} | | Port of the message originator. *Mandatory setting unless a registry based FromHeader is specified* | | {{toUser}} | | Username of the message receiver. *Mandatory setting unless a registry based custom ToHeader is specified.* | | {{toHost}} | | Hostname of the message receiver. *Mandatory setting unless a registry based ToHeader is specified* | | {{toPort}} | | Portname of the message receiver. *Mandatory setting unless a registry based ToHeader is specified* | | {{maxforwards}} | 0 | the number of intermediaries that may forward the message to the message receiver. *Optional setting. May alternatively be set using as registry based MaxForwardsHeader* | | {{eventId}} | | Setting for a String based event Id. *Mandatory setting unless a registry based FromHeader is specified* | | {{eventHeaderName}} | | Setting for a String based event Id. *Mandatory setting unless a registry based FromHeader is specified* | | {{maxMessageSize}} | {{1048576}} | Setting for maximum allowed Message size in bytes. | | {{cacheConnections}} | {{false}} | 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. | | {{consumer}} | {{false}} | This setting is used to determine whether the kind of header (FromHeader,ToHeader etc) that needs to be created for this endpoint| | {{automaticDialogSupport}} | {{off}} | Setting to specify whether every communication should be associated with a dialog. | | {{contentType}} | {{text}} | Setting for contentType can be set to any valid MimeType. | | {{contentSubType}} | {{xml}} | Setting for contentSubType can be set to any valid MimeSubType. | | {{receiveTimeoutMillis}} | {{10000}} | Setting for specifying amount of time to wait for a Response and/or Acknowledgement can be received from another SIP stack | | {{useRouterForAllUris}} | {{false}} | This setting is used when requests are sent to the Presence Agent via a proxy. | | {{msgExpiration}} | {{3600}} | The amount of time a message received at an endpoint is considered valid | | {{presenceAgent}} | {{false}} | This setting is used to distingish 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. | {div}

transport

tcp

Setting for choice of transport potocol. Valid choices are "tcp" or "udp".

fromUser

 

Username of the message originator. Mandatory setting unless a registry based custom FromHeader is specified.

fromHost

 

Hostname of the message originator. Mandatory setting unless a registry based FromHeader is specified

fromPort

 

Port of the message originator. Mandatory setting unless a registry based FromHeader is specified

toUser

 

Username of the message receiver. Mandatory setting unless a registry based custom ToHeader is specified.

toHost

 

Hostname of the message receiver. Mandatory setting unless a registry based ToHeader is specified

toPort

 

Portname of the message receiver. Mandatory setting unless a registry based ToHeader is specified

maxforwards

0

the number of intermediaries that may forward the message to the message receiver. Optional setting. May alternatively be set using as registry based MaxForwardsHeader

eventId

 

Setting for a String based event Id. Mandatory setting unless a registry based FromHeader is specified

eventHeaderName

 

Setting for a String based event Id. Mandatory setting unless a registry based FromHeader is specified

maxMessageSize

1048576

Setting for maximum allowed Message size in bytes.

cacheConnections

false

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.

consumer

false

This setting is used to determine whether the kind of header (FromHeader,ToHeader etc) that needs to be created for this endpoint

automaticDialogSupport

off

Setting to specify whether every communication should be associated with a dialog.

contentType

text

Setting for contentType can be set to any valid MimeType.

contentSubType

xml

Setting for contentSubType can be set to any valid MimeSubType.

receiveTimeoutMillis

10000

Setting for specifying amount of time to wait for a Response and/or Acknowledgement can be received from another SIP stack

useRouterForAllUris

false

This setting is used when requests are sent to the Presence Agent via a proxy.

msgExpiration

3600

The amount of time a message received at an endpoint is considered valid

presenceAgent

false

This setting is used to distingish 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.

Registry based Options

SIP requires a number of headers to be sent/received as part of a request. These SIP header can be enlisted in the Registry, such as in the Spring XML file.

The values that could be passed in, are the following:

Div
classconfluenceTableSmall

Name

Description

fromHeader

a custom Header object containing message originator settings. Must implement the type

Wiki Markup
{div:class=confluenceTableSmall} || Name || Description || | {{fromHeader}} | a custom Header object containing message originator settings. Must implement the type

javax.sip.header.FromHeader

| | {{toHeader}} | a custom Header object containing message receiver settings. Must implement the type

toHeader

a custom Header object containing message receiver settings. Must implement the type javax.sip.header.ToHeader

| | {{viaHeaders}} | List of custom Header objects of the type

viaHeaders

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)

| | {{contentTypeHeader}} | a custom Header object containing message content details. Must implement the type

contentTypeHeader

a custom Header object containing message content details. Must implement the type javax.sip.header.ContentTypeHeader

| | {{callIdHeader}} | a custom Header object containing call details. Must implement the type

callIdHeader

a custom Header object containing call details. Must implement the type javax.sip.header.CallIdHeader

| | {{maxForwardsHeader}} | a custom Header object containing details on maximum proxy forwards. This header places a limit on the viaHeaders possible. Must implement the type

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

| | {{eventHeader}} | a custom Header object containing event details. Must implement the type

eventHeader

a custom Header object containing event details. Must implement the type javax.sip.header.EventHeader

| | {{contactHeader}} | an optional custom Header object containing verbose contact details

contactHeader

an optional custom Header object containing verbose contact details (email,

phone

number

etc).

Must

implement

the

type

javax.sip.header.ContactHeader

| | {{expiresHeader}} | a custom Header object containing message expiration details. Must implement the type

expiresHeader

a custom Header object containing message expiration details. Must implement the type javax.sip.header.ExpiresHeader

| | {{extensionHeader}} | a custom Header object containing

extensionHeader

a custom Header object containing user/application

specific

details.

Must

implement

the

type

javax.sip.header.ExtensionHeader

| {div}

Sending Messages to/from a SIP endpoint

...