Modifier and Type	Class and Description
public static interface	ServerSessionStateController.ServerSessionStateChanges The object containing server session changes collected from the latest query execution.
public static class	ServerSessionStateController.SessionStateChange A single server session change record.
public static interface	ServerSessionStateController.SessionStateChangesListener

Field Summary

Modifier and Type	Field and Description
public static final int	SESSION_TRACK_GTIDS
public static final int	SESSION_TRACK_SCHEMA
public static final int	SESSION_TRACK_STATE_CHANGE
public static final int	SESSION_TRACK_SYSTEM_VARIABLES
public static final int	SESSION_TRACK_TRANSACTION_CHARACTERISTICS
public static final int	SESSION_TRACK_TRANSACTION_STATE

Method Summary

Modifier and Type	Method and Description
public default void	addSessionStateChangesListener(ServerSessionStateController.SessionStateChangesListener `SessionStateChangesListener` object. l) Add the `SessionStateChangesListener` that will process `ServerSessionStateChanges` on it's arrival.
public default ServerSessionStateController.ServerSessionStateChanges	Returns: `ServerSessionStateChanges` object. getSessionStateChanges() Get the object containing server session changes collected from the latest query execution.
public default void	removeSessionStateChangesListener(ServerSessionStateController.SessionStateChangesListener `SessionStateChangesListener` object. l) Remove `SessionStateChangesListener`.
public default void	setSessionStateChanges(ServerSessionStateController.ServerSessionStateChanges `ServerSessionStateChanges` object. changes) Set the object containing server session changes collected from the latest query execution.

Field Detail

SESSION_TRACK_GTIDS	back to summary
public static final int SESSION_TRACK_GTIDS

SESSION_TRACK_SCHEMA	back to summary
public static final int SESSION_TRACK_SCHEMA

SESSION_TRACK_STATE_CHANGE	back to summary
public static final int SESSION_TRACK_STATE_CHANGE

SESSION_TRACK_SYSTEM_VARIABLES	back to summary
public static final int SESSION_TRACK_SYSTEM_VARIABLES

SESSION_TRACK_TRANSACTION_CHARACTERISTICS	back to summary
public static final int SESSION_TRACK_TRANSACTION_CHARACTERISTICS

SESSION_TRACK_TRANSACTION_STATE	back to summary
public static final int SESSION_TRACK_TRANSACTION_STATE

Method Detail

addSessionStateChangesListener back to summary

addSessionStateChangesListener	back to summary
public default void addSessionStateChangesListener(ServerSessionStateController.SessionStateChangesListener l) Add the `SessionStateChangesListener` that will process `ServerSessionStateChanges` on it's arrival. Parameters l:ServerSessionStateController.SessionStateChangesListener `SessionStateChangesListener` object.

public default void addSessionStateChangesListener(ServerSessionStateController.SessionStateChangesListener l)

Add the SessionStateChangesListener that will process ServerSessionStateChanges on it's arrival.

Parameters

l:ServerSessionStateController.SessionStateChangesListener: SessionStateChangesListener object.

getSessionStateChanges back to summary

getSessionStateChanges	back to summary
public default ServerSessionStateController.ServerSessionStateChanges getSessionStateChanges() Get the object containing server session changes collected from the latest query execution. Please note that the driver could issue some queries internally. With that there is no guarantee that all session changes are reflected in the `ServerSessionStateChanges` object after the recent user's query. If this is an issue, a `SessionStateChangesListener` can be added via `addSessionStateChangesListener(SessionStateChangesListener)` to catch all session changes. Returns:ServerSessionStateController.ServerSessionStateChanges `ServerSessionStateChanges` object.

public default ServerSessionStateController.ServerSessionStateChanges getSessionStateChanges()

Get the object containing server session changes collected from the latest query execution.

Please note that the driver could issue some queries internally. With that there is no guarantee that all session changes are reflected in the ServerSessionStateChanges object after the recent user's query. If this is an issue, a SessionStateChangesListener can be added via addSessionStateChangesListener(SessionStateChangesListener) to catch all session changes.

Returns:ServerSessionStateController.ServerSessionStateChanges: ServerSessionStateChanges object.

removeSessionStateChangesListener back to summary

removeSessionStateChangesListener	back to summary
public default void removeSessionStateChangesListener(ServerSessionStateController.SessionStateChangesListener l) Remove `SessionStateChangesListener`. Parameters l:ServerSessionStateController.SessionStateChangesListener `SessionStateChangesListener` object.

public default void removeSessionStateChangesListener(ServerSessionStateController.SessionStateChangesListener l)

Remove SessionStateChangesListener.

Parameters

l:ServerSessionStateController.SessionStateChangesListener: SessionStateChangesListener object.

setSessionStateChanges back to summary

setSessionStateChanges	back to summary
public default void setSessionStateChanges(ServerSessionStateController.ServerSessionStateChanges changes) Set the object containing server session changes collected from the latest query execution. Used internally. Parameters changes:ServerSessionStateController.ServerSessionStateChanges `ServerSessionStateChanges` object.

public default void setSessionStateChanges(ServerSessionStateController.ServerSessionStateChanges changes)

Set the object containing server session changes collected from the latest query execution. Used internally.

Parameters

changes:ServerSessionStateController.ServerSessionStateChanges: ServerSessionStateChanges object.

com.mysql.cj.protocol back to summary

public Interface ServerSessionStateController.ServerSessionStateChanges

Known Direct Implementers: com.mysql.cj.protocol.a.NativeServerSessionStateController.NativeServerSessionStateChanges

The object containing server session changes collected from the latest query execution.

Driver is getting these changes when connection property trackSessionState=true and server supports session tracking.

Method Summary

Modifier and Type	Method and Description
public List<ServerSessionStateController.SessionStateChange>	getSessionStateChangesList()

Method Detail

getSessionStateChangesList	back to summary
public List<ServerSessionStateController.SessionStateChange> getSessionStateChangesList()

com.mysql.cj.protocol back to summary

public Class ServerSessionStateController.SessionStateChange

Class Inheritance

extends Object

java.lang.Object
com.mysql.cj.protocol.ServerSessionStateController.SessionStateChange

A single server session change record.

The server messages about session changes are parsed according to their known types:

SESSION_TRACK_SYSTEM_VARIABLES - two values, the system variable name and it's new value;
SESSION_TRACK_SCHEMA - single value, the new schema name;
SESSION_TRACK_STATE_CHANGE - single value, "1" or "0";
SESSION_TRACK_GTIDS - single value, list of GTIDs as reported by server;
SESSION_TRACK_TRANSACTION_CHARACTERISTICS - single value, transaction characteristics statement;
SESSION_TRACK_TRANSACTION_STATE - single value, transaction state record.

For the unknown change type the raw payload is written into the single value.

See more details in the server documentation.

Field Summary

Modifier and Type	Field and Description
private int	type
private List<String>	values

Constructor Summary

Access	Constructor and Description
public	SessionStateChange(int type)

Method Summary

Modifier and Type	Method and Description
public ServerSessionStateController.SessionStateChange	addValue(String value)
public int	getType()
public List<String>	getValues()

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

type	back to summary
private int type

values	back to summary
private List<String> values

Constructor Detail

SessionStateChange	back to summary
public SessionStateChange(int type)

Method Detail

addValue	back to summary
public ServerSessionStateController.SessionStateChange addValue(String value)

getType	back to summary
public int getType()

getValues	back to summary
public List<String> getValues()

public Interface ServerSessionStateController

Nested and Inner Type Summary

Field Summary

Method Summary

Field Detail

Method Detail

public Interface ServerSessionStateController.ServerSessionStateChanges

Method Summary

Method Detail

public Class ServerSessionStateController.SessionStateChange

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Interface ServerSessionStateController.SessionStateChangesListener

Method Summary

Method Detail