TWaver图形界面之道（五）Hello TWaver

继续上一章的介绍TWaver图形界面之道（四）如何申请与技术支持

本章将以一个入门示例开始，介绍TWaver的基本使用，设计思想以及开发流程，如果你已经熟悉了TWaver的使用，熟悉了TWaver的MVC的设计模式，可跳过本章节。

Hello TWaver

以一个经典示例开始，创建两个节点和一条连线，并在不同组件中展现，然后我们会追加告警，观察界面的变化。

开发环境

TWaver有多个产品分支，不同的编程语言有不同的开发环境，比如TWaver Java支持JDK1.4+，TWaver Web支持各主流浏览器，TWaver Flex要求Flex SDK 3.4.2+，TWaver .NET需要.NET Framework 3.5+，Silverlight 3.0+，而HTML5版本要求比较现代的浏览器。不同的语言开发平台也不同，这些在我们的开发手册中都有介绍，本书不再重复：

TWaver Java入门：http://doc.servasoftware.com/pages/viewpage.action?pageId=18415915

TWaver Web入门：http://doc.servasoftware.com/pages/viewpage.action?pageId=19010174

TWaver Flex入门：http://doc.servasoftware.com/pages/viewpage.action?pageId=16547882

TWaver .NET入门：http://doc.servasoftware.com/pages/viewpage.action?pageId=19008968

TWaver HTML5入门：http://doc.servasoftware.com/pages/viewpage.action?pageId=20776443

以TWaver Java为例

首先我们需要twaver.jar，这可以在TWaver Java试用包中找到，关于如何TWaver的申请可以阅读前面的章节：“TWaver如何获取”。

创建一个拓扑图

我们使用Eclipse开发工具，新建一个Java应用程序工程，引入twaver.jar，创建HelloTWaver类，编写下面的代码：

01	import java.awt.BorderLayout;

02	import java.awt.Component;

03	import javax.swing.JFrame;

04

05	import twaver.*;

06	import twaver.network.TNetwork;

07

08	public class HelloTWaver {

09	public static void main(String[] args) {

10	//创建DataBox

11	TDataBox box = new TDataBox();

12

13	//增加两个节点和一条连线

14	Node node = new Node();

15	node.setName("Hello");

16	node.setLocation(10, 10);

17	box.addElement(node);

18

19	Node node2 = new Node();

20	node2.setName("TWaver");

21	node2.setLocation(200, 150);

22	box.addElement(node2);

23

24	Link link = new Link(node, node2);

25	link.setName("Hello TWaver");

26	link.putLinkLabelRotatable(true);

27	box.addElement(link);

28

29

//定义拓扑图组件

30	TNetwork network = new TNetwork(box);

31

32

//显示拓扑图组件

33	showFrame("Hello TWaver", network);

34

}

35

36	public static JFrame showFrame(String title, Component component) {

37	JFrame frame = new JFrame();

38	frame.setTitle(title);

39	frame.getContentPane().add(component, BorderLayout.CENTER);

40	frame.setSize(800, 600);

41	frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

42	TWaverUtil.centerWindow(frame);

43	frame.setVisible(true);

44	return frame;

45

}

46

}

细看代码，分为四部分：创建DataBox；增加两个节点和一条连线；定义拓扑图组件；显示拓扑图。

运行代码，得到如下界面：

增加树，表格和属性页

然后增加树，表格，属性页等组件，并用JSplitPane布局显示，代码如下：

01	public class HelloTWaver {

02	public static void main(String[] args) {

03

...

04

//创建树组件

05	TTree tree = new TTree(box);

06

07	//创建属性页组件，并设置为可编辑

08	TPropertySheet sheet = new TPropertySheet(box);

09	sheet.setEditable(true);

10

11	//创建表格组件，设置为可编辑

12	TElementTable table = new TElementTable(box);

13	table.setElementClass(Element.class);

14	table.setEditable(true);

15

16	//分别将属性页和表格组件放置在滚动面板中，这样可以保证表头的正确显示

17	JScrollPane tablePanel = new JScrollPane(table);

18	JScrollPane sheetPanel = new JScrollPane(sheet);

19

20

//显示这些组件

21	showSplitPane("Hello TWaver", getSplitpane(tree, sheetPanel, 300, false), getSplitpane(network, tablePanel, 300, false), 100);

22

}

23

24	public static JFrame showSplitPane(String title, JComponent left, JComponent right, int leftLocation) {

25	JSplitPane mainPane = getSplitpane(left, right, leftLocation, true);

26	return showFrame(title, mainPane);

27

}

28

29	public static JSplitPane getSplitpane(JComponent firstPane, JComponent secondPane, int location, boolean isHorizontal) {

30	JSplitPane mainPane = new JSplitPane();

31	if (isHorizontal) {

32	mainPane.setRightComponent(secondPane);

33	mainPane.setLeftComponent(firstPane);

34	mainPane.setDividerLocation(location);

35

} else {

36	mainPane.setOrientation(JSplitPane.VERTICAL_SPLIT);

37	mainPane.setBottomComponent(secondPane);

38	mainPane.setTopComponent(firstPane);

39	mainPane.setDividerLocation(location);

40

}

41	return mainPane;

42

}

43

...

44

}

上面的代码创建了树，表格。属性页组件，添加到窗体面板，这里有两个细节值得注意：一个是JScrollPane的使用，Swing中的表格组件需要放置在滚动面板，也就是JScrollPane中，这样表格列头才能正常显示，TWaver中的表格组件和属性页组件都是继承于Swing的JTable，所以需要用JScrollPane包装一下；还有一个细节是代码设置了表格和属性页为可编辑，简单的一行代码，就可以实现节点和连线属性的编辑。

让我们来运行程序，得到如下界面：

添加告警

最后来尝试告警的使用，为了更好的展示告警传递效果，这里修改了网员的层次结构，增加了一个分组元素，并将前面创建的两个节点和一条连线设置为这个分组的孩子节点，然后我们像告警容器中添加一条紧急告警，这个告警与节点”TWaver”关联，添加下面的代码：

01

//添加分组

02	Group group = new Group();

03	group.setExpand(true);

04	group.addChild(node);

05	group.addChild(node2);

06	group.addChild(link);

07	box.addElement(group);

08

09

//添加告警

10	AlarmModel alarmModel = box.getAlarmModel();

11	//告警与node2关联

12	Alarm alarm = new Alarm(node2.getID(), AlarmSeverity.CRITICAL);

13	alarmModel.addAlarm(alarm);

运行界面如下，告警在拓扑图组件和树组件都有展示，节点“TWaver”被渲染为红色，它上面的红色冒泡（1C）表示有一条级别为紧急的新发告警产生，网元上的告警还会向其父节点传递，拓扑图和树图上都可以看到分组节点的渲染边框。点击节点“TWaver”属性页中可以显示它的告警状态属性。

Hello TWaver 示例的启示

每个TWaver产品分支有各自的Hello TWaver示例，这是TWaver入门的第一课，通过简单的示例，传递给大家对TWaver开发的一些启示：代码简洁，直观，实时联动，模型与视图分离。

代码简单

除了TWaver Web涉及到前后台的结合，比较复杂外，TWaver其他产品分支都很容易入门，比如TWaver Java的示例，只需要一个Java类，几行代码就可以制作一个完整的，可以操作的拓扑图界面，不需要安装第三方插件，不需要配置，都是最基本的Java编程，Flex编程或者.NET程序开发。

编码直观

界面编程最大的好处就是直观，每一行代码的设置在界面上都能直接看到效果，同样TWaver的特性很容易直观的展现，可以去尝试修改网元的样式属性，直接运行就可以看到效果，这为TWaver的学习提供了帮助，如果配合上我们的编辑器，很多图形效果都可以自己摸索和发现。

界面联动

TWaver的强大之一体现在多种界面之间的数据同步，交互同步，在Hello TWaver中我们可以看到，简单的创建组件，无需额外的代码，就能实现拓扑图的拖拽，框选，缩放等操作，各个组件中都可以同步选中网元，显示被选中网元的信息可以在属性表中显示，并且能够直接编辑，同步更新到各个组件。

M-V分离

通过Hello TWaver的示例还能了解到TWaver的开发习惯，TWaver使用MVC的设计模式，在入门示例中我们可以很明显的体会到M-V的关系，M就是数据，创建网元添加到数据容器，V是视图组件，创建组件，关联上M（数据容器）即可，如果不需要特殊的交互，组件的创建往往只是一行代码，更多的工作在于数据的填充，这正是TWaver数据驱动视图的使用习惯。