上一主题: 接口实体下一主题: cfgfiles 实体


属性实体

属性实体定义组件的可配置属性。 任何可能需要配置的参数都可以定义为属性。 采用下列方法将属性值提供给组件的软件:

注意:因为卷可作为可配置属性显示在边界上,卷和属性会共享命名空间,所以,用户无法定义具有相同名称的卷和属性。

属性实体具有以下属性:

type=

定义属性类型,此属性值必须是字符串、整数、ip_addr 或 IP_owned 之一。 如果未指定 type= 属性,则假设为字符串。

注意:“IP_owned”类型与“ip_addr”是一样的-它有一个 ipv4 或 IPv6 地址。

使用“IP_ownedd”而非“ip_addr”表示该地址是分配给组件本身的地址(即组件的 IP 子系统将应答此地址)。 非应用所拥有但应用却应连接的地址(作为外部服务)应当采用“ip_addr”类型。 类型“IP_owned”的属性需要在应用启动之前进行验证。 如果给出值不在网格上应用的允许使用范围之内,将会拒绝应用启动。 在添加“IP_owned”类型之前(因此使用“ip_addr”)创建的现有组件将可以正常运行,但是不会从配置的 IP 地址的启动时间检查中获益。 如果为它们设置的地址不正确,它们会在启动时无法运行(具有网格“外”的 IP 地址的网络数据包会在到达组件之前将被丢弃,即使已将该组件的操作系统配置应答该地址)。

filter=

定义属性有效值集合的正则表达式。 该表达式必须采用 Perl 定义的语法进行编码,以进行正则表达式模式匹配。 匹配是对整个属性值进行的-正如在 Perl 语句中使用 /^expression$/ 检查匹配一样(其中,expression 是 filter 属性的值)。
此属性是可选的。 如果不存在,则假设值为“.*”(匹配任何字符串)。

values=

此属性可用于替换 filter= 属性。 除了使用 values= expr 而非 filter= expr 来提示 GUI 编辑器正则表达式是要匹配的字符串以普通正则表达式形式(如 string1!string2!... 等)的简单串联之外,该属性被 ADL 编译器视为与 filter 属性完全相同。 这可用于显示属性表值的下拉列表,而不是自由文本编辑框。

min=
max=

整数属性的最小值和最大值。 如果指定的属性类型是整数,则这些可选属性指定有效值的限制。 除了由 filter= 属性指定的任何正则表达式模式之外,它们都适用。
这些值之一存在 - 或 + 符号时,表示要根据带符号整数对限制进行整数比较。

强制

如果存在,则此属性表示属性没有默认值。 当组件用于组件集时,属性值必须在组件集中提供,或者必须重定向到组件集边界;在后一种情况下,组件集的对应属性也具 mandatory 属性。
如果未指定 mandatory,则属性的默认值应使用 dflt= 属性给出(请参阅下文)。

dflt=

指定属性的默认值。 此属性不能与 mandatory 一起使用。

lowercase

指出要将属性值转换为小写才能用于配置组件。 这应用于需要对用户不区分大小写显示的属性,但是应给组件提供一致值,以可以使用区分大小写的比较进行比较。 小写转换是在 C 区域中完成的。