Differences Between Vaadin platform and V8 Applications
Most things you have previously done in the UI
class, can be achieved in alternative, better ways. These alternatives are covered in this documentation, but if some information is missing, please create an issue so we may add the necessary information.
In Vaadin 8 and 7, the UI
referenced a <div>
element which was a child of the <body>
in the DOM. In Vaadin platform, the is instead directly connected to to the <body>
element.
The API in the UI
class in Vaadin Flow has gone through a clean-up and some API that is not meant for application developers to access has been moved to internal classes. For using API that is still in UI
, the same UI.getCurrent()
call can still be used to obtain a reference to the UI for the currently active request.
While migrating, you still might want to create your own UI
, and you can see an example for that in the next topic.
The Servlet Definition is Optional
Similarly as the , the servlet definition is optional in Vaadin Flow. And the reason is also the same, the new Routing API, which is introduced in the next chapter. By default the servlet is automatically mapped to the root context path. You can of course still configure the servlet yourself, and it happens the same way as previously:
Java
In Vaadin 8, the application bootstrap happened in two phases. The initial page response only contained code to obtain more data related to the browser, data which was not available in the initial request. Based on this, the correct UI would be created. This was a good option back then since mobile devices capabilities required completely own client engine and UI to deliver the best possible end user experience.
This is not necessary anymore, and in Vaadin Flow the UI content is delivered on the first response and the application is bootstrapped without further network activity. This means that UIProvider
has become obsolete.
Modifying the Bootstrap Page
BoostrapListener
is still there and can be registered using a VaadinServiceInitListener
, as shown by .
As a custom UI
class is no longer needed, you can configure the used for your app in the main layout of your application. Please see the Server Push Configuration tutorial for more info.
Loading Indicator Configuration
The default loading indicator is the same as in Vaadin 8 Valo Theme. If you want to customize it or disable it, you should see the loading indicator documentation.
Some of the Java code in Vaadin Flow is directly inherited from Vaadin 8. Even in these cases, the package names are however changed. This is because we want to make it possible to use V8 components and views without classpath conflicts inside Vaadin Flow using the multiplatform tool. Thus the package names for Vaadin platform contain flow that separates them from the V8 packages.