@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.cloud.oracle.com/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 ExplicitlySetBmcModel.__explicitlySet__
. The hashCode()
and
equals(Object)
methods are implemented to take ExplicitlySetBmcModel.__explicitlySet__
into account.
The constructor, on the other hand, does not set ExplicitlySetBmcModel.__explicitlySet__
(since the
constructor cannot distinguish explicit null
from unset null
).
Modifier and Type | Class and Description |
---|---|
static class |
SessionPersistenceConfigurationDetails.Builder |
Constructor and Description |
---|
SessionPersistenceConfigurationDetails(String cookieName,
Boolean disableFallback)
Deprecated.
|
Modifier and Type | Method and Description |
---|---|
static SessionPersistenceConfigurationDetails.Builder |
builder()
Create a new builder.
|
boolean |
equals(Object o) |
String |
getCookieName()
The name of the cookie used to detect a session initiated by the backend server.
|
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.
|
int |
hashCode() |
SessionPersistenceConfigurationDetails.Builder |
toBuilder() |
String |
toString() |
String |
toString(boolean includeByteArrayContents)
Return a string representation of the object.
|
markPropertyAsExplicitlySet, wasPropertyExplicitlySet
@Deprecated @ConstructorProperties(value={"cookieName","disableFallback"}) public SessionPersistenceConfigurationDetails(String cookieName, Boolean disableFallback)
public static SessionPersistenceConfigurationDetails.Builder builder()
Create a new builder.
public SessionPersistenceConfigurationDetails.Builder toBuilder()
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
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
public String toString()
toString
in class com.oracle.bmc.http.client.internal.ExplicitlySetBmcModel
public String toString(boolean includeByteArrayContents)
Return a string representation of the object.
includeByteArrayContents
- true to include the full contents of byte arrayspublic boolean equals(Object o)
equals
in class com.oracle.bmc.http.client.internal.ExplicitlySetBmcModel
public int hashCode()
hashCode
in class com.oracle.bmc.http.client.internal.ExplicitlySetBmcModel
Copyright © 2016–2023. All rights reserved.