Interface CockpitCollectionService

All Known Implementing Classes:
DefaultCockpitCollectionService

public interface CockpitCollectionService
Service contains methods to deal with collections of objects that are used in cockpits on the model layer. Additionally each cockpit have in web layer its own instance of ObjectCollectionService that will be parametrized with the allowed item types that are valid for collections present in the specific cockpit.
  • Method Details

    • addToCollection

      int addToCollection(CockpitObjectAbstractCollectionModel collection, List<ItemModel> elements)
      Adds the elements contained in elements to the ObjectCollection collection.
      Parameters:
      collection - the collection to which elements are to be added
      elements - the elements to add
      Returns:
      the number of elements actually added to the collection.
    • removeFromCollection

      int removeFromCollection(CockpitObjectAbstractCollectionModel collection, List<ItemModel> elements)
      Removes the elements contained in elements from the ObjectCollection collection
      Parameters:
      collection - the collection from which elements are to be removed
      elements - the elements to remove
      Returns:
      the number of elements actually removed from the collection.
    • getElements

      List<ItemModel> getElements(CockpitObjectAbstractCollectionModel collection, int start, int count)
      Returns elements of the given object collection.
      Parameters:
      collection - the object collection to search elements of
      start - starting index of the search
      count - max. count of elements to be found
      Returns:
      elements of the given object collection according to given offset and count
    • removeNullItemReferences

      int removeNullItemReferences(CockpitObjectAbstractCollectionModel collection)
      Removes references to non-existing items
      Parameters:
      collection - the object collection to search elements of
      Returns:
      the number of removed references
    • getElementCount

      int getElementCount(CockpitObjectAbstractCollectionModel collection)
      Gets the element count for the given collection.
      Parameters:
      collection - the collection
      Returns:
      the element count
    • cloneCollection

      Clones the given collection and assigns just cloned collection to the given user.
      Parameters:
      collection - the collection to clone
      user - the user - clonned collection owner
      Returns:
      the just cloned collection
    • getCollectionsForUser

      List<CockpitObjectAbstractCollectionModel> getCollectionsForUser(UserModel user)
      Gets all collections for given user including the collections that given user has permission to read or write.
      Parameters:
      user - the user
      Returns:
      the collections for user
    • getSpecialCollectionsForUser

      List<CockpitObjectSpecialCollectionModel> getSpecialCollectionsForUser(UserModel user)
      Gets the special collections for a given user.
      Parameters:
      user - the user
      Returns:
      the special collections for user
    • getSpecialCollections

      List<CockpitObjectSpecialCollectionModel> getSpecialCollections(UserModel user, String collectionType)
      Gets the special collections of the specified type that belongs to the given user.
      Parameters:
      user - the user
      collectionType - the collection type
      Returns:
      the special collections
    • hasReadCollectionRight

      boolean hasReadCollectionRight(PrincipalModel principal, CockpitObjectAbstractCollectionModel collection)
      Returns information whether the user can read collection.
      Parameters:
      principal - the requested principal
      collection - the requested collection
    • hasWriteCollectionRight

      boolean hasWriteCollectionRight(PrincipalModel principal, CockpitObjectAbstractCollectionModel collection)
      Returns information whether the user can modify collection.
      Parameters:
      principal - the requested principal
      collection - the requested collection
    • isInCollection

      boolean isInCollection(ItemModel object, CockpitObjectAbstractCollectionModel collection)
      Checks if the given element belongs to the specified collection.
      Parameters:
      object - the object
      collection - the collection
      Returns:
      true if given element is in the specified collection
    • addReadUser

      void addReadUser(PrincipalModel user, CockpitObjectAbstractCollectionModel collection)
      Allows given user to read given collection.
      Parameters:
      user - to add read access
      collection - to add read access
    • addWriteUser

      void addWriteUser(PrincipalModel user, CockpitObjectAbstractCollectionModel collection)
      Allows given user to modify given collection.
      Parameters:
      user - to add write access
      collection - to add write access
    • removeReadUser

      void removeReadUser(PrincipalModel user, CockpitObjectAbstractCollectionModel collection)
      Disallow given user to read given collection.
      Parameters:
      user - to remove read access
      collection - to remove read access
    • removeWriteUser

      void removeWriteUser(PrincipalModel user, CockpitObjectAbstractCollectionModel collection)
      Disallow given user to modify given collection.
      Parameters:
      user - to remove write access
      collection - to remove write access