305.2. 选项
SIP 组件提供了一组广泛的配置选项和能力,以创建通过 SIP 协议传播状态所需的自定义有状态标头。
SIP 组件没有选项。
SIP 端点使用 URI 语法进行配置:
sip:uri
使用以下路径和查询参数:
305.2.1. 路径参数(1 参数):
名称 | 描述 | 默认值 | 类型 |
---|---|---|---|
uri | 要连接到的 SIP 服务器 所需的 URI (包括用户名和密码,例如: john:secretmyserver:9999) | URI |
305.2.2. 查询参数(44 参数):
名称 | 描述 | 默认值 | 类型 |
---|---|---|---|
cacheConnections (common) | 应由 SipStack 缓存连接,以减少连接创建成本。如果连接用于长时间运行的对话,这非常有用。 | false | 布尔值 |
contentSubType (common) | contentSubType 设置可以设置为任何有效的 MimeSubType。 | plain | 字符串 |
contentType (common) | 对于 contentType 的设置,可以设置为任何有效的 MimeType。 | text | 字符串 |
eventHeaderName (common) | 为基于 String 的事件类型设置。 | 字符串 | |
eventId (common) | 为基于字符串的事件 Id 设置。除非指定了基于 FromHeader 的 registry,否则强制设置 | 字符串 | |
fromHost (common) | 消息发起者的主机名。除非指定了基于 FromHeader 的 registry,否则强制设置 | 字符串 | |
fromPort (common) | 消息源器的端口。除非指定了基于 FromHeader 的 registry,否则强制设置 | int | |
fromUser (common) | 消息发起者的用户名。除非指定了基于 registry 的自定义 FromHeader,否则强制设置。 | 字符串 | |
msgExpiration (common) | 在端点收到的消息的时间被视为有效 | 3600 | int |
receiveTimeoutMillis (common) | 设置指定从另一个 SIP 堆栈接收响应和/或确认等待的时间 | 10000 | long |
stackName (common) | 与 SIP 端点关联的 SIP Stack 实例的名称。 | NAME_NOT_SET | 字符串 |
toHost (common) | 消息接收器的主机名。除非指定了基于 registry 的 ToHeader,否则强制设置 | 字符串 | |
toPort (common) | 邮件接收器的 PORTNAME。除非指定了基于 registry 的 ToHeader,否则强制设置 | int | |
toUser (common) | 消息接收器的用户名。除非指定了基于 registry 的自定义 ToHeader,否则强制设置。 | 字符串 | |
transport (common) | 设置用于选择传输协议。有效的选择是 tcp 或 udp。 | tcp | 字符串 |
bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
consumer (consumer) | 此设置用于确定是否需要为此端点创建的标头类型(FromHeader,ToHeader etc) | false | 布尔值 |
presenceAgent (consumer) | 此设置用于区分 Presence Agent 和一个消费者。这是因为 SIP Camel 组件附带一个基本的预备代理(仅用于测试目的)。消费者必须将此标志设为 true。 | false | 布尔值 |
exceptionHandler (consumer) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
exchangePattern (consumer) | 在消费者创建交换时设置交换模式。 | ExchangePattern | |
addressFactory (advanced) | 使用自定义 AddressFactory | AddressFactory | |
callIdHeader (advanced) | 包含调用详情的自定义标头对象。必须实现类型 javax.sip.header.CallIdHeader | CallIdHeader | |
contactHeader (advanced) | 可选的自定义标头对象,其中包含详细联系人详情(电子邮件、电话号码等)。必须实施类型 javax.sip.header.ContactHeader | ContactHeader | |
contentTypeHeader (advanced) | 包含消息内容详情的自定义标头对象。必须实现类型 javax.sip.header.ContentTypeHeader | ContentTypeHeader | |
eventHeader (advanced) | 包含事件详情的自定义标头对象。必须实施类型 javax.sip.header.EventHeader | EventHeader | |
expiresHeader (advanced) | 包含消息过期详情的自定义标头对象。必须实施类型 javax.sip.header.ExpiresHeader | ExpiresHeader | |
extensionHeader (advanced) | 包含用户/应用程序特定详情的自定义标头对象。必须实现类型 javax.sip.header.ExtensionHeader | ExtensionHeader | |
fromHeader (advanced) | 包含消息原始器设置的自定义标头对象。必须实现类型 javax.sip.header.FromHeader | FromHeader | |
headerFactory (advanced) | 使用自定义标头Factory | HeaderFactory | |
listeningPoint (advanced) | 使用自定义 ListeningPoint 实现 | ListeningPoint | |
maxForwardsHeader (advanced) | 包含最大代理转发详情的自定义标头对象。此标头对 viaHeaders 可能有一个限制。必须实施类型 javax.sip.header.MaxForwardsHeader | MaxForwardsHeader | |
maxMessageSize (advanced) | 设置最大允许的消息大小(以字节为单位)。 | 1048576 | int |
messageFactory (advanced) | 使用自定义 MessageFactory | MessageFactory | |
sipFactory (advanced) | 使用自定义 SipFactory 来创建要使用的 SipStack | SipFactory | |
sipStack (advanced) | 使用自定义 SipStack | SipStack | |
sipUri (advanced) | 使用自定义 SipURI。如果没有配置,则 SipUri fallback 来使用 toUser toHost:toPort 的选项 | SipURI | |
同步 (advanced) | 设置是否应严格使用同步处理,或者 Camel 允许使用异步处理(如果受支持)。 | false | 布尔值 |
toHeader (advanced) | 包含消息接收器设置的自定义标头对象。必须实施类型 javax.sip.header.ToHeader | ToHeader | |
viaHeaders (advanced) | 类型 javax.sip.header.ViaHeader 的自定义标头对象列表。每个包含请求转发的代理地址的 ViaHeader。(请注意,当请求到达其监听器时,每个代理会自动更新此标头。) | list | |
implementationDebugLogFile (logging) | 用于日志的客户端调试日志文件名称 | 字符串 | |
implementationServerLogFile (logging) | 用于日志的服务器日志文件名称 | 字符串 | |
implementationTraceLevel (logging) | 用于追踪的日志记录级别 | 0 | 字符串 |
maxForwards (proxy) | 最大代理转发数 | int | |
useRouterForAllUris (proxy) | 当请求通过代理发送到 Presence Agent 时,会使用这个设置。 | false | 布尔值 |