com.vaadin.flow.server.
Class HandlerHelper
- java.lang.Object
-
- com.vaadin.flow.server.HandlerHelper
-
All Implemented Interfaces:
public class HandlerHelper extends Object implements Serializable
Contains helper methods for
VaadinServlet
and generally for handlingVaadinRequests
.Since:
1.0
See Also:
-
-
Nested Class Summary
Nested Classes Modifier and Type Class and Description static class
HandlerHelper.RequestType
Framework internal enum for tracking the type of a request.
-
Method Summary
All Methods Modifier and Type Method and Description static Locale
findLocale(VaadinSession session, VaadinRequest request)
Helper to find the most most suitable Locale.
static String
getCancelingRelativePath(String pathToCancel)
Gets a relative path that cancels the provided path.
static boolean
isPathUnsafe(String path)
Checks if the given URL path contains the directory change instruction (dot-dot), taking into account possible double encoding in hexadecimal format, which can be injected maliciously.
static boolean
isRequestType(VaadinRequest request, HandlerHelper.RequestType requestType)
Returns whether the given request is of the given type.
static void
setResponseNoCacheHeaders(BiConsumer<String,String> headerSetter, BiConsumer<String,Long> longHeaderSetter)
Sets no cache headers to the specified response.
-
-
-
Method Detail
-
isRequestType
public static boolean isRequestType(VaadinRequest request, HandlerHelper.RequestType requestType)
Returns whether the given request is of the given type.
Parameters:
request
- the request to checkrequestType
- the type to check forReturns:
true
if the request is of the given type,false
otherwise
-
findLocale
public static Locale findLocale(VaadinSession session, VaadinRequest request)
Helper to find the most most suitable Locale. These potential sources are checked in order until a Locale is found:
- The passed component (or UI) if not null
UI.getCurrent()
if defined- The passed session if not null
VaadinSession.getCurrent()
if defined- The passed request if not null
VaadinService.getCurrentRequest()
if definedLocale.getDefault()
Parameters:
session
- the session that is searched for locale ornull
if not availablerequest
- the request that is searched for locale ornull
if not availableReturns:
the found locale
-
setResponseNoCacheHeaders
public static void setResponseNoCacheHeaders(BiConsumer<String,String> headerSetter, BiConsumer<String,Long> longHeaderSetter)
Sets no cache headers to the specified response.
Parameters:
headerSetter
- setter for string value headerslongHeaderSetter
- setter for long value headers
-
getCancelingRelativePath
public static String getCancelingRelativePath(String pathToCancel)
Gets a relative path that cancels the provided path. This essentially adds one .. for each part of the path to cancel.
Parameters:
pathToCancel
- the path that should be canceledReturns:
a relative path that cancels out the provided path segment
-
isPathUnsafe
public static boolean isPathUnsafe(String path)
Checks if the given URL path contains the directory change instruction (dot-dot), taking into account possible double encoding in hexadecimal format, which can be injected maliciously.
Parameters:
path
- the URL path to be verified.Returns:
true
, if the given path has a directory change instruction,false
otherwise.
-
-