TsgcWSPClient_STOMP_ActiveMQProperties › Versions

Versions Property

Selects which STOMP wire versions (1.0, 1.1, 1.2) are offered to the ActiveMQ broker in the WebSocket subprotocol list and the CONNECT accept-version header.

Syntax

property Versions: TsgcWSSTOMPVersion_Options read FVersions write SetVersions;

Default Value

V1_0=True, V1_1=True, V1_2=True

Remarks

Each flag controls a single STOMP protocol level: V1_0 for STOMP 1.0, V1_1 for STOMP 1.1 and V1_2 for STOMP 1.2. Every enabled version is advertised in two places: (1) the WebSocket Sec-WebSocket-Protocol handshake header, mapped to the tokens v10.stomp, v11.stomp and v12.stomp respectively, and (2) the STOMP accept-version header of the CONNECT frame as a comma-separated list (e.g. 1.0,1.1,1.2). All three flags are enabled by default, which lets ActiveMQ pick the highest mutually supported version (modern ActiveMQ and Artemis answer with 1.2). Restrict the set to force a specific version — for instance disable V1_0 and V1_1 to mandate STOMP 1.2, which is required for the ack header semantics and the nack frame format used by newer ActiveMQ releases. At least one flag must remain True or the CONNECT frame will be rejected.

Example


STOMP.Versions.V1_0 := False;
STOMP.Versions.V1_1 := False;
STOMP.Versions.V1_2 := True;

Back to Properties