返回包含 mbean 级策略的 modelmbean 的描述符。此描述符包含关于 mbean 和默认持久性及缓存策略的元数据。
描述符中的字段定义如下,但不限于此:
name : mbean 名称
descriptortype : 必须为 "mbean"
displayname : 要在显示中使用的属性名称
persistpolicy : onupdate|ontimer|nomoreoftenthan|onunregister|always|never
persistlocation : 应在其中保持 mbean 的完全限定目录名(如果适当)。
persistfile : 应在其中保持 mbean 的文件名称。
persistperiod : 秒数 - ontime 和 nomoreoftenthan persistpolicy 的保持周期的频率
currencytimelimit : 值保持有效的时间,<0 为无效,=0 为总是有效,>0 为有效的秒数
log : 其中 t:记录所有通知;f:不记录通知
logfile : 要记录事件的完全限定文件名
visibility : 1-4,其中 1:总是可见;4:几乎不可见
export : 要用于导出/公开此 mbean 的名称,以便其他 jmx agent 可以找到它
presentationstring : 允许数据与 mbean 关联的 xml 格式的字符串。
默认描述符为:name=mbeanname、descriptortype=mbean、displayname=this.getclassname()、persistpolicy=never、log=f、export=f、visibility=1 如果描述符不包含所有这些字段,则将以这些默认值添加它们。
注:由于与此规范的以前版本不一致,因此对于 currencytimelimit
,推荐不使用负值或零。要指示某个缓存的值永远无效,请忽略 currencytimelimit
字段。要指示它总是有效,请为此字段使用一个非常大的值。
- 指定者:
- 接口
modelmbeaninfo
中的 getmbeandescriptor
- 返回:
- mbean 描述符。
- 抛出:
mbeanexception
- 包装一个分布式通信异常。- 另请参见:
modelmbeaninfo.setmbeandescriptor(javax.management.descriptor)