Class SessionPersistenceConfigurationDetails


  • @Generated(value="OracleSDKGenerator",
               comments="API Version: 20170115")
    public final class SessionPersistenceConfigurationDetails
    extends com.oracle.bmc.http.client.internal.ExplicitlySetBmcModel
    The configuration details for implementing session persistence based on a user-specified cookie name (application cookie stickiness).

    Session persistence enables the Load Balancing service to direct any number of requests that originate from a single logical client to a single backend web server. For more information, see [Session Persistence](https://docs.oracle.com/iaas/Content/Balance/Reference/sessionpersistence.htm).

    With application cookie stickiness, the load balancer enables session persistence only when the response from a backend application server includes a Set-cookie header with the user-specified cookie name.

    To disable application cookie stickiness on a running load balancer, use the updateBackendSet operation and specify null for the SessionPersistenceConfigurationDetails object.

    Example: SessionPersistenceConfigurationDetails: null

    *Note:** SessionPersistenceConfigurationDetails (application cookie stickiness) and LBCookieSessionPersistenceConfigurationDetails (LB cookie stickiness) are mutually exclusive. An error results if you try to enable both types of session persistence.

    *Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
    Note: Objects should always be created or deserialized using the SessionPersistenceConfigurationDetails.Builder. This model distinguishes fields that are null because they are unset from fields that are explicitly set to null. This is done in the setter methods of the SessionPersistenceConfigurationDetails.Builder, which maintain a set of all explicitly set fields called SessionPersistenceConfigurationDetails.Builder.__explicitlySet__. The hashCode() and equals(Object) methods are implemented to take the explicitly set fields into account. The constructor, on the other hand, does not take the explicitly set fields into account (since the constructor cannot distinguish explicit null from unset null).

    • Method Detail

      • getCookieName

        public String getCookieName()
        The name of the cookie used to detect a session initiated by the backend server.

        Use ‘*’ to specify that any cookie set by the backend causes the session to persist.

        Example: example_cookie

        Returns:
        the value
      • getDisableFallback

        public Boolean getDisableFallback()
        Whether the load balancer is prevented from directing traffic from a persistent session client to a different backend server if the original server is unavailable.

        Defaults to false.

        Example: false

        Returns:
        the value
      • toString

        public String toString()
        Overrides:
        toString in class com.oracle.bmc.http.client.internal.ExplicitlySetBmcModel
      • toString

        public String toString​(boolean includeByteArrayContents)
        Return a string representation of the object.
        Parameters:
        includeByteArrayContents - true to include the full contents of byte arrays
        Returns:
        string representation
      • equals

        public boolean equals​(Object o)
        Overrides:
        equals in class com.oracle.bmc.http.client.internal.ExplicitlySetBmcModel
      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class com.oracle.bmc.http.client.internal.ExplicitlySetBmcModel