// license-header java merge-point
   //
   // Attention: Generated code! Do not modify by hand!
   // Generated by: hibernate/SpringHibernateDaoBase.vsl in <project>/mda/src/main/cartridge/custom/...
   //
   package fr.ifremer.quadrige3.core.dao.administration.program;
   
   /*-
    * #%L
   * Quadrige3 Core :: Client API
   * %%
   * Copyright (C) 2017 - 2024 Ifremer
   * %%
   * This program is free software: you can redistribute it and/or modify
   * it under the terms of the GNU Affero General Public License as published by
   * the Free Software Foundation, either version 3 of the License, or
   * (at your option) any later version.
   * 
   * This program is distributed in the hope that it will be useful,
   * but WITHOUT ANY WARRANTY; without even the implied warranty of
   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   * GNU General Public License for more details.
   * 
   * You should have received a copy of the GNU Affero General Public License
   * along with this program.  If not, see <http://www.gnu.org/licenses/>.
   * #L%
   */
  import fr.ifremer.quadrige3.core.dao.PrincipalStore;
  import fr.ifremer.quadrige3.core.dao.PropertySearch;
  import fr.ifremer.quadrige3.core.dao.Search;
  import fr.ifremer.quadrige3.core.dao.referential.Status;
  import fr.ifremer.quadrige3.core.dao.technical.hibernate.HibernateDaoSupport;
  import fr.ifremer.quadrige3.core.vo.administration.program.ProgramVO;
  import java.security.Principal;
  import java.sql.Timestamp;
  import java.util.ArrayList;
  import java.util.Collection;
  import java.util.Date;
  import java.util.Iterator;
  import java.util.LinkedHashSet;
  import java.util.List;
  import java.util.Set;
  import javax.annotation.Resource;
  import org.andromda.spring.PaginationResult;
  import org.apache.commons.collections.CollectionUtils;
  import org.apache.commons.collections.Transformer;
  import org.hibernate.Criteria;
  import org.hibernate.HibernateException;
  import org.hibernate.Query;
  import org.hibernate.ScrollableResults;
  
  /**
   * <p>
   * Base Spring DAO Class: is able to create, update, remove, load, and find
   * objects of type <code>Program</code>.
   * </p>
   *
   * @see Program
   */
  public abstract class ProgramDaoBase
      extends HibernateDaoSupport    
      implements ProgramDao
  {
      /**
       * {@inheritDoc}
       */
      @Override
      public Object get(final int transform, final String progCd)
      {
          if (progCd == null)
          {
              throw new IllegalArgumentException(
                  "Program.get - 'progCd' can not be null");
          }
          final Program entity = get(ProgramImpl.class, progCd);
          return transformEntity(transform, entity);
      }
      /**
       * {@inheritDoc}
       */
      @Override
      public Program get(String progCd)
      {
          return (Program)this.get(TRANSFORM_NONE, progCd);
      }
  
      /**
       * {@inheritDoc}
       */
      @Override
      public Object load(final int transform, final String progCd)
      {
          if (progCd == null)
          {
              throw new IllegalArgumentException(
                  "Program.load - 'progCd' can not be null");
          }
          final Program entity = get(ProgramImpl.class, progCd);
          return transformEntity(transform, entity);
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public Program load(String progCd)
     {
         return (Program)this.load(TRANSFORM_NONE, progCd);
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     @SuppressWarnings({"unchecked"})
     public Collection<Program> loadAll()
     {
         return (Collection<Program>) this.loadAll(ProgramDao.TRANSFORM_NONE);
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public Collection<?> loadAll(final int transform)
     {
         return this.loadAll(transform, -1, -1);
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public Collection<?> loadAll(final int pageNumber, final int pageSize)
     {
         return this.loadAll(ProgramDao.TRANSFORM_NONE, pageNumber, pageSize);
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public Collection<?> loadAll(final int transform, final int pageNumber, final int pageSize)
     {
         try
         {
             final Criteria criteria = this.getSession().createCriteria(ProgramImpl.class);
             if (pageNumber > 0 && pageSize > 0)
             {
                 criteria.setFirstResult(this.calculateFirstResult(pageNumber, pageSize));
                 criteria.setMaxResults(pageSize);
             }
             final Collection<?> results = criteria.list();
             this.transformEntities(transform, results);
             return results;
         }
         catch (HibernateException ex)
         {
             throw ex;
         }
     }
 
     /**
      * firstResult = (pageNumber - 1) * pageSize
      * @param pageNumber
      * @param pageSize
      * @return firstResult
      */
     protected int calculateFirstResult(int pageNumber, int pageSize)
     {
         int firstResult = 0;
         if (pageNumber > 0)
         {
             firstResult = (pageNumber - 1) * pageSize;
         }
         return firstResult;
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public Program create(Program program)
     {
         return (Program)this.create(ProgramDao.TRANSFORM_NONE, program);
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public Object create(final int transform, final Program program)
     {
         if (program == null)
         {
             throw new IllegalArgumentException(
                 "Program.create - 'program' can not be null");
         }
         this.getSessionFactory().getCurrentSession().save(program);
         return this.transformEntity(transform, program);
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     @SuppressWarnings({"unchecked"})
     public Collection<Program> create(final Collection<Program> entities)
     {
         return (Collection<Program>) create(ProgramDao.TRANSFORM_NONE, entities);
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public Collection<?> create(final int transform, final Collection<Program> entities)
     {
         if (entities == null)
         {
             throw new IllegalArgumentException(
                 "Program.create - 'entities' can not be null");
         }
                     for (Program entity : entities)
                     {
                         create(transform, entity);
                     }
         return entities;
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public Program create(
         String progNm,
         String progDc,
         Date progCreationDt,
         Timestamp updateDt,
         String progCm)
     {
         return (Program)this.create(ProgramDao.TRANSFORM_NONE, progNm, progDc, progCreationDt, updateDt, progCm);
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public Object create(
         final int transform,
         String progNm,
         String progDc,
         Date progCreationDt,
         Timestamp updateDt,
         String progCm)
     {
         Program entity = new ProgramImpl();
         entity.setProgNm(progNm);
         entity.setProgDc(progDc);
         entity.setProgCreationDt(progCreationDt);
         entity.setUpdateDt(updateDt);
         entity.setProgCm(progCm);
         return this.create(transform, entity);
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public Program create(
         String progNm,
         Status status)
     {
         return (Program)this.create(ProgramDao.TRANSFORM_NONE, progNm, status);
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public Object create(
         final int transform,
         String progNm,
         Status status)
     {
         Program entity = new ProgramImpl();
         entity.setProgNm(progNm);
         entity.setStatus(status);
         return this.create(transform, entity);
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public void update(Program program)
     {
         if (program == null)
         {
             throw new IllegalArgumentException(
                 "Program.update - 'program' can not be null");
         }
         this.getSessionFactory().getCurrentSession().update(program);
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public void update(final Collection<Program> entities)
     {
         if (entities == null)
         {
             throw new IllegalArgumentException(
                 "Program.update - 'entities' can not be null");
         }
                     for (Program entity : entities)
                     {
                         update(entity);
                     }
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public void remove(Program program)
     {
         if (program == null)
         {
             throw new IllegalArgumentException(
                 "Program.remove - 'program' can not be null");
         }
         this.getSessionFactory().getCurrentSession().delete(program);
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public void remove(String progCd)
     {
         if (progCd == null)
         {
             throw new IllegalArgumentException(
                 "Program.remove - 'progCd' can not be null");
         }
         Program entity = this.get(progCd);
         if (entity != null)
         {
             this.remove(entity);
         }
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public void remove(Collection<Program> entities)
     {
         if (entities == null)
         {
             throw new IllegalArgumentException(
                 "Program.remove - 'entities' can not be null");
         }
         deleteAll(entities);
     }
     /**
      * {@inheritDoc}
      */
     @Override
     public ProgramVO save(final ProgramVO program)
     {
         if (program == null)
         {
             throw new IllegalArgumentException(
                 "fr.ifremer.quadrige3.core.dao.administration.program.ProgramDao.save(ProgramVO program) - 'program' can not be null");
         }
         try
         {
             return this.handleSave(program);
         }
         catch (Throwable th)
         {
             throw new RuntimeException(
             "Error performing 'ProgramDao.save(ProgramVO program)' --> " + th,
             th);
         }
     }
 
     /**
      * Performs the core logic for {@link #save(ProgramVO)}
      * @param program
      * @return ProgramVO
      * @throws Exception
      */
     protected abstract ProgramVO handleSave(ProgramVO program)
         throws Exception;
 
     /**
      * {@inheritDoc}
      */
     @Override
     public void updateDate(final String programCode)
     {
         if (programCode == null)
         {
             throw new IllegalArgumentException(
                 "fr.ifremer.quadrige3.core.dao.administration.program.ProgramDao.updateDate(String programCode) - 'programCode' can not be null");
         }
         try
         {
             this.handleUpdateDate(programCode);
         }
         catch (Throwable th)
         {
             throw new RuntimeException(
             "Error performing 'ProgramDao.updateDate(String programCode)' --> " + th,
             th);
         }
     }
 
     /**
      * Performs the core logic for {@link #updateDate(String)}
      * @param programCode
      * @return void
      * @throws Exception
      */
     protected abstract void handleUpdateDate(String programCode)
         throws Exception;
 
     /**
      * Allows transformation of entities into value objects
      * (or something else for that matter), when the <code>transform</code>
      * flag is set to one of the constants defined in <code>ProgramDao</code>, please note
      * that the {@link #TRANSFORM_NONE} constant denotes no transformation, so the entity itself
      * will be returned.
      * <p>
      * This method will return instances of these types:
      * <ul>
      *   <li>{@link Program} - {@link #TRANSFORM_NONE}</li>
      *   <li>{@link ProgramVO} - {@link #TRANSFORM_PROGRAMVO}</li>
      * </ul>
      *
      * If the integer argument value is unknown {@link #TRANSFORM_NONE} is assumed.
      *
      * @param transform one of the constants declared in {@link ProgramDao}
      * @param entity an entity that was found
      * @return the transformed entity (i.e. new value object, etc)
      * @see ProgramDao#transformEntity(int, Program)
      */
     public Object transformEntity(final int transform, final Program entity)
     {
         Object target = null;
         if (entity != null)
         {
             switch (transform)
             {
                 case TRANSFORM_PROGRAMVO :
                     target = toProgramVO(entity);
                     break;
                 case ProgramDao.TRANSFORM_NONE : // fall-through
                 default:
                     target = entity;
             }
         }
         return target;
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public void transformEntities(final int transform, final Collection<?> entities)
     {
         switch (transform)
         {
             case TRANSFORM_PROGRAMVO :
                 toProgramVOCollection(entities);
                 break;
             case ProgramDao.TRANSFORM_NONE : // fall-through
                 default:
                 // do nothing;
         }
     }
 
     /**
      * @see ProgramDao#toEntities(Collection)
      */
     public void toEntities(final Collection<?> results)
     {
         if (results != null)
         {
             CollectionUtils.transform(results, this.ENTITYTRANSFORMER);
         }
     }
 
     /**
      * This anonymous transformer is designed to transform report query results
      * (which result in an array of entities) to {@link Program}
      * using the Jakarta Commons-Collections Transformation API.
      */
     private Transformer ENTITYTRANSFORMER =
         new Transformer()
         {
             public Object transform(Object input)
             {
                 Object result = null;
                 if (input instanceof Object[])
                 {
                     result = toEntity((Object[])input);
                 }
                 else if (input instanceof Program)
                 {
                     result = input;
                 }
                 return result;
             }
         };
 
     /**
      * @param row
      * @return Program
      */
     protected Program toEntity(Object[] row)
     {
         Program target = null;
         if (row != null)
         {
             final int numberOfObjects = row.length;
             for (int ctr = 0; ctr < numberOfObjects; ctr++)
             {
                 final Object object = row[ctr];
                 if (object instanceof Program)
                 {
                     target = (Program)object;
                     break;
                 }
             }
         }
         return target;
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     @SuppressWarnings({"unchecked"})
     public final Collection<ProgramVO> toProgramVOCollection(Collection<?> entities)
     {
         Collection<ProgramVO> result = new ArrayList<ProgramVO>();
         if (entities != null)
         {
             CollectionUtils.transform(entities, this.PROGRAMVO_TRANSFORMER);
             result.addAll((Collection<? extends ProgramVO>) entities);
         }
         return result;
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     @SuppressWarnings({ "unchecked" })
     public final ProgramVO[] toProgramVOArray(Collection<?> entities)
     {
         ProgramVO[] result = null;
         if (entities != null)
         {
             // Unchecked transformation: reuses entities Collection
             final Collection collection = new ArrayList(entities);
             this.toProgramVOCollection(collection);
             result = (ProgramVO[]) collection.toArray(new ProgramVO[collection.size()]);
         }
         return result;
     }
 
     /**
      * Default implementation for transforming the results of a report query into a value object. This
      * implementation exists for convenience reasons only. It needs only be overridden in the
      * {@link ProgramDaoImpl} class if you intend to use reporting queries.
      * @param row
      * @return toProgramVO(this.toEntity(row))
      * @see ProgramDao#toProgramVO(Program)
      */
     protected ProgramVO toProgramVO(Object[] row)
     {
         return this.toProgramVO(this.toEntity(row));
     }
 
     /**
      * This anonymous transformer is designed to transform entities or report query results
      * (which result in an array of objects) to {@link ProgramVO}
      * using the Jakarta Commons-Collections Transformation API.
      */
     private Transformer PROGRAMVO_TRANSFORMER =
         new Transformer()
         {
             public Object transform(Object input)
             {
                 Object result = null;
                 if (input instanceof Program)
                 {
                     result = toProgramVO((Program)input);
                 }
                 else if (input instanceof Object[])
                 {
                     result = toProgramVO((Object[])input);
                 }
                 return result;
             }
         };
 
     /**
      * {@inheritDoc}
      */
     @Override
     public final void programVOToEntityCollection(Collection<?> instances)
     {
         if (instances != null)
         {
             for (final Iterator<?> iterator = instances.iterator(); iterator.hasNext();)
             {
                 // - remove an objects that are null or not of the correct instance
                 if (!(iterator.next() instanceof ProgramVO))
                 {
                     iterator.remove();
                 }
             }
             CollectionUtils.transform(instances, this.ProgramVOToEntityTransformer);
         }
     }
 
     private final Transformer ProgramVOToEntityTransformer =
         new Transformer()
         {
             public Object transform(Object input)
             {
                 return programVOToEntity((ProgramVO)input);
             }
         };
 
 
     /**
      * {@inheritDoc}
      */
     @Override
     public void toProgramVO(
         Program source,
         ProgramVO target)
     {
         target.setProgCd(source.getProgCd());
         target.setProgNm(source.getProgNm());
         target.setProgDc(source.getProgDc());
         target.setProgCreationDt(source.getProgCreationDt());
         target.setUpdateDt(source.getUpdateDt());
         target.setProgCm(source.getProgCm());
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public ProgramVO toProgramVO(final Program entity)
     {
         ProgramVO target = null;
         if (entity != null)
         {
             target =  new ProgramVO();
             this.toProgramVO(entity, target);
         }
         return target;
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public void programVOToEntity(
         ProgramVO source,
         Program target,
         boolean copyIfNull)
     {
         if (copyIfNull || source.getProgNm() != null)
         {
             target.setProgNm(source.getProgNm());
         }
         if (copyIfNull || source.getProgDc() != null)
         {
             target.setProgDc(source.getProgDc());
         }
         if (copyIfNull || source.getProgCreationDt() != null)
         {
             target.setProgCreationDt(source.getProgCreationDt());
         }
         if (copyIfNull || source.getUpdateDt() != null)
         {
             target.setUpdateDt(source.getUpdateDt());
         }
         if (copyIfNull || source.getProgCm() != null)
         {
             target.setProgCm(source.getProgCm());
         }
     }
 
     /**
      * Gets the current <code>principal</code> if one has been set,
      * otherwise returns <code>null</code>.
      *
      * @return the current principal
      */
     protected Principal getPrincipal()
     {
         return PrincipalStore.get();
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     @SuppressWarnings({ "unchecked" })
     public PaginationResult search(final int transform, final int pageNumber, final int pageSize, final Search search)
     {
         try
         {
             search.setPageNumber(pageNumber);
             search.setPageSize(pageSize);
             final PropertySearch propertySearch = new PropertySearch(
                 this.getSession(), ProgramImpl.class, search);
             final List results = propertySearch.executeAsList();
             this.transformEntities(transform, results);
             return new PaginationResult(results.toArray(new Object[results.size()]), propertySearch.getTotalCount());
         }
         catch (HibernateException ex)
         {
             throw ex; /*super.convertHibernateAccessException(ex);*/
         }
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public PaginationResult search(final int pageNumber, final int pageSize, final Search search)
     {
         return this.search(ProgramDao.TRANSFORM_NONE, pageNumber, pageSize, search);
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public Set<?> search(final int transform, final Search search)
     {
         try
         {
             final PropertySearch propertySearch = new PropertySearch(
                 this.getSession(), ProgramImpl.class, search);
             final Set<?> results = propertySearch.executeAsSet();
             this.transformEntities(transform, results);
             return results;
         }
         catch (HibernateException ex)
         {
             throw ex; /*super.convertHibernateAccessException(ex);*/
         }
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     @SuppressWarnings("unchecked")
     public Set<Program> search(final Search search)
     {
         return (Set<Program>) this.search(ProgramDao.TRANSFORM_NONE, search);
     }
 
     /**
      * Executes and returns the given Hibernate queryObject as a {@link PaginationResult} instance.
      * @param queryObject
      * @param transform
      * @param pageNumber
      * @param pageSize
      * @return PaginationResult
      */
     @SuppressWarnings({ "unchecked" })
     protected PaginationResult getPaginationResult(
         final Query queryObject,
         final int transform, int pageNumber, int pageSize)
     {
         try
         {
             final ScrollableResults scrollableResults = queryObject.scroll();
             scrollableResults.last();
             int totalCount = scrollableResults.getRowNumber();
             totalCount = totalCount >= 0 ? totalCount + 1 : 0;
             if (pageNumber > 0 && pageSize > 0)
             {
                 queryObject.setFirstResult(this.calculateFirstResult(pageNumber, pageSize));
                 queryObject.setMaxResults(pageSize);
             }
             // Unchecked transformation because Set object is reused, cannot be strongly typed.
             Set results = new LinkedHashSet(queryObject.list());
             transformEntities(transform, results);
             return new PaginationResult(results.toArray(new Object[results.size()]), totalCount);
         }
         catch (HibernateException ex)
         {
             throw ex; /*super.convertHibernateAccessException(ex);*/
         }
     }
 
     // spring-hibernate-dao-base merge-point
 }