Package org.zkoss.zk.ui.sys

Interface SessionCtrl

All Known Implementing Classes:
SerializableSession, SimpleSession
public interface SessionCtrl
Additional interface of Session for implementation.

Note: applications shall never access this interface.

Author:
tomyeh

  • Method Details

    • setDeviceType

      void setDeviceType(String deviceType)
      Sets the device type that this session belongs to.

      It is called by the desktop when Desktop.setDeviceType(java.lang.String) is called. Don't call this method directly. Otherwise, the result is unpredictable.

      Since:
      2.4.1

    • getDesktopCache

      DesktopCache getDesktopCache()
      Returns the desktop cache, or null if not available.

      Note: this is an utility to implement DesktopCacheProvider, which might or might not use this method. Other part of ZK shall not access this method.

    • setDesktopCache

      void setDesktopCache(DesktopCache cache)
      Sets the desktop cache.

      Note: this is an utility to implement DesktopCacheProvider, which might or might not use this method. Other part of ZK shall not access this method.

      Parameters:
      cache - the desktop cache; null to denote no cache available.

    • onDestroyed

      void onDestroyed()
      Called when the session is destroyed.

      Application shall never access this method.

    • recover

      void recover(Object nativeSession)
      Called when ZK detects Session.getNativeSession() is not initialized properly.

      It is actually a workaround to solve the issue that some Web container fails to call HttpSessionActivationListener.sessionDidActivate() upon failover.

      It can be used to solve the issue that the mapping between the native session and the ZK session is changed. For example, you might manually invalidate the http session and recreate one. Then, you have to call this method to associate the ZK session with the new created session.

    • isInvalidated

      boolean isInvalidated()
      Returns whether this session is invalidated (i.e., Session.invalidate() was called).

      Note: ZK doesn't invalidate it immediately (until the event has been processed), so the session might be still alive.

    • invalidateNow

      void invalidateNow()
      Really invalidates the session.

      Application shall never access this method.

    • notifyClientRequest

      boolean notifyClientRequest(boolean keepAlive)
      Notifies the session that a client request is received.
      Parameters:
      keepAlive - if the request will keep the session alive, or the request shall be ignored. If the request shall be ignored and the session is timeout, it will cause the session to expire (i.e., be invalidated).
      Returns:
      whether the session is invalidated (since 6.0.0)
      Since:
      3.0.0