[转载]Swing第二刀:枝间新绿一重重 – Java综合 – Java – JavaEye论坛.
关于绿色
喜欢绿色,喜欢雅黑,无可救药。在这个吵吵闹闹的软件行业,绿色也忽然从“春风一拂千山绿”唯美变成俗 不可耐的buzzword。比如:
- 绿色软件:大大的buzzword。忽然一夜之间,所有的软件都绿色了,好像不“绿”就跟不上形势。比如绿色杀毒,绿色OFFICE,绿色 ERP,绿色windows。反正全绿。
- 绿色征途:看,精神鸦~片也可以很“绿”的;
- 绿~坝-花季护航:呃,老好的软件,不多说了;
- 绿色世博:嗯,喊的老响了。至今一头雾水。
框架,还是框架
这个程序的设计初衷是快速建立一个美观的Swing应用程序外观。但是,具体来说,它又并非完全是下面 几个东西:
- LookAndFeel:这个程序并非一个LnF。一个LnF会对所有的Swing组件进行重新定义Paint并可以通过 UIManager.setLookAndFeel进行启用。这个程序用到了大量LookAndFeel的机制,甚至也直接定义了不少UI。不过它并不是 一个完整的LookAndFeel。这些定制完全是为这个程序框架服务的。也就是说,这些UI和重绘机制只有在当前的程序框架起作用,而无法指望一句 UIManager.setLookAndFeel就将你的任意Swing程序变成上图风格。
- 组件库:也不是组件库。其实里面的组件,除了这个OutlookPane(左侧的模块树)是完全新做出来的(而且没有从JTabbedPane继 承,也许理论上还经不起太严谨的推敲),其他的组件都是很简单、现成的。例如列表、按钮、菜单等,都是直接用Swing的,只是重载了一些方法或者定义了 UI而已。而且我并非是想让大家直接new OutlookPane()这样来使用,而是使用XML文件对整个界面进行配置使用;
- GUI程序框架:似乎有点大。这仅仅是一个很小的程序而已。
做Java的喜欢满嘴Framework。你要是不能气定神闲一口气提到20个Framework并有 意无意的暗示自己很精通,那~都不好意思跟人家说话;最好再能挑一个有点名气的,指手画脚、评头论足、怒其不争一下下,那就像大牛了(例如 Hibernate就是个很不错的candidate)。所以,咱这个小程序也就死乞白赖往“框架”上凑凑,反正已经带上了“绿帽子”,也不怕丢人丢到 底。
好吧,这是一个框架,虽然我也不知道框架该怎么定义。反正我的设计初衷是:如果你用Swing开发一个 类似上图结构的应用程序,那么你可以直接用这个框架。这个程序框,包含了上面菜单、地下状态条、左边模块栏、右边功能快捷列表,中间多tab标签页的各种 内容(也提供了几个常用的内容页风格,例如列表、流程图等)。这个窗口已经被封装好,通过XML配置文件来定义菜单、状态条、模块栏、流程图、右边的快捷 列表。同时,这些都是联动的。例如:点击左边的模块栏中的子模块,一个对应的流程图会显示在中间tab页;选中流程图中的节点,可以把该节点相关的功能列 在右侧。点击右侧列表,可以执行各种定义好的动作(动作通过动作码定义,后面会详细介绍)。使用么,直接new 一个窗口类,set各个部分的XML文件名,然后setVisible(true)就OK了。至于中间的各个组件和大家关心的LookAndFeel,则 都定义好了,基本上不用太关心细节。
不管怎么说,我们就叫它“框架”吧。
XML配置
每个应用程序都千奇百怪,功能各异。如何用一个同样的界面来组织呢?的确,这个界面并非适合所有人。不 过这里的所有菜单、按钮、流程图、图标等,其动作都是可以用一个“动作码”类定义的,所有的动作都会回调一个统一的函数。而我们只要在这个函数处插入监 听,就可以拦截具体动作码,执行我们想做的任何事情,例如格式化C盘、往aobama@whitehouse.com邮箱发个垃圾邮件啥的。
例如,要定义主菜单,通过这个XML:
- <?xml version=“1.0” encoding=“UTF-8”?>
- <menubar>
- <menu text=“System”>
- <menu text=“One Sub Module”>
- <menuitem text=“Test Report Item” tooltip=“Tooltip”
- icon=“/free/email.png” action=“A001”/>
- <menuitem text=“Test Report Item” tooltip=“Tooltip”
- icon=“/free/email.png” action=“A001”/>
- <menuitem text=“Test Report Item” tooltip=“Tooltip”
- icon=“/free/email.png” action=“A001”/>
- <menuitem text=“Test Report Item” tooltip=“Tooltip”
- icon=“/free/email.png” action=“A001”/>
- …
- </menu>
- </menubar>
以上XML可以定义一个System的主菜单,以及一个One Sub Module的菜单项,以及一系列的二级菜单。每个菜单都可以设置icon图标、文字、tooltip文字,以及动作码(就是那个action)。如下 图:
左侧的模块栏就是典型的Outlook的风格,很多软件干脆都叫它OutlookPane(我这里也是 如此)。这个OutlookPane的配置,通过如下类似XML:
- <outlook>
- <module text=“Engineering Box”
- icon=“/free/test/module_unselected.png”
- selected_icon=“/free/test/module_selected.png”
- network=“network.xml”>
- </module>
- </outlook>
同样,主模块(也就是每个大分栏)包含了模块栏的文字、icon图标(选中和未选中两个),以及一个 xml文件。这个xml文件包含了一个流程图,流程图包含了具体的子模块。点击展开大模块栏后,所有的子模块也会显示在栏目中,同时模块的流程关系会通过 对应的xml文件中定义的方式,显示在一个图形化的流程图界面中,最终显示在中间的tab页上。
可以看到,左侧的模块列表和中间的图形节点是一一对应的。当鼠标选中节点后(变成橙色),左侧的列表对 应的项也会被选中。同时,和这个节点(代表了一个具体子模块)相关的功能,都会显示在右侧的快捷列表中(这是通过指向的network.xml文件定义 的)
上面例子中的Network.xml内容举例如下:
- <?xml version=“1.0” encoding=“UTF-8”?>
- <network>
- <node x=“30” y=“50”
- text=“AP Prepay”
- network_text=“AP Prepay”
- tooltip=“This is a tooltip of a node”
- icon=“/free/test/module.png”
- list_icon=“/free/test/submodule.png”>
- <button1 tooltip=“Tooltip”
- icon=“/free/test/module_attachment.png” action=“X002”/>
- <button2 tooltip=“Tooltip”
- icon=“/free/test/module_attachment.png” action=“X002”/>
- <button3 tooltip=“Tooltip”
- icon=“/free/test/module_attachment.png” action=“X002”/>
- <shortcuts>
- <separator text=“Most Often Used Reports”/>
- <shortcut text=“Add a Part” tooltip=“Tooltip”
- icon=“/free/submodule.png” action=“Z010”/>
- <shortcut text=“Delete a Part” tooltip=“Tooltip”
- icon=“/free/submodule.png” action=“Z010”/>
- <shortcut text=“AP Aging Report” tooltip=“Tooltip”
- icon=“/free/chart.png” action=“Z010”/>
- <shortcut text=“MRP for All Parts Used this Month” tooltip=“Tooltip”
- icon=“/free/user.png” action=“Z010”/>
- <shortcut text=“Dashboard of this Month” tooltip=“Tooltip”
- icon=“/free/email.png” action=“Z010”/>
- <shortcut text=“All Open Purchase Orders” tooltip=“Tooltip”
- icon=“/free/chart.png” action=“Z010”/>
- <shortcut text=“Search in Address Book” tooltip=“Tooltip”
- icon=“/free/user.png” action=“Z010”/>
- <shortcut text=“All Online Users” tooltip=“Tooltip”
- icon=“/free/email.png” action=“Z010”/>
- <separator text=“Common Reports”/>
- <shortcut text=“All Open Purchase Orders” tooltip=“Tooltip”
- icon=“/free/chart.png” action=“Z010”/>
- <shortcut text=“Search in Address Book” tooltip=“Tooltip”
- icon=“/free/user.png” action=“Z010”/>
- <shortcut text=“All Online Users” tooltip=“Tooltip”
- icon=“/free/email.png” action=“Z010”/>
- <shortcut text=“All Open Purchase Orders” tooltip=“Tooltip”
- icon=“/free/chart.png” action=“Z010”/>
- <shortcut text=“Search in Address Book” tooltip=“Tooltip”
- icon=“/free/user.png” action=“Z010”/>
- <shortcut text=“All Online Users” tooltip=“Tooltip”
- icon=“/free/email.png” action=“Z010”/>
- <shortcut text=“All Open Purchase Orders” tooltip=“Tooltip”
- icon=“/free/chart.png” action=“Z010”/>
- <shortcut text=“Search in Address Book” tooltip=“Tooltip”
- icon=“/test/user.png” action=“Z010”/>
- <shortcut text=“All Online Users” tooltip=“Tooltip”
- icon=“/free/email.png” action=“Z010”/>
- </shortcuts>
- </node>
- </network>
其中,每个node定义了一个子模块节点。节点上包含x、y坐标信息、文本信息、tooltip、 icon图标(中间大的主图标),以及三个按钮。每个node如图所示,可以携带3个按钮。每个按钮可以挂一个图标、tooltip、icon以及动作 码。我们可以定义其任意动作。
然后,每个node又携带了一个shortcuts列表,包含了这个节点所有相关的功能点,在node 被选中后,以右侧的列表方式列出。如图所示:
此外,流程图中的箭头是通过类似如下XML在network.xml中定义:
- <arrow x=“170” y=“80” direction=“left” rotation=“0”/>
其中x、y是坐标,direction是方向,可以是上下左右以及斜向共8个方向。此外 rotation还提供了旋转角度。如果right_up这个45度的右上角度不符合要求,可以在增加rotation进行进一步调节。
右侧快捷列表的分割文字,也是通过如下xml进行定义:
- <shortcuts>
- <separator text=“Most Often Used Reports”/>
- <shortcut text=“Add a Part” tooltip=“Tooltip”
- icon=“/free/test/submodule.png” action=“Z010”/>
- …
分隔条可以携带一个文字,用来对很多列表项进行分组:
还有工具条也是可以配置的。工具条在这个框架里被放在了模块栏的顶部。通过如下XML配置其按钮:
- <?xml version=“1.0” encoding=“UTF-8”?>
- <toolbar>
- <button tooltip=“Tooltip” icon=“/free/test/message.png” action=“B001” />
- <separator/>
- <button tooltip=“Tooltip” icon=“/free/test/user.png” action=“B001” />
- <separator/>
- <button tooltip=“Tooltip” icon=“/free/test/email.png” action=“B001” />
- <separator/>
- <button tooltip=“Tooltip” icon=“/free/test/viewer.png” action=“B001” />
- <separator/>
- <button tooltip=“Tooltip” icon=“/free/test/chart.png” action=“B001” />
- <separator/>
- <button tooltip=“Tooltip” icon=“/free/test/capture.png” action=“B001” />
- <separator/>
- <button tooltip=“Tooltip” icon=“/free/test/image_edit.png” action=“B001” />
- <separator/>
- </toolbar>
其中<separator>定义了一个分割竖线 ,完全美观之用。显示效果如下:
最后一个配置项是软件右上角的LOGO。每个系统都想有一个地方漂亮的显示咱家的LOGO,那才有成就 感!这里通过menubar菜单的XML文件如下配置:
- <logo image=“/free/test/logo_company.png” tooltip=“WPT Power Transmission” />
可以对图片、tooltip进行定义。显示效果如下:
这样,一个完整的”纯绿色“应用程序框架就差不多被”配置“出来了。
程序接口
其实设计初衷是无需使用源代码,直接使用下方提供的jar包即可进行二次开发。因为毕竟通过XML就可 以对界面元素进行定义了。如果要把这个框架集成到你的应用程序中,并执行你的具体动作,只需要对free.Shell这个类进行一个函数重载即可。
- public void command(String action) {
- String message = “Perform action “ + action + “.”;
- this.lbStatusMessage.setText(message);
- }
在Shell这个类中,界面上所有的按钮、菜单、列表等被点击后,都会回调这个Shell的 command方法,并传回action字符串,也就是我们在XML中定义的动作码。接着你就用if else或者case啥的进行处理动作吧!当然也可以调用addTab方法在Shell界面中添加一个tab页面。其使用方法会下次详细阐述。
关于效率、内存、布局和其他
有朋友说很担心执行效率、内存占用。这是对Swing常被攻击的的一个老话题了。简单直接的回答 是:Swing效率没问题。内存占用没问题。满眼哗哗一片字符串,就一定占内存吗?table有1000行,渲染的花里胡哨,就内存问题吗?完全不是这么 一回事。例如,如果你了解Swing的table的renderer机制,其实无论表格有多少行,一个列是用同一个renderer实例来paint的。 注意,是一个实例哈。editor也是一样。很多初学者以为这一列用JComboBox编辑,1000行就会create成1000个ComboBox。 那就完全错了。Renderer就是一个“橡皮章”,一个章,不停的在每个格子里面“盖章”,重绘就重新盖;Editor就是当一个“萝卜”,哪个“坑” 需要编辑时,table动态把它“放”在这个单元格(坑)上面,下次下个单元格需要编辑,再被挪过去。对于一个列来说,就一个萝卜,一个橡皮章。怎么会说 “占用内存”?如果说1000行字符串占用内存,那这些字符串用什么语言和平台不占用内存呢?同样字符串在不同的语言和平台上可以说占用内存几乎没什么差 别。这个以后可以专门讨论。
在这个本程序中,状态栏上有一个封装好的内存监控工具条:
它的作用是监测目前Java的总的申请的堆内存以及使用的内存。相关代码如下:
- MemoryMXBean memorymbean = ManagementFactory.getMemoryMXBean();
- long usedMemory = memorymbean.getHeapMemoryUsage().getUsed();
- long totalMemory = memorymbean.getHeapMemoryUsage().getMax();
上面图片中的“18M/63M”标明默认Java堆大小是64M目前使用了18M。尝试多打开一些表格 界面、拓扑图界面,可见内存使用并不是很多。
说Swing的效率低,也不是很有说服力。其实Swing本质还是Java2D在paint东西,看看 那些杂乱的Metal***UI源码就知道了。不过Swing确实设计的够复杂啰嗦,一个LnF就能绕死人。这些机制会导致Swing慢一些。不过说到底 程序的快慢瓶颈还不是在Swing上,还是在如何设计和使用上。例如线程的处理等等,这些都不是初学者很容易搞定的东西。这也导致Swing总是被贴上 “慢”的标签。
自动布局方面,也是比较啰嗦的。如果用IDE的话,推荐NetBeans里面的GUI编辑工具,它使用 的实际是Matisse这个layout。这里有两篇官方文章介绍:
http://wiki.netbeans.org/UsingGUIEditor
http://netbeans.org/features/java/swing.html
如果手写代码,我还是推荐一个超强但比较复杂的TableLayout。这里有其介绍:
http://java.sun.com/products/jfc/tsc/articles/tablelayout/
其他简单的布局,大多可以用Swing内置的几个layout搞定。另外尽量多套用Panel进行嵌 套,化繁为简。不要试图一次一个Panel+Layout把一个复杂的界面搞定,那样会很累。
有朋友很不齿这里使用到了JGoodies和TWaver,这里也说明一下。在JGoodies的基础 上再去定制UI确实美观了不少,不过理论上确实可以彻底抛开JGoodies。这样就要完全彻底重写一整套的LnF了,包括文本框按钮啊所有的东西。目前 确实还没有这样的时间和精力,以后会考虑出一个WithoutJGoodies版本。使用TWaver主要是为了做中间的流程图和拓扑图,并且使用的也比 较顺手了。如果不需要中间的拓扑图流程图,也可以without TWaver,以后会考虑改一版。不过这些东西都是很不错的工具,能用就拿来为我所用,不喜欢用就借鉴一下了事。
程序下载
执行方法:解压zip文件,双击其中的run.bat。
运行环境:Java 6。
其他说明:zip包中的free.jar就是本文提到的框架。其他两个jar包是jgoodies lnf和twaver做流程图的支撑包,可不用理会。
由于牵扯到公司的业务,程序的源代码还在整理之中,预计还要一周左右会整理完毕。到时候一定会跟大家分 享整个程序的源代码。下一次我会详细介绍每一个组件的制作方法和相关代码。
- Free.zip (2.2 MB)