@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 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
).
Modifier and Type | Class and Description |
---|---|
static class |
SessionPersistenceConfigurationDetails.Builder |
EXPLICITLY_SET_FILTER_NAME, EXPLICITLY_SET_PROPERTY_NAME
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–2024. All rights reserved.