-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<li><a href="#requirements">Requirements</a></li>
</ul>
-<p><i><b>This is a prerelease version of Vaadin 6.2</b>, the Release
-Notes will change before the final release.</i> Also notice that the regular
-Vaadin Plugin for Eclipse does not support Vaadin 6.2 yet; you should
-use <tt>http://vaadin.com/eclipse/experimental</tt> as the URL for the
-experimental plugin that supports the upcoming Vaadin 6.2.</p>
-
-<p>Vaadin @version@ is an update for Vaadin 6. In addition to various fixes, it
+<p>Vaadin @version@ is an update release for Vaadin 6. In addition to various fixes, it
contains a number of significant enhancements.</p>
<ul>
<li>Widget set definition and component-to-widget mapping has been redesigned</li>
<ul>
- <li>Reuse of widgets is now much easier, as it is easier to package and use widget set JARs and otherwise combine widget sets.</li>
- <li>A widget set definition class is no longer used. Java code needed for widget instantiation and client-server mapping is
- automatically generated by GWT compiler. For common Vaadin user, Widgetset is now only a GWT module definition file (.gwt.xml).</li>
+ <li>Reuse of widgets is now much easier, as it is easier to package and use widget
+ set JARs and otherwise combine widget sets.</li>
+
+ <li>A widget set definition class is no longer used. Java code needed for widget
+ instantiation and client-server mapping is automatically generated by GWT
+ compiler. For common Vaadin user, Widgetset is now only a GWT module definition
+ file (.gwt.xml).</li>
+
<li>Server-side component is mapped to a client-side widget with an annotation:
<pre>@ClientWidget(com.vaadin.demo.colorpicker.gwt.client.ui.VColorPicker.class)
public class ColorPicker extends AbstractField {</pre>
</li>
+
<li>The <tt>getTag()</tt> method is no longer needed</tt></li>
- <li>The Vaadin Plugin for Eclipse can create new widget stubs, define the mapping, and create widget set definition files (<tt>.gwt.xml</tt>).</li>
- <li>See <tt>WebContent/docs/example-source/build-widgetset.xml</tt> for example on how you can compile widget sets and widget set JARs with Ant.</li>
- <li>A widget set builder allows automatic generation and maintenance of widget configurations, making use of widget set JARs easier.</li>
+
+ <li>The Vaadin Plugin for Eclipse can create new widget stubs, define the mapping,
+ and create widget set definition files (<tt>.gwt.xml</tt>).</li>
+
+ <li>See <tt>WebContent/docs/example-source/build-widgetset.xml</tt> for an example
+ on how you can compile widget sets and widget set JARs with Ant.</li>
+
+ <li>A widget set builder allows automatic generation and maintenance of widget
+ configurations, making use of widget set JARs easier.</li>
+
+ <li>See <a href="#widgetupgrade">notes below</a> for upgrading widget set
+ definitions and widget mappings from earlier version of Vaadin 6.</li>
</ul>
<li>Other enhancements to development of new components</li>
<ul>
</ul>
<li>On the client-side:</li>
<ul>
- <li>Ability to check if a listener is registered on server side</li>
+ <li>Ability to check if a listener is registered on the server-side</li>
<li>Typed arrays and maps can now be sent to server with <tt>updateVariable()</tt></li>
</ul>
</ul>
<li>Refactoring widget sets has also provided some optimizations for rendering</li>
<li>Portlet 2.0 (JSR 268) support (no separate servlet, no session problems, portlet-to-portlet communication, etc)</li>
<li>OSGi support</li>
- <li>Enhanced sorting of <b>IndexedContainer</b> and <b>BeanItemContainer</b></li>
- <li>New layout in Sampler and several new examples</li>
+ <li>Enhanced sorting of <b>IndexedContainer</b> and <b>BeanItemContainer</b> [TODO]</li>
+ <li>Improved event support [TODO]</li>
<li>JavaScript injection with <tt>Window.excecuteJavaScript()</tt>, "the method that you never want to use, but that is nice to have"</li>
- <li><b>Tree</b> style generator, <b>TabSheet</b> close button, plus dozens of other small enhancements and bug fixes</li>
+ <li>Additional Maven archetypes [TODO]</li>
+ <li>New layout in Sampler and several new examples</li>
+ <li><b>HttpServletRequestListener</b> [TODO]</li>
+ <li><b>PortletRequestListener</b> [TODO]</li>
+ <li>Window closable support [TODO]</li>
+ <li>Enhancements to various components:</li>
+ <ul>
+ <li><b>Tree</b>: item style generator, rendering optimizations</li>
+ <li><b>ItemSorter</b> [TODO]</li>
+ <li><b>Tabsheet</b>: a close button for tabs</li>
+ <li><b>SplitPanel</b>: double-click event for a splitter</li>
+ <li><b>MenuBar</b> enhancements [TODO]</li>
+ <li><b>DateField</b>: lenient/non-lenient support [TODO]</li>
+ <li>Click listeners for <b>Panel</b>, <b>Embedded</b>, and layout components [TODO]</li>
+ <li>Focus and blur events for <b>DateField</b>, <b>TextField</b>, and <b>Select</b> [TODO]</li>
+ </ul>
+ <li>Automatic integration tests for the supported servers</li>
+ <li>Dozens of other small enhancements and bug fixes</li>
</ul>
<p>Problem fixes and enhancements planned for upcoming releases can be found from the <a
<p>As always, when upgrading from an earlier version, you should recompile any custom
widget sets and refresh your project in Eclipse. If you are upgrading from earlier than
-6.1.0, notice that Vaadin 6.1 uses GWT 1.7.0 (included in the installation package). See
+6.2.0, notice that Vaadin 6.2 uses GWT 1.7.0 (included in the installation package). See
<a href="#upgrading">General Upgrade Notes</a> for more details on upgrading.</p>
-<h2>Widgetset upgrade notes</h2>
+<h2><a name="widgetupgrade">Upgrading Custom Component Projects from Earlier Vaadin 6</a></h2>
+
+<p>If you are using custom components (components from other than the
+<b>DefaultWidgetSet</b>) from an earlier version of Vaadin 6, you will need to upgrade the
+widget set definitions.</p>
-See preliminary instructions from <a href="http://dev.vaadin.com/wiki/WidgetSetUpgrade">wiki</a>.
+<p>[TODO]</p>
+
+<ul>
+ <li>If using a widget set from another project (most likely from a separate JAR file):</li>
+ <ul>
+ <li>Get a widget set JAR compatible with Vaadin 6.2. If the new JAR does not contain a
+ precompiled widget set (as it normally does not), you need to create a custom widget
+ set for your project. The experimental eclipse plugin will create it for you
+ automatically.</li>
+ </ul>
+ <li>If the project has its own widget set:
+ <ul>
+ <li>Remove <tt>WidgetSet.java</tt> file, this is no more needed</li>
+ <li>If project has client-side components in its own source directory:</li>
+ <ul>
+ <li>Remove <i>getTag()</i> method implementations from server-side components; tag
+ names are no longer used. We have intentionally made the <i>getTag()</i> method
+ <tt>final</tt> to make it easier to find them (they wont compile)</li>
+
+ <li>Annotate server-side components having client side counterpart with
+ <tt>@ClientWidget(VClientSideCounterPart.class)</tt> annotation. Basically these are the
+ same components that had the <i>getTag()</i> method previously. </li>
+ </ul>
+ <li>If (combined) widget set uses widgets from other widget sets (most likely from a separate JAR file)</li>
+ <ul>
+ <li>Update referenced widget sets to support 6.2</li>
+ <li>Add/keep necessary inherits tags in your combined widgetset (<tt>.gwt.xml</tt> file). Eclipse plugin will again try to automatically add these to your widgetset.</li>
+ </ul>
+ <li>If you package a widget set as a JAR for usage in other projects:</li>
+ <ul>
+ <li>Add an entry like Vaadin-Widgetsets: com.vaadin.incubator.fastlayouts.ws.FastLayoutsWidgetSet to JAR files MANIFEST.MF file. This helps tools to detect package as vaadin component package.</li>
+ </ul>
+ </ul>
+</ul>
<h2><a name="upgrading">General Upgrade Notes</a></h2>
<p>The following closed issues have been included in this release:</p>
<ul>
- <li><a href="http://dev.vaadin.com/ticket/2719">#2719</a>: Sampler margin demo shows wide right margin without explanation</li>
+ <li><a href="http://dev.vaadin.com/ticket/2118">#2118</a>: Sample: ProgressIndicator</li>
+ <li><a href="http://dev.vaadin.com/ticket/2715">#2715</a>: Sample: Slider</li>
+ <li><a href="http://dev.vaadin.com/ticket/2854">#2854</a>: Paintable should be an appropriate variable type</li>
<li><a href="http://dev.vaadin.com/ticket/2918">#2918</a>: Same application is loaded in different portlet instances</li>
<li><a href="http://dev.vaadin.com/ticket/3070">#3070</a>: Tree's Items should be easily styled</li>
<li><a href="http://dev.vaadin.com/ticket/3088">#3088</a>: ComboBox, If only one item is listed, pressing Enter should choose it, not discard</li>
<li><a href="http://dev.vaadin.com/ticket/3117">#3117</a>: Portlet 2.0 (JSR-286) support</li>
+ <li><a href="http://dev.vaadin.com/ticket/3120">#3120</a>: Window.setClosable(boolean)</li>
+ <li><a href="http://dev.vaadin.com/ticket/3133">#3133</a>: Window draggability disabling feature</li>
<li><a href="http://dev.vaadin.com/ticket/3234">#3234</a>: Component Event Listener Framework for all widgets/components</li>
+ <li><a href="http://dev.vaadin.com/ticket/3259">#3259</a>: Removing all action handlers</li>
<li><a href="http://dev.vaadin.com/ticket/3277">#3277</a>: MenuBar.MenuItem could have setVisible() method</li>
- <li><a href="http://dev.vaadin.com/ticket/3323">#3323</a>: Redesign sampler main screen</li>
+ <li><a href="http://dev.vaadin.com/ticket/3338">#3338</a>: Create a Maven archetype for creating a widget project</li>
+ <li><a href="http://dev.vaadin.com/ticket/3367">#3367</a>: It should be possible to specify parameters for embedded flash</li>
<li><a href="http://dev.vaadin.com/ticket/3386">#3386</a>: Add JUnit tests for ensuring compatibility with all supported application servers and portals</li>
- <li><a href="http://dev.vaadin.com/ticket/3387">#3387</a>: Google AppEngine integration test</li>
+ <li><a href="http://dev.vaadin.com/ticket/3416">#3416</a>: Theme should contain Vaadin version</li>
<li><a href="http://dev.vaadin.com/ticket/3433">#3433</a>: BeanItemContainer's sort is not overridable</li>
<li><a href="http://dev.vaadin.com/ticket/3434">#3434</a>: IndexedContainer's compare is not overridable</li>
+ <li><a href="http://dev.vaadin.com/ticket/3479">#3479</a>: Embedded applications should not change the page title</li>
+ <li><a href="http://dev.vaadin.com/ticket/3483">#3483</a>: PopupView rendering style inside a layout is unspecified</li>
+ <li><a href="http://dev.vaadin.com/ticket/3484">#3484</a>: Sample: OptionGroup</li>
+ <li><a href="http://dev.vaadin.com/ticket/3498">#3498</a>: Window doesn't get focus correctly</li>
<li><a href="http://dev.vaadin.com/ticket/3499">#3499</a>: PopupView CSS style is broken</li>
+ <li><a href="http://dev.vaadin.com/ticket/3515">#3515</a>: Sample: NativeButton</li>
+ <li><a href="http://dev.vaadin.com/ticket/3518">#3518</a>: Sample: Menubar</li>
+ <li><a href="http://dev.vaadin.com/ticket/3526">#3526</a>: SplitPanel collapse and expand with doubleclick</li>
<li><a href="http://dev.vaadin.com/ticket/3541">#3541</a>: VerticalLayout//HorizontalLayout/GridLayout/AbsoluteLayout/CSSLayout should support click events</li>
<li><a href="http://dev.vaadin.com/ticket/3544">#3544</a>: Implement support for focus/blur events in TextField</li>
<li><a href="http://dev.vaadin.com/ticket/3553">#3553</a>: Change nightly and develpoment version numbering</li>
<li><a href="http://dev.vaadin.com/ticket/3605">#3605</a>: Patch to avoid concurrent modification exceptions in EventRouter</li>
+ <li><a href="http://dev.vaadin.com/ticket/3631">#3631</a>: LoginForm login button is too wide in IE6/IE7</li>
<li><a href="http://dev.vaadin.com/ticket/3640">#3640</a>: Update build-widgetsets.xml and verify it works</li>
+ <li><a href="http://dev.vaadin.com/ticket/3641">#3641</a>: Document the way widgets and widgetsets are created and used in Vaadin 6.2</li>
+ <li><a href="http://dev.vaadin.com/ticket/3654">#3654</a>: Decide on final PaintTarget.paintReference(Paintable, String) API</li>
<li><a href="http://dev.vaadin.com/ticket/3655">#3655</a>: ApplicationRunner logs unnecessary java.lang.ClassNotFoundExceptions</li>
<li><a href="http://dev.vaadin.com/ticket/3683">#3683</a>: TextField.setRows() API needs reworking</li>
+ <li><a href="http://dev.vaadin.com/ticket/3688">#3688</a>: ContainerHierarchicalWrapper should stay ordered by the wrapped container</li>
+ <li><a href="http://dev.vaadin.com/ticket/3715">#3715</a>: Sub windows are shown as VView in debug console</li>
+ <li><a href="http://dev.vaadin.com/ticket/3717">#3717</a>: Parameterize BeanItem and ComponentContainer.getComponentIterator</li>
<li><a href="http://dev.vaadin.com/ticket/3731">#3731</a>: Implement a simpler alternative to ApplicationContext.TransactionListener</li>
<li><a href="http://dev.vaadin.com/ticket/3740">#3740</a>: Tabsheet no longer fully serializable, doesn't work in GAE</li>
<li><a href="http://dev.vaadin.com/ticket/3754">#3754</a>: Add data.util.TextFileProperty</li>
<li><a href="http://dev.vaadin.com/ticket/3784">#3784</a>: Panel.setScrollTop does not work with invalid values</li>
<li><a href="http://dev.vaadin.com/ticket/3785">#3785</a>: Style names for MenuBar.MenuItem</li>
<li><a href="http://dev.vaadin.com/ticket/3786">#3786</a>: Add focus and blur events to Select/VFilterSelect and DateField/VTextualDate</li>
+ <li><a href="http://dev.vaadin.com/ticket/3787">#3787</a>: validator is not called when field is empty and not required</li>
<li><a href="http://dev.vaadin.com/ticket/3788">#3788</a>: Typo in setWriteThrough's parameter name</li>
+ <li><a href="http://dev.vaadin.com/ticket/3807">#3807</a>: LoginForm doesn't work when multiple windows are used for the same application</li>
+ <li><a href="http://dev.vaadin.com/ticket/3809">#3809</a>: Sample: Immediate upload</li>
+ <li><a href="http://dev.vaadin.com/ticket/3817">#3817</a>: Upload: Browsers send different filenames</li>
+ <li><a href="http://dev.vaadin.com/ticket/3819">#3819</a>: Document that widgetset compiler loads classes</li>
+ <li><a href="http://dev.vaadin.com/ticket/3820">#3820</a>: DefaultItemSorter is not serializable</li>
+ <li><a href="http://dev.vaadin.com/ticket/3824">#3824</a>: Make sure build generates theme version</li>
+ <li><a href="http://dev.vaadin.com/ticket/3825">#3825</a>: AbstractComponentThrows NPE when both visible and enable is set to false</li>
+ <li><a href="http://dev.vaadin.com/ticket/3828">#3828</a>: TextField inside a layout inside a Table is clipped</li>
+ <li><a href="http://dev.vaadin.com/ticket/3830">#3830</a>: Group widgetset builder output</li>
+ <li><a href="http://dev.vaadin.com/ticket/3831">#3831</a>: Show better information about what widget is missing</li>
+ <li><a href="http://dev.vaadin.com/ticket/3835">#3835</a>: "Portlet 2.0 does not support the ""style"" parameter"</li>
+ <li><a href="http://dev.vaadin.com/ticket/3842">#3842</a>: Make widgetset generation console output parameterized</li>
+ <li><a href="http://dev.vaadin.com/ticket/3843">#3843</a>: Form caption is blue in IE</li>
+ <li><a href="http://dev.vaadin.com/ticket/3845">#3845</a>: Twincol select buttons are missing right border in IE6</li>
+ <li><a href="http://dev.vaadin.com/ticket/3848">#3848</a>: Rich text sample is cut in IE</li>
+ <li><a href="http://dev.vaadin.com/ticket/3849">#3849</a>: Undefined wide menubar is 100% wide in IE6</li>
+ <li><a href="http://dev.vaadin.com/ticket/3850">#3850</a>: Submenu icon is placed outside the menu in IE7</li>
+ <li><a href="http://dev.vaadin.com/ticket/3853">#3853</a>: Sampler fragments should be backwards compatible</li>
+ <li><a href="http://dev.vaadin.com/ticket/3856">#3856</a>: Add javadoc to UIDL class</li>
+ <li><a href="http://dev.vaadin.com/ticket/3859">#3859</a>: Application contains mysterious deprecated methods</li>
+ <li><a href="http://dev.vaadin.com/ticket/3862">#3862</a>: JSApi sample uses threads</li>
+ <li><a href="http://dev.vaadin.com/ticket/3872">#3872</a>: Remove reservr from demo page</li>
+ <li><a href="http://dev.vaadin.com/ticket/3874">#3874</a>: Two click events is sent for a middle click in a layout</li>
+ <li><a href="http://dev.vaadin.com/ticket/3879">#3879</a>: Removing portlet leaks memory</li>
</ul>
<h2><a name="requirements">Requirements</a></h2>
projects / vaadin-framework.git / commitdiff