Module org.eclipse.jetty.ee10.websocket.jakarta.common

Package org.eclipse.jetty.ee10.websocket.jakarta.common

Class JakartaWebSocketFrameHandlerFactory

java.lang.Object

org.eclipse.jetty.ee10.websocket.jakarta.common.JakartaWebSocketFrameHandlerFactory

public abstract class JakartaWebSocketFrameHandlerFactory
extends Object

Field Summary

Fields

Modifier and Type	Field	Description
protected final org.eclipse.jetty.websocket.core.WebSocketComponents	components
protected final JakartaWebSocketContainer	container
protected final org.eclipse.jetty.websocket.core.util.InvokerUtils.ParamIdentifier	paramIdentifier

Constructor Summary

Constructors

Constructor	Description
JakartaWebSocketFrameHandlerFactory(JakartaWebSocketContainer container, org.eclipse.jetty.websocket.core.util.InvokerUtils.ParamIdentifier paramIdentifier)

Method Summary

Modifier and Type	Method	Description
static MethodHandle	bindTemplateVariables(MethodHandle target, String[] namedVariables, Map<String,String> templateValues)	Bind the URI Template Variables to their provided values, converting to the type that the MethodHandle target has declared.
protected JakartaWebSocketFrameHandlerMetadata	createEndpointMetadata(jakarta.websocket.EndpointConfig endpointConfig)
static org.eclipse.jetty.websocket.core.messages.MessageSink	createMessageSink(JakartaWebSocketSession session, JakartaWebSocketMessageMetadata msgMetadata)
protected JakartaWebSocketFrameHandlerMetadata	discoverJakartaFrameHandlerMetadata(Class<?> endpointClass, JakartaWebSocketFrameHandlerMetadata metadata)
static MethodHandles.Lookup	getApplicationMethodHandleLookup(Class<?> lookupClass)	Gives a MethodHandles.Lookup instance to be used to find public methods in application classes.
abstract JakartaWebSocketFrameHandlerMetadata	getMetadata(Class<?> endpointClass, jakarta.websocket.EndpointConfig endpointConfig)
static MethodHandles.Lookup	getServerMethodHandleLookup()	Gives a MethodHandles.Lookup instance to be used to find methods in server classes.
abstract jakarta.websocket.EndpointConfig	newDefaultEndpointConfig(Class<?> endpointClass)
JakartaWebSocketFrameHandler	newJakartaWebSocketFrameHandler(Object endpointInstance, UpgradeRequest upgradeRequest)
static MethodHandle	wrapNonVoidReturnType(MethodHandle handle, JakartaWebSocketSession session)

Methods inherited from class java.lang.Object

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

Field Details

container

protected final JakartaWebSocketContainer container

paramIdentifier

protected final org.eclipse.jetty.websocket.core.util.InvokerUtils.ParamIdentifier paramIdentifier

components

protected final org.eclipse.jetty.websocket.core.WebSocketComponents components

Constructor Details

JakartaWebSocketFrameHandlerFactory

public JakartaWebSocketFrameHandlerFactory(JakartaWebSocketContainer container,
 org.eclipse.jetty.websocket.core.util.InvokerUtils.ParamIdentifier paramIdentifier)

Method Details

getMetadata

public abstract JakartaWebSocketFrameHandlerMetadata getMetadata(Class<?> endpointClass,
 jakarta.websocket.EndpointConfig endpointConfig)

newDefaultEndpointConfig

public abstract jakarta.websocket.EndpointConfig newDefaultEndpointConfig(Class<?> endpointClass)

newJakartaWebSocketFrameHandler

public JakartaWebSocketFrameHandler newJakartaWebSocketFrameHandler(Object endpointInstance,
 UpgradeRequest upgradeRequest)

createMessageSink

public static org.eclipse.jetty.websocket.core.messages.MessageSink createMessageSink(JakartaWebSocketSession session,
 JakartaWebSocketMessageMetadata msgMetadata)

wrapNonVoidReturnType

public static MethodHandle wrapNonVoidReturnType(MethodHandle handle,
 JakartaWebSocketSession session)

createEndpointMetadata

protected JakartaWebSocketFrameHandlerMetadata createEndpointMetadata(jakarta.websocket.EndpointConfig endpointConfig)

discoverJakartaFrameHandlerMetadata

protected JakartaWebSocketFrameHandlerMetadata discoverJakartaFrameHandlerMetadata(Class<?> endpointClass,
 JakartaWebSocketFrameHandlerMetadata metadata)

bindTemplateVariables

public static MethodHandle bindTemplateVariables(MethodHandle target,
 String[] namedVariables,
 Map<String,String> templateValues)

Bind the URI Template Variables to their provided values, converting to the type that the MethodHandle target has declared.

Conversion follows the JSR356 rules for @PathParam and only supports String, Primitive Types (and their Boxed version)

Parameters:

target - the target MethodHandle to work with. This is assumed to contain a MethodHandle.type() where all of the initial parameters are the same parameters as found in the provided namedVariables array.

namedVariables - the array of named variables. Can be null.

templateValues - the Map of template values (Key to Value), must have same number of entries that namedVariables has.

Returns:

a MethodHandle where all of the namedVariables in the target type have been statically assigned a converted value (and removed from the resulting MethodHandle.type(), or null if no target MethodHandle was provided.

getServerMethodHandleLookup

public static MethodHandles.Lookup getServerMethodHandleLookup()

Gives a MethodHandles.Lookup instance to be used to find methods in server classes. For lookups on application classes use getApplicationMethodHandleLookup(Class) instead.

This uses the caller sensitive MethodHandles.lookup(), this will allow MethodHandle access to server classes we need to use and will give access permissions to private methods as well.

Returns:

a lookup object to be used to find methods on server classes.

getApplicationMethodHandleLookup

public static MethodHandles.Lookup getApplicationMethodHandleLookup(Class<?> lookupClass)

Gives a MethodHandles.Lookup instance to be used to find public methods in application classes. For lookups on server classes use getServerMethodHandleLookup() instead.

This uses MethodHandles.publicLookup() as we only need access to public method of the lookupClass. To look up a method on the lookupClass, it must be public and the class must be accessible from this module, so if the lookupClass is in a JPMS module it must be exported so that the public methods of the lookupClass are accessible outside of the module.

The MethodHandles.Lookup.in(Class) allows us to search specifically in the endpoint Class to avoid any potential linkage errors which could occur if the same class is present in multiple web apps. Unlike using MethodHandles.publicLookup() using MethodHandles.lookup() with MethodHandles.Lookup.in(Class) will cause the lookup to lose its public access to the lookup class if they are in different modules.

MethodHandles.privateLookupIn(Class, MethodHandles.Lookup) is also unsuitable because it requires the caller module to read the target module, and the target module to open reflective access to the lookupClasses private methods. This is possible but requires extra configuration to provide private access which is not necessary for the purpose of accessing the public methods.

Parameters:

lookupClass - the desired lookup class for the new lookup object.

Returns:

a lookup object to be used to find methods on the lookupClass.