sib: URL 语法
sib: URL 具有下列语法:
sib:/[destination|path]?property_1=value_1&property_2=value_2&...
其中:- 方括号(“[ ]”)指示参数是可选的。
- 传输类型是 sib:,后跟 /destination 以指定目标类型或后跟 /path 以指定正向路由路径,后跟包含一个或多个属性的“查询字符串”。在该主题的后续部分中描述所允许的属性。
必需属性
下列属性是必需的。它们用于指定请求目标。
注: 所有目标名称必须是标准名称。即,它们必须包括服务集成总线的名称以及目标名称本身。使用语法 bus:destination。
如果总线名或目标名包含冒号或逗号,请使用双引号 (“”) 将该名称括起来。如果它包含双引号,那么重复使用一次双引号。
- destinationName
- 目标名。
- path
- 正向路由路径,以一组由逗号分隔的目标名的格式。
- replyDestinationName
- 要用于应答的目标名。
- inboundService
- 标识请求方应用程序使用的特定连接的入站服务的名称。如果目标是服务目标并带有关联的出站服务配置,那么可省略该值,因为在该情况下,请求方将通过服务目标连接至出站服务。
- timeout
- 请求方等待响应的时间。缺省值为 60 秒。如果值为零,那么表示无限等待。
与服务集成技术相关的属性
下列属性是可选的。如果您没有为属性指定值,那么使用缺省值。有关这些属性所允许的值的更多信息,请参阅为 SIMessage 接口生成的 API 信息。
- reliability
- 请求消息的可靠性。
- timeToLive
- 请求超时之前的时间量(以毫秒计)。如果值为零,那么表示请求永不超时。注: timeout 属性(请参阅必需的属性)是时间延迟,在该时间之后,请求者应用程序将阻塞应用程序线程,该应用程序线程正在等待对请求的响应和响应操作。 timeToLive 和 replyTimeToLive 可选属性表示消息传递引擎应花多长时间来处理请求和应答消息。这不包括服务实现期间的处理时间。因此,通常将超时设置为请求和响应生存时间加上某些服务处理时间量的总和。
- priority
- 请求消息的优先级。
- user
- 访问请求目标所需的用户标识。
- password
- 访问请求目标所需的密码。
- replyReliability
- 应答消息的可靠性。
- replyTimeToLive
- 应答超时之前的时间量(以毫秒计)。如果值为零,那么表示应答永不超时。
- replyPriority
- 应答消息的优先级。
其他属性
您还可将用户定义的属性包括在 URL 中。这些属性必须以 user. 前缀来命名。例如:
sib:/destination?destinationName=myBus:myDestination & reliability=assured & user.customData=XYZ
在发送该请求之后,URL 自身在消息属性中可用并被命名为 inbound.url。