305.2. 选项
SIP 组件提供了一组广泛的配置选项,并可创建通过 SIP 协议传播状态所需的自定义有状态标头。
SIP 组件没有选项。
SIP 端点使用 URI 语法进行配置:
sip:uri
使用以下路径和查询参数:
305.2.1. 路径参数(1 参数):
Name | 描述 | 默认值 | 类型 |
---|---|---|---|
uri | 要连接的 SIP 服务器 所需的 URI (用户名和密码可以包括: john:secretmyserver:9999) | URI |
305.2.2. 查询参数(44 参数):
Name | 描述 | 默认值 | 类型 |
---|---|---|---|
cacheConnections (common) | 应 SipStack 缓存连接,以降低连接创建成本。如果连接用于长时间运行的对话,这非常有用。 | false | 布尔值 |
contentSubType (common) | 为 contentSubType 设置可设置为任何有效的 MimeSubType。 | plain | 字符串 |
contentType (common) | contentType 的设置可以设置为任何有效的 MimeType。 | text | 字符串 |
eventHeaderName (common) | 为基于 String 的事件类型设置。 | 字符串 | |
eventId (common) | 为基于 String 的事件 Id 设置。除非指定了基于 registry 的 FromHeader,否则强制设置 | 字符串 | |
fromHost (common) | 消息 originator 的主机名。除非指定了基于 registry 的 FromHeader,否则强制设置 | 字符串 | |
FromPort (common) | 消息 originator 的端口。除非指定了基于 registry 的 FromHeader,否则强制设置 | int | |
fromUser (common) | 消息 originator 的用户名。除非指定了基于 registry 的自定义 FromHeader,否则强制设置。 | 字符串 | |
msgExpiration (common) | 端点收到的消息被视为有效的时间 | 3600 | int |
receiveTimeoutMillis (common) | 设置以指定等待 Response 和/或 Acknowledgement 的时间,可以从另一个 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 等) | false | 布尔值 |
presenceAgent (consumer) | 此设置用于区分 Presence Agent 和消费者。这是因为 SIP Camel 组件附带一个基本优先级代理(仅用于测试目的)。消费者必须将此标志设置为 true。 | false | 布尔值 |
ExceptionHandler ( consumer) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
exchangePattern (consumer) | 在消费者创建交换时设置交换模式。 | ExchangePattern | |
addressFactory (advanced) | 使用自定义 AddressFactory | AddressFactory | |
callIdHeader (advanced) | 包含调用详情的自定义 Header 对象。必须实施类型 javax.sip.header.CallIdHeader | CallIdHeader | |
contactHeader (advanced) | 可选的自定义 Header 对象,其中包含详细联系人详细信息(电子邮件、电话号码等)。必须实施类型 javax.sip.header.ContactHeader | ContactHeader | |
contentTypeHeader (advanced) | 包含消息内容详情的自定义 Header 对象。必须实施类型 javax.sip.header.ContentTypeHeader | ContentTypeHeader | |
eventHeader (advanced) | 包含事件详情的自定义 Header 对象。必须实施类型 javax.sip.header.EventHeader | EventHeader | |
expiresHeader (advanced) | 包含消息过期详情的自定义 Header 对象。必须实施类型 javax.sip.header.ExpiresHeader | ExpiresHeader | |
extensionHeader (advanced) | 包含用户/应用程序特定详情的自定义 Header 对象。必须实施类型 javax.sip.header.ExtensionHeader | ExtensionHeader | |
fromHeader (advanced) | 包含消息 originator 设置的自定义 Header 对象。必须实施类型 javax.sip.header.FromHeader | FromHeader | |
headerFactory (advanced) | 使用自定义 HeaderFactory | HeaderFactory | |
listeningPoint (advanced) | 使用自定义 ListeningPoint 实现 | ListeningPoint | |
maxForwardsHeader (advanced) | 包含最大代理转发详情的自定义 Header 对象。这个标头会对 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 | |
同步 (高级) | 设置是否应严格使用同步处理,还是允许 Camel 使用异步处理(如果支持)。 | false | 布尔值 |
toHeader (advanced) | 包含消息接收器设置的自定义 Header 对象。必须实施类型 javax.sip.header.ToHeader | ToHeader | |
viaHeaders (advanced) | 类型 javax.sip.header.ViaHeader 的自定义 Header 对象列表。每个 ViaHeader 都包含用于请求转发的代理地址。(请注意,当请求到达其监听器时,每个代理会自动更新此标头。) | list | |
implementationDebugLogFile (logging) | 用于日志记录的客户端调试日志文件的名称 | 字符串 | |
implementationServerLogFile (logging) | 用于日志记录的服务器日志文件的名称 | 字符串 | |
implementationTraceLevel (logging) | 追踪的日志记录级别 | 0 | 字符串 |
maxForwards (proxy) | 最大代理转发数 | int | |
useRouterForAllUris (proxy) | 当请求通过代理发送到 Presence 代理时,会使用此设置。 | false | 布尔值 |