多种通用方法的集合——SwingUtilities

 

技巧：Swing的实用工具SwingUtilities

Swing提供了许多的在Swing组件内部使用的实用工具，SwingUtilities类就是其中一个。它提供了许多的涉及计算、转换、访问控制、布局等方面的方法，这些方法已广泛的应用在各种Swing组件当中。当然，我们也可以把它拿来应用到我们自己的程序当中。 下面我们就来了解一个这些实用的功能. (1)转换方法 MouseEvent convertMouseEvent(Component source, MouseEvent ourceEvent, Component destination) 将一个鼠标事件从一个组件转换到另一个组件上。 Point convertPoint(Component source, int x, int y, Component estination) Point convertPoint(Component source, Point aPoint, Component destination) 将一个组件上的点坐标转换成另一个组件上的坐标点。 void convertPointFromScreen(Point p, Component c) 将一个屏暮坐标点转换成一个组件的坐标点. void convertPointToScreen( Point p, omponent c)   将一个组件上的坐标点转换成屏暮坐标。 Rectangle convertRectangle(Component source, Rectangle aRectangle, Component destination) 将一个组件上的矩形坐标转换成另一个组件上的矩形坐标. (2)计算方法 Rectangle[] computeDifference(Rectangle r1,Rectangle r2) Rectangle computeIntersection(int x, int y, int width, int height, Rectangle dest) Rectangle computeUnion(int x, int y, int width, int height, Rectangle dest) int computeStringWidth(FontMetrics fm, String str) boolean isRectangleContainingRectangle(Rectangle a, Rectangle b) 上面这些方法计算两个矩形之间的差集、交集、并集，还可确定一个矩形是否包括了另一个矩形，以及计算一个字符串的像素宽度. (3)鼠标按钮信息 boolean isLeftMouseButton(MouseEvent anEvent) boolean isMiddleMouseButton(MouseEvent anEvent) boolean isRightMouseButton(MouseEvent anEvent) 以给定的鼠标事件来判定按下了哪个鼠标按钮。 (4)访问控制方法 Component findFocusOwner(Component c) 取得给定组件的焦点组件. Component getLocalBounds(Component aComponent) 取得给定组件的范围(Bounds)信息. Component getRoot(Component c) JRootPane getRootPane(Component c) 取得给定组件的根窗格. Window windowForComponent(Component aComponent) 返回一个组件的视窗Window. (5)组件绘制 String layoutCompoundLabel(FontMetrics fm, String text, Icon icon, int verticalAlignment, int horizontalAlignment, int verticalTextPosition, int horizontalTextPosition, Rectangle viewR, Rectangle iconR, Rectangle textR, int textIconGap) String layoutCompoundLabel(JComponent c, FontMetrics fm, String text, Icon icon, int verticalAlignment, int horizontalAlignment, int verticalTextPosition, int rizontalTextPosition, Rectangle viewR, Rectangle iconR, Rectangle textR, int textIconGap)void paintComponent(Graphics g, Component c, Container p, int x, int y, int w, int h) 这两个方法用于重新布局swing按钮和标签上的文本和图标. void paintComponent(Graphics g, Component c, Container p, int x, int y, int w, int h) void paintComponent(Graphics g, Component c, Container p, Rectangle r) 在任一个图形上绘制一个组件。   /************************************************************/    1. UIManager , Look and Feel , SwingUtilities         最简单的swing程序   JFrame , UIManager , Look and Feel , SwingUtilities ，javaw进程的结束    一、尝试了一下，一个最简单的Swing程序需要9行： view plain copy to clipboard print ? import javax.swing.*;      public class taskman {     public static void main(String[] args) {            JFrame f = new JFrame("任务人II") ;           f.setSize(300,200) ;           f.setVisible(true) ;       }   }    该程序运行结果如下（win XP，使用经典外观）：   回头看代码，是否可以再精简 1. import语句不能省，要不然程序不认识JFrame；    2. 构造JFrame对象(f)，不能省，这时我们要显示的窗口；    3. 设置f的大小，如果不设置，大小为0，等于看不到；    4. setVisible，这个方法将窗口显示出来    5. 当然，可以删除空行，或将代码压缩到一行，不过那样就不好读了。 二、响应窗口关闭事件   上述最小程序是不完整的。表现如下： 1、如果在命令行使用java taskman启动程序，关闭窗口之后，命令行的程序并不结束，必须使用CTRL-C来中止程序执行； 2、如果使用javaw taskman启动，关闭窗口之后，系统中对应的javaw进程不能自动结束，必须使用任务管理器找到进程，手动中止，如果没有察觉到这个现象，反复启动这样的程序后，会发现，虽然所有的窗口都已经关闭，但系统中的javaw进程却会越来越多，最终威胁系统的稳定运行；   为了解决这个问题，我们的最简程序还需要增加一条语句：            f.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 增加这条语句以后的代码如下：    view plain copy to clipboard print ? import javax.swing.*;      public class taskman {       public static void main(String[] args) {            JFrame f = new JFrame("任务人II") ;           f.setSize(300,200) ;           f.setDefaultCloseOperation           (JFrame.EXIT_ON_CLOSE) ;           f.setVisible(true) ;       }   }   在关闭这个程序产生的窗口时，java将调用System.exit(0)，相关的java或javaw进程就会同时结束了。     三、窗口的外观一致性 响应了窗口关闭事件以后，我们的swing程序对操作系统而言已经是一个“行事检点”的模范程序了，然而看起来窗口的样子还是怪怪的，尤其是在窗口中添加了控件以后，总觉得边框和窗口主面板不协调，查了查文档，知道可以通过UIMagager解决这个问题，即在程序一开始使用如下三条语句：  view plain copy to clipboard print ? String lnf = UIManager.getCrossPlatformLookAndFeelClassName() ;   UIManager.setLookAndFeel(lnf) ;   JFrame.setDefaultLookAndFeelDecorated(true) ;    修改后的程序外观如下：          代码如下：    view plain copy to clipboard print ? import javax.swing.*;      public class taskman {       public static void main(String[] args)        throws Exception {           String lnf = UIManager           .getCrossPlatformLookAndFeelClassName() ;           UIManager.setLookAndFeel(lnf) ;           JFrame.setDefaultLookAndFeelDecorated(true) ;                      JFrame f = new JFrame("任务人II") ;           f.setSize(300,200) ;           f.setDefaultCloseOperation           (JFrame.EXIT_ON_CLOSE) ;           f.setVisible(true) ;       }   }    四、swing的java线程安全要求   统一了外观以后，再与swing tutorials对照， 发现还有一个关键的东西：SwingUtilities.invokeLater。 查了查资料，发现如果不用这个东西，会有swing线程不安全的问题，使用这个东西后，代码明显复杂了： view plain copy to clipboard print ? import javax.swing.*;      public class taskman {       public static void main(String[] args)        throws Exception {           String lnf = UIManager           .getCrossPlatformLookAndFeelClassName() ;           UIManager.setLookAndFeel(lnf) ;           JFrame.setDefaultLookAndFeelDecorated(true) ;                      SwingUtilities.invokeLater(new Runnable(){               public void run() {                   make_ui() ;               }           }) ;       }              static void make_ui() {           JFrame f = new JFrame("任务人II") ;           f.setSize(300,200) ;           f.setDefaultCloseOperation           (JFrame.EXIT_ON_CLOSE) ;           f.setVisible(true) ;       }   }       /************************************************************/  2. SwingUtilities , invokeLater , 线程安全   SwingUtilities 和线程安全 多线程是图形界面程序的本质特征，几乎所有图形界面程序都要响应按钮、文本框、菜单等控件触发的事件，为了完成这些任务，必须使用多线程。 对于不熟悉多线程程序的人来说，需要一段时间来理解和适应多线程的程序设计。 Swing规范要求，在Swing控件可见以后，所有对其外观的修改都应当采用如下的形式： view plain  copy to clipboard  print ? SwingUtilities.invokeLater(new Runnable(){       public void run() {                     // ...                    // 修改GUI控件的外观       }   }) ;   并说明，“由于swing不是线程安全的，不采用这种方式可能会出现意想不到的错误...“ 对于不太了解Swing的人来说，这个要求真可以说是莫名其妙，在我对此感到莫名其妙的时候，我也比较好奇，会产生什么意想不到的错误呢？ 要说明这个问题，可以用一个具体的例子配合实验来说明。 假设我们用swing实现如下一个应用： 名称：通知 说明：这个swing程序将在启动后，访问网络，将网络上以某种加密格式存储的通知信息显示出来。 界面示例：   上图中"用户需要的数据"就是通知内容。 经过研究，我们决定使用JTextArea作为显示通知的控件，从网络上拿到通知文本以后，使用如下JTextArea指令将通知内容显示出来： data.setText(str) ; 一个看起来很简单的应用。 可是在我们进行了实现，并做了一些优化以后，却发现时不常的，我们的通知内容不能显示出来，初步调查显示，在无法显示通知时，java控制台会出现一条异常：    这也许就是传说中的意想不到的错误。 下面我们将使用最多不超过80行的本地程序来模拟这个错误的呈现。 最初我们做了如下实现： view plain  copy to clipboard print ? import javax.swing.*;      public class taskman_serial {              taskman_serial() {           // 从网上获取通知内容              String str = "这是用户需要的数据" ;                         JTextArea data = new JTextArea(str) ;           JFrame frame =  new JFrame( "任务人II") ;           frame.setSize( 300,  200) ;           frame.setDefaultCloseOperation           (JFrame.EXIT_ON_CLOSE) ;           frame.setContentPane(data) ;                      frame.setVisible(true) ;       }          public static void main(String[] args)        throws Exception{           String lnf = UIManager              .getCrossPlatformLookAndFeelClassName() ;              UIManager.setLookAndFeel(lnf) ;              JFrame.setDefaultLookAndFeelDecorated(true) ;                        new taskman_serial() ;       }   }   运行这个程序，看起来完美的实现了设计要求。 但是，在用户使用了一段时间以后，却提出了一个设计要求之外的需求： 有时候，获取网络上的通知信息需要十几秒甚至更长的时间，而在这段时间内，屏幕一直没有反映，让人感觉程序没有启动，结果重复的双击图标，一会儿出现了一大堆通知窗口。 ok，我们改进程序如下： 1、启动后立即显示程序窗口，通知区域显示”正在获取通知“； 2、装载通知以后，再将通知显示出来 看来肯定需要线程来帮忙了， 1、我们分别启动两个线程，一个获取数据，一个创建gui， 2、GUI创建完成以后马上显示出来，而得到数据以后，再更新数据区域， 3、为了使两个线程都可以访问JTextArea，我们把它定义为taskman的属性变量 为了模拟耗时的网络操作，我们编写了子程序op，用于模拟访问网络消耗的毫秒数： view plain  copy to clipboard  print ? void op(long millis) {        try {            Thread.sleep(millis) ;       } catch (Exception exc) {}   }   完整代码如下： view plain  copy to clipboard  print ? import javax.swing.*;      public class taskman_thread {       JTextArea data ;              taskman_thread() {           Thread t_ui = new Thread() {                public void run() {                    make_ui() ;               }           } ;           Thread t_load = new Thread() {                public void run() {                    load_data() ;               }           } ;                      t_ui.start() ;           t_load.start() ;       }          void make_ui() {            data = new JTextArea("正在获取数据...") ;           JFrame frame = new JFrame("任务人II") ;           frame.setContentPane(data) ;           frame.setDefaultCloseOperation           (JFrame.EXIT_ON_CLOSE) ;           frame.setSize(300, 200) ;           frame.setVisible(true) ;       }              void load_data() {            // 用3000毫秒时间访问网络，将得到的数据显示在控件中           op(3000) ;           data.setText("这是用户需要的数据") ;       }              void op(long millis) {            try {                Thread.sleep(millis) ;           } catch (Exception exc) {}       }          public static void main(String[] args)        throws Exception{           String lnf = UIManager              .getCrossPlatformLookAndFeelClassName() ;              UIManager.setLookAndFeel(lnf) ;              JFrame.setDefaultLookAndFeelDecorated(true) ;                 new taskman_thread() ;       }   }   经运行，达到预期要求，程序在启动后立即显示了GUI画面，并在稍后完成了网络访问，刷新了通知区域 噩梦是在一个管理需求后开始的，需求说，程序需要在启动后，要到中心服务器获取用户的权限，如果用户可以发布通知，界面上要有发布通知的控件，否则，界面仍然和原来一样。  只须在子程序make_ui()的首部增加语句op(4000)，就可以模拟这个问题： view plain  copy to clipboard  print ? void make_ui() {        op(4000) ;       // 获取用户权限信息        data = new JTextArea("正在获取数据...") ;       JFrame frame = new JFrame("任务人II") ;       frame.setContentPane(data) ;       frame.setDefaultCloseOperation       (JFrame.EXIT_ON_CLOSE) ;       frame.setSize(300, 200) ;       frame.setVisible(true) ;   }   修改其中op()的参数，如果是2000，肯定不会有问题，如果大于3000，就会出问题。 问题显而易见，由于make_ui的执行时间延长了，当得到了数据但JTextArea还未完成初始化时，就会出现问题。 好了，如果是这样，该用SwingUtilities了，是否应该这样写代码： view plain  copy to clipboard  print ? taskman_ok() {       Thread t_ui = new Thread() {            public void run() {                make_ui() ;           }       } ;       Thread t_load = new Thread() {            public void run() {                load_data() ;           }       } ;              SwingUtilities.invokeLater(t_ui);       SwingUtilities.invokeLater(t_load) ;   }   运行一下结果正常了，时间长了很多，原来4秒可以完成通知的下载和显示，现在需要7秒了，make_ui()和load_data()实际上又变成了串行执行。 再改进，仅把与GUI相关的指令序列放进SwingUtilities，这回OK了，既可以最快的打开界面，又可以并行的获取数据了。 完整代码如下： view plain  copy to clipboard  print ? import javax.swing.*;      public class taskman_ok {       JTextArea data ;              taskman_ok() {           Thread t_ui = new Thread() {                public void run() {                    make_ui() ;               }           } ;           Thread t_load = new Thread() {                public void run() {                    load_data() ;               }           } ;                      SwingUtilities.invokeLater(t_ui);           t_load.start() ;       }          void make_ui() {            op(4000) ;           // 获取用户权限信息            data = new JTextArea("正在获取数据...") ;           JFrame frame = new JFrame("任务人II") ;           frame.setContentPane(data) ;           frame.setDefaultCloseOperation           (JFrame.EXIT_ON_CLOSE) ;              frame.setSize(300, 200) ;           frame.setVisible(true) ;       }              void load_data() {            // 用3000毫秒时间访问网络，将得到的数据显示在控件中            op(3000) ;           SwingUtilities.invokeLater(new Runnable(){               public void run() {                    data.setText("这是用户需要的数据") ;               }           }) ;       }              void op(long millis) {            try {                Thread.sleep(millis) ;           } catch (Exception exc) {}       }          public static void main(String[] args)        throws Exception{           String lnf = UIManager              .getCrossPlatformLookAndFeelClassName() ;              UIManager.setLookAndFeel(lnf) ;              JFrame.setDefaultLookAndFeelDecorated(true) ;                 new taskman_ok() ;       }   }