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

subnetwork

墨衍会员 · AI 创作全网分发码龄17年

关注

原创最新推荐文章于 2026-05-06 10:15:18 发布 287 阅读 AI 写同款· GEO 优化 ›

继续上一章的介绍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类，编写下面的代码：

 
import java.awt.BorderLayout; 

import java.awt.Component; 

import javax.swing.JFrame; 

   04 

import twaver.*; 

import twaver.network.TNetwork; 

   07 

public class HelloTWaver { 

    public static void main(String[] args) { 

        //创建DataBox 

        TDataBox box = new TDataBox(); 

   12 

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

        Node node = new Node(); 

        node.setName("Hello"); 

        node.setLocation(10, 10); 

        box.addElement(node); 

   18 

        Node node2 = new Node(); 

        node2.setName("TWaver"); 

        node2.setLocation(200, 150); 

        box.addElement(node2); 

   23 

        Link link = new Link(node, node2); 

        link.setName("Hello TWaver"); 

        link.putLinkLabelRotatable(true); 

        box.addElement(link); 

   28 

        //定义拓扑图组件 

        TNetwork network = new TNetwork(box); 

   31 

        //显示拓扑图组件 

        showFrame("Hello TWaver", network); 

    } 

   35 

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

        JFrame frame = new JFrame(); 

        frame.setTitle(title); 

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

        frame.setSize(800, 600); 

        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); 

        TWaverUtil.centerWindow(frame); 

        frame.setVisible(true); 

        return frame; 

    } 

   46}

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

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

增加树，表格和属性页

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

 
public class HelloTWaver { 

    public static void main(String[] args) { 

        ... 

        //创建树组件 

        TTree tree = new TTree(box); 

   06 

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

        TPropertySheet sheet = new TPropertySheet(box); 

        sheet.setEditable(true); 

   10 

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

        TElementTable table = new TElementTable(box); 

        table.setElementClass(Element.class); 

        table.setEditable(true); 

   15 

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

        JScrollPane tablePanel = new JScrollPane(table); 

        JScrollPane sheetPanel = new JScrollPane(sheet); 

   19 

        //显示这些组件 

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

    } 

   23 

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

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

        return showFrame(title, mainPane); 

    } 

   28 

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

        JSplitPane mainPane = new JSplitPane(); 

        if (isHorizontal) { 

            mainPane.setRightComponent(secondPane); 

            mainPane.setLeftComponent(firstPane); 

            mainPane.setDividerLocation(location); 

        } else { 

            mainPane.setOrientation(JSplitPane.VERTICAL_SPLIT); 

            mainPane.setBottomComponent(secondPane); 

            mainPane.setTopComponent(firstPane); 

            mainPane.setDividerLocation(location); 

        } 

        return mainPane; 

    } 

    ... 

   44}

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

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

添加告警

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

 
   01//添加分组

   02 Group group = new Group(); 

   03 group.setExpand(true); 

   04group.addChild(node);

   05group.addChild(node2);

   06group.addChild(link);

   07box.addElement(group);

   08 

   09//添加告警

   10AlarmModel alarmModel = box.getAlarmModel();

   11//告警与node2关联

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

   13alarmModel.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数据驱动视图的使用习惯。

收录于