Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "JFace Data Binding"

(How does this work?)
(77 intermediate revisions by 12 users not shown)
Line 1: Line 1:
== What is JFace Data Binding? (code name: Krispy Kreme) ==
+
__NOTOC__
 +
JFace Data Binding is a multi-threaded set of abstractions that allow for automated validation and synchronization of values between objects.  This is commonly used for, but not limited to, the binding of user interface components to model attributes.  The core concepts behind the project are [[Observables]] and [[Binding | Bindings]].  We provide IObservable implementations for SWT,  JFace, and JavaBeans but the core is void of references to these in anticipation of implementations for other projects (e.g. EMF, Swing, etc.).
 +
{{JFace Data Binding}}
  
Developing line of business applications as Eclipse Rich Client Platform applications presents a number of unique challenges.
+
<table border="0"  width="100%" cellspacing="6">
 +
<tr>
 +
<td valign="top" width="33%">
 +
<h3>Tutorials & Presentations</h3>
 +
* [[/Getting started | Getting Started]]
 +
* [[/Tutorial | Tutorial]]
 +
* [[/Snippets | Snippets]]
 +
* [http://www.vogella.com/articles/EclipseDataBinding/article.html Eclipse JFace Databinding and Validation - Tutorial]
 +
* [[JFace Data Binding Introduction|High-Level Description of Data Binding]]
 +
* [http://it-republik.de/jaxenter/artikel/Eclipse-DataBinding-fuer-die-Kommunikation-zwischen-Modell-und-GUI-1353.html#toplink/  Eclipsemagazin 04 / 2007 (German)]
  
* How does one validate data entry when the number of possible interactions between validation rules rises proportional to the square of the number of data entry fields on an input form?
+
<h3>Concepts</h3>
 +
* [[/Observable|Observable]]: value, list, set, or map whose state changes can be observed
 +
* [[/Binding|Binding]]: keeps the state of two observables in sync, uni- or bidirectional
 +
* [[/Data_Binding_Context|Data Binding Context]]: a container for bindings
 +
* [[/Converter|Converter]]: used by a binding to convert values
 +
* [[/Validators|Validators]]: used by a binding to validate values
 +
* [[/Realm|Realm]]: serializes access to observables (every observable belongs to a realm)
 +
* [[/TrackedGetter|Tracked Getter]]: makes the system aware of observables that a piece of code depends on
 +
* [[/Master_Detail|Master-Detail]]: used when you want to bind to attributes of the currently selected object, rather than a fixed object
 +
* [[/The New Binding API|Bind]]: the new and improved binding API
 +
</td>
 +
<td valign="top" width="33%">
  
* How does one avoid coding repetitive, dull, tedious, and error-prone SWT event handlers?
+
<h3>Miscellaneous</h3>
 +
* [[/FAQ | FAQ]]
 +
* [http://fire-change-event.blogspot.com/  fireChangeEvent() Blog]
 +
* [[/How to Contribute | How to Contribute]]
 +
* [[/Wiki Guidelines|Wiki Guidelines]]
 +
* [[/Conformance Tests|Conformance Tests]]
 +
* [[/EMF|Binding to EMF]]
 +
* [[/GWT|Binding to GWT (experimental work)]]
 +
* [[/DOM|Binding to DOM (experimental work)]]
 +
* [[/SSE|Binding to SSE (DOM, EMF, CSS) (experimental work)]]
 +
* [[/Rhino|Binding to Rhino (Javascript Scriptable Object) (experimental work)]]
 +
* [[/PojoBindable|Binding to Pojo (by using NOT BeansObservable) (experimental work)]]
 +
* [[/JSR303BeanJFaceDatabindingValidation|JFace Databinding Validation with JSR-303 (experimental work)]]
 +
</td>
 +
</tr>
 +
</table>
  
* How can one improve reuse of data-driven user interfaces?
+
== Contact Us ==
 +
The [http://www.eclipse.org/newsportal/thread.php?group=eclipse.platform.jface JFace newsgroup] is the place for discussions and questions relating to JFace Data Binding. When posting please prefix the subject with "[DataBinding]" to allow us to easily find posts related to the project.
  
All of these concerns are improved using JFace Data Binding.
+
Design discussions and bugs are located on [https://bugs.eclipse.org/bugs/ Eclipse bugzilla] with a the values...
 +
; Classification : Eclipse
 +
; Product : Platform
 +
; Component : UI
  
=== How does this work? ===
+
Like posts to the newsgroup when logging bugs please prefix the summary with "[DataBinding]" to allow for easier identification.
  
Traditionally, database-driven line of business applications are organized into tiers:
+
== Getting Involved ==
 +
There are many ways to get involved with JFace Data Binding.  To find out how you can contribute see [[/How to Contribute|How to Contribute]].
  
* a database tier
+
== Historical Documents ==
* a business or domain model tier
+
* [https://admin.adobe.acrobat.com/_a300965365/p77464314/ JFace Data Binding Webinar] ''(The code in this presentation is slightly out of date - converters and validators are set up differently in the final 1.0 API.)''
* a presentation tier
+
* [[Media:Databinding.zip | Dave and Boris's EclipseCon 2007 long talk and slides]](Slightly out of date)
 +
* [[Media:Databinding.pdf | Dave Orme's EclipseCon 2006 Lightning Talk slides]] ''(This presentation is outdated. The concepts are still relevant though.)''
 +
* [[/Original Design | Original Design Document]]
 +
* [[/Scenarios | Scenarios Document]]
  
The communication paths between these tiers are organized along the routes that data flows within and among these tiers.
+
== Project Release Status ==
 +
JFace Data Binding 1.0 was released with Eclipse 3.3, [[Europa Simultaneous Release | Europa]].  The Eclipse 3.3.1 release (Europa Fall Maintenance Release) contains a number of [https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=%5BDataBinding%5D&classification=Eclipse&product=Platform&component=UI&target_milestone=3.3.1&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0= bug fixes].
  
Recently, Hibernate, EJB3, and Rails technologies have emerged as a means of automating the data flow between the business tier and the database tier.
+
[[Category:Data Binding]][[Category:Platform UI]]
 
+
By analogy, just as Hibernate helps automate the data flow between the business tier and the database tier, JFace Data Binding helpse automate the data flow betweeen the business tier and the presentation tier.
+
 
+
== Status of JFace Data Binding ==
+
 
+
'''Note:''' ''The JFace data binding framework is new in 3.2 and is now provisional API for Eclipse 3.2.  This means that although there is "internal" in the package names, you can use the APIs and we intend to publish the APIs as full APIs in the next version of Eclipse.  However, although we will try to minimize breaking changes, there are no guarantees that we will not make breaking changes before the API is published.
+
 
+
For comments, design feed back, and bug reports, please enter [https://bugs.eclipse.org/bugs/enter_bug.cgi?product=Platform&version=3.2&component=UI&rep_platform=All&op_sys=All&priority=P3&bug_severity=normal&target_milestone=---&bug_status=NEW&assigned_to=Platform-UI-Inbox%40eclipse.org&qa_contact=&cc=&bug_file_loc=http%3A%2F%2F&short_desc=%5BDataBinding%5D&comment=&commentprivacy=0&keywords=&dependson=&blocked=&maketemplate=Remember%20values%20as%20bookmarkable%20template&form_name=enter_bug bugs against Platform/UI] using <nowiki>[DataBinding]</nowiki> in the summary.''
+
 
+
* [[Data Binding HOWTO]] Document
+
* [[JFace Data Binding Design]] Document
+
* [[JFace Data Binding Scenarios]] Document
+

Revision as of 07:32, 14 August 2013

JFace Data Binding is a multi-threaded set of abstractions that allow for automated validation and synchronization of values between objects. This is commonly used for, but not limited to, the binding of user interface components to model attributes. The core concepts behind the project are Observables and Bindings. We provide IObservable implementations for SWT, JFace, and JavaBeans but the core is void of references to these in anticipation of implementations for other projects (e.g. EMF, Swing, etc.).

JFace Data Binding
Home
How to Contribute
FAQ
Snippets
Concepts
Binding
Converter
Observable
Realm

Tutorials & Presentations

Concepts

  • Observable: value, list, set, or map whose state changes can be observed
  • Binding: keeps the state of two observables in sync, uni- or bidirectional
  • Data Binding Context: a container for bindings
  • Converter: used by a binding to convert values
  • Validators: used by a binding to validate values
  • Realm: serializes access to observables (every observable belongs to a realm)
  • Tracked Getter: makes the system aware of observables that a piece of code depends on
  • Master-Detail: used when you want to bind to attributes of the currently selected object, rather than a fixed object
  • Bind: the new and improved binding API

Miscellaneous

Contact Us

The JFace newsgroup is the place for discussions and questions relating to JFace Data Binding. When posting please prefix the subject with "[DataBinding]" to allow us to easily find posts related to the project.

Design discussions and bugs are located on Eclipse bugzilla with a the values...

Classification 
Eclipse
Product 
Platform
Component 
UI

Like posts to the newsgroup when logging bugs please prefix the summary with "[DataBinding]" to allow for easier identification.

Getting Involved

There are many ways to get involved with JFace Data Binding. To find out how you can contribute see How to Contribute.

Historical Documents

Project Release Status

JFace Data Binding 1.0 was released with Eclipse 3.3, Europa. The Eclipse 3.3.1 release (Europa Fall Maintenance Release) contains a number of bug fixes.

Back to the top