Класс StyleablePropertyFactory<S extends Styleable>

public class StyleablePropertyFactory<S extends Styleable> extends Object

Методы для создания экземпляров StyleableProperty с соответствующими CssMetaData, созданными за кулисами. Эти методы значительно уменьшают объем кода-шаблона, необходимого для реализации StyleableProperty и CssMetaData. Эти методы принимают Function<? extends Styleable, StyleableProperty<?>>, который возвращает ссылку на свойство. См. пример ниже. Обратите внимание, что для эффективного использования памяти и повышения производительности CSS рекомендуется создание StyleablePropertyFactory в качестве статического члена, как показано ниже.

 public final class MyButton extends Button {

     private static final StyleablePropertyFactory<MyButton> FACTORY = new StyleablePropertyFactory<>(Button.getClassCssMetaData());

     MyButton(String labelText) {
         super(labelText);
         getStyleClass().add("my-button");
     }

     // Typical JavaFX property implementation
     public ObservableValue<Boolean> selectedProperty() { return (ObservableValue<Boolean>)selected; }
     public final boolean isSelected() { return selected.getValue(); }
     public final void setSelected(boolean isSelected) { selected.setValue(isSelected); }

     // StyleableProperty implementation reduced to one line
     private final StyleableProperty<Boolean> selected =
         FACTORY.createStyleableBooleanProperty(this, "selected", "-my-selected", s -> s.selected);

     @Override
     public List<CssMetaData<? extends Styleable, ?>> getControlCssMetaData() {
         return FACTORY.getCssMetaData();
     }

 }
 

Приведённый выше пример является простейшим использованием StyleablePropertyFactory. Однако это использование не предоставляет статические CssMetaData, которые полезны для getClassCssMetaData(), что описано в javadoc для CssMetaData. Статические CssMetaData, однако, могут быть созданы с помощью StyleablePropertyFactory методов и будут возвращены методами, которые создают экземпляры StyleableProperty, как показано в примере ниже. Обратите внимание, что статический метод getClassCssMetaData() является соглашением, используемым во всём кодовом базисе JavaFX, но сам метод getClassCssMetaData() не используется во время выполнения.

 public final class MyButton extends Button {

     private static final StyleablePropertyFactory<MyButton> FACTORY =
         new StyleablePropertyFactory<>(Button.getClassCssMetaData());

     private static final CssMetaData<MyButton, Boolean> SELECTED =
         FACTORY.createBooleanCssMetaData("-my-selected", s -> s.selected, false, false);

     MyButton(String labelText) {
         super(labelText);
         getStyleClass().add("my-button");
     }

     // Typical JavaFX property implementation
     public ObservableValue<Boolean> selectedProperty() { return (ObservableValue<Boolean>)selected; }
     public final boolean isSelected() { return selected.getValue(); }
     public final void setSelected(boolean isSelected) { selected.setValue(isSelected); }

     // StyleableProperty implementation reduced to one line
     private final StyleableProperty<Boolean> selected =
         new SimpleStyleableBooleanProperty(SELECTED, this, "selected");

     public static List<CssMetaData<? extends Styleable, ?>> getClassCssMetaData() {
         return FACTORY.getCssMetaData();
     }

     @Override
     public List<CssMetaData<? extends Styleable, ?>> getControlCssMetaData() {
         return FACTORY.getCssMetaData();
     }
 }
 

То же самое можно сделать с внутренним классом. Предыдущий пример вызывал new SimpleStyleableBooleanProperty для создания selected свойства. Этот пример использует фабрику для доступа к CssMetaData, который был создан вместе с анонимным внутренним классом. Во всех смыслах эти два примера идентичны.

 public final class MyButton extends Button {

     private static CssMetaData<MyButton, Boolean> SELECTED;

     private static final StyleablePropertyFactory<MyButton> FACTORY =
         new StyleablePropertyFactory<>(Button.getClassCssMetaData()) {
         {
             SELECTED = createBooleanCssMetaData("-my-selected", s -> s.selected, false, false);
         }
     };


     MyButton(String labelText) {
         super(labelText);
         getStyleClass().add("my-button");
     }

     // Typical JavaFX property implementation
     public ObservableValue<Boolean> selectedProperty() { return (ObservableValue<Boolean>)selected; }
     public final boolean isSelected() { return selected.getValue(); }
     public final void setSelected(boolean isSelected) { selected.setValue(isSelected); }

     // StyleableProperty implementation reduced to one line
     private final StyleableProperty<Boolean> selected =
         new SimpleStyleableBooleanProperty(SELECTED, "selected", "my-selected");

     public static List<CssMetaData<? extends Styleable, ?>> getClassCssMetaData() {
         return FACTORY.getCssMetaData();
     }

     @Override
     public List<CssMetaData<? extends Styleable, ?>> getControlCssMetaData() {
         return FACTORY.getCssMetaData();
     }
 }
 

Примечания:

Единственный вариант создания StyleableProperty со значением типа число — создание StyleableProperty<Number>. Возвращаемое значение из метода getValue() класса StyleableProperty — это Number. Поэтому метод get свойства JavaFX должен вызывать соответствующий метод value для типа возвращаемого значения. Например,

     public ObservableValue<Double> offsetProperty() { return (ObservableValue<Double>)offset; }
     public Double getOffset() { return offset.getValue().doubleValue(); }
     public void setOffset(Double value) { offset.setValue(value); }
     private final StyleableProperty<Number> offset = FACTORY.createStyleableNumberProperty(this, "offset", "-my-offset", s -> ((MyButton)s).offset);