123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633 |
- <!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" />
- <title>Vaadin Framework @version@</title>
- <link rel="stylesheet" type="text/css" href="css/styles.css" />
-
- <!--[if lte IE 6]>
- <link rel="stylesheet" type="text/css" href="css/ie.css" />
- <![endif]-->
- <style type="text/css">
- .nested-list ol {
- counter-reset: item
- }
-
- .nested-list li {
- display: block
- }
-
- .nested-list li:before {
- content: counters(item, ".") ". ";
- counter-increment: item
- }
- </style>
- </head>
-
- <body>
- <div id="header">
- <h1>Vaadin – thinking of U and I</h1>
- <div id="version">
- <strong>Version @version@</strong>
- </div>
- </div>
- <!-- /header -->
-
- <div id="content">
- <p>Version @version@ built on @builddate@.</p>
-
- <h2 id="tableofcontents">Release Notes for Vaadin Framework
- @version@</h2>
- <ul>
- <li><a href="#overview">Overview of Vaadin
- @version@ Release</a></li>
- <li><a href="#changelog">Change log for Vaadin
- @version@</a></li>
- <li><a href="#enhancements">Enhancements in Vaadin
- @version-minor@</a></li>
- <li><a href="#incompatible">Incompatible changes in
- @version-minor@</a></li>
- <li><a href="#behavioraltering">Behavior altering
- changes in @version-minor@</a></li>
- <li><a href="#knownissues">Known issues in
- @version-minor@</a></li>
- <li><a href="#limitations">Limitations in
- @version-minor@</a></li>
- <li><a href="#vaadin">Vaadin Installation</a></li>
- <li><a href="#package">Package Contents</a></li>
- <li><a href="#migrating">Migrating from Vaadin 6 to
- Vaadin 7</a></li>
- <li><a href="#dependencies">Vaadin @version@
- dependencies</a></li>
- <li><a href="#upgrading">Upgrading to Vaadin
- @version-minor@</a></li>
- <li><a href="#supportedversions">Supported
- technologies</a></li>
- <li><a href="#authors">Authors</a></li>
- <li><a href="#vaadinontheweb">Vaadin on the Web</a></li>
- </ul>
-
- <h2 id="overview">Overview of Vaadin @version@ Release</h2>
-
- <p>
- Vaadin @version@ is a minor release that includes a
- number of new features and bug fixes, as listed in the <a
- href="#enhancements">list of enhancements</a> and <a
- href="#changelog">change log</a> below.
- </p>
-
- <!-- ================================================================ -->
- <h3 id="changelog">Change log for Vaadin @version@</h3>
-
- <p>This release includes the following closed issues:</p>
-
- <table>
- @release-notes-tickets@
- <tr><td> </td><td></td></tr>
- <tr><td class="fv"><span class="vote">Vote</span></td><td colspan="2" class="pad">Enhancements <a href=" https://vaadin.com/support">Vaadin support</a> users have voted for</td></tr>
- <tr><td class="bfp"><span class="bfp">Priority</span></td><td colspan="2" class="pad">Defects <a href=" https://vaadin.com/support">Vaadin support</a> users have prioritized</td></tr>
- </table>
- <br/>
- <p>
- You can also view the <a
- href="http://dev.vaadin.com/query?status=closed&resolution=fixed&milestone=Vaadin+@version@&order=id">list
- of the closed issues</a> at the Vaadin developer's site.
- </p>
-
- <h2 id="enhancements">Enhancements in Vaadin
- @version-minor@</h2>
-
- <p>The @version-minor@ includes many major and minor
- enhancements. Below is a list of the most notable changes:</p>
-
- <ul>
- <li>Internet Explorer 11 support</li>
- <li>Window Phone 8.1 support</li>
- <li>Long polling support through Atmosphere 2</li>
- <li>Font icon support</li>
- <li>Tomcat 8 support</li>
- <li>Wildfly 8 support</li>
- <li>Websocket support for Tomcat 8, Glassfish 4, Jetty 9.1, Wildfly 8</li>
- <li>TestBench 4 support</li>
- <li>GWT 2.6 compatibility</li>
- <li>Widget set size reduction</li>
- <li>Widget set compilation speed improvement by collapsing all permutations</li>
- <li>New built-in converters: StringToBigDecimal, StringToLong</li>
- <li>New built-in support for Date in communication</li>
- <li>WAI-ARIA improvements: Window, Notification, TabSheet</li>
- <li>Sass compiler is a separate project</li>
- <li>Support for @OnStateChange for easier state handling</li>
- <li>Reload events for UIs with @PreserveOnRefresh</li>
- <li>Responsive layouts</li>
- </ul>
-
- <p>
- For enchancements introduced in Vaadin 7, see the <a
- href="http://vaadin.com/download/release/7.0/7.0.0/release-notes.html">Release
- Notes for Vaadin 7.0.0</a>.
- </p>
-
- <h3 id="incompatible">Incompatible changes</h3>
- <ul>
- <li>It is assumed that the UI will no longer be used after Page.setLocation
- is called. Do not use this to start downloads.</li>
- <li>The portlet requests class VaadinGateinRequest is now called
- VaadinGateInRequest</li>
- <li>The JSON library has been changed from org.json to the json implementation
- from the Android SDK. They are 99% compatible.</li>
- <li>StringToNumberConverter has been removed in favor of more specific
- converters such as StringToBigDecimalConverter.</li>
- <li>There is no longer support for "multiple variable bursts"
- in the UIDL communication.</li>
- </ul>
- <h3 id="behavioraltering">Behavior altering changes</h3>
- <ul>
- <li>Default push fallback is now long-polling</li>
- <li>VerticalLayout and HorizontalLayout.replaceComponent now applies old
- component parameters (e.g. expand ratio) to the new component. This is
- now consistent between all layouts in the framework, where relevant
- properties are applied to the replacement.</li>
- <li>All GWT permutations are collapsed when using DefaultWidgetSet. To use
- separate permutations, inherit Vaadin instead of DefaultWidgetSet and
- add the needed entry-point.</li>
- <li>Requests to "/context;jsessionid=xyz" are redirected to
- "/context/;jsessionid=xyz" which is against specifications but based
- on how jsessionid is used</li>
- <li>Adding a ValueChangeListener to a component will make it immediate</li>
- <li>ComboBox is immediate by default</li>
- </ul>
-
- <h3 id="knownissues">Known issues</h3>
- <ul>
- <li>Reconnecting a dropped push connection sometimes fails when using
- Firefox and streaming or long polling.
- (<a href="http://dev.vaadin.com/ticket/13578">#13578</a>)
- </li>
- <li>Drag'n'drop in a Table doesn't work on touch devices running
- Internet Explorer (Windows Phone, Surface)
- (<a href="http://dev.vaadin.com/ticket/13737">#13737</a>)
- </li>
- </ul>
-
- <h3 id="limitations">Limitations</h3>
- <ul>
- <li>It is currently not possible to specify <tt>font-size</tt>
- as <tt>em</tt> or <tt>%</tt>, or layout component sizes
- with <tt>em</tt> (<a
- href="http://dev.vaadin.com/ticket/10634">#10634</a>)
- </li>
- <li>Push is currently not supported in portals (See <a
- href="http://dev.vaadin.com/ticket/11493">#11493</a>)
- </li>
- <li>HTTP session can not be invalidated while using
- push over websockets on Tomcat 7 (<a href="http://dev.vaadin.com/ticket/11721">#11721</a>)
- </li>
- <li>Cookies are not available while using websockets (<a
- href="http://dev.vaadin.com/ticket/11808">#11808</a>)
- </li>
- <li>Not all proxies are compatible with websockets or streaming.
- Use long polling to avoid these problems.</li>
- </ul>
-
- <h2 id="vaadin">Vaadin Installation</h2>
-
- <p>
- <b>Vaadin</b> is a Java framework for building modern web
- applications that look great, perform well and make you and
- your users happy. <b>Vaadin</b> is available under the
- Apache License, Version 2.0 (see the
- <tt>license.html</tt>
- in the Vaadin ZIP or JAR package).
- </p>
-
- <p>
- The easiest ways to install <b>Vaadin</b> are:
- </p>
-
- <ul>
- <li>If using Maven, define it as a dependency or use
- any of the available archetypes (only <tt>vaadin-application</tt>
- is available for Vaadin 7 at the time of this release)
- to create a new project
- </li>
-
- <li>If using Eclipse, use the Vaadin Plugin for
- Eclipse, which automatically downloads the Vaadin
- libraries.
- </li>
- </ul>
-
- <p>
- It is also available as a ZIP package downloadable from <a
- href="http://vaadin.com/download">Vaadin Download
- page</a>.
- </p>
-
- <h3 id="package">Package Contents</h3>
-
- <p>Inside the ZIP installation package you will find:</p>
-
- <ul>
- <li>Separate server-side (<tt>vaadin-server</tt>) and
- client-side (<tt>vaadin-client</tt>, <tt>vaadin-client-compiler</tt>)
- development libraries
- </li>
- <li>Precompiled widget set (<tt>vaadin-client-compiled</tt>)
- for server-side development
- </li>
- <li>Shared library (<tt>vaadin-shared</tt>) for both
- server- and client-side libraries
- </li>
- <li>Built-in themes (<tt>vaadin-themes</tt>)
- </li>
- <li>Dependency libraries provided under the <tt>lib/</tt>
- folder
- </li>
- </ul>
-
- <p>
- See the
- <tt>README.TXT</tt>
- in the installation package for detailed information about
- the package contents. <a href="http://vaadin.com/book">Book
- of Vaadin</a> (for Vaadin 7) gives more detailed
- instructions.
- </p>
-
- <p>
- For server-side development, copy the
- <tt>vaadin-server</tt>
- ,
- <tt>vaadin-client-compiled</tt>
- ,
- <tt>vaadin-shared</tt>
- , and
- <tt>vaadin-themes</tt>
- from the main folder and the dependencies from the
- <tt>lib</tt>
- folder to the
- <tt>WEB-INF/lib</tt>
- folder of your Vaadin project. (The
- <tt>vaadin-client-compiled</tt>
- 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.)
- </p>
-
- <h4 id="package.updates">Updates to the Packaging</h4>
- <p>
- 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.
- </p>
-
- <p>
- For pure client-side development, you only need the
- <tt>vaadin-client</tt>
- and
- <tt>vaadin-client-compiler</tt>
- JARs, which should be put to a non-deployed project library
- folder, such as
- <tt>lib</tt>
- . 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.
- </p>
-
- <h2 id="migrating">Migrating from Vaadin 6</h2>
-
- <p>
- 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 <b>UI</b>
- or <b>UI.LegacyApplication</b> instead of <b>Application</b>.
- A detailed list of migration changes are given in the <a
- href="https://vaadin.com/wiki/-/wiki/Main/Migrating+from+Vaadin+6+to+Vaadin+7">Vaadin
- 7 Migration Guide</a>.
- </p>
-
- <p>Any custom client-side widgets need to be ported to use
- the new client-server communication API, or the Vaadin 6
- compatibility API.</p>
-
- <p>
- Vaadin 6 add-ons (ones that contain widgets) do not work in
- Vaadin 7 - please check the add-ons in <a
- href="http://vaadin.com/directory/">Vaadin Directory</a>
- for Vaadin 7 support.
- </p>
-
- <h2 id="dependencies">Vaadin @version@ Dependencies</h2>
-
- <p>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.</p>
-
- <p>
- The Vaadin ZIP installation package includes the
- dependencies in the
- <tt>lib</tt>
- subfolder. These need to be copied to the
- <tt>WEB-INF/lib</tt>
- folder of the web application that uses Vaadin.
- </p>
-
- <p>
- The dependencies are listed in the <a href="license.html">Licensing
- description</a>. Some are explicit dependencies packaged and
- distributed as separate JARs, while some are included inside
- other libraries.
- </p>
-
- <h3>Bean Validation</h3>
-
- <p>
- 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
- <tt>WEB-INF/lib</tt>
- directory of the web application that uses validation.
- </p>
-
- <h2 id="upgrading">Upgrading from Vaadin 7.1 to Vaadin @version-minor@</h2>
-
- <p>When upgrading from an earlier Vaadin version, you must:
- </p>
-
- <ul>
- <li>Recompile your classes using the new Vaadin
- version. Binary compatibility is only guaranteed for
- maintenance releases of Vaadin.</li>
-
- <li>Unless using the precompiled widget set, recompile
- your widget set using the new Vaadin version.</li>
- </ul>
-
- <p>Remember also to refresh the project in your IDE to
- ensure that the new version of everything is in use.</p>
-
- <p>
- By using the "
- <tt>?debug</tt>
- " URL parameter, you can verify that the version of the
- servlet, the theme, and the widget set all match.
- </p>
-
- <p>
- <b>Eclipse</b> 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).
- </p>
-
- <p>
- <b>Maven</b> users should update the Vaadin dependency
- version in the
- <tt>pom.xml</tt>
- unless it is defined as
- <tt>LATEST</tt>
- . You must also ensure that the GWT dependency uses the
- correct version and recompile your project and your widget
- set.
- </p>
-
- <p>
- <b>Liferay and other portal</b> users must install the
- Vaadin libraries in
- <t>ROOT/WEB-INF/lib/</b> in the portal (and remove a
- possibly obsolete older <tt>vaadin.jar</tt>). Additionally,
- the contents of the <tt>vaadin-client-compiled</tt> and <tt>vaadin-themes</tt>
- must be extracted to the <tt>ROOT/html/VAADIN</tt> directory
- in the Liferay installation. If your portal uses custom
- widgets, you can use <a
- href="http://vaadin.com/directory#addon/liferay-control-panel-plugin-for-vaadin:vaadin">
- Liferay Control Panel for Vaadin</a> for easy widget set compilation.</t>
- </p>
-
- <h2 id="gae">
- Notes and Limitations for Google App Engine
- </h4>
- </h2>
-
- <p>The following instructions and limitations apply when you
- run a Vaadin application under the Google App Engine.</p>
-
- <ul>
- <li>
- <p>
- Applications must use <b>GAEVaadinServlet</b>
- instead of <b>VaadinServlet</b> in
- <tt>web.xml</tt>
- .
- </p>
- </li>
-
- <li>
- <p>
- Session support must be enabled in
- <tt>appengine-web.xml</tt>
- :
- </p> <pre> <sessions-enabled>true</sessions-enabled></pre>
- </li>
-
- <li>
- <p>Avoid using the session for storage, usual App
- Engine limitations apply (no synchronization, that
- is, unreliable).</p>
- </li>
-
- <li>
- <p>
- Vaadin uses memcache for mutex, the key is of the
- form
- <tt>_vmutex<sessionid></tt>
- .
- </p>
- </li>
-
- <li>
- <p>
- The Vaadin <b>VaadinSession</b> class is serialized
- separately into memcache and datastore; the memcache
- key is
- <tt>_vac<sessionid></tt>
- and the datastore entity kind is
- <tt>_vac</tt>
- with identifiers of the type
- <tt>_vac<sessionid></tt>
- .
- </p>
- </li>
-
- <li>
- <p>
- DO NOT update application state when serving an <b>ConnectorResource</b>
- (such as <b>ClassResource</b>.<i>getStream()</i>).
- </p>
- </li>
-
- <li>
- <p>The application remains locked during uploads - a
- progress bar is not possible</p>
- </li>
- </ul>
-
- <p>
- For other known problems, see open tickets at developer site
- <a href="http://dev.vaadin.com/">dev.vaadin.com</a>.
- </p>
-
- <h2 id="supportedversions">Supported Technologies</h2>
-
- <p>
- Vaadin 7 is compatible with <b>Java 6</b> and newer. Vaadin
- 7 is especially supported on the following <b>operating
- systems</b>:
- </p>
-
- <ul>
- <li>Windows</li>
- <li>Linux</li>
- <li>Mac OS X</li>
- </ul>
-
- <p>
- Vaadin 7 requires <b>Java Servlet API 2.4</b> but also
- supports later versions and should work with any Java
- application server that conforms to the standard. The
- following <b>application servers</b> are supported:
- </p>
-
- <ul>
- <li>Apache Tomcat 5-8</li>
- <li>Apache TomEE 1</li>
- <li>Oracle WebLogic Server 10.3-12</li>
- <li>IBM WebSphere Application Server 7-8</li>
- <li>JBoss Application Server 4-7</li>
- <li>Wildfly 8</li>
- <li>Jetty 5-9</li>
- <li>Glassfish 2-4</li>
- </ul>
-
- <p>
- Vaadin 7 supports the JSR-286 Portlet specification and all
- portals that implement the specification should work. The
- following <b>portals</b> are supported:
- </p>
-
- <ul>
- <li>Liferay Portal 5.2-6</li>
- <li>GateIn Portal 3</li>
- <li>eXo Platform 3</li>
- <li>IBM WebSphere Portal 8</li>
- </ul>
-
- <p>
- Vaadin also supports <b>Google App Engine</b>.
- </p>
-
- <p>
- Vaadin @version@ supports the following <b>desktop browsers</b>:
- </p>
-
- <ul>
- <li>Mozilla Firefox 18-29</li>
- <li>Mozilla Firefox 17 ESR, 24 ESR</li>
- <li>Internet Explorer 8-11</li>
- <li>Safari 6-7</li>
- <li>Opera 12, 16-20</li>
- <li>Google Chrome 23-34</li>
- </ul>
-
- <p>
- Additionally, Vaadin supports the built-in browsers in the
- following <b>mobile operating systems</b>:
- </p>
-
- <ul>
- <li>iOS 5-7</li>
- <li>Android 2.3-4</li>
- <li>Windows Phone 8</li>
- </ul>
-
- <p>Vaadin SQL Container supports the following databases:</p>
- <ul>
- <li>HSQLDB</li>
- <li>MySQL</li>
- <li>MSSQL</li>
- <li>Oracle</li>
- <li>PostgreSQL</li>
- </ul>
-
- <h2 id="authors">Authors</h2>
- Vaadin @version@ was created by:
- <ul>
- @release-notes-authors@
- </ul>
- <h2 id="vaadinontheweb">Vaadin on the Web</h2>
-
- <ul>
- <li><a href="http://vaadin.com">vaadin.com - The
- developer portal containing everything you need to
- know about Vaadin</a></li>
- <li><a href="http://vaadin.com/demo">vaadin.com/demo
- - A collection of demos for Vaadin</a></li>
- <li><a href="http://vaadin.com/learn">vaadin.com/learn
- - Getting started with Vaadin</a></li>
- <li><a href="http://vaadin.com/forum">vaadin.com/forum
- - Forums for Vaadin related discussions</a></li>
- <li><a href="http://vaadin.com/book">vaadin.com/book
- - Book of Vaadin - everything you need to know about
- Vaadin</a></li>
- <li><a href="http://vaadin.com/api">vaadin.com/api
- - Online javadocs</a></li>
- <li><a href="http://vaadin.com/directory">vaadin.com/directory
- - Add-ons for Vaadin</a></li>
-
- <li><a href="http://vaadin.com/pro-tools">vaadin.com/pro-tools
- - Commercial tools for Vaadin development</a></li>
- <li><a href="http://vaadin.com/support">vaadin.com/support
- - Commercial support for Vaadin development </a></li>
- <li><a href="http://vaadin.com/services">vaadin.com/services
- - Expert services for Vaadin</a></li>
- <li><a href="http://vaadin.com/company">vaadin.com/company
- - Information about the company behind Vaadin</a></li>
-
- <li><a href="http://dev.vaadin.com">dev.vaadin.com
- - Bug tracker</a></li>
-
- <li><a
- href="http://dev.vaadin.com/wiki/Vaadin/Development/StartingVaadin7Development">How
- to get the source code of Vaadin</a></li>
- </ul>
-
- </div>
- <!-- /content-->
-
- <div id="footer">
- <span class="slogan"><strong>vaadin <em>}></em>
- </strong> thinking of U and I<span> <a href="#top">↑ Back
- to top</a>
- </div>
- <!-- /footer -->
- </body>
- </html>
-
- <!-- Keep this comment at the end of the file
- Local variables:
- mode: xml
- sgml-omittag:nil
- sgml-shorttag:nil
- sgml-namecase-general:nil
- sgml-general-insert-case:lower
- sgml-minimize-attributes:nil
- sgml-always-quote-attributes:t
- sgml-indent-step:2
- sgml-indent-data:t
- sgml-parent-document:nil
- sgml-exposed-tags:nil
- sgml-local-catalogs:("/etc/sgml/catalog" "/usr/share/xemacs21/xemacs-packages/etc/psgml-dtds/CATALOG")
- sgml-local-ecat-files:("ECAT" "~/sgml/ECAT" "/usr/share/sgml/ECAT" "/usr/local/share/sgml/ECAT" "/usr/local/lib/sgml/ECAT")
- End:
- -->
|