SessionHandle para el direccionamiento

Al utilizar una política de ubicación de particiones por contenedor, puede utilizar un SessionHandle. Un objeto SessionHandle contiene información de partición para la sesión actual y se puede reutilizar para una nueva sesión.

Un objeto SessionHandle incluye información para la partición a la que está vinculada la sesión actual. SessionHandle es extremadamente útil para la política de ubicación de particiones por contenedor y se puede serializar con la serialización Java estándar.

Si tiene una instancia de SessionHandle puede aplicar dicho descriptor de contexto en una sesión con el método setSessionHandle(destino de SessionHandle), que pasa el descriptor de contexto como el destino. Puede recuperar el objeto SessionHandle con el método Session.getSessionHandle.

Puesto que sólo es aplicable en un escenario de colocación por contenedor, al obtener el objeto SessionHandle se emite una IllegalStateException si una cuadrícula de datos determinada tiene varios conjuntos de correlaciones por contenedor o no tiene ninguno. Si no invoca el método setSessionHandle antes de llamar al método getSessionHandle, se seleccionará el objeto SessionHandle adecuado en función de la configuración de las propiedades del cliente.

También puede utilizar la clase ayudante SessionHandleTransformer para convertir el descriptor de contexto en distintos formatos. Los métodos de esta clase pueden cambiar la representación de un descriptor de contexto de matriz de bytes a instancia, de serie a instancia y viceversa en ambos casos y, también, pueden escribir los contenidos del descriptor de contexto en la corriente de salida.

Si desea ver un ejemplo sobre cómo poder utilizar un objeto SessionHandle, consulte Direccionamiento a zonas según preferencias.