学习笔记3

告警展示
告警可以是新的（new）或已确认的（acknowledged）。在Twaver中，术语本地告警指的是发生在网元对象上的新的或已确认的告警，传播（propagative）告警指的是所有包含的子网元的最高级别本地告警，总告警指的是本地告警和传播告警的最高级别告警。


它们以如下方式展现：
新告警：电信网元对象的新告警在告警气球中通过颜色和文字展现最严重告警的数量和级别。
确认告警：比较新告警和已确认告警的严重程度，在网元对象区域显示最严重的告警颜色。

告警传递：所有包含的子网元最严重告警（不管是新告警还是确认告警）级别的颜色显示在网元边沿

Alarm是一个预定义的，展现电信级设备告警信息的业务对象。在TWaver中，告警对象用来呈现OSS服务器端告警信息，可以从客户端创建或由服务器端创建传递到客户端，可序列化或编码转化成XML格式。TWaver告警仅仅定义了客户端最普遍和最常用的特性，也就是说，是专为客户设计的。在一般情况下，OSS服务器端有更复杂的告警对象，带有更多业务信息，客户端告警可以作为虑服务器端告警凡人简化版本，仅仅包含客户端需要展现的信息。TWaver告警是一个非常轻量级的对象，可以创建几百万告警对象并把它们装入TWaver DataBox. 所有的TWaver告警保存在DataBox告警容器AlarmModel中，利用TDataBox.getAlarmModel（）可以获得AlarmModel对象，每一个告警对象都可以设置ElementID属性，如果设置了ElementbID属性，AlarmModel会查找相关的网元（Element）并自动修改它的AlarmState。告警对象可以像Element一样，利用client properties机制定义并检索用户自定义属性。
添加告警代码示例如下所示：
Alarm alarm=new Alarm("ALM001");

alarm.setElementID("node1");

alarm.setAlarmSeverity(AlarmSeverity.CRITICAL);

alarm.setAcked(true);


box.getAlarmModel().addAlarm(alarm);


AlarmSeverity定义了告警对象的严重程度，在Twaver中，每一个告警对象都需要制定一个告警级别以表明告警信息的严重性。在这个类中，Twaver定义了许多与通常应用相对应的告警级别。开发者可以删除预定义的告警级别，添加自定义的告警级别；也可以修改预定义告警级别的名称、颜色等属性。
注：每一个预定义告警级别都有一个简称（多数情况下，简称只有一个字符），这个简称将会显示在告警气球中以显示告警严重程度。


AlarmState提供了一个电信对象所承载告警对象的展现模型，每一展现在告警系统中告警级别，可以包含一些新告警和一些已确认告警。
AlarmState数据结构：

___________________________________________________________
overall alarms
      |
    native----new-----severity 1           total number
      |        |   |--severity 2           total number
      |        |   |--severity n           total number
      |        |
      |      acknowledged----severity 1    total number
      |                   |--severity 2    total number
      |                   |--severity n    total number
      |
    propagate alarm------------------------propagated severity
___________________________________________________________

新告警可以通过确认操作转化成确认告警
(new alarm)---------acknowledge-------->(acknowledged alarm)

TWaver告警管理和告警统计支持，包括告警组件、告警对象、告警容器
等等。有 AlarmStateStatistics模型可以统计 DataBox中 Element的 AlarmState告
警信息，并且有可设置过滤器只统计感兴趣的图元功能，界面方面有组件。
TAlarmOverview以及组件 TAlarmStatTable，通过表格、饼图、版图的丰富形式显
示告警统计信息。同时 TWaver提供 AlarmModel模型以及Alarm告警对象对全局的
告警进行管理和驱动。告警表格组件 TAlarmTable可以绑定 AlarmModel通过表格方
式直接展示告警内容。
告警信息可以通过图元染色、冒泡、边框染色、闪烁等多种方式表达告警信息。
告警可以通过 AlarmSeverity.registerAlarmSeverity自定义不同的告警级别和告警颜
色，通过 AlarmSeverity.setSeverityComparator可以自定义告警级别的比较规则，
severity.setColor可以动态改变告警级别对应的告警颜色，所有自定义会立刻起效，
无需做任何重启、刷新等类似工作。