FXMLLoader 工厂方法可以用于用户定义 类 吗？
Can FXMLLoader factory methods be used for user-defined classes?
在 "Pro JavaFX 8: A Definitive Guide to Building Desktop, Mobile, and Embedded Java Clients" 的第 3 章中，一个示例说明了如何直接在 FXML 文件中指定对象。
您可以在本 post 的末尾找到完整的 FXML 文件以及示例中的其他文件。
这是我正在处理的片段。 sizes 字段使用 fx:factory 属性来指示工厂方法 Utilities.createList() 必须用于创建整数列表，然后用三个整数填充该列表。
<sizes>
<Utilities fx:factory="createMyCollection">
<Integer fx:value="1"/>
<Integer fx:value="2"/>
<Integer fx:value="3"/>
</Utilities>
</sizes>
这里是Utilities.java:
package projavafx.fxmlbasicfeatures;
import java.util.ArrayList;
import java.util.List;
public class Utilities {
public static final Double TEN_PCT = 0.1d;
public static final Double TWENTY_PCT = 0.2d;
public static final Double THIRTY_PCT = 0.3d;
public static List<Integer> createList() {
return new ArrayList<>();
}
}
我的问题是：使用这些工厂方法所涉及的一般机制是什么？
想明白FXMLLoader是怎么知道需要用add方法把三个Integer加到创建的对象上的。自然地，它必须 以某种方式 关于 List 或 Collection，但这些知识在哪里指定？它是内置在 FXMLLoader 中的吗？如果是这样，如何为用户定义的classes提供这样的工厂方法？
我实际上尝试将它与用户定义的 class 一起使用。我将以下代码片段添加到 Utilities.java，它创建了一个 MyCollection class，它有一个方法 add(Integer) 并定义了一个 Utilities.createMyCollection 方法：
public class Utilities {
(...)
public static class MyCollection {
private List<Integer> myList = new LinkedList<>();
public void add(Integer o) {
myList.add(o);
}
public String toString() {
return myList.toString();
}
}
public static MyCollection createMyCollection() {
return new MyCollection();
}
(...)
}
但是，当我在 FXML 文件中替换 createMyCollection 时，我收到消息 "MyCollections does not have a default property. Place MyCollection content in a property element."
这让我想知道如何为用户定义的 class 声明默认值 属性，以及 List 为何已经有一个。
这是所有文件（除了上面的Utilities.java）：
FXMLBasicFeatures.fxml:
<?import javafx.scene.paint.Color?>
<?import projavafx.fxmlbasicfeatures.FXMLBasicFeaturesBean?>
<?import projavafx.fxmlbasicfeatures.Utilities?>
<?import java.lang.Double?>
<?import java.lang.Integer?>
<?import java.lang.Long?>
<?import java.util.HashMap?>
<?import java.lang.String?>
<FXMLBasicFeaturesBean name="John Smith"
flag="true"
count="12345"
xmlns:fx="http://javafx.com/fxml/1">
<address>12345 Main St.</address>
<foreground>#ff8800</foreground>
<background>
<Color red="0.0" green="1.0" blue="0.5"/>
</background>
<price>
<Double fx:value="3.1415926"/>
</price>
<discount>
<Utilities fx:constant="TEN_PCT"/>
</discount>
<sizes>
<Utilities fx:factory="createList">
<Integer fx:value="1"/>
<Integer fx:value="2"/>
<Integer fx:value="3"/>
</Utilities>
</sizes>
<profits>
<HashMap q1="1000" q2="1100" q3="1200" a4="1300"/>
</profits>
<fx:define>
<Long fx:id="inv" fx:value="9765625"/>
</fx:define>
<inventory>
<fx:reference source="inv"/>
</inventory>
<products>
<String fx:value="widget"/>
<String fx:value="gadget"/>
<String fx:value="models"/>
</products>
<abbreviations CA="California" NY="New York" FL="Florida" MO="Missouri"/>
</FXMLBasicFeaturesBean>
FXMLBasicFeaturesBean.java:
package projavafx.fxmlbasicfeatures;
import javafx.scene.paint.Color;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
public class FXMLBasicFeaturesBean {
private String name;
private String address;
private boolean flag;
private int count;
private Color foreground;
private Color background;
private Double price;
private Double discount;
private List<Integer> sizes;
private Map<String, Double> profits;
private Long inventory;
private List<String> products = new ArrayList<String>();
private Map<String, String> abbreviations = new HashMap<>();
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getAddress() {
return address;
}
public void setAddress(String address) {
this.address = address;
}
public boolean isFlag() {
return flag;
}
public void setFlag(boolean flag) {
this.flag = flag;
}
public int getCount() {
return count;
}
public void setCount(int count) {
this.count = count;
}
public Color getForeground() {
return foreground;
}
public void setForeground(Color foreground) {
this.foreground = foreground;
}
public Color getBackground() {
return background;
}
public void setBackground(Color background) {
this.background = background;
}
public Double getPrice() {
return price;
}
public void setPrice(Double price) {
this.price = price;
}
public Double getDiscount() {
return discount;
}
public void setDiscount(Double discount) {
this.discount = discount;
}
public List<Integer> getSizes() {
return sizes;
}
public void setSizes(List<Integer> sizes) {
this.sizes = sizes;
}
public Map<String, Double> getProfits() {
return profits;
}
public void setProfits(Map<String, Double> profits) {
this.profits = profits;
}
public Long getInventory() {
return inventory;
}
public void setInventory(Long inventory) {
this.inventory = inventory;
}
public List<String> getProducts() {
return products;
}
public Map<String, String> getAbbreviations() {
return abbreviations;
}
@Override
public String toString() {
return "FXMLBasicFeaturesBean{" +
"name='" + name + '\'' +
",\n\taddress='" + address + '\'' +
",\n\tflag=" + flag +
",\n\tcount=" + count +
",\n\tforeground=" + foreground +
",\n\tbackground=" + background +
",\n\tprice=" + price +
",\n\tdiscount=" + discount +
",\n\tsizes=" + sizes +
",\n\tprofits=" + profits +
",\n\tinventory=" + inventory +
",\n\tproducts=" + products +
",\n\tabbreviations=" + abbreviations +
'}';
}
}
FXMLBasicFeaturesMain.java:
package projavafx.fxmlbasicfeatures;
import javafx.fxml.FXMLLoader;
import java.io.IOException;
public class FXMLBasicFeaturesMain {
public static void main(String[] args) throws IOException {
FXMLBasicFeaturesBean bean = FXMLLoader.load(
FXMLBasicFeaturesMain.class.getResource(
"/projavafx/fxmlbasicfeatures/FXMLBasicFeatures.fxml")
);
System.out.println("bean = " + bean);
}
}
这里实际上有几个不同的问题。如您所知，基本用法是 FXMLLoader 通过 JavaBean 命名方案查找 classical 风格的属性。所以如果你有 class
public class Bean {
private String text ;
public void setText(String text) {
this.text = text ;
}
public String getText() {
return text ;
}
}
然后（因为 class 有一个默认的无参数构造函数），您可以在 FXML 中实例化 Bean：
<Bean>
并且您可以通过将 属性 text 作为属性引用来调用 setText 方法：
<Bean text="Some text"/>
或作为 属性 元素：
<Bean>
<text>
<String fx:value="Some text"/>
</text>
</Bean>
java.util.List 的实例得到特殊对待。如果 属性 名称匹配 只读 List 属性：即类型 java.util.List 的 属性 具有get... 方法但没有 set... 方法，FXML 中的子节点将传递给相应的 List 实例 add(...) 方法。
所以如果我们将这样的 属性 添加到 Bean:
import java.util.List ;
import java.util.ArrayList ;
public class Bean {
private String text ;
private List<String> elements ;
public Bean() {
this.elements = new ArrayList<>();
}
public List<String> getElements() {
return elements ;
}
public void setText(String text) {
this.text = text ;
}
public String getText() {
return text ;
}
}
然后我们可以在 FXML 中填充列表：
<Bean text="Some text">
<elements>
<String fx:value="One"/>
<String fx:value="Two"/>
<String fx:value="Three"/>
</elements>
<Bean>
您提到的另一个问题是 "default property"。您可以通过在 class 上使用 @DefaultProperty 注释 并指定 class 的默认值 属性 属性 被认为是默认值：
import java.util.List ;
import java.util.ArrayList ;
@DefaultProperty("text")
public class Bean {
private String text ;
private List<String> elements ;
public Bean() {
this.elements = new ArrayList<>();
}
public List<String> getElements() {
return elements ;
}
public void setText(String text) {
this.text = text ;
}
public String getText() {
return text ;
}
}
现在，如果您在 FXML 中指定实例元素 <Bean> 的子元素，而不指定 属性，这些子元素将用作默认值 属性:
<Bean>
<String fx:value="Some Text"/>
</Bean>
将在 Bean 实例上调用 setText("Some Text")。
当然你可以结合这些想法并使 List 实例成为默认的 属性（这实际上是布局容器的工作方式：Pane 定义 "children"作为默认 属性):
import java.util.List ;
import java.util.ArrayList ;
@DefaultProperty("elements")
public class Bean {
private String text ;
private List<String> elements ;
public Bean() {
this.elements = new ArrayList<>();
}
public List<String> getElements() {
return elements ;
}
public void setText(String text) {
this.text = text ;
}
public String getText() {
return text ;
}
}
现在你可以做到了
<Bean text="Some Text">
<String fx:value="One"/>
<String fx:value="Two" />
<String fx:value="Three" />
</Bean>
将用 ["One", "Two", "Three"] 填充 elements 列表。
在 "Pro JavaFX 8: A Definitive Guide to Building Desktop, Mobile, and Embedded Java Clients" 的第 3 章中，一个示例说明了如何直接在 FXML 文件中指定对象。
您可以在本 post 的末尾找到完整的 FXML 文件以及示例中的其他文件。
这是我正在处理的片段。 sizes 字段使用 fx:factory 属性来指示工厂方法 Utilities.createList() 必须用于创建整数列表，然后用三个整数填充该列表。
<sizes>
<Utilities fx:factory="createMyCollection">
<Integer fx:value="1"/>
<Integer fx:value="2"/>
<Integer fx:value="3"/>
</Utilities>
</sizes>
这里是Utilities.java:
package projavafx.fxmlbasicfeatures;
import java.util.ArrayList;
import java.util.List;
public class Utilities {
public static final Double TEN_PCT = 0.1d;
public static final Double TWENTY_PCT = 0.2d;
public static final Double THIRTY_PCT = 0.3d;
public static List<Integer> createList() {
return new ArrayList<>();
}
}
我的问题是：使用这些工厂方法所涉及的一般机制是什么？
想明白FXMLLoader是怎么知道需要用add方法把三个Integer加到创建的对象上的。自然地，它必须 以某种方式 关于 List 或 Collection，但这些知识在哪里指定？它是内置在 FXMLLoader 中的吗？如果是这样，如何为用户定义的classes提供这样的工厂方法？
我实际上尝试将它与用户定义的 class 一起使用。我将以下代码片段添加到 Utilities.java，它创建了一个 MyCollection class，它有一个方法 add(Integer) 并定义了一个 Utilities.createMyCollection 方法：
public class Utilities {
(...)
public static class MyCollection {
private List<Integer> myList = new LinkedList<>();
public void add(Integer o) {
myList.add(o);
}
public String toString() {
return myList.toString();
}
}
public static MyCollection createMyCollection() {
return new MyCollection();
}
(...)
}
但是，当我在 FXML 文件中替换 createMyCollection 时，我收到消息 "MyCollections does not have a default property. Place MyCollection content in a property element."
这让我想知道如何为用户定义的 class 声明默认值 属性，以及 List 为何已经有一个。
这是所有文件（除了上面的Utilities.java）：
FXMLBasicFeatures.fxml:
<?import javafx.scene.paint.Color?>
<?import projavafx.fxmlbasicfeatures.FXMLBasicFeaturesBean?>
<?import projavafx.fxmlbasicfeatures.Utilities?>
<?import java.lang.Double?>
<?import java.lang.Integer?>
<?import java.lang.Long?>
<?import java.util.HashMap?>
<?import java.lang.String?>
<FXMLBasicFeaturesBean name="John Smith"
flag="true"
count="12345"
xmlns:fx="http://javafx.com/fxml/1">
<address>12345 Main St.</address>
<foreground>#ff8800</foreground>
<background>
<Color red="0.0" green="1.0" blue="0.5"/>
</background>
<price>
<Double fx:value="3.1415926"/>
</price>
<discount>
<Utilities fx:constant="TEN_PCT"/>
</discount>
<sizes>
<Utilities fx:factory="createList">
<Integer fx:value="1"/>
<Integer fx:value="2"/>
<Integer fx:value="3"/>
</Utilities>
</sizes>
<profits>
<HashMap q1="1000" q2="1100" q3="1200" a4="1300"/>
</profits>
<fx:define>
<Long fx:id="inv" fx:value="9765625"/>
</fx:define>
<inventory>
<fx:reference source="inv"/>
</inventory>
<products>
<String fx:value="widget"/>
<String fx:value="gadget"/>
<String fx:value="models"/>
</products>
<abbreviations CA="California" NY="New York" FL="Florida" MO="Missouri"/>
</FXMLBasicFeaturesBean>
FXMLBasicFeaturesBean.java:
package projavafx.fxmlbasicfeatures;
import javafx.scene.paint.Color;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
public class FXMLBasicFeaturesBean {
private String name;
private String address;
private boolean flag;
private int count;
private Color foreground;
private Color background;
private Double price;
private Double discount;
private List<Integer> sizes;
private Map<String, Double> profits;
private Long inventory;
private List<String> products = new ArrayList<String>();
private Map<String, String> abbreviations = new HashMap<>();
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getAddress() {
return address;
}
public void setAddress(String address) {
this.address = address;
}
public boolean isFlag() {
return flag;
}
public void setFlag(boolean flag) {
this.flag = flag;
}
public int getCount() {
return count;
}
public void setCount(int count) {
this.count = count;
}
public Color getForeground() {
return foreground;
}
public void setForeground(Color foreground) {
this.foreground = foreground;
}
public Color getBackground() {
return background;
}
public void setBackground(Color background) {
this.background = background;
}
public Double getPrice() {
return price;
}
public void setPrice(Double price) {
this.price = price;
}
public Double getDiscount() {
return discount;
}
public void setDiscount(Double discount) {
this.discount = discount;
}
public List<Integer> getSizes() {
return sizes;
}
public void setSizes(List<Integer> sizes) {
this.sizes = sizes;
}
public Map<String, Double> getProfits() {
return profits;
}
public void setProfits(Map<String, Double> profits) {
this.profits = profits;
}
public Long getInventory() {
return inventory;
}
public void setInventory(Long inventory) {
this.inventory = inventory;
}
public List<String> getProducts() {
return products;
}
public Map<String, String> getAbbreviations() {
return abbreviations;
}
@Override
public String toString() {
return "FXMLBasicFeaturesBean{" +
"name='" + name + '\'' +
",\n\taddress='" + address + '\'' +
",\n\tflag=" + flag +
",\n\tcount=" + count +
",\n\tforeground=" + foreground +
",\n\tbackground=" + background +
",\n\tprice=" + price +
",\n\tdiscount=" + discount +
",\n\tsizes=" + sizes +
",\n\tprofits=" + profits +
",\n\tinventory=" + inventory +
",\n\tproducts=" + products +
",\n\tabbreviations=" + abbreviations +
'}';
}
}
FXMLBasicFeaturesMain.java:
package projavafx.fxmlbasicfeatures;
import javafx.fxml.FXMLLoader;
import java.io.IOException;
public class FXMLBasicFeaturesMain {
public static void main(String[] args) throws IOException {
FXMLBasicFeaturesBean bean = FXMLLoader.load(
FXMLBasicFeaturesMain.class.getResource(
"/projavafx/fxmlbasicfeatures/FXMLBasicFeatures.fxml")
);
System.out.println("bean = " + bean);
}
}
这里实际上有几个不同的问题。如您所知，基本用法是 FXMLLoader 通过 JavaBean 命名方案查找 classical 风格的属性。所以如果你有 class
public class Bean {
private String text ;
public void setText(String text) {
this.text = text ;
}
public String getText() {
return text ;
}
}
然后（因为 class 有一个默认的无参数构造函数），您可以在 FXML 中实例化 Bean：
<Bean>
并且您可以通过将 属性 text 作为属性引用来调用 setText 方法：
<Bean text="Some text"/>
或作为 属性 元素：
<Bean>
<text>
<String fx:value="Some text"/>
</text>
</Bean>
java.util.List 的实例得到特殊对待。如果 属性 名称匹配 只读 List 属性：即类型 java.util.List 的 属性 具有get... 方法但没有 set... 方法，FXML 中的子节点将传递给相应的 List 实例 add(...) 方法。
所以如果我们将这样的 属性 添加到 Bean:
import java.util.List ;
import java.util.ArrayList ;
public class Bean {
private String text ;
private List<String> elements ;
public Bean() {
this.elements = new ArrayList<>();
}
public List<String> getElements() {
return elements ;
}
public void setText(String text) {
this.text = text ;
}
public String getText() {
return text ;
}
}
然后我们可以在 FXML 中填充列表：
<Bean text="Some text">
<elements>
<String fx:value="One"/>
<String fx:value="Two"/>
<String fx:value="Three"/>
</elements>
<Bean>
您提到的另一个问题是 "default property"。您可以通过在 class 上使用 @DefaultProperty 注释 并指定 class 的默认值 属性 属性 被认为是默认值：
import java.util.List ;
import java.util.ArrayList ;
@DefaultProperty("text")
public class Bean {
private String text ;
private List<String> elements ;
public Bean() {
this.elements = new ArrayList<>();
}
public List<String> getElements() {
return elements ;
}
public void setText(String text) {
this.text = text ;
}
public String getText() {
return text ;
}
}
现在，如果您在 FXML 中指定实例元素 <Bean> 的子元素，而不指定 属性，这些子元素将用作默认值 属性:
<Bean>
<String fx:value="Some Text"/>
</Bean>
将在 Bean 实例上调用 setText("Some Text")。
当然你可以结合这些想法并使 List 实例成为默认的 属性（这实际上是布局容器的工作方式：Pane 定义 "children"作为默认 属性):
import java.util.List ;
import java.util.ArrayList ;
@DefaultProperty("elements")
public class Bean {
private String text ;
private List<String> elements ;
public Bean() {
this.elements = new ArrayList<>();
}
public List<String> getElements() {
return elements ;
}
public void setText(String text) {
this.text = text ;
}
public String getText() {
return text ;
}
}
现在你可以做到了
<Bean text="Some Text">
<String fx:value="One"/>
<String fx:value="Two" />
<String fx:value="Three" />
</Bean>
将用 ["One", "Two", "Three"] 填充 elements 列表。