Difference between revisions of "JFace Data Binding/FAQ"

From Eclipsepedia

Jump to: navigation, search
(Added project set file information.)
Line 19: Line 19:
  
 
=== How do I run the tests? ===
 
=== How do I run the tests? ===
In order to run the tests you need to check out the following projects:
+
In order to run the tests you need to have the following projects in your workspace:
 
* org.eclipse.core.databinding
 
* org.eclipse.core.databinding
 
* org.eclipse.core.databinding.beans
 
* org.eclipse.core.databinding.beans
Line 25: Line 25:
 
* org.eclipse.jface.examples.databinding
 
* org.eclipse.jface.examples.databinding
 
* org.eclipse.jface.tests.databinding
 
* org.eclipse.jface.tests.databinding
 +
 +
Rather than checking these projects out one by one we publish [http://www.eclipse.org/eclipse/platform-ui/psf/ project set files] to do this for you.  All you need to do is to download the appropriate file, import it into your workspace (File->Import->Team->Team Project Set), and the projects will be checked out for you.
  
 
View the run configurations in your workspace (Run->Run...).  Run JUnit Plug-in Test->JFace-Data Binding Test Suite.
 
View the run configurations in your workspace (Run->Run...).  Run JUnit Plug-in Test->JFace-Data Binding Test Suite.

Revision as of 09:56, 20 August 2007

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

Contents

Does Data Binding depend upon Eclipse?

The core Data Binding plug-in only depends upon org.eclipse.equinox.common and no other parts of Eclipse. There are parts of Data Binding that depend upon SWT/JFace but these have been broken out into a separate plug-in, org.eclipse.jface.databinding. For a discussion of why the core depends upon equinox common see bug 153630 comment 9.

Does Data Binding depend upon SWT?

No. Data Binding is meant to be UI toolkit agnostic and more specifically UI agnostic. There is default support for SWT and JFace but this is in the org.eclipse.jface.databinding project which is separate from the core Data Binding APIs that live in org.eclipse.core.databinding. For background and when the separation occurred in see bug 153630.

How do I report a bug?

On the Eclipse bugzilla log a bug to Eclipse > Platform > UI with "[DataBinding]" in the summary.

When will the public API be ready?

The majority of refactorings have occurred. We have few planned before 3.3M6 (API freeze) but we still reserve the right tweak the API as we see fit until then. The 1.0 version will be a part of Eclipse 3.3. (Technically, it will be version 1.1, because version 1.0 of data binding shipped with Eclipse 3.2.) To view the plan item for this see bug 154132.

Where can I ask a question?

You can ask questions on the Eclipse Platform newsgroup. When you post please prefix the title with "[DataBinding]".

How do I bind to the ValidationError of a Binding or DataBindingContext?

See snippet 004.

How do I run the tests?

In order to run the tests you need to have the following projects in your workspace:

  • org.eclipse.core.databinding
  • org.eclipse.core.databinding.beans
  • org.eclipse.jface.databinding
  • org.eclipse.jface.examples.databinding
  • org.eclipse.jface.tests.databinding

Rather than checking these projects out one by one we publish project set files to do this for you. All you need to do is to download the appropriate file, import it into your workspace (File->Import->Team->Team Project Set), and the projects will be checked out for you.

View the run configurations in your workspace (Run->Run...). Run JUnit Plug-in Test->JFace-Data Binding Test Suite.

Where can I get the plugins?

The JFace Data Binding plug-ins can be found in any of the following distributions on the Eclipse download page:

  • Eclipse SDK
  • RCP Runtime/SDK
  • Platform Runtime/SDK

Just select the desired build (e.g. stable, integration, nightly) and download one of the above distributions.

Where can I find examples of how to use data binding?

The org.eclipse.jface.examples.databinding project contains snippets that demonstrate some of the more common usages of the API.

Can JFace Data Binding run against Eclipse 3.2.x?

Yes, but depending upon your needs you might need to take an extra step. The 1.0 version of JDB does not depend upon Eclipse 3.3 APIs. But the org.eclipse.jface.databinding plug-in distributed by Eclipse will only run against Eclipse 3.3. The distributions of org.eclipse.core.databinding and org.eclipse.core.databinding.beans will run just fine against Eclipse 3.2.x. If wanting to run org.eclipse.jface.databinding against Eclipse 3.2.x you'll need to build it from source against your target platform. For more information as to why this is necessary see bug 177476.