jrubyfx 0.9.2-java → 1.0.0-java

data/lib/jrubyfx/dsl_map.rb

@@ -0,0 +1,267 @@
+=begin
+JRubyFX - Write JavaFX and FXML in Ruby
+Copyright (C) 2013 The JRubyFX Team
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+=end
+
+# DO NOT MODIFY THIS FILE!
+# This file is generated by the `rake reflect` task.
+
+module JRubyFX
+  module DSL
+    NAME_TO_CLASSES = {
+      # Manual overrides
+      'observable_array_list' => proc { |*args| FXCollections.observable_array_list(*args) },
+      'double_property' => SimpleDoubleProperty,
+      'xy_chart_series' => Java::javafx.scene.chart.XYChart::Series,
+      'xy_chart_data' => Java::javafx.scene.chart.XYChart::Data,
+      # Automatically generated
+      'animation' => Animation,
+      'animation_timer' => AnimationTimer,
+      'fade_transition' => FadeTransition,
+      'fill_transition' => FillTransition,
+      'interpolator' => Interpolator,
+      'key_frame' => KeyFrame,
+      'key_value' => KeyValue,
+      'parallel_transition' => ParallelTransition,
+      'path_transition' => PathTransition,
+      'pause_transition' => PauseTransition,
+      'rotate_transition' => RotateTransition,
+      'scale_transition' => ScaleTransition,
+      'sequential_transition' => SequentialTransition,
+      'stroke_transition' => StrokeTransition,
+      'timeline' => Timeline,
+      'transition' => Transition,
+      'translate_transition' => TranslateTransition,
+      'platform' => Platform,
+      'simple_boolean_property' => SimpleBooleanProperty,
+      'simple_double_property' => SimpleDoubleProperty,
+      'simple_float_property' => SimpleFloatProperty,
+      'simple_integer_property' => SimpleIntegerProperty,
+      'simple_list_property' => SimpleListProperty,
+      'simple_long_property' => SimpleLongProperty,
+      'simple_map_property' => SimpleMapProperty,
+      'simple_object_property' => SimpleObjectProperty,
+      'simple_set_property' => SimpleSetProperty,
+      'simple_string_property' => SimpleStringProperty,
+      'change_listener' => ChangeListener,
+      'fx_collections' => FXCollections,
+      'event' => Event,
+      'action_event' => ActionEvent,
+      'event_handler' => EventHandler,
+      'initializable' => Initializable,
+      'load_exception' => LoadException,
+      'horizontal_direction' => HorizontalDirection,
+      'h_pos' => HPos,
+      'insets' => Insets,
+      'orientation' => Orientation,
+      'pos' => Pos,
+      'rectangle2_d' => Rectangle2D,
+      'side' => Side,
+      'vertical_direction' => VerticalDirection,
+      'v_pos' => VPos,
+      'group' => Group,
+      'node' => Node,
+      'parent' => Parent,
+      'scene' => Scene,
+      'canvas' => Canvas,
+      'area_chart' => AreaChart,
+      'axis' => Axis,
+      'bar_chart' => BarChart,
+      'bubble_chart' => BubbleChart,
+      'category_axis' => CategoryAxis,
+      'chart' => Chart,
+      'line_chart' => LineChart,
+      'number_axis' => NumberAxis,
+      'pie_chart' => PieChart,
+      'scatter_chart' => ScatterChart,
+      'stacked_area_chart' => StackedAreaChart,
+      'stacked_bar_chart' => StackedBarChart,
+      'value_axis' => ValueAxis,
+      'xy_chart' => XYChart,
+      'accordion' => Accordion,
+      'button' => Button,
+      'cell' => Cell,
+      'check_box' => CheckBox,
+      'check_box_tree_item' => CheckBoxTreeItem,
+      'check_menu_item' => CheckMenuItem,
+      'choice_box' => ChoiceBox,
+      'color_picker' => ColorPicker,
+      'combo_box' => ComboBox,
+      'context_menu' => ContextMenu,
+      'hyperlink' => Hyperlink,
+      'label' => Label,
+      'list_cell' => ListCell,
+      'list_view' => ListView,
+      'menu' => Menu,
+      'menu_bar' => MenuBar,
+      'menu_button' => MenuButton,
+      'menu_item' => MenuItem,
+      'pagination' => Pagination,
+      'password_field' => PasswordField,
+      'popup_control' => PopupControl,
+      'progress_bar' => ProgressBar,
+      'progress_indicator' => ProgressIndicator,
+      'radio_button' => RadioButton,
+      'radio_menu_item' => RadioMenuItem,
+      'scroll_bar' => ScrollBar,
+      'scroll_pane' => ScrollPane,
+      'separator' => Separator,
+      'separator_menu_item' => SeparatorMenuItem,
+      'slider' => Slider,
+      'split_menu_button' => SplitMenuButton,
+      'split_pane' => SplitPane,
+      'tab' => Tab,
+      'table_view' => TableView,
+      'table_cell' => TableCell,
+      'table_column' => TableColumn,
+      'tab_pane' => TabPane,
+      'text_area' => TextArea,
+      'text_field' => TextField,
+      'titled_pane' => TitledPane,
+      'toggle_button' => ToggleButton,
+      'toggle_group' => ToggleGroup,
+      'tool_bar' => ToolBar,
+      'tooltip' => Tooltip,
+      'tree_cell' => TreeCell,
+      'tree_item' => TreeItem,
+      'tree_view' => TreeView,
+      'content_display' => ContentDisplay,
+      'overrun_style' => OverrunStyle,
+      'selection_mode' => SelectionMode,
+      'blend' => Blend,
+      'blend_mode' => BlendMode,
+      'bloom' => Bloom,
+      'blur_type' => BlurType,
+      'box_blur' => BoxBlur,
+      'color_adjust' => ColorAdjust,
+      'color_input' => ColorInput,
+      'displacement_map' => DisplacementMap,
+      'drop_shadow' => DropShadow,
+      'gaussian_blur' => GaussianBlur,
+      'glow' => Glow,
+      'image_input' => ImageInput,
+      'inner_shadow' => InnerShadow,
+      'lighting' => Lighting,
+      'motion_blur' => MotionBlur,
+      'perspective_transform' => PerspectiveTransform,
+      'reflection' => Reflection,
+      'sepia_tone' => SepiaTone,
+      'shadow' => Shadow,
+      'image' => Image,
+      'image_view' => ImageView,
+      'pixel_reader' => PixelReader,
+      'pixel_writer' => PixelWriter,
+      'clipboard' => Clipboard,
+      'clipboard_content' => ClipboardContent,
+      'context_menu_event' => ContextMenuEvent,
+      'drag_event' => DragEvent,
+      'gesture_event' => GestureEvent,
+      'input_event' => InputEvent,
+      'input_method_event' => InputMethodEvent,
+      'key_code' => KeyCode,
+      'key_event' => KeyEvent,
+      'mnemonic' => Mnemonic,
+      'mouse_drag_event' => MouseDragEvent,
+      'mouse_event' => MouseEvent,
+      'rotate_event' => RotateEvent,
+      'scroll_event' => ScrollEvent,
+      'swipe_event' => SwipeEvent,
+      'touch_event' => TouchEvent,
+      'transfer_mode' => TransferMode,
+      'zoom_event' => ZoomEvent,
+      'anchor_pane' => AnchorPane,
+      'border_pane' => BorderPane,
+      'column_constraints' => ColumnConstraints,
+      'flow_pane' => FlowPane,
+      'grid_pane' => GridPane,
+      'hbox' => HBox,
+      'pane' => Pane,
+      'priority' => Priority,
+      'row_constraints' => RowConstraints,
+      'stack_pane' => StackPane,
+      'tile_pane' => TilePane,
+      'vbox' => VBox,
+      'audio_clip' => AudioClip,
+      'audio_equalizer' => AudioEqualizer,
+      'audio_track' => AudioTrack,
+      'equalizer_band' => EqualizerBand,
+      'media' => Media,
+      'media_exception' => MediaException,
+      'media_error_event' => MediaErrorEvent,
+      'media_marker_event' => MediaMarkerEvent,
+      'media_player' => MediaPlayer,
+      'media_view' => MediaView,
+      'video_track' => VideoTrack,
+      'color' => Color,
+      'cycle_method' => CycleMethod,
+      'image_pattern' => ImagePattern,
+      'linear_gradient' => LinearGradient,
+      'paint' => Paint,
+      'radial_gradient' => RadialGradient,
+      'stop' => Stop,
+      'arc' => Arc,
+      'arc_to' => ArcTo,
+      'arc_type' => ArcType,
+      'circle' => Circle,
+      'close_path' => ClosePath,
+      'cubic_curve' => CubicCurve,
+      'cubic_curve_to' => CubicCurveTo,
+      'ellipse' => Ellipse,
+      'fill_rule' => FillRule,
+      'hline_to' => HLineTo,
+      'line' => Line,
+      'line_to' => LineTo,
+      'move_to' => MoveTo,
+      'path' => Path,
+      'path_element' => PathElement,
+      'polygon' => Polygon,
+      'polyline' => Polyline,
+      'quad_curve' => QuadCurve,
+      'quad_curve_to' => QuadCurveTo,
+      'rectangle' => Rectangle,
+      'shape' => Shape,
+      'stroke_line_cap' => StrokeLineCap,
+      'stroke_line_join' => StrokeLineJoin,
+      'stroke_type' => StrokeType,
+      'svg_path' => SVGPath,
+      'vline_to' => VLineTo,
+      'font' => Font,
+      'font_posture' => FontPosture,
+      'font_smoothing_type' => FontSmoothingType,
+      'font_weight' => FontWeight,
+      'text' => Text,
+      'text_alignment' => TextAlignment,
+      'text_bounds_type' => TextBoundsType,
+      'affine' => Affine,
+      'rotate' => Rotate,
+      'scale' => Scale,
+      'shear' => Shear,
+      'translate' => Translate,
+      'web_view' => WebView,
+      'html_editor' => HTMLEditor,
+      'directory_chooser' => DirectoryChooser,
+      'file_chooser' => FileChooser,
+      'modality' => Modality,
+      'popup' => Popup,
+      'popup_window' => PopupWindow,
+      'screen' => Screen,
+      'stage' => Stage,
+      'stage_style' => StageStyle,
+      'window' => Window,
+      'window_event' => WindowEvent,
+      'duration' => Duration,
+    }
+  end
+end

data/lib/jrubyfx/imports.rb

@@ -0,0 +1,64 @@
+=begin
+JRubyFX - Write JavaFX and FXML in Ruby
+Copyright (C) 2013 The JRubyFX Team
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+=end
+
+require_relative 'utils'
+
+# Update load path to include the JavaFX runtime and fail nicely if we can't find it
+begin
+  if ENV['JFX_DIR']
+    $LOAD_PATH << ENV['JFX_DIR']
+  else #should we check for 1.7 vs 1.8? oh well, adding extra paths won't hurt anybody (maybe performance loading)
+    jfx_path = ENV_JAVA["sun.boot.library.path"]
+    $LOAD_PATH << if jfx_path.include? ":\\" and !jfx_path.include? "/" # can be tricked, but should work fine
+      #windows
+      jfx_path.gsub(/\\bin[\\]*$/i, "\\lib")
+    else
+      # *nix
+      jfx_path.gsub(/[\/\\][amdix345678_]+$/, "") # strip i386 or amd64 (including variants). TODO: ARM
+    end
+  end
+
+  # Java 8 (after ea-b75) and above has JavaFX as part of the normal distib, only require it if we are 7 or below
+  jre = ENV_JAVA["java.runtime.version"].match %r{^(?<version>(?<major>\d+)\.(?<minor>\d+))\.(?<patch>\d+)(_\d+)?-?(?<release>ea|u\d)?(-?b(?<build>\d+))?}
+  require 'jfxrt.jar' if ENV['JFX_DIR'] or
+    jre[:version].to_f < 1.8 or
+    (jre[:version].to_f == 1.8 and jre[:release] == 'ea' and jre[:build].to_i < 75)
+
+  # Attempt to load a javafx class
+  Java.javafx.application.Application
+rescue  LoadError, NameError
+  puts "JavaFX runtime not found.  Please install Java 7u6 or newer or set environment variable JFX_DIR to the folder that contains jfxrt.jar "
+  puts "If you have Java 7u6 or later, this is a bug. Please report to the issue tracker on github. Include your OS version, 32/64bit, and architecture (x86, ARM, PPC, etc)"
+  exit -1
+end
+
+module JRubyFX
+  # If you need JavaFX, just include this module. Its sole purpose in life is to
+  # import all JavaFX stuff, plus a few useful Java classes (like Void)
+  module FXImports
+
+    # If something is missing, just java_import it in your code.
+    # And then ask us to put it in this list
+    #
+
+    # The below lines are generated by `rake reflect`. Do not edit.
+
+java_import 'javafx.animation.Animation','javafx.animation.AnimationTimer','javafx.animation.FadeTransition','javafx.animation.FillTransition','javafx.animation.Interpolator','javafx.animation.KeyFrame','javafx.animation.KeyValue','javafx.animation.ParallelTransition','javafx.animation.PathTransition','javafx.animation.PauseTransition','javafx.animation.RotateTransition','javafx.animation.ScaleTransition','javafx.animation.SequentialTransition','javafx.animation.StrokeTransition','javafx.animation.Timeline','javafx.animation.Transition','javafx.animation.TranslateTransition','javafx.application.Platform','javafx.beans.property.SimpleBooleanProperty','javafx.beans.property.SimpleDoubleProperty','javafx.beans.property.SimpleFloatProperty','javafx.beans.property.SimpleIntegerProperty','javafx.beans.property.SimpleListProperty','javafx.beans.property.SimpleLongProperty','javafx.beans.property.SimpleMapProperty','javafx.beans.property.SimpleObjectProperty','javafx.beans.property.SimpleSetProperty','javafx.beans.property.SimpleStringProperty','javafx.beans.value.ChangeListener','javafx.collections.FXCollections','javafx.event.Event','javafx.event.ActionEvent','javafx.event.EventHandler','javafx.fxml.Initializable','javafx.fxml.LoadException','javafx.geometry.HorizontalDirection','javafx.geometry.HPos','javafx.geometry.Insets','javafx.geometry.Orientation','javafx.geometry.Pos','javafx.geometry.Rectangle2D','javafx.geometry.Side','javafx.geometry.VerticalDirection','javafx.geometry.VPos','javafx.scene.Group','javafx.scene.Node','javafx.scene.Parent','javafx.scene.Scene','javafx.scene.canvas.Canvas','javafx.scene.chart.AreaChart','javafx.scene.chart.Axis','javafx.scene.chart.BarChart','javafx.scene.chart.BubbleChart','javafx.scene.chart.CategoryAxis','javafx.scene.chart.Chart','javafx.scene.chart.LineChart','javafx.scene.chart.NumberAxis','javafx.scene.chart.PieChart','javafx.scene.chart.ScatterChart','javafx.scene.chart.StackedAreaChart','javafx.scene.chart.StackedBarChart','javafx.scene.chart.ValueAxis','javafx.scene.chart.XYChart','javafx.scene.control.Accordion','javafx.scene.control.Button','javafx.scene.control.Cell','javafx.scene.control.CheckBox','javafx.scene.control.CheckBoxTreeItem','javafx.scene.control.CheckMenuItem','javafx.scene.control.ChoiceBox','javafx.scene.control.ColorPicker','javafx.scene.control.ComboBox','javafx.scene.control.ContextMenu','javafx.scene.control.Hyperlink','javafx.scene.control.Label','javafx.scene.control.ListCell','javafx.scene.control.ListView','javafx.scene.control.Menu','javafx.scene.control.MenuBar','javafx.scene.control.MenuButton','javafx.scene.control.MenuItem','javafx.scene.control.Pagination','javafx.scene.control.PasswordField','javafx.scene.control.PopupControl','javafx.scene.control.ProgressBar','javafx.scene.control.ProgressIndicator','javafx.scene.control.RadioButton','javafx.scene.control.RadioMenuItem','javafx.scene.control.ScrollBar','javafx.scene.control.ScrollPane','javafx.scene.control.Separator','javafx.scene.control.SeparatorMenuItem','javafx.scene.control.Slider','javafx.scene.control.SplitMenuButton','javafx.scene.control.SplitPane','javafx.scene.control.Tab','javafx.scene.control.TableView','javafx.scene.control.TableCell','javafx.scene.control.TableColumn','javafx.scene.control.TabPane','javafx.scene.control.TextArea','javafx.scene.control.TextField','javafx.scene.control.TitledPane','javafx.scene.control.ToggleButton','javafx.scene.control.ToggleGroup','javafx.scene.control.ToolBar','javafx.scene.control.Tooltip','javafx.scene.control.TreeCell','javafx.scene.control.TreeItem','javafx.scene.control.TreeView','javafx.scene.control.ContentDisplay','javafx.scene.control.OverrunStyle','javafx.scene.control.SelectionMode','javafx.scene.effect.Blend','javafx.scene.effect.BlendMode','javafx.scene.effect.Bloom','javafx.scene.effect.BlurType','javafx.scene.effect.BoxBlur','javafx.scene.effect.ColorAdjust','javafx.scene.effect.ColorInput','javafx.scene.effect.DisplacementMap','javafx.scene.effect.DropShadow','javafx.scene.effect.GaussianBlur','javafx.scene.effect.Glow','javafx.scene.effect.ImageInput','javafx.scene.effect.InnerShadow','javafx.scene.effect.Lighting','javafx.scene.effect.MotionBlur','javafx.scene.effect.PerspectiveTransform','javafx.scene.effect.Reflection','javafx.scene.effect.SepiaTone','javafx.scene.effect.Shadow','javafx.scene.image.Image','javafx.scene.image.ImageView','javafx.scene.image.PixelReader','javafx.scene.image.PixelWriter','javafx.scene.input.Clipboard','javafx.scene.input.ClipboardContent','javafx.scene.input.ContextMenuEvent','javafx.scene.input.DragEvent','javafx.scene.input.GestureEvent','javafx.scene.input.InputEvent','javafx.scene.input.InputMethodEvent','javafx.scene.input.KeyCode','javafx.scene.input.KeyEvent','javafx.scene.input.Mnemonic','javafx.scene.input.MouseDragEvent','javafx.scene.input.MouseEvent','javafx.scene.input.RotateEvent','javafx.scene.input.ScrollEvent','javafx.scene.input.SwipeEvent','javafx.scene.input.TouchEvent','javafx.scene.input.TransferMode','javafx.scene.input.ZoomEvent','javafx.scene.layout.AnchorPane','javafx.scene.layout.BorderPane','javafx.scene.layout.ColumnConstraints','javafx.scene.layout.FlowPane','javafx.scene.layout.GridPane','javafx.scene.layout.HBox','javafx.scene.layout.Pane','javafx.scene.layout.Priority','javafx.scene.layout.RowConstraints','javafx.scene.layout.StackPane','javafx.scene.layout.TilePane','javafx.scene.layout.VBox','javafx.scene.media.AudioClip','javafx.scene.media.AudioEqualizer','javafx.scene.media.AudioTrack','javafx.scene.media.EqualizerBand','javafx.scene.media.Media','javafx.scene.media.MediaException','javafx.scene.media.MediaErrorEvent','javafx.scene.media.MediaMarkerEvent','javafx.scene.media.MediaPlayer','javafx.scene.media.MediaView','javafx.scene.media.VideoTrack','javafx.scene.paint.Color','javafx.scene.paint.CycleMethod','javafx.scene.paint.ImagePattern','javafx.scene.paint.LinearGradient','javafx.scene.paint.Paint','javafx.scene.paint.RadialGradient','javafx.scene.paint.Stop','javafx.scene.shape.Arc','javafx.scene.shape.ArcTo','javafx.scene.shape.ArcType','javafx.scene.shape.Circle','javafx.scene.shape.ClosePath','javafx.scene.shape.CubicCurve','javafx.scene.shape.CubicCurveTo','javafx.scene.shape.Ellipse','javafx.scene.shape.FillRule','javafx.scene.shape.HLineTo','javafx.scene.shape.Line','javafx.scene.shape.LineTo','javafx.scene.shape.MoveTo','javafx.scene.shape.Path','javafx.scene.shape.PathElement','javafx.scene.shape.Polygon','javafx.scene.shape.Polyline','javafx.scene.shape.QuadCurve','javafx.scene.shape.QuadCurveTo','javafx.scene.shape.Rectangle','javafx.scene.shape.Shape','javafx.scene.shape.StrokeLineCap','javafx.scene.shape.StrokeLineJoin','javafx.scene.shape.StrokeType','javafx.scene.shape.SVGPath','javafx.scene.shape.VLineTo','javafx.scene.text.Font','javafx.scene.text.FontPosture','javafx.scene.text.FontSmoothingType','javafx.scene.text.FontWeight','javafx.scene.text.Text','javafx.scene.text.TextAlignment','javafx.scene.text.TextBoundsType','javafx.scene.transform.Affine','javafx.scene.transform.Rotate','javafx.scene.transform.Scale','javafx.scene.transform.Shear','javafx.scene.transform.Translate','javafx.scene.web.WebView','javafx.scene.web.HTMLEditor','javafx.stage.DirectoryChooser','javafx.stage.FileChooser','javafx.stage.Modality','javafx.stage.Popup','javafx.stage.PopupWindow','javafx.stage.Screen','javafx.stage.Stage','javafx.stage.StageStyle','javafx.stage.Window','javafx.stage.WindowEvent','javafx.util.Duration'
+java_import 'java.lang.Void'    
+  end
+end
+

data/lib/jrubyfx/java_fx_impl.rb

@@ -15,7 +15,6 @@ See the License for the specific language governing permissions and
 limitations under the License.
 =end
 #:nodoc: all
-require 'jrubyfx'
 
 # Due to certain bugs in JRuby 1.7 (namely some newInstance mapping bugs), we
 # are forced to re-create the Launcher if we want a pure ruby wrapper

data/lib/jrubyfx/module.rb

@@ -0,0 +1,172 @@
+=begin
+JRubyFX - Write JavaFX and FXML in Ruby
+Copyright (C) 2013 The JRubyFX Team
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+=end
+
+require_relative 'utils/common_utils'
+
+# This module contains useful methods for defining JavaFX code. Include it in your
+# class to use it, and the JRubyFX::FXImports. JRubyFX::Application and JRubyFX::Controller already include it.
+module JRubyFX
+  include JRubyFX::FXImports
+  include JRubyFX::Utils::CommonUtils
+
+  ##
+  # call-seq:
+  #   with(obj, hash) => obj
+  #   with(obj) { block } => obj
+  #   with(obj, hash) { block }=> obj
+  #   
+  # Set properties (e.g. setters) on the passed in object plus also invoke
+  # any block passed against this object.
+  # === Examples
+  #
+  #   with(grid, vgap: 2, hgap: 2) do
+  #     set_pref_size(500, 400)
+  #     children << location << go << view
+  #   end
+  #
+  def with(obj, properties = {}, &block)
+    populate_properties(obj, properties)
+
+    if block_given?
+      # cache the proxy - http://wiki.jruby.org/Persistence
+      obj.class.__persistent__ = true if obj.class.ancestors.include? JavaProxy
+      obj.extend(JRubyFX)
+      obj.instance_eval(&block)
+    end
+    
+    obj
+  end
+
+  ##
+  # call-seq:
+  #   run_later { block }
+  # 
+  # Convenience method so anything can safely schedule to run on JavaFX
+  # main thread.
+  def run_later(&block)
+    Platform.run_later &block
+  end
+
+  ##
+  # call-seq:
+  #   build(class) => obj
+  #   build(class, hash) => obj
+  #   build(class) { block } => obj
+  #   build(class, hash) { block } => obj
+  #   
+  # Create "build" a new JavaFX instance with the provided class and
+  # set properties (e.g. setters) on that new instance plus also invoke
+  # any block passed against this new instance.  This also can build a proc
+  # or lambda form in which case the return value of the block will be what 
+  # is used to set the additional properties on.
+  # === Examples
+  #
+  #   grid = build(GridPane, vgap: 2, hgap: 2) do
+  #     set_pref_size(500, 400)
+  #     children << location << go << view
+  #   end
+  #
+  #  build(proc { Foo.new }, vgap: 2, hgap: 2)
+  #
+  def build(klass, *args, &block)
+    args, properties = split_args_from_properties(*args)
+
+    obj = if klass.kind_of? Proc
+      klass.call(*args)
+    else
+      klass.new(*attempt_conversion(klass, :new, *args))
+    end
+
+    with(obj, properties, &block)
+  end
+  
+  def self.included(mod)
+    mod.extend(JRubyFX::FXMLClassUtils)
+  end
+  
+  module FXMLClassUtils
+    def fxml_raw_accessor(symbol_name, type=java::lang::String)
+      # TODO: RDoc
+      # TODO: somebody clean this up
+      # TODO: _reader and _writer
+      send(:define_method, symbol_name.id2name.snake_case + "=") do |val|
+        instance_variable_set("@#{symbol_name}", val)
+      end
+      send(:define_method, symbol_name.id2name.snake_case) do
+        instance_variable_get("@#{symbol_name}")
+      end
+      send(:define_method, symbol_name.id2name.snake_case + "GetType") do
+        return type.java_class
+      end
+      camel = symbol_name.id2name
+      camel = camel[0].upcase + camel[1..-1]
+      send(:define_method, "set" + camel) do |val|
+        instance_variable_set("@#{symbol_name}", val)
+      end
+      send(:define_method, "get" + camel) do
+        instance_variable_get("@#{symbol_name}")
+      end
+      send(:define_method, symbol_name.id2name + "GetType") do
+        return type.java_class
+      end
+    end
+    def fxml_accessor(symbol_name,ptype=Java::javafx.beans.property.SimpleStringProperty, type=nil)
+      # TODO: RDoc
+      # TODO: somebody clean this up
+      # TODO: _reader and _writer ? maybe? not?
+      pname = symbol_name.id2name + "Property"
+      unless type
+        type = ptype.java_class.java_instance_methods.find_all{|x|x.name == "getValue"}.map{|x|x.return_type}.find_all{|x|x != java.lang.Object.java_class}
+        if type.length != 1
+          raise "Unknown property type. Please manually supply a type or report this as a bug"
+        end
+        type = type[0]
+      else
+        type = type.java_class
+      end
+      send(:define_method, symbol_name.id2name.snake_case + "=") do |val|
+        send(pname).setValue val
+      end
+      send(:define_method, symbol_name.id2name.snake_case) do
+        send(pname).getValue
+      end
+      send(:define_method, symbol_name.id2name.snake_case + "GetType") do
+        return type
+      end
+      camel = symbol_name.id2name
+      camel = camel[0].upcase + camel[1..-1]
+      send(:define_method, "set" + camel) do |val|
+        send(pname).setValue val
+      end
+      send(:define_method, "get" + camel) do
+        send(pname).getValue
+      end
+      send(:define_method, symbol_name.id2name + "GetType") do
+        return type
+      end
+      send(:define_method, pname) do
+        unless instance_variable_get("@#{symbol_name}")
+          instance_variable_set("@#{symbol_name}", ptype.new(self, symbol_name.to_s))
+        end
+        return instance_variable_get("@#{symbol_name}")
+      end
+      add_method_signature pname, [ptype]
+      add_method_signature "set" + camel, [java.lang.Void, type]
+      add_method_signature "get" + camel, [type]
+    end
+  end
+end