com.vaadin.flow.server.communication

Class WebComponentBootstrapHandler

java.lang.Object

com.vaadin.flow.server.SynchronizedRequestHandler

com.vaadin.flow.server.BootstrapHandler

com.vaadin.flow.server.communication.WebComponentBootstrapHandler

All Implemented Interfaces:

RequestHandler, Serializable

public class WebComponentBootstrapHandler
extends BootstrapHandler

Bootstrap handler for WebComponent requests.

Since:

2.0

Author:

Vaadin Ltd.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.vaadin.flow.server.BootstrapHandler

BootstrapHandler.BootstrapContext, BootstrapHandler.BootstrapPageBuilder, BootstrapHandler.BootstrapUriResolver, BootstrapHandler.PageBuilder

Field Summary

Fields inherited from class com.vaadin.flow.server.BootstrapHandler

POLYFILLS_JS

Constructor Summary

Constructors

Modifier	Constructor and Description
	WebComponentBootstrapHandler() Creates a new bootstrap handler with default page builder.
protected	WebComponentBootstrapHandler(BootstrapHandler.PageBuilder pageBuilder) Creates a new bootstrap handler, allowing to use custom page builder.

Method Summary

Modifier and Type	Method and Description
protected boolean	canHandleRequest(VaadinRequest request) Check whether a request may be handled by this handler.
protected BootstrapHandler.BootstrapContext	createAndInitUI(Class<? extends UI> uiClass, VaadinRequest request, VaadinResponse response, VaadinSession session)
protected BootstrapHandler.BootstrapContext	createBootstrapContext(VaadinRequest request, VaadinResponse response, UI ui, Function<VaadinRequest,String> callback) Creates a new instance of BootstrapHandler.BootstrapContext for given request, response and ui.
protected String	getRequestUrl(VaadinRequest request) Returns the request's base url to use in constructing and initialising ui.
protected String	getServiceUrl(VaadinRequest request) Returns the service url needed for initialising the UI.
boolean	synchronizedHandleRequest(VaadinSession session, VaadinRequest request, VaadinResponse response) Identical to SynchronizedRequestHandler.handleRequest(VaadinSession, VaadinRequest, VaadinResponse) except the VaadinSession is locked before this is called and unlocked after this has completed.
protected void	writeBootstrapPage(String contentType, VaadinResponse response, org.jsoup.nodes.Element head, String serviceUrl) Copies the Elements found in the given head elements into the head of the embedding website using JavaScript.

Methods inherited from class com.vaadin.flow.server.BootstrapHandler

getPageBuilder, getServiceUrl, getUIClass, readResource, resolvePageTitle, setupPushConnectionFactory

Methods inherited from class com.vaadin.flow.server.SynchronizedRequestHandler

handleRequest

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

WebComponentBootstrapHandler

public WebComponentBootstrapHandler()

Creates a new bootstrap handler with default page builder.

WebComponentBootstrapHandler

protected WebComponentBootstrapHandler(BootstrapHandler.PageBuilder pageBuilder)

Creates a new bootstrap handler, allowing to use custom page builder.

Parameters:

pageBuilder - Page builder to use.

Method Detail

canHandleRequest

protected boolean canHandleRequest(VaadinRequest request)

Description copied from class: SynchronizedRequestHandler

Check whether a request may be handled by this handler. This can be used as an optimization to avoid locking the session just to investigate some method property. The default implementation just returns true which means that all requests will be handled by calling SynchronizedRequestHandler.synchronizedHandleRequest(VaadinSession, VaadinRequest, VaadinResponse) with the session locked.

Overrides:

canHandleRequest in class SynchronizedRequestHandler

Parameters:

request - the request to handle

Returns:

true if the request handling should continue once the session has been locked; false if there's no need to lock the session since the request would still not be handled.

getRequestUrl

protected String getRequestUrl(VaadinRequest request)

Returns the request's base url to use in constructing and initialising ui.

Parameters:

request - Request to the url for.

Returns:

Request's url.

createAndInitUI

protected BootstrapHandler.BootstrapContext createAndInitUI(Class<? extends UI> uiClass,
                                                            VaadinRequest request,
                                                            VaadinResponse response,
                                                            VaadinSession session)

Overrides:

createAndInitUI in class BootstrapHandler

createBootstrapContext

protected BootstrapHandler.BootstrapContext createBootstrapContext(VaadinRequest request,
                                                                   VaadinResponse response,
                                                                   UI ui,
                                                                   Function<VaadinRequest,String> callback)

Description copied from class: BootstrapHandler

Creates a new instance of BootstrapHandler.BootstrapContext for given request, response and ui.

Overrides:

createBootstrapContext in class BootstrapHandler

Parameters:

request - the request object

response - the response object

ui - the UI object

Returns:

a new bootstrap context instance

synchronizedHandleRequest

public boolean synchronizedHandleRequest(VaadinSession session,
                                         VaadinRequest request,
                                         VaadinResponse response)
                                  throws IOException

Description copied from class: SynchronizedRequestHandler

Identical to SynchronizedRequestHandler.handleRequest(VaadinSession, VaadinRequest, VaadinResponse) except the VaadinSession is locked before this is called and unlocked after this has completed.

Overrides:

synchronizedHandleRequest in class BootstrapHandler

Parameters:

session - The session for the request

request - The request to handle

response - The response object to which a response can be written.

Returns:

true if a response has been written and no further request handlers should be called, otherwise false

Throws:

IOException - If an IO error occurred

See Also:

SynchronizedRequestHandler.handleRequest(VaadinSession, VaadinRequest, VaadinResponse)

writeBootstrapPage

protected void writeBootstrapPage(String contentType,
                                  VaadinResponse response,
                                  org.jsoup.nodes.Element head,
                                  String serviceUrl)
                           throws IOException

Copies the Elements found in the given head elements into the head of the embedding website using JavaScript. Drops <base> element.

Parameters:

contentType - Content type of the response.

response - VaadinResponse into which the script is written

head - head element of Vaadin Bootstrap page. The child elements are copied into the embedding page's head using JavaScript.

serviceUrl - base path to use for the head elements' URLs

Throws:

IOException - if writing fails

getServiceUrl

protected String getServiceUrl(VaadinRequest request)

Returns the service url needed for initialising the UI.

Parameters:

request - Request.

Returns:

Service url for the given request.