Version @version@ built on @builddate@.

Release Notes for Vaadin Framework @version@

Overview of Vaadin @version@ Release

Vaadin @version@ is a minor release that includes a number of new features and bug fixes, as listed in the list of enhancements and change log below.

Change log for Vaadin @version@

This release includes the following closed issues:

#4054Change ComboBox to be immediate by default
Vote#7229Add option to support null intermediate properties in NestedMethodProperty
#8012DateField click-n-hold bug with multiple onMouseDown events
#8029Change setImmediate default to true for most components
#8168Table.propertyValueConverters should be cleaned when a property id is removed
#9153LayoutManager missing methods
#9269Change UIDL request payload to be valid JSON
#9379Optimize generated code size
#9814DragAndDropWrapper should only start dragging when the primary mouse button is pressed
#9997Add StringToBigDecimalConverter
#10015Update Link to use state and rpc
#10338Immediately clean up old UI when loading new
#10392Unhelpful error message if using generics in RPC interface
#10446Fix memory problem of BeanItem/MethodProperty
#10618PopupView doesn't display caption
#11054@PreserveOnRefresh looses page title on refresh
#11257Remove multiple variable burst support from UIDL communication
Priority#11324BeanValidator uses HTML in error message, that is being escaped
#11367Vaadin 7 Accordion - Problem 2
#11409Move DragAndDropService to VaadinSession
#11435NestedMethodProperty and null values
#11599Stack traces generated by DefaultErrorHandler are ridiculous
Vote#11744Allow Overriding Cache Time for certain files
#11758VaadinServlet isStaticResourceRequest incorrect/inefficient
#11803Javadoc of @Widgetset annotation speaks about defining a theme
#11804Typo in UI class Javadoc
#11820Accessibility for Notification
#11821Accessibility for Window
#11823Tabsheet should not immediately select a tab when changing tab using keyboard
#11824Tabsheet tabs should support alternate text
#11826Support optional screen reader notification when a tab is added or removed
#11827Accessibility for TabSheet
#11830Support screen reader only notifications
#11874Prevent to exit a (Sub)Window with the tab key
#11947Long File Size is not supported in VHtml5File and DragAndDropWrapper
#12064Add support for setId to TabSheet.Tab
#12092StringToNumberConverter should be removed
#12120Support websockets with Glassfish4
Priority#12139with push enabled, session is not destroyed
#12159Switch back to master branch of GWT (Vaadin 7.2)
#12180Add shorthand for recursively measuring child components
Vote#12191Provide reload event for UI classes with @PreserveOnRefresh
#12251Add ServiceDestoryListener
#12255@PreserveOnRefresh might cause problems with multiple UIs on the same page
#12257When selecting a Tab, screen reader reads out all the tabs
#12265Prevent SynchronizedRequestHandler from locking just to determine it doesn't handle the request
#12269Invoke the connector's ErrorHandler for exceptions in ConnectorResourceHandler
#12276Opening (Sub)Window requires assistive description to be set
#12291Add a StringToLongConverter
#12292Ensure pending access queue race condition is fixed
Priority#12307VaadinServlet handleContextRootWithoutSlash incorrect when URL contains ;jsessionid
#12321Alt text on button icon does not appear
#12323Responsive Addon not working on IE8 window resize
#12329Support Tomcat 8
Priority#12337VScrollTable does not stop timer on detach
#12344Can set focus outside modal Window with Tab key
#12353Setting page title dynamically broken
#12394Integrate the Reponsive add-on
#12414Changing value in Label doesn't fire value change event
#12421Use GWT git repository instead of GWT subversion repository
#12461StringIndexOutOfBoundException is thrown if UI class is in default package
#12466Add support for poll listeners
#12517aria-invalid attribute is not removed after successful validation
#12525The user should be able to trigger MenuBar actions/submenus the the space key also
#12536ComboBox Tooltip not handled on Focus
#12550Slider doesn't update correctly with window re-sizing
#12601Upgrade to atmosphere-runtime 2
Priority#12612Duplicate Session Destroy notifications delivered on session shutdown when proxied
Vote#12629Support IE 11
#127107.2 build fails with new GWT
#12713Update vaadin-deps to contain new Guava
Priority#12714v-table-header-drag element should reside inside v-overlay-container element
#12765DefaultWIdgetSet cannot be compiled
#12780NativeButton.setIconAlternateText has no effect
#12825Remove obsolete field "width" from VNativeButton
#12843On session timeout, client UIs are not properly notified
#12849When component with tooltip is focused with tab, screen reader reads a wrong component.
#12860Merge upstream GWT IE10 changes
#12871Update GWT dependencies
#12873Generated createWidget() does not work for widgets with generics
#12900@DelegateToWidget does not work with widget using generics
#12902TestBench3 selectors fail on paths with domChild
#12904ComponentLocator and LocatorStrategy implementations are intra-dependent
#12925Page.setLocation should use window name "_self"
#12931Notifications do not support Position.MIDDLE_LEFT and MIDDLE_RIGHT
Priority#12944TabSheet does state change event before creating DOM
#12958Simplify state change event handling
#12959Use JSNI in generated invokers to support non-public methods
#13011Support long polling for push
#13020VaadinFinderLocatorStrategy should return paths for elements
#13053Make it possible to retrieve all VaadinSession inside a HTTP session
#13067Selects should have convenience method to add items with varargs parameter
#13068Binding a simple bean to fields from a view object requires 4 lines
#13073Support Date in state + rpc
#13080vaadin-push depends on two versions of compat-tomcat
#13081Enable JUnit tests to be run on shared classes
#13082IE8 does not work with long polling
#13083Upgrade to atmosphere-javascript 2.0.8
#13124DateField in disabled layout
#13127Creating an UI with only Windows breaks first window
#13152Support font icons
#13156DatePicker client-side disabled state works incorrectly after calling setUseNative(true)
#13164Create long polling versions of all push tests
#13196Atmosphere-runtime pre-2.1.0 does not support Jetty 9.1
#13199Atmosphere init failure should be nonfatal
#13206Clicking on the active tab in a TabSheet doesn't focus it
#13209Missing javadoc for Field interface
#13222com.vaadin.ui.Upload introduce new "SelectionListener"
#13223Refactor PushConnection
#13252ICU4J should not be in client-compiler-deps
#13259Re-enable Opera 12 permutation
#13274Collapse all GWT permutations by default
#13277Consider updating to android sdk json
#13287Replace c.g.g.u.c.Element with c.g.g.d.c.Element
#13300Snapshot build broken
#13329CustomDateFormat test fails because legacy locator is not 100% compatible
#13350Websockets do not work with multiple servlets on Tomcat 8
#13367window.prompt is not supported on Metro versions of IE
#13368Dragging doesn't work on IE on a touch screen
#13372MenuBar / MenuItem does not support FontIcon
#13373Notification does not support FontIcon
#13374Consider enabling the Atmosphere protocol
#13375Actions do not support FontIcon
#13376ComboBox items do not support FontIcon
#13383Vaadin 7.2 (SNAPSHOT) broken on Glassfish 4
#13384Support Wildfly 8
#13395Re-add Opera 12 support
#13399Wrong behaviour of Table#setColumnAlignment(Object, Align)
#13402Update TabSheet and Accordion to use Vaadin 7 style
#13405Verify we do not use multiple versions of the same dependency
#13409Change the default push fallback to long polling
Priority#13410vaadin-shared-deps bundle doesn't confirm to the OSGi version requirement
Priority#13421unable to enter a modal window via tabbing once you exit it
#13427OSGi: vaadin-push has unsatisfied dependency
#13430Title should not be set to null
#13445Clicking the window header doesn't move it to the top
#13446Button should have constructor with just icon Resources
#13449Ensure license info is up to date
#13460com.vaadin.data.util.filter.Like accepts String as property id
#13473Improve error message when attaching component from a different session
#13502Add "incompatible changes" section to release notes
#13514BroadcasterCache must be used
#13516VerticalLayout and HorizontalLayout insert additional icons for contained components
#13518javadoc is incorrect at com.vaadin.shared.ui.label.ContentMode
#13528Race condition in Atmosphere when initializing two VaadinServlets at the same time
#13529Session expired not shown for websocket connections
#13531Use the same version of commons-io in all modules
#13532Override the sass-compiler's cssparser version
#13542Discourage use of LayoutManager.setNeedsLayout while a layout is running
#13545JSONCodec inefficiecies
#13548Responsive tutorial
#13549Support pointer events for IE10+IE11
#13550Button mousedown - mouseout - mouseover - mouseup should cause click
#13551Improve extending portlet requests for accessing servlet requests
#13556findUI throws NullPointerException
#13557DnD in WRAPPER drag start mode doesn't show text area text in drag image.
#13560Atmosphere warning appears with default new project: No BroadcasterCache configured.
#13568AbstractOrderedLayout.replaceComponent should also apply layout settings to the new component
#13578Push reconnect fails after a network failure when using long-polling with Firefox
Priority#13583Vaadin does not handle URL-encoded request URL parameter values properly
#13593PopupView is broken
#13598Disable animations in popup view until fixed
#13612Correct release notes
#13613Update GWT to latest upstream master
#13617NPE when session expires if session expiration messages texts have been removed
#13620Vaadin7.2beta: Reloading PreserveOnrefresh App with Push fails with NPE, due to PushConnection being null from disconnect
#13625Update to TestBench 4.0.0.alpha1
#13651Vaadin7.2beta: Upgrade saas compiler version
#13655NoSuchElement exception on DnD to the table without data.
#13682SuperDevMode broken with 7.2.0.beta1
#13685Move v-loc of bootstrap.js from GET to POST parameter
#13692Widgetset compilation fails with primitive 'long' field in shared state
#13706TabSheet too narrow on IE8
#13716AtmospherePushConnection.disconnect() does not actually close the connection
#13719Re-enable animations in popup view
Priority#13720Legacy event handling is not aware of PointerEvents
#13723Button Icons and Error Indicators can change places
#13727Push reconnect doesn't work properly after a network failure with IE & long-polling
#13729Delete deprecated c.v.c.ComponentLocator
#13731Combobox does not render icons correctly
VoteEnhancements Vaadin support users have voted for
PriorityDefects Vaadin support users have prioritized

You can also view the list of the closed issues at the Vaadin developer's site.

Enhancements in Vaadin @version-minor@

The @version-minor@ includes many major and minor enhancements. Below is a list of the most notable changes:

For enchancements introduced in Vaadin 7, see the Release Notes for Vaadin 7.0.0.

Incompatible changes

Behavior altering changes

Known issues

Limitations

Vaadin Installation

Vaadin is a Java framework for building modern web applications that look great, perform well and make you and your users happy. Vaadin is available under the Apache License, Version 2.0 (see the license.html in the Vaadin ZIP or JAR package).

The easiest ways to install Vaadin are:

It is also available as a ZIP package downloadable from Vaadin Download page.

Package Contents

Inside the ZIP installation package you will find:

See the README.TXT in the installation package for detailed information about the package contents. Book of Vaadin (for Vaadin 7) gives more detailed instructions.

For server-side development, copy the vaadin-server , vaadin-client-compiled , vaadin-shared , and vaadin-themes from the main folder and the dependencies from the lib folder to the WEB-INF/lib folder of your Vaadin project. (The vaadin-client-compiled is necessary if you do not wish to compile the widget set by your own, which you need to do if you use almost any add-on components.)

Updates to the Packaging

Since Vaadin 7.2.0, the old vaadin-theme-compiler has been moved into a separate project and renamed to vaadin-sass-compiler. It is now included along with the other 3rd party dependencies in the ZIP package.

For pure client-side development, you only need the vaadin-client and vaadin-client-compiler JARs, which should be put to a non-deployed project library folder, such as lib . You also need them if you compile the widget set for any reason, such as using Vaadin add-ons, or create new server-side components integrated with client-side widgets.

Migrating from Vaadin 6

All Vaadin 6 applications need some changes when migrating to Vaadin 7. The most obvious changes are in the application/window API and require extending either UI or UI.LegacyApplication instead of Application. A detailed list of migration changes are given in the Vaadin 7 Migration Guide.

Any custom client-side widgets need to be ported to use the new client-server communication API, or the Vaadin 6 compatibility API.

Vaadin 6 add-ons (ones that contain widgets) do not work in Vaadin 7 - please check the add-ons in Vaadin Directory for Vaadin 7 support.

Vaadin @version@ Dependencies

When using Maven, Ivy, Gradle, or other dependency management system, all Vaadin dependencies are downloaded automatically. This is also the case when using the Vaadin Plugin for Eclipse.

The Vaadin ZIP installation package includes the dependencies in the lib subfolder. These need to be copied to the WEB-INF/lib folder of the web application that uses Vaadin.

The dependencies are listed in the Licensing description. Some are explicit dependencies packaged and distributed as separate JARs, while some are included inside other libraries.

Bean Validation

If you use the bean validation feature in Vaadin 7, you need a Bean Validation API implementation. You need to install the implementation JAR in the WEB-INF/lib directory of the web application that uses validation.

Upgrading from Vaadin 7.1 to Vaadin @version-minor@

When upgrading from an earlier Vaadin version, you must:

Remember also to refresh the project in your IDE to ensure that the new version of everything is in use.

By using the " ?debug " URL parameter, you can verify that the version of the servlet, the theme, and the widget set all match.

Eclipse users should always check if there is a new version of the Eclipse Plug-in available. The Eclipse Plug-in can be used to update the Vaadin version in the project (Project properties » Vaadin).

Maven users should update the Vaadin dependency version in the pom.xml unless it is defined as LATEST . You must also ensure that the GWT dependency uses the correct version and recompile your project and your widget set.

Liferay and other portal users must install the Vaadin libraries in ROOT/WEB-INF/lib/ in the portal (and remove a possibly obsolete older vaadin.jar). Additionally, the contents of the vaadin-client-compiled and vaadin-themes must be extracted to the ROOT/html/VAADIN directory in the Liferay installation. If your portal uses custom widgets, you can use Liferay Control Panel for Vaadin for easy widget set compilation.

Notes and Limitations for Google App Engine

The following instructions and limitations apply when you run a Vaadin application under the Google App Engine.

For other known problems, see open tickets at developer site dev.vaadin.com.

Supported Technologies

Vaadin 7 is compatible with Java 6 and newer. Vaadin 7 is especially supported on the following operating systems:

Vaadin 7 requires Java Servlet API 2.4 but also supports later versions and should work with any Java application server that conforms to the standard. The following application servers are supported:

Vaadin 7 supports the JSR-286 Portlet specification and all portals that implement the specification should work. The following portals are supported:

Vaadin also supports Google App Engine.

Vaadin @version@ supports the following desktop browsers:

Additionally, Vaadin supports the built-in browsers in the following mobile operating systems:

Vaadin SQL Container supports the following databases:

Vaadin on the Web