Top Description Fields Constructors Methods
com.oracle.bmc

public final Class Realm

extends Object
implements Serializable, Comparable<Realm>
Class Inheritance
All Implemented Interfaces
java.lang.Comparable, java.io.Serializable
Imports
com.oracle.bmc.internal.Alloy, com.oracle.bmc.util.VisibleForTesting, com.oracle.bmc.util.internal.NameUtils, jakarta.annotation.Nonnull, java.io.Serializable, java.util.LinkedHashMap, .Locale, .Map, .Optional, java.util.concurrent.locks.Lock, .ReentrantReadWriteLock

Class containing all Identity realms.

Accounts (tenancies) are per Realm.

Field Summary

Modifier and TypeField and Description
private static final Map<String, Realm>
private static final Map<String, Realm>
private static final Map<String, Realm>
private static final ReentrantReadWriteLock
public static final Realm
public static final Realm
public static final Realm
public static final Realm
public static final Realm
public static final Realm
public static final Realm
public static final Realm
public static final Realm
public static final Realm
public static final Realm
public static final Realm
public static final Realm
public static final Realm
public static final Realm
public static final Realm
public static final Realm
private static final Lock
private final String
realmId

The id of the realm.

private final String
secondLevelDomain

The second level domain of the realm.

private static final long
private static final Lock

Constructor Summary

AccessConstructor and Description
private
Realm(String realmId, String secondLevelDomain)

private
Realm(String realmId, String secondLevelDomain, boolean isAlloyRealm)

Method Summary

Modifier and TypeMethod and Description
protected static void
public int

Returns:

the value 0 if the realmId of the compared Realm is equal to the realmId of this Realm; a value less than 0 if the realmId of this Realm is lexicographically less than the realmId of the compared Realm; and a value greater than 0 if the realmId of this Realm is lexicographically greater than the realmId of the compared Realm.
compareTo
(Realm
The Realm to be compared.
other
)

Implements java.lang.Comparable.compareTo.

Compares to realms lexicographically based on their realmId.

public boolean
equals(final Object
the reference object with which to compare.
o
)

Overrides java.lang.Object.equals.

Indicates whether some other object is "equal to" this one.

public String
public String
public int
hashCode()

Overrides java.lang.Object.hashCode.

Returns a hash code value for this object.

public static Realm

Returns:

The registered Realm (or existing one if found).
register
(String
The realm id.
realmId
,
String
The second level domain of the realm.
secondLevelDomain
)

Register a new Realm.

public static Realm

Returns:

The registered Realm (or existing one if found).
register
(String
The realm id.
realmId
,
String
The second level domain of the realm.
secondLevelDomain
,
boolean
'true' if realm is from alloy configuration.
isAlloyRealm
)

Register a new Realm.

public String
toString()

Overrides java.lang.Object.toString.

Returns a string representation of the object.

public static Realm

Returns:

The Realm object matching the specified name, if available.
valueOf
(String
The name of the realm
name
)

Returns the Realm object matching the specified name.

public static Realm[]

Returns:

Known realms
values
()

All known Realms in this version of the SDK

Inherited from java.lang.Object:
clonefinalizegetClassnotifynotifyAllwaitwaitwait

Field Detail

ALL_REALMSback to summary
private static final Map<String, Realm> ALL_REALMS
ALLOY_REALMSback to summary
private static final Map<String, Realm> ALLOY_REALMS
KNOWN_REALMSback to summary
private static final Map<String, Realm> KNOWN_REALMS
lockback to summary
private static final ReentrantReadWriteLock lock
OC1back to summary
public static final Realm OC1
OC10back to summary
public static final Realm OC10
OC14back to summary
public static final Realm OC14
OC15back to summary
public static final Realm OC15
OC19back to summary
public static final Realm OC19
OC2back to summary
public static final Realm OC2
OC20back to summary
public static final Realm OC20
OC21back to summary
public static final Realm OC21
OC23back to summary
public static final Realm OC23
OC24back to summary
public static final Realm OC24
OC26back to summary
public static final Realm OC26
OC29back to summary
public static final Realm OC29
OC3back to summary
public static final Realm OC3
OC35back to summary
public static final Realm OC35
OC4back to summary
public static final Realm OC4
OC8back to summary
public static final Realm OC8
OC9back to summary
public static final Realm OC9
readLockback to summary
private static final Lock readLock
realmIdback to summary
private final String realmId

The id of the realm.

secondLevelDomainback to summary
private final String secondLevelDomain

The second level domain of the realm.

serialVersionUIDback to summary
private static final long serialVersionUID
writeLockback to summary
private static final Lock writeLock

Constructor Detail

Realmback to summary
private Realm(String realmId, String secondLevelDomain)
Realmback to summary
private Realm(String realmId, String secondLevelDomain, boolean isAlloyRealm)

Method Detail

clearAlloyRealmsback to summary
protected static void clearAlloyRealms()
Annotations
@InternalSdk
@VisibleForTesting
compareToback to summary
public int compareTo(Realm other)

Implements java.lang.Comparable.compareTo.

Compares to realms lexicographically based on their realmId.

Parameters
other:Realm

The Realm to be compared.

Returns:int

the value 0 if the realmId of the compared Realm is equal to the realmId of this Realm; a value less than 0 if the realmId of this Realm is lexicographically less than the realmId of the compared Realm; and a value greater than 0 if the realmId of this Realm is lexicographically greater than the realmId of the compared Realm.

equalsback to summary
public boolean equals(final Object o)

Overrides java.lang.Object.equals.

Doc from java.lang.Object.equals.

Indicates whether some other object is "equal to" this one.

The equals method implements an equivalence relation on non-null object references:

  • It is reflexive: for any non-null reference value x, x.equals(x) should return true.
  • It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
  • It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
  • It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
  • For any non-null reference value x, x.equals(null) should return false.

An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.

Parameters
o:Object

the reference object with which to compare.

Returns:boolean

true if this object is the same as the obj argument; false otherwise.

getRealmIdback to summary
public String getRealmId()
getSecondLevelDomainback to summary
public String getSecondLevelDomain()
hashCodeback to summary
public int hashCode()

Overrides java.lang.Object.hashCode.

Doc from java.lang.Object.hashCode.

Returns a hash code value for this object. This method is supported for the benefit of hash tables such as those provided by java.util.HashMap.

The general contract of hashCode is:

  • Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
  • If two objects are equal according to the equals method, then calling the hashCode method on each of the two objects must produce the same integer result.
  • It is not required that if two objects are unequal according to the equals method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.
Returns:int

a hash code value for this object

registerback to summary
public static Realm register(String realmId, String secondLevelDomain)

Register a new Realm. Used to allow the SDK to be forward compatible with unreleased realms.

Parameters
realmId:String

The realm id.

secondLevelDomain:String

The second level domain of the realm.

Returns:Realm

The registered Realm (or existing one if found).

registerback to summary
public static Realm register(String realmId, String secondLevelDomain, boolean isAlloyRealm)

Register a new Realm. Used to allow the SDK to be forward compatible with unreleased realms.

Parameters
realmId:String

The realm id.

secondLevelDomain:String

The second level domain of the realm.

isAlloyRealm:boolean

'true' if realm is from alloy configuration.

Returns:Realm

The registered Realm (or existing one if found).

toStringback to summary
public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object. Satisfying this method's contract implies a non-null result must be returned.

Returns:String

a string representation of the object

Annotations
@Override
valueOfback to summary
public static Realm valueOf(String name) throws IllegalArgumentException

Returns the Realm object matching the specified name. The name must match exactly. (Extraneous whitespace characters are not permitted.)

Parameters
name:String

The name of the realm

Returns:Realm

The Realm object matching the specified name, if available.

Exceptions
IllegalArgumentException:
if no realm exists with the specified name
valuesback to summary
public static Realm[] values()

All known Realms in this version of the SDK

Returns:Realm[]

Known realms