Class ChunkedSessionRegistry

java.lang.Object

eu.cloudnetservice.driver.network.chunk.defaults.ChunkedSessionRegistry

@Singleton
public final class ChunkedSessionRegistry
extends Object

A registry for chunked transfer sessions that are currently running and active.

Since:

4.0

Field Summary

Fields

Modifier and Type	Field	Description
private final Map<UUID,ChunkedPacketHandler>	runningSessions

Constructor Summary

Constructors

Constructor	Description
ChunkedSessionRegistry()

Method Summary

Modifier and Type	Method	Description
void	completeSession(@NonNull UUID sessionId)	Marks the given session as completed by removing it from the lookup registry.
@NonNull ChunkedPacketHandler	getOrCreateSession(@NonNull ChunkSessionInformation sessionInformation, @NonNull Function<ChunkSessionInformation,ChunkedPacketHandler> sessionFactory)	Gets the currently active session or creates a new session using the given instance factory.
void	registerSession(@NonNull UUID sessionId, @NonNull ChunkedPacketHandler handler)	Registers the given handler for the given session id, unless another handler is already registered.

Methods inherited from class java.lang.Object

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

Field Details

runningSessions

private final Map<UUID,ChunkedPacketHandler> runningSessions

Constructor Details

ChunkedSessionRegistry

public ChunkedSessionRegistry()

Method Details

completeSession

public void completeSession(@NonNull
 @NonNull UUID sessionId)

Marks the given session as completed by removing it from the lookup registry. Further tries to access a session with the given unique id will create a new session instead.

Parameters:

sessionId - the id of the session to mark as completed.

Throws:

NullPointerException - if the given session id is null.

registerSession

public void registerSession(@NonNull
 @NonNull UUID sessionId,
 @NonNull
 @NonNull ChunkedPacketHandler handler)

Registers the given handler for the given session id, unless another handler is already registered.

Parameters:

sessionId - the session id to register the handler for.

handler - the handler to register for the session id.

Throws:

NullPointerException - if the given session id or handler is null.

getOrCreateSession

@NonNull
public @NonNull ChunkedPacketHandler getOrCreateSession(@NonNull
 @NonNull ChunkSessionInformation sessionInformation,
 @NonNull
 @NonNull Function<ChunkSessionInformation,ChunkedPacketHandler> sessionFactory)

Gets the currently active session or creates a new session using the given instance factory. Sessions are unique by their session id. Concurrently accessing this method to create a new session will return the same session instance to all callers.

Parameters:

sessionInformation - the information of the session to get or create the session of.

sessionFactory - the factory to call if no session is currently associated with the session id.

Returns:

the existing registered or newly created transfer session for the provided session id.

Throws:

NullPointerException - if the given session information or session factory is null.