Interface RealmProvider

    • Method Detail

      • createRealm

        RealmModel createRealm​(String name)
        Creates new realm with the given name. The internal ID will be generated automatically.
        Parameters:
        name - String name of the realm
        Returns:
        Model of the created realm.
      • createRealm

        RealmModel createRealm​(String id,
                               String name)
        Created new realm with given ID and name.
        Parameters:
        id - Internal ID of the realm or null if one is to be created by the underlying store. If the store expects the ID to have a certain format (for example UUID) and the supplied ID doesn't follow the expected format, the store may replace the id with a new one at its own discretion.
        name - String name of the realm
        Returns:
        Model of the created realm.
      • getRealm

        RealmModel getRealm​(String id)
        Exact search for a realm by its internal ID.
        Parameters:
        id - Internal ID of the realm.
        Returns:
        Model of the realm
      • getRealmByName

        RealmModel getRealmByName​(String name)
        Exact search for a realm by its name.
        Parameters:
        name - String name of the realm
        Returns:
        Model of the realm
      • getRealmsStream

        Stream<RealmModel> getRealmsStream()
        Returns realms as a stream.
        Returns:
        Stream of RealmModel. Never returns null.
      • getRealmsWithProviderTypeStream

        Stream<RealmModel> getRealmsWithProviderTypeStream​(Class<?> type)
        Returns stream of realms which has component with the given provider type.
        Parameters:
        type - Class<?> Type of the provider.
        Returns:
        Stream of RealmModel. Never returns null.
      • removeRealm

        boolean removeRealm​(String id)
        Removes realm with the given id.
        Parameters:
        id - of realm.
        Returns:
        true if the realm was successfully removed.
      • removeClientInitialAccessModel

        default void removeClientInitialAccessModel​(RealmModel realm,
                                                    String id)
      • removeExpiredClientInitialAccess

        void removeExpiredClientInitialAccess()
        Removes all expired client initial accesses from all realms.
      • deleteLocalizationTextsByLocale

        boolean deleteLocalizationTextsByLocale​(RealmModel realm,
                                                String locale)
      • addClient

        ClientModel addClient​(RealmModel realm,
                              String id,
                              String clientId)
        Deprecated.
        Use the corresponding method from ClientProvider.
        Description copied from interface: ClientProvider
        Adds a client with given internal ID and clientId to the given realm.
        Specified by:
        addClient in interface ClientProvider
        Parameters:
        realm - Realm owning this client.
        id - Internal ID of the client or null if one is to be created by the underlying store
        clientId - String that identifies the client to the external parties. Maps to client_id in OIDC or entityID in SAML.
        Returns:
        Model of the created client.
      • addClient

        default ClientModel addClient​(RealmModel realm,
                                      String clientId)
        Deprecated.
        Use the corresponding method from ClientProvider.
        Description copied from interface: ClientProvider
        Adds a client with given clientId to the given realm. The internal ID of the client will be created automatically.
        Specified by:
        addClient in interface ClientProvider
        Parameters:
        realm - Realm owning this client.
        clientId - String that identifies the client to the external parties. Maps to client_id in OIDC or entityID in SAML.
        Returns:
        Model of the created client.
      • getClientsCount

        long getClientsCount​(RealmModel realm)
        Deprecated.
        Use the corresponding method from ClientProvider.
        Description copied from interface: ClientProvider
        Returns number of clients in the given realm
        Specified by:
        getClientsCount in interface ClientProvider
        Parameters:
        realm - Realm.
        Returns:
        Number of the clients in the given realm.
      • addRealmRole

        default RoleModel addRealmRole​(RealmModel realm,
                                       String name)
        Deprecated.
        Use the corresponding method from RoleProvider.
        Description copied from interface: RoleProvider
        Adds a realm role with given name to the given realm. The internal ID of the role will be created automatically.
        Specified by:
        addRealmRole in interface RoleProvider
        Parameters:
        realm - Realm owning this role.
        name - String name of the role.
        Returns:
        Model of the created role.
      • addRealmRole

        RoleModel addRealmRole​(RealmModel realm,
                               String id,
                               String name)
        Deprecated.
        Use the corresponding method from RoleProvider.
        Description copied from interface: RoleProvider
        Adds a realm role with given internal ID and name to the given realm.
        Specified by:
        addRealmRole in interface RoleProvider
        Parameters:
        realm - Realm owning this role.
        id - Internal ID of the role or null if one is to be created by the underlying store
        name - String name of the role.
        Returns:
        Model of the created client.
      • moveGroup

        void moveGroup​(RealmModel realm,
                       GroupModel group,
                       GroupModel toParent)
        Deprecated.
        Use the corresponding method from GroupProvider.
        Description copied from interface: GroupProvider
        This method is used for moving groups in group structure, for example:
        • making an existing child group child group of some other group,
        • setting a top level group (i.e. group without parent group) child of some group,
        • making a child group top level group (i.e. removing its parent group).
          Specified by:
          moveGroup in interface GroupProvider
          Parameters:
          realm - Realm owning this group.
          group - Group to update.
          toParent - New parent group, or null if we are moving the group to top level group.
        • getGroupsCount

          Long getGroupsCount​(RealmModel realm,
                              Boolean onlyTopGroups)
          Deprecated.
          Use the corresponding method from GroupProvider.
          Description copied from interface: GroupProvider
          Returns a number of groups/top level groups (i.e. groups without parent group) for the given realm.
          Specified by:
          getGroupsCount in interface GroupProvider
          Parameters:
          realm - Realm.
          onlyTopGroups - When true the function returns a count of top level groups only.
          Returns:
          Number of groups/top level groups.
        • getGroupsCountByNameContaining

          Long getGroupsCountByNameContaining​(RealmModel realm,
                                              String search)
          Deprecated.
          Use the corresponding method from GroupProvider.
          Description copied from interface: GroupProvider
          Returns the number of top level groups containing groups with the given string in name for the given realm.
          Specified by:
          getGroupsCountByNameContaining in interface GroupProvider
          Parameters:
          realm - Realm.
          search - Case insensitive string which will be searched for.
          Returns:
          Number of groups with the given string in its name.
        • removeGroup

          boolean removeGroup​(RealmModel realm,
                              GroupModel group)
          Deprecated.
          Use the corresponding method from GroupProvider.
          Description copied from interface: GroupProvider
          Removes the given group for the given realm.
          Specified by:
          removeGroup in interface GroupProvider
          Parameters:
          realm - Realm.
          group - Group.
          Returns:
          true if the group was removed, false if group doesn't exist or doesn't belong to the given realm
        • createGroup

          default GroupModel createGroup​(RealmModel realm,
                                         String name)
          Deprecated.
          Use the corresponding method from GroupProvider.
          Description copied from interface: GroupProvider
          Creates a new group with the given name in the given realm. Effectively the same as createGroup(realm, null, name, null).
          Specified by:
          createGroup in interface GroupProvider
          Parameters:
          realm - Realm.
          name - Name.
          Returns:
          Model of the created group.
        • createGroup

          default GroupModel createGroup​(RealmModel realm,
                                         String id,
                                         String name)
          Deprecated.
          Use the corresponding method from GroupProvider.
          Description copied from interface: GroupProvider
          Creates a new group with the given id and name in the given realm. Effectively the same as createGroup(realm, id, name, null)
          Specified by:
          createGroup in interface GroupProvider
          Parameters:
          realm - Realm.
          id - Id.
          name - Name.
          Returns:
          Model of the created group
        • createGroup

          default GroupModel createGroup​(RealmModel realm,
                                         String name,
                                         GroupModel toParent)
          Deprecated.
          Use the corresponding method from GroupProvider.
          Description copied from interface: GroupProvider
          Creates a new group with the given name and parent to the given realm. Effectively the same as createGroup(realm, null, name, toParent).
          Specified by:
          createGroup in interface GroupProvider
          Parameters:
          realm - Realm.
          name - Name.
          toParent - Parent group.
          Returns:
          Model of the created group.
        • createGroup

          GroupModel createGroup​(RealmModel realm,
                                 String id,
                                 String name,
                                 GroupModel toParent)
          Deprecated.
          Use the corresponding method from GroupProvider.
          Description copied from interface: GroupProvider
          Creates a new group with the given name, id, name and parent to the given realm.
          Specified by:
          createGroup in interface GroupProvider
          Parameters:
          realm - Realm.
          id - Id, will be generated if null.
          name - Name.
          toParent - Parent group, or null if the group is top level group
          Returns:
          Model of the created group