概述
本文檔是原型Swing應用程序框架的簡介，目標讀者是那些愿意評論初始原型的的開發者。它既不是綜合的教程，也不是開發者指南，它只是通過示例引入框架主要特性的概觀。在檢查規格說明（javadoc）和實現之前，閱讀本材料是明智之舉。
目標
本API的目標是由原始的Java規格請求（JSR） JSR-296所定義, 它在2006年5月批準。 其整體目標是簡化構建Swing應用程序，讓桌面Java開發人員對此的工作也是直截了當的。通過提供一小組類，也叫“框架”來達到此目標。框架定義了對大多數桌面應用程序的共有的基礎設施：
- 應用程序生命周期管理，特別是GUI的啟動和關閉。
- 對資源管理和載入的支持，這些資源是字符串，格式化的消息，圖像，顏色，字體以及桌面應用程序共有的其他類型的資源。
- 對動作定義，管理和綁定的支持，其中包含了異步運行的動作（在后臺運行）。
- 持久化會話狀態：支持自動地，有選擇地保存應用程序一次運行到下次運行的GUI狀態，比如頂層的窗口幾何位置。
框架API概述
框架應用程序建立Application基類的子類，它定義了應用程序的生命周期，特別是應用程序的啟動時所為，關閉時所為。當應用程序啟動時，建立這個子類的單個實例。ApplicationContext 單體支持Application類的子類。它提供對動作，資源，任務，對話狀態和存儲，其它對象和服務的訪問。它對應用程序來說是全局的。框架的整體結構可根據這兩個單體來描述.
SR-296架構：應用程序（Application），ApplicationContext 單體模式
免責聲明
這是初稿。在許多方面未完成，并且這里所述的API的確在演進當中。它打算為那些對框架API當前狀態好奇并能容忍其瑕疵的開發人員所作。我希望它將激發那種讓代碼和文檔下次修訂更好的建設性反饋來。
應用程序框架示例
對開發者來說，熟悉新的API最容易的方法是通過學習幾個示例。本節提供一系列示例增量式地展示許多API最為重要的方面。每個示例的源代碼可在示例包中找到。
下面的示例節包含類它們依賴的框架類的簡單梗概。要獲得更完整的解釋，請參見下面主要章節，或者查詢javadoc規范。
基于Hello World的Application
為了編寫應用程序，只需要做幾件事情：
- 擴展Application 類并覆蓋startup方法。 startup方法應當建立和顯示應用程序初始的GUI。
- 當應用程序退出時，當用戶關閉最頂層的窗口時，調用Application.exit()。這將導致應用程序讓exitListeners運行并最終運行Application.shudown().
- 在main方法里，調用Application.launch方法。這將構建并啟動在事件分派線程上的Application子類。
下列示例正是這樣做的。實際上基于SingleFrameApplication類這種應用程序非常簡單，因為它處理應用程序JFrame的構建和配置。但是本例這個版本應當使得在SingleFrameApplication 類里的“鉤子下面（under the hood）”發生的事情更加明了。
public class ApplicationExample1 extends Application {
JFrame mainFrame = null;
@Override protected void startup(String[] ignoreArgs) {
JLabel label = new JLabel("Hello World", JLabel.CENTER);
label.setFont(new Font("LucidaSans", Font.PLAIN, 32));
mainFrame = new JFrame(" Hello World ");
mainFrame.add(label, BorderLayout.CENTER);
mainFrame.addWindowListener(new MainFrameListener());
mainFrame.setDefaultCloseOperation(JFrame.DO_NOTHING_ON_CLOSE);
mainFrame.pack();
mainFrame.setLocationRelativeTo(null); // center the window
mainFrame.setVisible(true);
}
private class MainFrameListener extends WindowAdapter {
public void windowClosing(WindowEvent e) {
exit(e);
}
}
public static void main(String[] args) {
launch(ApplicationExample1.class, args);
}
}
如果運行ApplicationExample1，結果如下：
ApplicationExample1 (Hello World) 屏幕截圖
在此仍然存在許多（JFrame)樣板，因為應用程序基類不能假定應用程序到底構建GUI的數量。下一個示例顯示了通過使用一個擴展Application 叫做SingleFrameApplication的類，如何更簡單地完成相同的工作。
基于Hello World的SingleFrameApplication
為了建立只有一個主JFrame的應用程序，只要擴展SingleFrameApplication類即可。應用程序的子類應當覆蓋建立應用程序的主GUI面板的startup方法，然后建立，配置和顯示包含這個面板的JFrame。
public class SingleFrameExample1 extends SingleFrameApplication {
public void startup(String[] args) {
JLabel label = new JLabel(" Hello World ");
label.setFont(new Font("LucidaSans", Font.PLAIN, 32));
show(label);
}
public static void main(String[] args) {
launch(SingleFrameExample1.class, args);
}
}
盡管本例和前面的例子完全一致，但是建立和配置主JFrame的樣本文件是由SingleFrameApplication.show 方法處理的。SingleFrameApplication也負責打點一些其它的公共的生命周期雜務，比如載入資源和保存/恢復對話狀態。
帶有資源的SingleFrameApplication
在前面示例中，建立了帶有文字字符串的JLable。由用戶讀取的字符串應當本地化。為了完成本地化，字符串應當從ResourceBundle載入。應用程序框架支持自動初始化從ResourceBundle資源載入的有名組件的特性。對“資源注入（resource injection）”的支持超出了字符串的范疇；數值的初始值，顏色，字體和大多數其它的公共桌面GUI類型都能夠用資源來定義。
這里是前面例子的新版本。本例除了設置它的名稱之外，對JLabel沒作任何配置：
public class SingleFrameExample2 extends SingleFrameApplication {
public void startup(String[] args) {
JLabel label = new JLabel();
label.setName("label");
show(label);
}
public static void main(String[] args) {
launch(SingleFrameExample2.class, args);
}
}
SingleFrameExample2的ResourceBundle是以相同名字的特性文件，它駐留在資源子包里。文件中的資源定義了一個名叫"label"組件的初始值：
label.opaque = true
label.background = 0, 0, 0
label.foreground = 255, 255, 255
label.text = Hello World
label.font = Lucida-PLAIN-48
label.icon = earth.png
本例簡單演示了配置從ResourceBundle的組件。在實際應用程序里，將使用很可能需要本地化的值的資源，有時是諸如顏色、字體那些和本地化值緊密相關的特性。通過用資源而不是用代碼定義，隔離依賴于像圖像文件之類的外部對象的組件特性也是有用的。這使得開發者比較容易理解應用程序外部資源依賴是什么，并能簡化對系統的變化的處理。
如果運行SingleFrameExample2，那么其效果如下：
SingleFrameExample2 (Hello World) 屏幕截圖
SingleFrameApplication.show方法使用ResourceMap的injectComponents方法初始化從應用程序的ResourceBundle載入的每個有名組件的特性。
退出應用程序
通過調用Applcaiton.exit方法，應用程序應當能順利退出。當關閉主JFrame時，SingleFrameApplication的職責所在。在實際的應用程序里，確保用戶在關閉是真的希望退出經常是重要的。例如，可能希望詢問未保存的文檔或者未完成的事務處理。在exit()真的終止應用程序之前，通過調用canExit方法輪詢所有的exitListener。如果任何一個canExit方法返回false，退出過程將終止。否則，調用exitListener的willExit方法，并最終調用Appliciton 的shutdown方法。這些方法正是打理任何清掃工作的地方。
本例在下面正是用一個對話來詢問用戶確認退出的。
public class SingleFrameExample3 extends SingleFrameApplication {
public void startup(String[] args) {
ExitListener maybeExit = new ExitListener() {
public boolean canExit(EventObject e) {
int option = JOptionPane.showConfirmDialog(null, "Really Exit?");
return option == JOptionPane.YES_OPTION;
}
public void willExit(EventObject e) { }
};
addExitListener(maybeExit);
JButton button = new JButton();
button.setName("button");
button.setAction(new ActionAdapter() {
public void actionPerformed(ActionEvent e) {
exit(e);
}
});
show(button);
}
public static void main(String[] args) {
launch(SingleFrameExample3.class, args);
}
}
本例的ResourceBundle和前面相似，既然這樣還是配置了這個JButton。也增加了一個定義主JFrame的標題的資源。SingleFrameApplication命名它建立的JFrame為"mainFrame"。
mainFrame.title = ExitListener Demo
button.background = 255, 255, 255
button.foreground = 0, 0, 0
button.text = Click to Exit
button.font = Lucida-PLAIN-48
button.icon = exit.png
如果運行SingleFrameExample3，單擊窗口的關閉按鈕或者按下巨大的“Click to Exit”按鈕嘗試退出時，將提示操作者確認：
SingleFrameExample3 屏幕截圖
在本例里，使用建立一個實現了javax.swing.Action的匿名類的實例的常規方法來設置按鈕的動作特性。動作對象的actionPerformed方法只是調用exit。應用程序框架則通過使用新的@Action標注從而建立動作對象的建立。
（待續，請參見：Swing應用程序框架（Swing Application Framework）API緒論（JSR-296）之二（翻譯）)