Interface ModifiableSecurityRealm

    • Method Detail

      • getRealmIdentityForUpdate

        default ModifiableRealmIdentity getRealmIdentityForUpdate​(Principal principal)
                                                           throws RealmUnavailableException
        Get an update handle for to the identity for the given principal in the context of this security realm. Any validation / name mapping is an implementation detail for the realm. The identity may or may not exist. The returned handle must be cleaned up by a call to RealmIdentity.dispose(). During the lifespan of a ModifiableRealmIdentity, no other updates or authentications may take place for the corresponding realm identity, thus care should be taken to minimize the duration of the identity's lifespan.

        If there is not enough information to locate an identity compatible with this realm, ModifiableRealmIdentity.NON_EXISTENT may be returned.

        Parameters:
        principal - the principal to use to locate the ModifiableRealmIdentity handle (must not be null)
        Returns:
        the ModifiableRealmIdentity for the provided information (not null)
        Throws:
        RealmUnavailableException
      • getRealmIdentityForUpdate

        default ModifiableRealmIdentity getRealmIdentityForUpdate​(Evidence evidence)
                                                           throws RealmUnavailableException
        Get an update handle for to the identity for the given principal in the context of this security realm. Any validation / name mapping is an implementation detail for the realm. The identity may or may not exist. The returned handle must be cleaned up by a call to RealmIdentity.dispose(). During the lifespan of a ModifiableRealmIdentity, no other updates or authentications may take place for the corresponding realm identity, thus care should be taken to minimize the duration of the identity's lifespan.

        If there is not enough information to locate an identity compatible with this realm, ModifiableRealmIdentity.NON_EXISTENT may be returned.

        Parameters:
        evidence - the evidence to use to locate the ModifiableRealmIdentity handle (must not be null)
        Returns:
        the ModifiableRealmIdentity for the provided information (not null)
        Throws:
        RealmUnavailableException