Package org.exoplatform.portal.mop.service

Interface LayoutService

All Superinterfaces:
DataStorage
public interface LayoutService extends DataStorage

  • Field Details

    • PAGE_CREATED

      static final String PAGE_CREATED

    • PAGE_REMOVED

      static final String PAGE_REMOVED

    • PAGE_UPDATED

      static final String PAGE_UPDATED

    • PORTAL_CONFIG_CREATED

      static final String PORTAL_CONFIG_CREATED

    • PORTAL_CONFIG_REMOVED

      static final String PORTAL_CONFIG_REMOVED

    • PORTAL_CONFIG_UPDATED

      static final String PORTAL_CONFIG_UPDATED

  • Method Details

    • create

      void create(PortalConfig config)
      Create a PortalConfig in database
      Then broadcast PORTAL_CONFIG_CREATED event
      Specified by:
      create in interface DataStorage
      Parameters:
      config - PortalConfig

    • save

      void save(PortalConfig config)
      This method should update the PortalConfig object
      Then broadcast PORTAL_CONFIG_UPDATED event
      Specified by:
      save in interface DataStorage
      Parameters:
      config - PortalConfig

    • getPortalConfig

      PortalConfig getPortalConfig(String portalName)
      This method should load the PortalConfig object from db according to the portalName
      Specified by:
      getPortalConfig in interface DataStorage
      Parameters:
      portalName -
      Returns:
      PortalConfig

    • getPortalConfig

      PortalConfig getPortalConfig(String ownerType, String portalName)
      This method should load the PortalConfig object from db according to the portalName and ownerType
      Specified by:
      getPortalConfig in interface DataStorage
      Parameters:
      ownerType -
      portalName -
      Returns:
      PortalConfig

    • getPortalConfig

      PortalConfig getPortalConfig(SiteKey siteKey)
      Retrieves PortalConfig of designated SiteKey
      Specified by:
      getPortalConfig in interface DataStorage
      Parameters:
      siteKey - SiteKey
      Returns:
      null if not found, else PortalConfig

    • getPortalConfig

      PortalConfig getPortalConfig(long siteId)
      This method should load the PortalConfig object from db according to the siteId
      Parameters:
      siteId -
      Returns:
      PortalConfig

    • remove

      void remove(PortalConfig config)
      Remove the PortalConfig from the database
      Then broadcast PORTAL_CONFIG_REMOVED event
      Specified by:
      remove in interface DataStorage
      Parameters:
      config - PortalConfig

    • removePages

      void removePages(SiteKey siteKey)
      Removes all pages of a given site
      Parameters:
      siteKey - SiteKey

    • getPage

      Page getPage(String pageId)
      This method should load the Page object from the database according to the pageId
      Specified by:
      getPage in interface DataStorage
      Parameters:
      pageId - - String represent id of page, it must be valid pageId (3 parts saparate by :: )
      Returns:
      Page

    • getPage

      Page getPage(long id)
      This method should load the Page object from the database according to the technical identifier of the page
      Parameters:
      id - - UUID of page
      Returns:
      Page

    • getPage

      Page getPage(PageKey pageKey)
      Retrieves Page designated by its key
      Specified by:
      getPage in interface DataStorage
      Parameters:
      pageKey - PageKey
      Returns:
      Page

    • getPageContext

      PageContext getPageContext(PageKey pageKey)
      retrieves PageContext switch its key
      Parameters:
      pageKey - PageKey
      Returns:
      PageContext

    • findPages

      List<PageContext> findPages(SiteKey siteKey)
      Retrieves the list of pages in a give site
      Parameters:
      siteKey - SiteKey
      Returns:
      List of type PageContext

    • findPages

      QueryResult<PageContext> findPages(int offset, int limit, SiteType siteType, String siteName, String pageName, String pageTitle)
      Search for pages using some criteria and pagination options
      Parameters:
      offset - pagination offset
      limit - pagination limit
      siteType - SiteType
      siteName - site name
      pageName - page name search term
      pageTitle - page title search term
      Returns:
      QueryResult containing list of pages

    • remove

      void remove(Page page)
      Removes a given page from store
      Specified by:
      remove in interface DataStorage
      Parameters:
      page - Page

    • remove

      void remove(PageKey pageKey)
      Removes a page from store designated by its PageKey
      Specified by:
      remove in interface DataStorage
      Parameters:
      pageKey - PageKey

    • create

      void create(Page page)
      This method should create or update the given page object
      Then broasdcast PAGE_CREATED event
      Specified by:
      create in interface DataStorage
      Parameters:
      page -

    • save

      List<ModelChange> save(Page page)
      Saves a page. If a page with the same id already exists then a merge operation will occur, otherwise it throws IllegalStateException
      The operation returns a list of the change object that describes the changes that occured during the save operation.
      Then broadcast PAGE_UPDATED event
      Specified by:
      save in interface DataStorage
      Parameters:
      page - the page to save
      Returns:
      the list of model changes that occurred during the save

    • save

      void save(PageContext pageContext, Page page)
      Saves a PageContext with its PageState in addition to the layout defined in Page object
      Parameters:
      pageContext - PageContext with title, description and permissions
      page - Page to save page layout and structure

    • save

      void save(PageContext pageContext)
      Saves a PageContext with its PageState
      Parameters:
      pageContext - PageContext with title, description and permissions

    • getApplicationModel

      <S> Application<S> getApplicationModel(String applicationStorageId)
      Retrieved Application model switch its storage identifier
      Specified by:
      getApplicationModel in interface DataStorage
      Type Parameters:
      S - can be of type Portlet only, see ApplicationType
      Parameters:
      applicationStorageId -
      Returns:
      Application

    • getId

      <S> String getId(ApplicationState<S> state)
      Return contentId according to each state (transient, persistent, clone)
      Specified by:
      getId in interface DataStorage
      Type Parameters:
      S - can be of type Portlet only, see ApplicationType
      Parameters:
      state -
      Returns:
      ApplicationState of type Portlet

    • load

      <S> S load(ApplicationState<S> state, ApplicationType<S> type)
      Return content state. If can't find, return null
      Specified by:
      load in interface DataStorage
      Type Parameters:
      S - can be of type Portlet only, see ApplicationType
      Parameters:
      state - - ApplicationState object
      type - - ApplicationType object
      Returns:
      Portlet

    • save

      <S> ApplicationState<S> save(ApplicationState<S> state, S preferences)
      Save content state
      Specified by:
      save in interface DataStorage
      Type Parameters:
      S - can be of type Portlet only, see ApplicationType
      Parameters:
      state - - ApplicationState object. It must be CloneApplicationState or PersistentApplicationState object
      preferences - - object to be saved
      Returns:
      ApplicationState typed with Portlet

    • find

      <T> org.exoplatform.commons.utils.LazyPageList<T> find(Query<T> q, Comparator<T> sortComparator)
      Return LazyPageList of object (sorted) which type and other info determined in Query object
      Specified by:
      find in interface DataStorage
      Type Parameters:
      T - could be of type Page or PortalConfig
      Parameters:
      q - - Query object
      sortComparator - Comparator used for sorting results
      Returns:
      LazyPageList

    • find2

      <T> org.exoplatform.commons.utils.ListAccess<T> find2(Query<T> q, Comparator<T> sortComparator)
      Return ListAccess, we can retrieved array of object (sorted) in database through this.
      Specified by:
      find2 in interface DataStorage
      Type Parameters:
      T - could be of type Page or PortalConfig
      Parameters:
      q - - Query object
      sortComparator - - Comparator object, used to sort the result list
      Returns:
      LazyPageList

    • getSharedLayout

      Container getSharedLayout(String siteName)
      Return shared layout containing common layout of all sites (user, group and sites). This will retrieve the layout from /conf/portal/portal/sharedlayout-{siteName}.xml else if not found, retrieve it from /conf/portal/portal/sharedlayout.xml
      Specified by:
      getSharedLayout in interface DataStorage
      Parameters:
      siteName -
      Returns:
      Container

    • getSiteNames

      List<String> getSiteNames(SiteType siteType, int offset, int limit)
      Retrieves all site type names with pagination.
      Specified by:
      getSiteNames in interface DataStorage
      Parameters:
      siteType - SiteType
      offset - offset of the query
      limit - limit of the list to fetch
      Returns:
      List of corresponding site names, else empty list if not found

    • getImportStatus

      default Status getImportStatus()
      Specified by:
      getImportStatus in interface DataStorage

    • saveImportStatus

      default void saveImportStatus(Status status)
      Specified by:
      saveImportStatus in interface DataStorage

    • getSites

      default List<PortalConfig> getSites(SiteFilter siteFilter)
      Retrieves sites according to the given site filter
      Parameters:
      siteFilter - SiteFilter site filter for results filtering
      Returns:
      List of sites portal config

    • getSiteBannerStream

      default InputStream getSiteBannerStream(String siteName) throws org.exoplatform.commons.exception.ObjectNotFoundException, IOException
      Retrieve site banner as stream
      Parameters:
      siteName - name of the portal site
      Returns:
      found InputStream
      Throws:
      org.exoplatform.commons.exception.ObjectNotFoundException - When site not found or file attachment
      IOException

    • getDefaultSiteBannerStream

      default InputStream getDefaultSiteBannerStream(String siteName)
      Retrieve default site banner as stream
      Parameters:
      siteName - name of the portal site
      Returns:
      found InputStream

    • removeSiteBanner

      default void removeSiteBanner(String siteName) throws org.exoplatform.commons.exception.ObjectNotFoundException
      remove site banner
      Parameters:
      siteName - name of the portal site
      Throws:
      org.exoplatform.commons.exception.ObjectNotFoundException - When site not found or file attachment