关于StatusbarBuilder的说明

相关文章：

一、接口说明

接口方法有4类，包括Builder设置，创建实例，添加显示格和显示提示信息。

 

1. 设置builder

设置状态条的背景颜色

public static void setBackground(Color color);

 

设置状态条中显示格的风格。有2种风格，默认是StatusbarBuilder.LOWERED，这是大多数状态条常见的。另一个是StatusbarBuilder.PLAIN，显示格式为平面。

public static void setBarStyle(int style);

 

设置显示窗格之间的距离。

public static void setGap(int width) ;

 

设置窗格的高度。

public static void setHeight(int height);

 

设置显示提示信息的部件。如果不设置，则使用默认的JLabel作为显示。

public static void setNotice(JComponent comp);

 

一旦对builder做了设定，以后创建的状态条实例都会使用这些设置。调用这个函数可以恢复到默认设置。

public static void reset();

 

2. 创建实例

为一个已存在的窗口创建一个status bar。状态条不检查窗口的布局，直接认定窗口使用BorderLayout布局管理器，并且 把工具条置于窗口下方，适用用大多数应用。

public static StatusbarBuilder getInstance(Window window)

 

如果你用了别的布局管理器，可以使用这个方法。通过传递一个constraints来确定工具条位置。

public static StatusbarBuilder getInstance(Window window, Ojbect constraints)

 

3. 添加显示格

添加一个显示格到状态条

public void add(JComponent comp);

 

添加一个显示格到状态条，并指出固定宽度。这个方法应该比较常用。

public void add(JComponent comp, int solidWidth);

 

添加一个显示格到状态条，指定最小宽度和最大宽度

public void add(JComponent comp, int minWidth, int maxWidth);

 

添加一个显示格到状态条，指定最小宽度、初始宽度和最大宽度

public void add(JComponent comp, int minWidth, int prefWidth, int maxWidth);

 

4. 显示提示信息

显示一条提示信息。比如：notice("准备完毕。");

public void notice(String s);

 

提示信息部件的窗格样式是单独设置的，可以设置成是平的或凹陷的。

public void setNoticeStyle (int style);

 

二、主要设计思想

1. 封装

其实这个状态条只是一个使用BoxLayout作为布局管理的JPanel，使用add(JComponent)修饰窗格并添加到JPanel。我最初的设计就是这样。但是由于JPanle从Container继承而来，所以，如果开发过程中使用add(new Label())，Label是一个Component对象，那么这个Label就会在没有经过add(JComponent)方法的修饰的情况下添加到状态条，导致布局混乱。而add(Component)是public的，后继的继承中不能降低其可见度。所以，我使用了一个非Component子类的包装类来屏蔽外部对JPanel的访问。

 

2. 实例管理

我想我在这里犯了一个错误。看过代码的知道我用一个Hashtable来管理维护window及其申请的实例，对于初次申请的window，为其创建一个状态条，并贮存window和新实例的引用。以后该window再申请时，直接返回已创建的该window相应的实例。同时，我还为每个提出申请的window注册了一个监听器，当window关闭时，消除window和实例的引用。我的意图是在保证一个窗口只能创建一个状态条的同时，随时可以使用getInstance(Window window)获得引用。

 

开始我觉得是个不错的想法，但是到测试时发现问题了（参考我的例子）。当SubWindow关闭之后（关闭模式是DISPOSE_ON_CLOSE），StatusbarBuilder清除了对SubWindow及其对应StatusBar的引用。但是，当点击MainWindow状态条上的“haha”按钮时，SubWindow又恢复了显示。这时，如果再调用getInstance(referenceOfSubWindowInstance)就会出错。这个测试我当时没想到，所以没写到在例子里。窗口重新激活的原因我想是因为jvm的收集机制，只要还有指向该对象的引用，这个对象就不会被回收。我在“haha”按钮的执行代码中就有窗口的引用，并且该引用是final类型。在实际应用中，不排除这种情况的可能，尽管少，并且注意之后会避免，但毕竟是个缺陷，留待后续版本解决。

 

3. SlightBevelBorder

这个类继承了jsdk中的SoftBevelBorder，代码其实很简单。当我有这个想法时，我看了BevelBorder的代码，“原来如此”。所以有时间的话看看jsdk的源代码对提高编程水平是很有帮助的。虽然有些结构很难，但并不都是高不可攀。

 

三、一点心得

学了这么长时间，总算有点成就感了。通过作为一个练习，从中又学到一些设计方法和思路。现在网上有很多实现界面的类，其实，我想说，我们也可以做到，甚至更好。

 

继续努力。

 

 

 

• 关于StatusbarBuilder的说明: 介绍API说明、设计思路以及当前存在的问题。
• SlightBevelBorder.java :SlightBevelBorder类源代码。
• StatusbarBuilder.java：StatusbarBuilder类源代码。
• TestStatusbar.java：测试程序

•