图1:DesktopDemo用户接口 |
public DesktopDemo() { //初始化所有的GUI组件. initComponents(); // 停用启动浏览器和电子邮件客户端的按钮 // 停用打开,编辑和打印文件的按钮 disableActions(); ... } /** * 停用所有的图形组件,直到我们了解 * 是否支持它们的功能. */ private void disableActions() { txtBrowserURI.setEnabled(false); btnLaunchBrowser.setEnabled(false); txtMailTo.setEnabled(false); btnLaunchEmail.setEnabled(false); rbEdit.setEnabled(false); rbOpen.setEnabled(false); rbPrint.setEnabled(false); txtFile.setEnabled(false); btnLaunchApplication.setEnabled(false); } ... public javax.swing.JTextField txtBrowserURI; public javax.swing.JButton btnLaunchBrowser; public javax.swing.JTextField txtMailTo; public javax.swing.JButton btnLaunchEmail; public javax.swing.JRadioButton rbEdit; public javax.swing.JRadioButton rbOpen; public javax.swing.JRadioButton rbPrint; public javax.swing.JTextField txtFile; public javax.swing.JButton btnLaunchApplication; |
Desktop desktop = null; //在使用更多的Desktop API前,首先检查 //是否这种API为该特定主机上的特别的虚拟机所支持。 if (Desktop.isDesktopSupported()) { desktop = Desktop.getDesktop(); ... |
如果你的应用程序在调用getDesktop()之前不使用isDesktopSupported()进行API支持检查,那么它必须准备捕获一个UnsupportedOperationException异常-当你的应用程序在一个不支持这种特性的平台上请求一个Desktop实例时将抛出这种异常。另外,如果你的应用程序运行于一种无键盘、鼠标和监视器环境下,该getDesktop()方法将抛出一个java.awt.HeadlessException异常。
一旦检索完毕,该Desktop实例即允许你的应用程序浏览、邮寄、打开、编辑或甚至打印一个文件或URI,但是只有在被检索的Desktop实例支持这些活动的前提下才行。每个这些活动被称为一个行为(Action),并且每一个行为被描述为一个Desktop.Action枚举实例:
· BROWSE-描述主机的默认浏览器执行的一种浏览行为
· MAIL-描述主机的默认电子邮件客户端执行的一种邮件行为
· OPEN-描述一种与打开一特定的文件类型相关联的应用程序执行的打开行为
· EDIT-描述一种与编辑一特定的文件类型相关联的应用程序执行的编辑行为
· PRINT-描述一种与打印一特定的文件类型相关联的应用程序执行的打印行为
在调用任何这些行为之前,一个应用程序必须确定是否该Desktop实例支持它们。这与确定是否一个Desktop实例可用是有所不同的。这个Desktop.isDesktopSupported()方法告诉你是否能够创建一个实例。一旦获得一个Desktop对象,你就可以查询该对象来确定支持哪些特定类型的行为。如果该Desktop对象不支持特定的行为,或如果该桌面API本身并不被支持,那么DesktopDemo简单地停用那些受影响的图形组件。如图2所示,在停用状态下,不能使用这些组件来调用桌面特性。
图2:当不支持桌面API时图形组件被停用。 |
通过使用一个新的Desktop实例,下列代码检查负责是否支持Desktop.Action并且启用适当的图形组件:
public DesktopDemo() { ... //在使用更多的桌面API前,首先检查 //是否这种API为该特定主机上的特别的虚拟机所支持。 if (Desktop.isDesktopSupported()) { desktop = Desktop.getDesktop(); // 现在,启用按钮以实现被支持的行为 enableSupportedActions(); } ... } /** *启用在该主机上被支持的行为。 *这些行为有:打开浏览器, *打开电子邮件客户端,和使用它们相关联的应用程序打开,编辑与打印文件。 */ private void enableSupportedActions() { if (desktop.isSupported(Desktop.Action.BROWSE)) { txtBrowserURI.setEnabled(true); btnLaunchBrowser.setEnabled(true); } if (desktop.isSupported(Desktop.Action.MAIL)) { txtMailTo.setEnabled(true); btnLaunchEmail.setEnabled(true); } if (desktop.isSupported(Desktop.Action.OPEN)) { rbOpen.setEnabled(true); } if (desktop.isSupported(Desktop.Action.EDIT)) { rbEdit.setEnabled(true); } if (desktop.isSupported(Desktop.Action.PRINT)) { rbPrint.setEnabled(true); } if (rbEdit.isEnabled() || rbOpen.isEnabled() || rbPrint.isEnabled()) { txtFile.setEnabled(true); btnLaunchApplication.setEnabled(true); } } |
一旦该应用程序确定了被支持的行为,它即启用适当的图形组件。如果所有的组件都被启用,那么相应的UI应该看上去如图3所示。
图3:当支持桌面API时,启用组件。 |
四、 打开浏览器
调用下列实例方法将打开你的主机的默认浏览器:
public void browse(URI uri) throws IOException |
因为仅当支持相关联的Desktop.ActionDesktopDemo时,UI组件才被启用,所以,在实际调用browse()方法之前,这个简单的演示应用程序不需要进行行为支持检查。然而,在每一种调用之前检查行为支持在实际中将增加程序的健壮性:
if (desktop.isSupported(Desktop.Action.BROWSE)) { //启动浏览器 ... } |
DesktopDemo把一个java.awt.event.ActionListener添加到每一个按钮上。当被启用时,"Launch Browser"按钮通过它的ActionListener调用下列方法:
private void onLaunchBrowser(java.awt.event.ActionEvent evt) { URI uri = null; try { uri = new URI(txtBrowserURI.getText()); desktop.browse(uri); } catch(IOException ioe) { ioe.printStackTrace(); } catch(URISyntaxException use) { use.printStackTrace(); } ... } |
这个browse()方法可能抛出各种类型的异常,这包括:当该URI为null时抛出一个NullPointerException异常;如果不支持BROWSE行为将抛出一个UnsupportedOperationException异常;如果不能发现或启动一个缺省的浏览器或应用程序则抛出一个IOException异常;如果一个安全管理器否定一次调用则抛出一个SecurityException异常。
然而,如果一切顺利,那么听取器(Listener)将从图4中相联系的文本域中检索文本,创建一个URI并且调用browse()方法。上面的代码将启动你的系统的默认浏览器并且指示该浏览器装载该URI,如图5所示。
图4:使用一个特定URI启动默认浏览器。 图5:使用桌面API启动默认浏览器。 |
五、 发送电子邮件
如果支持该行为的话,该应用程序能够启动主机的默认电子邮件客户端-通过调用这个Desktop实例方法:
public void mail(URI uri) throws IOException DesktopDemo为"Launch Mail"按钮提供了一个ActionListener。在这种情况中,该听取器调用下列方法: private void onLaunchMail(java.awt.event.ActionEvent evt) { String mailTo = txtMailTo.getText(); URI uriMailTo = null; try { if (mailTo.length() > 0) { uriMailTo = new URI("mailto", mailTo, null); desktop.mail(uriMailTo); } else { desktop.mail(); } } catch(IOException ioe) { ioe.printStackTrace(); } catch(URISyntaxException use) { use.printStackTrace(); } ... } |
该onLaunchMail()方法从相关的文本域中检索电子邮件接收者,并且在存在一位接收者时使用一种mailto模式的参数创建URI,然后调用mail()方法。这个mail()方法被重载,这样你可以使用(或不使用)一个描述其mailto接收者的URI(见图6)来调用这个方法。
图6:使用一个电子邮件接收者启动默认电子邮件客户端。 |
当创建这个URI时,你可以使用多个电子邮件接收者。这个mailto模式支持CC,BCC,SUBJECT和BODY域。例如,可以使用下列文本来创建一个mailto URI:
mailto:[email protected]?SUBJECT=Happy New Year!&BODY=Happy New Year, Duke!
图7显示出相应的结果。
图7:桌面API使用多个mailto参数启动默认电子邮件客户端。 |
当然,你也可以不使用参数来调用mail()。在这种情况中,你的电子邮件客户端将启动一个新的没有指定接收者、主题或邮件正文的电子邮件窗口。
六、 打开、编辑和打印文件
Java应用程序可以分别使用一个Desktop对象的open(),edit()和print()方法来从与其相联系的应用程序中打开,编辑和打印文件(见图8)。同样,仅在该Desktop实例支持它们时,DesktopDemo才允许这些行为,因此在本应用程序环境下,不必再次进行这种支持检查。
图8:启动与一特定的文件类型相联系的应用程序。 |
DesktopDemo中的每一个单选按钮也都有它自己的ActionListener。在这种情况中,每一个单选按钮都设置一个实例变量,以便描述最近选择的按钮的相关联Desktop.Action:
Desktop.Action action; private void onPrintAction(java.awt.event.ActionEvent evt) { action = Desktop.Action.PRINT; } private void onEditAction(java.awt.event.ActionEvent evt) { action = Desktop.Action.EDIT; } private void onOpenAction(java.awt.event.ActionEvent evt) { action = Desktop.Action.OPEN; } |
当你按下"Launch Default Application"按钮时,它调用它自己的听取器-这将调用下列方法:
private void onLaunchDefaultApplication(java.awt.event.ActionEvent evt) { String fileName = txtFile.getText(); File file = new File(fileName); try { switch(action) { case OPEN: desktop.open(file); break; case EDIT: desktop.edit(file); break; case PRINT: desktop.print(file); break; } } catch (IOException ioe) { ioe.printStackTrace(); } ... } |
这个方法决定选择哪个Desktop.Action并且调用适当的Desktop实例方法-open(),edit()或print()。每个方法都需要一个File参数-它被用于执行要求的行为。
有趣的是,不同的应用程序可以针对甚至相同的文件类型上的这些不同的行为进行注册。例如,可以使用OPEN行为启动Firefox浏览器,使用EDIT行为启动Emacs,甚至使用PRINT行为启动另外不同的应用程序。你的主机桌面的关联用来决定应该调用什么样的应用程序。
注意 使用Mustang中现有桌面API来操作桌面文件关联是不可能的,而且目前只能使用平台依赖的工具来创建或改变这些关联。
七、 总结
桌面集成是Mustang的一个重要主题。Mustang支持这种主题的一种方式是提供一组java.awt.Desktop API。这种API允许Java应用程序启动主机的默认浏览器和电子邮件客户端。另外,Java应用程序能够启动与特定的文件类型相关联的应用程序以打开,编辑和打印文件。尽管Java应用程序不能操作,创建,或改变文件关联,但是这些桌面API确定允许Java应用程序启动默认的相关联的应用程序。