/*
    * Copyright (c) 2002-2025, City of Paris
    * All rights reserved.
    *
    * Redistribution and use in source and binary forms, with or without
    * modification, are permitted provided that the following conditions
    * are met:
    *
    *  1. Redistributions of source code must retain the above copyright notice
   *     and the following disclaimer.
   *
   *  2. Redistributions in binary form must reproduce the above copyright notice
   *     and the following disclaimer in the documentation and/or other materials
   *     provided with the distribution.
   *
   *  3. Neither the name of 'Mairie de Paris' nor 'Lutece' nor the names of its
   *     contributors may be used to endorse or promote products derived from
   *     this software without specific prior written permission.
   *
   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
   * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
   * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
   * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
   * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
   * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
   * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
   * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
   * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
   * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
   * POSSIBILITY OF SUCH DAMAGE.
   *
   * License 1.0
   */
  package fr.paris.lutece.portal.business.page;
  
  import fr.paris.lutece.portal.service.image.ImageResource;
  import fr.paris.lutece.util.ReferenceList;
  
  import java.util.Collection;
  import java.util.List;
  
  /**
   * IPageDAO Interface
   */
  public interface IPageDAO
  {
      /**
       * Insert a new record in the table.
       * 
       * @param page
       *            The Page object
       */
      void insert( Page page );
  
      /**
       * load the data of level from the table
       * 
       * @param nPageId
       *            The identifier of the object Page
       * @param bPortlets
       *            The boolean
       * @return The Instance of the object Page
       */
      Page load( int nPageId, boolean bPortlets );
  
      /**
       * load the data of level from the table without image content
       * 
       * @param nPageId
       *            The identifier of the object Page
       * @param bPortlets
       *            The boolean
       * @return The Instance of the object Page
       */
      Page loadWithoutImageContent( int nPageId, boolean bPortlets );
  
      /**
       * load a page associated to a portlet
       * 
       * @param nPorletId
       *            The identifier of the object portlet associate to the page
       * @return The Instance of the object Page
       */
      Page loadPageByIdPortlet( int nPorletId );
  
      /**
       * Delete a record from the table
       * 
       * @param nPageId
       *            The identifier of the object nPageId
       */
      void delete( int nPageId );
  
      /**
       * Update the record in the table
       * 
       * @param page
       *            The instance of the page to update
       */
     void store( Page page );
 
     /**
      * Select all the child pages for a page which is specified in parameter
      *
      * @param nParentPageId
      *            The parent page identifier
      * @return The list of objects Page (without portlets list)
      */
     Collection<Page> selectChildPages( int nParentPageId );
 
     /**
      * Select all child pages for a page which is specified in parameter For each pages, only select : Id, pageParentId, name and description
      * 
      * @param nParentPageId
      *            the ParentPageId identifier
      * @return The list of objects Page
      */
     Collection<Page> selectChildPagesMinimalData( int nParentPageId );
 
     /**
      * Loads all the pages for a portal
      * 
      * @return The pages of the current portal (without portlets list, of course !)
      */
     List<Page> selectAllPages( );
 
     /**
      * Invalidate the page after a modification
      *
      * @param nPageId
      *            the page identifier
      */
     void invalidatePage( int nPageId );
 
     /**
      * Load the Referencelist of documentTypes
      * 
      * @return listDocumentTypes
      */
     ReferenceList getPagesList( );
 
     /**
      * Return the list of all the pages filtered by Lutece Role specified in parameter
      *
      * @param strRoleKey
      *            The Lutece Role key
      * @return a collection of pages
      */
     Collection<Page> getPagesByRoleKey( String strRoleKey );
 
     /**
      * Search the last order of child page list
      * 
      * @param nParentPageId
      *            The parent page Id
      * @return The new page order
      */
     int selectNewChildPageOrder( int nParentPageId );
 
     /**
      * Load a image corresponding to an Page
      *
      * @param nIdPage
      *            The Page Id
      * @return the instance of the ImageContent
      */
     ImageResource loadImageResource( int nIdPage );
 
     /**
      * Tests if page exist
      *
      * @param nPageId
      *            The identifier of the document
      * @return true if the page existed, false otherwise
      */
     boolean checkPageExist( int nPageId );
 
     /**
      * Load the last modified page
      * 
      * @return the last modified {@link Page}
      */
     Page loadLastModifiedPage( );
 
     /**
      * Update the authorization node of the page
      * 
      * @param nIdPage
      *            the page id
      * @param nIdAuthorizationNode
      *            the authorization node id
      */
     void updateAutorisationNode( int nIdPage, Integer nIdAuthorizationNode );
 
     /**
      * select list of children Pages Which Must Change their authorization node
      * 
      * @param nIdParentPage
      *            the id of the parent page
      * @return an id list
      */
     List<Integer> selectPageForChangeAutorisationNode( int nIdParentPage );
 }