Class McpRequestStateProtectionContext

java.lang.Object

com.soklet.McpRequestStateProtectionContext

@ThreadSafe
public final class McpRequestStateProtectionContext
extends Object

Immutable framework-supplied context for an application request-state protector.

Associated-data bytes are the exact versioned canonical binding that Soklet can independently reconstruct for the original operation and its retry. A custom protector must authenticate these bytes exactly. Neither they nor the other values in this context are suitable for logs or metric dimensions.

Author:

Mark Allen

Method Summary

Modifier and Type	Method	Description
boolean	equals(@Nullable Object other)	Compares the exact canonical protection inputs, including associated-data bytes by content.
static @NonNull McpRequestStateProtectionContext	fromComponents(@NonNull String endpointPath, @NonNull McpProtocolVersion protocolVersion, @NonNull String jsonRpcMethod, byte @NonNull [] associatedData)	Creates a protection context from its components.
byte @NonNull []	getAssociatedData()
@NonNull String	getEndpointPath()
@NonNull String	getJsonRpcMethod()
@NonNull McpProtocolVersion	getProtocolVersion()
int	hashCode()

Methods inherited from class Object

getClass, notify, notifyAll, toString, wait, wait, wait

Method Details

fromComponents

public static @NonNull McpRequestStateProtectionContext fromComponents(@NonNull String endpointPath,
 @NonNull McpProtocolVersion protocolVersion,
 @NonNull String jsonRpcMethod,
 byte @NonNull [] associatedData)

Creates a protection context from its components. This factory is useful for exercising application-provided request-state protectors in isolation; Soklet constructs the authoritative contexts used for live requests.

Parameters:

endpointPath - normalized endpoint path

protocolVersion - validated MCP protocol version

jsonRpcMethod - MCP JSON-RPC method

associatedData - canonical associated data, defensively copied

Returns:

immutable request-state protection context

Throws:

NullPointerException - if any argument is null

getEndpointPath

public @NonNull String getEndpointPath()

Returns:

normalized endpoint path

getProtocolVersion

public @NonNull McpProtocolVersion getProtocolVersion()

Returns:

validated MCP protocol version supplied on this request

getJsonRpcMethod

public @NonNull String getJsonRpcMethod()

Returns:

MCP JSON-RPC method

getAssociatedData

public byte @NonNull [] getAssociatedData()

Returns:

defensive copy of the canonical associated data

equals

public boolean equals(@Nullable Object other)

Compares the exact canonical protection inputs, including associated-data bytes by content.

Overrides:

equals in class Object

Returns:

whether every protection-context property is structurally equal

hashCode

public int hashCode()

Overrides:

hashCode in class Object

Returns:

structural protection-context hash code