cdmlib-services/src/main/java/eu/etaxonomy/cdm/api/service/IdentifiableServiceBase.java

   1 // $Id$
   2 /**
   3 * Copyright (C) 2007 EDIT
   4 * European Distributed Institute of Taxonomy
   5 * http://www.e-taxonomy.eu
   6 *
   7 * The contents of this file are subject to the Mozilla Public License Version 1.1
   8 * See LICENSE.TXT at the top of this package for the full license terms.
   9 */
  10
  11 package eu.etaxonomy.cdm.api.service;
  12
  13 import java.util.ArrayList;
  14 import java.util.Arrays;
  15 import java.util.HashMap;
  16 import java.util.HashSet;
  17 import java.util.List;
  18 import java.util.Map;
  19 import java.util.Set;
  20 import java.util.UUID;
  21
  22 import org.apache.log4j.Logger;
  23 import org.hibernate.criterion.Criterion;
  24 import org.springframework.transaction.annotation.Transactional;
  25
  26 import eu.etaxonomy.cdm.api.service.config.IIdentifiableEntityServiceConfigurator;
  27 import eu.etaxonomy.cdm.api.service.dto.FindByIdentifierDTO;
  28 import eu.etaxonomy.cdm.api.service.pager.Pager;
  29 import eu.etaxonomy.cdm.api.service.pager.impl.DefaultPagerImpl;
  30 import eu.etaxonomy.cdm.common.monitor.DefaultProgressMonitor;
  31 import eu.etaxonomy.cdm.common.monitor.IProgressMonitor;
  32 import eu.etaxonomy.cdm.hibernate.HibernateProxyHelper;
  33 import eu.etaxonomy.cdm.model.common.CdmBase;
  34 import eu.etaxonomy.cdm.model.common.DefinedTerm;
  35 import eu.etaxonomy.cdm.model.common.ISourceable;
  36 import eu.etaxonomy.cdm.model.common.IdentifiableEntity;
  37 import eu.etaxonomy.cdm.model.common.IdentifiableSource;
  38 import eu.etaxonomy.cdm.model.common.LSID;
  39 import eu.etaxonomy.cdm.model.common.UuidAndTitleCache;
  40 import eu.etaxonomy.cdm.model.media.Rights;
  41 import eu.etaxonomy.cdm.model.name.NonViralName;
  42 import eu.etaxonomy.cdm.model.reference.Reference;
  43 import eu.etaxonomy.cdm.model.reference.ReferenceFactory;
  44 import eu.etaxonomy.cdm.model.taxon.TaxonBase;
  45 import eu.etaxonomy.cdm.persistence.dao.common.IIdentifiableDao;
  46 import eu.etaxonomy.cdm.persistence.dao.hibernate.HibernateBeanInitializer;
  47 import eu.etaxonomy.cdm.persistence.dao.initializer.AutoPropertyInitializer;
  48 import eu.etaxonomy.cdm.persistence.query.MatchMode;
  49 import eu.etaxonomy.cdm.persistence.query.OrderHint;
  50 import eu.etaxonomy.cdm.persistence.query.OrderHint.SortOrder;
  51 import eu.etaxonomy.cdm.strategy.cache.common.IIdentifiableEntityCacheStrategy;
  52 import eu.etaxonomy.cdm.strategy.match.DefaultMatchStrategy;
  53 import eu.etaxonomy.cdm.strategy.match.IMatchStrategy;
  54 import eu.etaxonomy.cdm.strategy.match.IMatchable;
  55 import eu.etaxonomy.cdm.strategy.match.MatchException;
  56 import eu.etaxonomy.cdm.strategy.merge.IMergable;
  57 import eu.etaxonomy.cdm.strategy.merge.IMergeStrategy;
  58 import eu.etaxonomy.cdm.strategy.merge.MergeException;
  59
  60 public abstract class IdentifiableServiceBase<T extends IdentifiableEntity,DAO extends IIdentifiableDao<T>> extends AnnotatableServiceBase<T,DAO>
  61                                                 implements IIdentifiableEntityService<T>{
  62
  63
  64         protected static final int UPDATE_TITLE_CACHE_DEFAULT_STEP_SIZE = 1000;
  65         protected static final  Logger logger = Logger.getLogger(IdentifiableServiceBase.class);
  66
  67         @Override
  68         @Transactional(readOnly = true)
  69         public Pager<Rights> getRights(T t, Integer pageSize, Integer pageNumber, List<String> propertyPaths) {
  70         Integer numberOfResults = dao.countRights(t);
  71
  72                 List<Rights> results = new ArrayList<Rights>();
  73                 if(numberOfResults > 0) { // no point checking again //TODO use AbstractPagerImpl.hasResultsInRange(numberOfResults, pageNumber, pageSize)
  74                         results = dao.getRights(t, pageSize, pageNumber,propertyPaths);
  75                 }
  76
  77                 return new DefaultPagerImpl<Rights>(pageNumber, numberOfResults, pageSize, results);
  78         }
  79
  80         @Override
  81         @Transactional(readOnly = true)
  82         public Pager<IdentifiableSource> getSources(T t, Integer pageSize, Integer pageNumber, List<String> propertyPaths) {
  83                  Integer numberOfResults = dao.countSources(t);
  84
  85                  List<IdentifiableSource> results = new ArrayList<IdentifiableSource>();
  86                  if(numberOfResults > 0) { // no point checking again //TODO use AbstractPagerImpl.hasResultsInRange(numberOfResults, pageNumber, pageSize)
  87                          results = dao.getSources(t, pageSize, pageNumber,propertyPaths);
  88                  }
  89
  90                  return new DefaultPagerImpl<IdentifiableSource>(pageNumber, numberOfResults, pageSize, results);
  91         }
  92
  93
  94         @Transactional(readOnly = false)
  95         @Override
  96         public T replace(T x, T y) {
  97                 return dao.replace(x, y);
  98         }
  99         /**
 100          * FIXME Candidate for harmonization
 101          * Given that this method is strongly typed, and generic, could we not simply expose it as
 102          * List<T> findByTitle(String title) as it is somewhat less cumbersome. Admittedly, I don't
 103          * understand what is going on with the configurators etc. so maybe there is a good reason for
 104          * the design of this method.
 105          * @param title
 106          * @return
 107          */
 108         @Transactional(readOnly = true)
 109         protected List<T> findCdmObjectsByTitle(String title){
 110                 return ((IIdentifiableDao)dao).findByTitle(title);
 111         }
 112
 113         @Transactional(readOnly = true)
 114         protected List<T> findCdmObjectsByTitle(String title, Class<T> clazz){
 115                 return ((IIdentifiableDao)dao).findByTitleAndClass(title, clazz);
 116         }
 117         @Transactional(readOnly = true)
 118         protected List<T> findCdmObjectsByTitle(String title, CdmBase sessionObject){
 119                 return ((IIdentifiableDao)dao).findByTitle(title, sessionObject);
 120         }
 121
 122         /*
 123          * TODO - Migrated from CommonServiceBase
 124          *  (non-Javadoc)
 125          * @see eu.etaxonomy.cdm.api.service.ICommonService#getSourcedObjectById(java.lang.String, java.lang.String)
 126          */
 127         @Transactional(readOnly = true)
 128         @Override
 129         public ISourceable getSourcedObjectByIdInSource(Class clazz, String idInSource, String idNamespace) {
 130                 ISourceable result = null;
 131
 132                 List<T> list = dao.findOriginalSourceByIdInSource(idInSource, idNamespace);
 133                 if (! list.isEmpty()){
 134                         result = list.get(0);
 135                 }
 136                 return result;
 137         }
 138
 139         @Transactional(readOnly = true)
 140         @Override
 141         public List<UuidAndTitleCache<T>> getUuidAndTitleCache() {
 142                 return dao.getUuidAndTitleCache();
 143         }
 144
 145         @Transactional(readOnly = true)
 146         @Override
 147         public Pager<T> findByTitle(Class<? extends T> clazz, String queryString,MatchMode matchmode, List<Criterion> criteria, Integer pageSize, Integer pageNumber, List<OrderHint> orderHints, List<String> propertyPaths) {
 148                  Integer numberOfResults = dao.countByTitle(clazz, queryString, matchmode, criteria);
 149
 150                  List<T> results = new ArrayList<T>();
 151                  if(numberOfResults > 0) { // no point checking again //TODO use AbstractPagerImpl.hasResultsInRange(numberOfResults, pageNumber, pageSize)
 152                                 results = dao.findByTitle(clazz, queryString, matchmode, criteria, pageSize, pageNumber, orderHints, propertyPaths);
 153                  }
 154
 155                   return new DefaultPagerImpl<T>(pageNumber, numberOfResults, pageSize, results);
 156         }
 157
 158         @Transactional(readOnly = true)
 159         @Override
 160         public Pager<T> findByTitle(IIdentifiableEntityServiceConfigurator<T> config){
 161                 return findByTitle(config.getClazz(), config.getTitleSearchStringSqlized(), config.getMatchMode(), config.getCriteria(), config.getPageSize(), config.getPageNumber(), config.getOrderHints(), config.getPropertyPaths());
 162         }
 163
 164         @Transactional(readOnly = true)
 165         @Override
 166         public List<T> listByTitle(Class<? extends T> clazz, String queryString,MatchMode matchmode, List<Criterion> criteria, Integer pageSize, Integer pageNumber, List<OrderHint> orderHints, List<String> propertyPaths) {
 167                  Integer numberOfResults = dao.countByTitle(clazz, queryString, matchmode, criteria);
 168
 169                  List<T> results = new ArrayList<T>();
 170                  if(numberOfResults > 0) { // no point checking again //TODO use AbstractPagerImpl.hasResultsInRange(numberOfResults, pageNumber, pageSize)
 171                                 results = dao.findByTitle(clazz, queryString, matchmode, criteria, pageSize, pageNumber, orderHints, propertyPaths);
 172                  }
 173                  return results;
 174         }
 175
 176         @Transactional(readOnly = true)
 177         @Override
 178         public Pager<T> findTitleCache(Class<? extends T> clazz, String queryString, Integer pageSize, Integer pageNumber, List<OrderHint> orderHints, MatchMode matchMode){
 179                 long numberOfResults = dao.countTitleCache(clazz, queryString, matchMode);
 180
 181                  List<T> results = new ArrayList<T>();
 182                  if(numberOfResults > 0) { // no point checking again //TODO use AbstractPagerImpl.hasResultsInRange(numberOfResults, pageNumber, pageSize)
 183                                 results = dao.findTitleCache(clazz, queryString, pageSize, pageNumber, orderHints, matchMode);
 184                  }
 185                  int r = 0;
 186                  r += numberOfResults;
 187
 188                   return new DefaultPagerImpl<T>(pageNumber, r , pageSize, results);
 189         }
 190
 191         @Transactional(readOnly = true)
 192         @Override
 193         public List<T> listByReferenceTitle(Class<? extends T> clazz, String queryString,MatchMode matchmode, List<Criterion> criteria, Integer pageSize, Integer pageNumber, List<OrderHint> orderHints, List<String> propertyPaths) {
 194                  Integer numberOfResults = dao.countByReferenceTitle(clazz, queryString, matchmode, criteria);
 195
 196                  List<T> results = new ArrayList<T>();
 197                  if(numberOfResults > 0) { // no point checking again //TODO use AbstractPagerImpl.hasResultsInRange(numberOfResults, pageNumber, pageSize)
 198                                 results = dao.findByReferenceTitle(clazz, queryString, matchmode, criteria, pageSize, pageNumber, orderHints, propertyPaths);
 199                  }
 200                  return results;
 201         }
 202
 203         @Transactional(readOnly = true)
 204         @Override
 205         public T find(LSID lsid) {
 206                 return dao.find(lsid);
 207         }
 208
 209         @Transactional(readOnly = true)
 210         @Override
 211         public Pager<T> search(Class<? extends T> clazz, String queryString, Integer pageSize, Integer pageNumber, List<OrderHint> orderHints, List<String> propertyPaths) {
 212         Integer numberOfResults = dao.count(clazz,queryString);
 213
 214                 List<T> results = new ArrayList<T>();
 215                 if(numberOfResults > 0) { // no point checking again //TODO use AbstractPagerImpl.hasResultsInRange(numberOfResults, pageNumber, pageSize)
 216                         results = dao.search(clazz,queryString, pageSize, pageNumber, orderHints, propertyPaths);
 217                 }
 218
 219                 return new DefaultPagerImpl<T>(pageNumber, numberOfResults, pageSize, results);
 220         }
 221
 222         @Override
 223         @Transactional(readOnly = false)
 224         public void updateTitleCache() {
 225                 updateTitleCache(null, null, null, null);
 226         }
 227
 228         @Transactional(readOnly = false)  //TODO check transactional behaviour, e.g. what happens with the session if count is very large
 229         protected <S extends T > void updateTitleCacheImpl(Class<S> clazz, Integer stepSize, IIdentifiableEntityCacheStrategy<T> cacheStrategy, IProgressMonitor monitor) {
 230                 if (stepSize == null){
 231                         stepSize = UPDATE_TITLE_CACHE_DEFAULT_STEP_SIZE;
 232                 }
 233                 if (monitor == null){
 234                         monitor = DefaultProgressMonitor.NewInstance();
 235                 }
 236
 237                 int count = dao.count(clazz);
 238                 monitor.beginTask("update titles", count);
 239                 int worked = 0;
 240                 for(int i = 0 ; i < count ; i = i + stepSize){
 241                         // not sure if such strict ordering is necessary here, but for safety reasons I do it
 242                         ArrayList<OrderHint> orderHints = new ArrayList<OrderHint>();
 243                         orderHints.add( new OrderHint("id", OrderHint.SortOrder.ASCENDING));
 244
 245
 246                         Map<Class<? extends CdmBase>, AutoPropertyInitializer<CdmBase>> oldAutoInit = switchOfAutoinitializer();
 247                         List<S> list = this.list(clazz, stepSize, i, orderHints, null);
 248                         switchOnOldAutoInitializer(oldAutoInit);
 249
 250                         List<T> entitiesToUpdate = new ArrayList<T>();
 251                         for (T entity : list){
 252                                 HibernateProxyHelper.deproxy(entity, clazz);
 253                                 if (entity.isProtectedTitleCache() == false){
 254                                         updateTitleCacheForSingleEntity(cacheStrategy, entitiesToUpdate, entity);
 255                                 }
 256                                 worked++;
 257                         }
 258                         for (T entity: entitiesToUpdate){
 259                                 if (entity.getTitleCache() != null){
 260                                         //System.err.println(entity.getTitleCache());
 261                                 }else{
 262                                         //System.err.println("no titleCache" + ((NonViralName)entity).getNameCache());
 263                                 }
 264                         }
 265                         saveOrUpdate(entitiesToUpdate);
 266                         monitor.worked(list.size());
 267                         if (monitor.isCanceled()){
 268                                 monitor.done();
 269                                 return;
 270                         }
 271                 }
 272                 monitor.done();
 273         }
 274
 275         /**
 276          * Brings back all auto initializers to the bean initializer
 277          * @see #switchOfAutoinitializer()
 278          * @param oldAutoInit
 279          */
 280         protected void switchOnOldAutoInitializer(
 281                         Map<Class<? extends CdmBase>, AutoPropertyInitializer<CdmBase>> oldAutoInit) {
 282                 HibernateBeanInitializer initializer = (HibernateBeanInitializer)this.appContext.getBean("defaultBeanInitializer");
 283                 initializer.setBeanAutoInitializers(oldAutoInit);
 284         }
 285
 286         /**
 287          * Removes all auto initializers from the bean initializer
 288          *
 289          * @see #switchOnOldAutoInitializer(Map)
 290          * @return
 291          */
 292         protected Map<Class<? extends CdmBase>, AutoPropertyInitializer<CdmBase>> switchOfAutoinitializer() {
 293                 HibernateBeanInitializer initializer = (HibernateBeanInitializer)this.appContext.getBean("defaultBeanInitializer");
 294                 Map<Class<? extends CdmBase>, AutoPropertyInitializer<CdmBase>> oldAutoInitializers = initializer.getBeanAutoInitializers();
 295                 Map<Class<? extends CdmBase>, AutoPropertyInitializer<CdmBase>> map = new HashMap<Class<? extends CdmBase>, AutoPropertyInitializer<CdmBase>>();
 296                 initializer.setBeanAutoInitializers(map);
 297                 return oldAutoInitializers;
 298         }
 299
 300         /**
 301          * @param cacheStrategy
 302          * @param entitiesToUpdate
 303          * @param entity
 304          */
 305         /**
 306          * @param cacheStrategy
 307          * @param entitiesToUpdate
 308          * @param entity
 309          */
 310         private void updateTitleCacheForSingleEntity(
 311                         IIdentifiableEntityCacheStrategy<T> cacheStrategy,
 312                         List<T> entitiesToUpdate, T entity) {
 313
 314                 assert (entity.isProtectedTitleCache() == false );
 315
 316                 //exclude recursive inreferences
 317                 if (entity.isInstanceOf(Reference.class)){
 318                         Reference<?> ref = CdmBase.deproxy(entity, Reference.class);
 319                         if (ref.getInReference() != null && ref.getInReference().equals(ref)){
 320                                 return;
 321                         }
 322                 }
 323
 324
 325                 //define the correct cache strategy
 326                 IIdentifiableEntityCacheStrategy entityCacheStrategy = cacheStrategy;
 327                 if (entityCacheStrategy == null){
 328                         entityCacheStrategy = entity.getCacheStrategy();
 329                         //FIXME find out why the wrong cache strategy is loaded here, see #1876
 330                         if (entity instanceof Reference){
 331                                 entityCacheStrategy = ReferenceFactory.newReference(((Reference<?>)entity).getType()).getCacheStrategy();
 332                         }
 333                 }
 334                 entity.setCacheStrategy(entityCacheStrategy);
 335
 336
 337                 //old titleCache
 338                 entity.setProtectedTitleCache(true);
 339                 String oldTitleCache = entity.getTitleCache();
 340                 entity.setTitleCache(oldTitleCache, false);   //before we had entity.setProtectedTitleCache(false) but this deleted the titleCache itself
 341
 342                 //NonViralNames and Reference have more caches //TODO handle in NameService
 343                 String oldNameCache = null;
 344                 String oldFullTitleCache = null;
 345                 String oldAbbrevTitleCache = null;
 346                 if (entity instanceof NonViralName ){
 347
 348                         try{
 349                                 NonViralName<?> nvn = (NonViralName) entity;
 350                                 if (!nvn.isProtectedNameCache()){
 351                                         nvn.setProtectedNameCache(true);
 352                                         oldNameCache = nvn.getNameCache();
 353                                         nvn.setProtectedNameCache(false);
 354                                 }
 355                                 if (!nvn.isProtectedFullTitleCache()){
 356                                         nvn.setProtectedFullTitleCache(true);
 357                                         oldFullTitleCache = nvn.getFullTitleCache();
 358                                         nvn.setProtectedFullTitleCache(false);
 359                                 }
 360                         }catch(ClassCastException e){
 361                                 System.out.println("entity: " + entity.getTitleCache());
 362                         }
 363
 364                 }else if (entity instanceof Reference){
 365                         Reference<?> ref = (Reference<?>) entity;
 366                         if (!ref.isProtectedAbbrevTitleCache()){
 367                                 ref.setProtectedAbbrevTitleCache(true);
 368                                 oldAbbrevTitleCache = ref.getAbbrevTitleCache();
 369                                 ref.setProtectedAbbrevTitleCache(false);
 370                         }
 371                 }
 372                 setOtherCachesNull(entity);
 373                 String newTitleCache= null;
 374                 NonViralName<?> nvn = null;//TODO find better solution
 375                 try{
 376                         if (entity instanceof NonViralName){
 377                                 nvn = (NonViralName) entity;
 378                                 newTitleCache = entityCacheStrategy.getTitleCache(nvn);
 379                         } else{
 380                                  newTitleCache = entityCacheStrategy.getTitleCache(entity);
 381                         }
 382                 }catch (ClassCastException e){
 383                         nvn = HibernateProxyHelper.deproxy(entity, NonViralName.class);
 384                         newTitleCache = entityCacheStrategy.getTitleCache(nvn);
 385                         //System.out.println("titleCache: " +entity.getTitleCache());
 386                 }
 387
 388                 if ( oldTitleCache == null   || oldTitleCache != null && ! oldTitleCache.equals(newTitleCache) ){
 389                         entity.setTitleCache(null, false);
 390                         String newCache = entity.getTitleCache();
 391                         if (newCache == null){
 392                                 logger.warn("newCache should never be null");
 393                         }
 394                         if (oldTitleCache == null){
 395                                 logger.info("oldTitleCache should never be null");
 396                         }
 397                         if (nvn != null){
 398                                 //NonViralName<?> nvn = (NonViralName) entity;
 399                                 nvn.getNameCache();
 400                                 nvn.getFullTitleCache();
 401                         }
 402                         if (entity instanceof Reference){
 403                                 Reference<?> ref = (Reference<?>) entity;
 404                                 ref.getAbbrevTitleCache();
 405                         }
 406                         entitiesToUpdate.add(entity);
 407                 }else if (nvn != null){
 408                         //NonViralName<?> nvn = (NonViralName) entity;
 409                         String newNameCache = nvn.getNameCache();
 410                         String newFullTitleCache = nvn.getFullTitleCache();
 411                         if ((oldNameCache == null && !nvn.isProtectedNameCache()) || (oldNameCache != null && !oldNameCache.equals(newNameCache))){
 412                                 entitiesToUpdate.add(entity);
 413                         }else if ((oldFullTitleCache == null && !nvn.isProtectedFullTitleCache()) || (oldFullTitleCache != null && !oldFullTitleCache.equals(newFullTitleCache))){
 414                                 entitiesToUpdate.add(entity);
 415                         }
 416                 }else if (entity instanceof Reference){
 417                         Reference<?> ref = (Reference<?>) entity;
 418                         String newAbbrevTitleCache = ref.getAbbrevTitleCache();
 419                         if ( (oldAbbrevTitleCache == null && !ref.isProtectedAbbrevTitleCache() ) || (oldAbbrevTitleCache != null && !oldAbbrevTitleCache.equals(newAbbrevTitleCache))){
 420                                 entitiesToUpdate.add(entity);
 421                         }
 422                 }
 423
 424
 425         }
 426
 427
 428
 429         /**
 430          * Needs override if not only the title cache should be set to null to
 431          * generate the correct new title cache
 432          */
 433         protected void setOtherCachesNull(T entity) {
 434                 return;
 435         }
 436
 437
 438
 439         private class DeduplicateState{
 440                 String lastTitleCache;
 441                 Integer pageSize = 50;
 442                 int nPages = 3;
 443                 int startPage = 0;
 444                 boolean isCompleted = false;
 445                 int result;
 446         }
 447
 448         @Override
 449         @Transactional(readOnly = false)
 450         public int deduplicate(Class<? extends T> clazz, IMatchStrategy matchStrategy, IMergeStrategy mergeStrategy) {
 451                 DeduplicateState dedupState = new DeduplicateState();
 452
 453                 if (clazz == null){
 454                         logger.warn("Deduplication clazz must not be null!");
 455                         return 0;
 456                 }
 457                 if (! ( IMatchable.class.isAssignableFrom(clazz) && IMergable.class.isAssignableFrom(clazz) )  ){
 458                         logger.warn("Deduplication implemented only for classes implementing IMatchable and IMergeable. No deduplication performed!");
 459                         return 0;
 460                 }
 461                 Class matchableClass = clazz;
 462                 if (matchStrategy == null){
 463                         matchStrategy = DefaultMatchStrategy.NewInstance(matchableClass);
 464                 }
 465                 List<T> nextGroup = new ArrayList<T>();
 466
 467                 int result = 0;
 468 //              double countTotal = count(clazz);
 469 //
 470 //              Number countPagesN = Math.ceil(countTotal/dedupState.pageSize.doubleValue()) ;
 471 //              int countPages = countPagesN.intValue();
 472 //
 473
 474                 List<OrderHint> orderHints = Arrays.asList(new OrderHint[]{new OrderHint("titleCache", SortOrder.ASCENDING)});
 475
 476                 while (! dedupState.isCompleted){
 477                         //get x page sizes
 478                         List<T> objectList = getPages(clazz, dedupState, orderHints);
 479                         //after each page check if any changes took place
 480                         int nUnEqualPages = handleAllPages(objectList, dedupState, nextGroup, matchStrategy, mergeStrategy);
 481                         nUnEqualPages = nUnEqualPages + dedupState.pageSize * dedupState.startPage;
 482                         //refresh start page counter
 483                         int finishedPages = nUnEqualPages / dedupState.pageSize;
 484                         dedupState.startPage = finishedPages;
 485                 }
 486
 487                 result += handleLastGroup(nextGroup, matchStrategy, mergeStrategy);
 488                 return result;
 489         }
 490
 491
 492         private int handleAllPages(List<T> objectList, DeduplicateState dedupState, List<T> nextGroup, IMatchStrategy matchStrategy, IMergeStrategy mergeStrategy) {
 493                 int nUnEqual = 0;
 494                 for (T object : objectList){
 495                         String currentTitleCache = object.getTitleCache();
 496                         if (currentTitleCache != null && currentTitleCache.equals(dedupState.lastTitleCache)){
 497                                 //=titleCache
 498                                 nextGroup.add(object);
 499                         }else{
 500                                 //<> titleCache
 501                                 dedupState.result += handleLastGroup(nextGroup, matchStrategy, mergeStrategy);
 502                                 nextGroup = new ArrayList<T>();
 503                                 nextGroup.add(object);
 504                                 nUnEqual++;
 505                         }
 506                         dedupState.lastTitleCache = currentTitleCache;
 507                 }
 508                 handleLastGroup(nextGroup, matchStrategy, mergeStrategy);
 509                 return nUnEqual;
 510         }
 511
 512         private List<T> getPages(Class<? extends T> clazz, DeduplicateState dedupState, List<OrderHint> orderHints) {
 513                 List<T> result = new ArrayList<T>();
 514                 for (int pageNo = dedupState.startPage; pageNo < dedupState.startPage + dedupState.nPages; pageNo++){
 515                         List<T> objectList = listByTitle(clazz, null, null, null, dedupState.pageSize, pageNo, orderHints, null);
 516                         result.addAll(objectList);
 517                 }
 518                 if (result.size()< dedupState.nPages * dedupState.pageSize ){
 519                         dedupState.isCompleted = true;
 520                 }
 521                 return result;
 522         }
 523
 524         private int handleLastGroup(List<T> group, IMatchStrategy matchStrategy, IMergeStrategy mergeStrategy) {
 525                 int result = 0;
 526                 int size = group.size();
 527                 Set<Integer> exclude = new HashSet<Integer>();  //set to collect all objects, that have been merged already
 528                 for (int i = 0; i < size - 1; i++){
 529                         if (exclude.contains(i)){
 530                                 continue;
 531                         }
 532                         for (int j = i + 1; j < size; j++){
 533                                 if (exclude.contains(j)){
 534                                         continue;
 535                                 }
 536                                 T firstObject = group.get(i);
 537                                 T secondObject = group.get(j);
 538
 539                                 try {
 540                                         if (matchStrategy.invoke((IMatchable)firstObject, (IMatchable)secondObject)){
 541                                                 commonService.merge((IMergable)firstObject, (IMergable)secondObject, mergeStrategy);
 542                                                 exclude.add(j);
 543                                                 result++;
 544                                         }
 545                                 } catch (MatchException e) {
 546                                         logger.warn("MatchException when trying to match " + firstObject.getTitleCache());
 547                                         e.printStackTrace();
 548                                 } catch (MergeException e) {
 549                                         logger.warn("MergeException when trying to merge " + firstObject.getTitleCache());
 550                                         e.printStackTrace();
 551                                 }
 552                         }
 553                 }
 554                 return result;
 555         }
 556
 557         @Transactional(readOnly = true)
 558         @Override
 559         public Integer countByTitle(Class<? extends T> clazz, String queryString,MatchMode matchmode, List<Criterion> criteria){
 560                  Integer numberOfResults = dao.countByTitle(clazz, queryString, matchmode, criteria);
 561
 562                  return numberOfResults;
 563         }
 564
 565         @Transactional(readOnly = true)
 566         @Override
 567         public Integer countByTitle(IIdentifiableEntityServiceConfigurator<T> config){
 568                 return countByTitle(config.getClazz(), config.getTitleSearchStringSqlized(),
 569                                 config.getMatchMode(), config.getCriteria());
 570
 571         }
 572
 573         @Override
 574         @Transactional(readOnly = true)
 575         public <S extends T> Pager<FindByIdentifierDTO<S>> findByIdentifier(
 576                         Class<S> clazz, String identifier, DefinedTerm identifierType, MatchMode matchmode,
 577                         boolean includeEntity, Integer pageSize,
 578                         Integer pageNumber,     List<String> propertyPaths) {
 579
 580                 Integer numberOfResults = dao.countByIdentifier(clazz, identifier, identifierType, matchmode);
 581         List<Object[]> daoResults = new ArrayList<Object[]>();
 582         if(numberOfResults > 0) { // no point checking again
 583                 daoResults = dao.findByIdentifier(clazz, identifier, identifierType,
 584                                 matchmode, includeEntity, pageSize, pageNumber, propertyPaths);
 585         }
 586
 587         List<FindByIdentifierDTO<S>> result = new ArrayList<FindByIdentifierDTO<S>>();
 588         for (Object[] daoObj : daoResults){
 589                 if (includeEntity){
 590                         result.add(new FindByIdentifierDTO<S>((DefinedTerm)daoObj[0], (String)daoObj[1], (S)daoObj[2]));
 591                 }else{
 592                         result.add(new FindByIdentifierDTO<S>((DefinedTerm)daoObj[0], (String)daoObj[1], (UUID)daoObj[2], (String)daoObj[3]));
 593                 }
 594         }
 595                 return new DefaultPagerImpl<FindByIdentifierDTO<S>>(pageNumber, numberOfResults, pageSize, result);
 596         }
 597
 598
 599 }
 600