JavaFX綁定探究
在進行JavaFX綁定之前,要明白,JavaFX建立在普通的Java SE運行上。為了在本文中展示這個示例,你需要為你的操作系統(tǒng)(在此只支持官方的Windows 和Mac OS X)下載合適的JavaFX SDK。具體請參考Resources。安裝installation過程只需要幾個步驟。在Windows的機器上,默認安裝地址是C:\Program Files\JavaFX\javafx-sdk1.1. Mac OS X users should look at /Library/Frameworks/JavaFX.framework/Versions/1.1。
|
圖1. JavaFX SDK基礎(chǔ)目錄 |
圖1 顯示了JavaFX SDK的基礎(chǔ)目錄。這個bin目錄包括可執(zhí)行編譯并運行JavaFX Script程序。我們不使用它們。JavaFX(Script)documentation在docs中。文件src.zip包括部分JavaFX運行的來源。如果你打開它,你會注意到文件是以stg 和 .st結(jié)尾的。***lib和它的子目錄包含庫.jars。本文的示例取決于它們中的一些。
Locations
lib/shared/javafxrt.jar包含com.sun.javafx.runtime.location包。它的類和接口來自基本的JavaFX Binding的構(gòu)建塊。例如,Location接口代表一個值,它可能是可變的或是不能改變的,有效或無效的,空的或是非空。這樣的狀態(tài)可以通過相應的getters來查詢,例如,isMutable()。如果Location的值是無效的,當update()方法被調(diào)用時,或該值被檢索時,它會被更新。
一個Location的類型是通過子接口來決定的;例如,IntLocation.。如果你要在src.zip中查詢IntLocation.java,你不會看到它。這是因為它的來源是來自兩個文件XxxLocation.st 和XxxTemplate.stg。每個子接口為類型XYZ添加getAsXYZ和and setAsXYZ()。還有DoubleLocation, FloatLocation, ShortLocation, CharLocation, LongLocation, BooleanLocation, ByteLocation和 ObjectLocation。
其他的對象可能會附屬于一個Location。當值與地址變化聯(lián)系在一起的時候,change listeners可以接收到通知。***,Locations是很懶惰的:雖然當值無效的時候change listeners會得到通知,但是新的值不會被重新計算直到需要它的時候。到目前為止,我指談論了接口的問題。當然,可以為我以上所提到的類型而隨時執(zhí)行Locations。
public static void main(String[] args) {
final IntVariable i1 = IntVariable.make(42); i1.addChangeListener(new ChangeListener() { @Override public boolean onChange() { System.out.println("onChange(): " + i1.get()); return false; } }); System.out.println(i1.get() + ", isMutable(): " + i1.isMutable()); IntLocation i2 = IntConstant.make(24); System.out.println(i2.get() + ", isMutable(): " + i2.isMutable()); i1.set(i2.get()); } |
為了編譯并運行LocationDemo1,請附加lib/shared/javafxrt.jar到你的類路徑上。這個演示示例采用了IntVariable 和IntConstant類。兩個都執(zhí)行了IntLocation接口,因此是Locations。使用靜態(tài)make()方法創(chuàng)建Instances。使用get()查詢當前值。正如你在圖2中所看到的,在初始化引發(fā)一個通知之后,設(shè)置一個值。它通過子抽象類ChangeListener來進行處理。
|
圖2. LocationDemo1輸出 |
當?shù)刂穬?nèi)容已經(jīng)改變的時候,它的onChange()方法被調(diào)用。該方法返回一個Boolean值,指示監(jiān)聽者是否仍然有效。返回false將導致監(jiān)聽者從監(jiān)聽者名單上刪除。Javadoc建議,當相關(guān)的弱引用被報告清除的時候,那些做它們自己弱引用管理的監(jiān)聽者應該返回false。
就像JGoodies Binding的ValueModel,還有Beans Binding的Property一樣,Locations 讀取和編寫類型值提供了一個方法。它們也可以通知注冊的監(jiān)聽者關(guān)于值的變化。***,你將會在以下的小節(jié)中看到它們用于建立綁定。
建立Java綁定
像Beans Binding 和JGoodies Binding一樣,JavaFX運行包含一個輔助類來建立JavaFX綁定:com.sun.javafx.runtime.location.Bindings。它是用于在兩個Locations之間建立bijective關(guān)系。這個意思是說如果一個值被更新,它所對應的也會被更新。在Locations被實例之后,它們被傳遞到bijectiveBind()。
public class BindingDemo1 {
private static IntLocation i1, i2; public static void main(String[] args) { i1 = IntVariable.make(); i2 = IntVariable.make(); Bindings.bijectiveBind(i2, i1); showValues(); i1.setAsInt(10); showValues(); i2.setAsInt(100); showValues(); } private static void showValues() { System.out.println("i1: " + i1.get()); System.out.println("i2: " + i2.get()); } } |
bijectiveBind(i2, i1)在i1 和 i2之間建立兩種依賴關(guān)系。如果其中一個被更新,例如,調(diào)用setAsInt(),其他的值也會變化。為了到達此目的,執(zhí)行附加了兩個監(jiān)聽者在Locations中分享狀態(tài)。方便的方法makeBijectiveBind()創(chuàng)建一個新的Location并它綁定到現(xiàn)存的綁定上面。如下所示:
i1 = IntVariable.make();
i2 = Bindings.makeBijectiveBind(i1);
BindingDemo2展示了如何使用它。它包含在/today/2009/06/02/sources.zip中。具體細節(jié)請參考Resources。圖3顯示了它的輸出。
|
圖3. BindingDemo2輸出 |
請注意只有可編譯的類型才能使用bijectiveBind()來進行綁定。以下的代碼行取自BindingDemo3.java(包含在sources.zip中的)。***眼看上去代碼沒什么問題。但是,它們會拋出ClassCastException異常。這里發(fā)生什么事情了呢?
ObjectLocation loc1 = IntVariable.make();
ObjectLocation loc2 = BooleanVariable.make();
Bindings.bijectiveBind(loc1, loc2);
在創(chuàng)建綁定的過程中,loc2.get()結(jié)果被傳遞到loc1的set()方法中。這個不會為Boolean 和 Integer工作的。為了避免這種問題,只要適當?shù)拇_定參數(shù)泛型類型ObjectLocation。目前為止,我們已經(jīng)看到兩個變量是如何被同步的。以下的小節(jié)中將看一看Swing組件是如何被綁定的。
綁定Swing組件
幾乎每個JavaFX Script教程都是由顯示一個窗口,按鈕或是標簽的小程序開始的。JavaFX 使用Swing來構(gòu)建并顯示這些組件。因此,我們可以假設(shè)Swing融入了JavaFX運行。不久你將會看到,這個也會應用于綁定。
lib/desktop/javafx-swing.jar文件包含javafx.ext.swing包。它的類包含了大多數(shù)常見的Swing組件。如果你檢查它們,你將會注意到它們用$開始顯示各區(qū)域。它們的類型是ObjectVariable,它可以執(zhí)行ObjectLocation。
|
圖4. 在Eclipse的Members視圖中SwingLabel |
考慮到這個接口屬于com.sun.javafx.runtime.location包,它是安全的假設(shè)這樣的Locations可以綁定到其他的變量上。以下的程序展示你是如何做到這個的。為了編譯并運行這個示例,請?zhí)砑觢ib/shared/javafxrt.jar, lib/desktop/javafx-swing.jar, lib/desktop/Scenario.jar, 以及 lib/desktop/javafxgui.jar到你的類路徑上。
public class SwingDemo1 {
public static void main(String[] args) { JFrame f = new JFrame(); f.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); JPanel p = new JPanel(new BorderLayout()); f.setContentPane(p); SwingLabel label = new SwingLabel(); ObjectLocation text = Bindings.makeBijectiveBind(label.$text); p.add(label.getJComponent(), BorderLayout.CENTER); f.pack(); f.setVisible(true); text.set("Hello, JavaFX!"); } } |
SwingLabel被實例化并分配到label。
Location被分配到test并綁定到label.的$text上。
標簽被有層次的添加到組件上。
請注意你不能直接添加SwingLabel到容器中。相反。它的getJComponent()方法用來獲取JComponent實例。
雖然這個簡單的例子展示了一個Swing組件如何被綁定到一個變量上的,但是卻沒有說明使用JavaFX 綁定的好處。在我以前的文章"Binding Beans,"中,我演示了如何使用JGoodies Binding 和 Beans Binding來執(zhí)行一個簡單的音量控制。
VolumeControl示例
音量控制是基于一個簡單的特定應用的POJO叫做Volume。它有兩個區(qū)域:volume 和mute。如圖5所示,它通過一個復選框和一個滑塊進行操作。標簽顯示現(xiàn)在的volume值。除此之外,mute控制音量是否調(diào)整。
|
圖5. 音量控制示例 |
涉及Swing組件和POJO區(qū)域之間的關(guān)系如下:
復選框設(shè)置mute。
滑塊設(shè)置volume。
Mute選擇或不選擇復選框。
Volume設(shè)置成滑塊的位置。
Mute啟用或禁用滑塊。
Volume設(shè)置標簽文本。
完整的來源包含在sources.zip中。細節(jié)請參考Resources部分。它的結(jié)構(gòu)很像我以前的文章中的版本,所以很容易比較不同的版本。為了編譯并運行VolumeControl,請?zhí)砑觢ib/shared/javafxrt.jar, lib/desktop/javafx-swing.jar, lib/desktop/Scenario.jar, 和lib/desktop/javafxgui.jar到你的類路徑。
首先,所有相關(guān)的組件都要初始化。這個發(fā)生在initComponents()中。例如,垂直壞塊被創(chuàng)建并有如下設(shè)置:
sliderVolume = new SwingSlider();
sliderVolume.$vertical.set(true);
在initEventHandling()中建立綁定。例如,復選框與mute鏈接,用以下命令Bindings.bijectiveBind(checkboxMute.$selected, volume.mute); 當復選框被選擇的時候禁用滑塊是通過添加一個監(jiān)聽者到mute上實現(xiàn)的。
volume.mute.addChangeListener(new ChangeListener() {
@Override public boolean onChange() { sliderVolume.$enabled.set(! volume.mute.get()); return true; } }); |
public boolean onChange() {
labelInfo.$text.set(volume.volume.get().toString()); return true; } |
總結(jié)
很驚訝的看到JavaFX綁定在Swing應用程序中的使用是如此簡單。雖然綁定構(gòu)架還沒有為這個所設(shè)計,但是它是一個相當體面的工作。盡管如此,本文還是故意忽視了一些問題:
Sun會允許使用并可能重新分配部分JavaFX運行給非JavaFX應用程序嗎?
如何安全使用內(nèi)部類?這里所描述的包還沒有被設(shè)計成公共的APIS。
為什么沒有成熟的綁定構(gòu)架給Swing開發(fā)者們使用?
即使JavaFX綁定可以或是不能在產(chǎn)品環(huán)境中使用,但是對于它的內(nèi)部研究還是充滿樂趣和鼓舞的。
【編輯推薦】