merge from trunk
[taxeditor.git] / eu.etaxonomy.taxeditor.store / src / main / java / eu / etaxonomy / taxeditor / store / SearchManager.java
index 952bf050309e23747a8b27e727d2a71919093380..5aab63bc8e094599ba57b38e9a5f651e7c4686e7 100644 (file)
@@ -1,9 +1,9 @@
 // $Id$
 /**
 * Copyright (C) 2007 EDIT
-* European Distributed Institute of Taxonomy 
+* European Distributed Institute of Taxonomy
 * http://www.e-taxonomy.eu
-* 
+*
 * The contents of this file are subject to the Mozilla Public License Version 1.1
 * See LICENSE.TXT at the top of this package for the full license terms.
 */
@@ -24,19 +24,20 @@ import eu.etaxonomy.cdm.api.service.IOccurrenceService;
 import eu.etaxonomy.cdm.api.service.IReferenceService;
 import eu.etaxonomy.cdm.api.service.ITaxonService;
 import eu.etaxonomy.cdm.api.service.IUserService;
+import eu.etaxonomy.cdm.api.service.config.IFindTaxaAndNamesConfigurator;
 import eu.etaxonomy.cdm.api.service.config.IIdentifiableEntityServiceConfigurator;
-import eu.etaxonomy.cdm.api.service.config.ITaxonServiceConfigurator;
 import eu.etaxonomy.cdm.model.agent.AgentBase;
 import eu.etaxonomy.cdm.model.agent.TeamOrPersonBase;
 import eu.etaxonomy.cdm.model.common.Group;
-import eu.etaxonomy.cdm.model.common.IIdentifiableEntity;
+import eu.etaxonomy.cdm.model.common.IdentifiableEntity;
 import eu.etaxonomy.cdm.model.common.RelationshipBase;
 import eu.etaxonomy.cdm.model.common.User;
 import eu.etaxonomy.cdm.model.common.UuidAndTitleCache;
 import eu.etaxonomy.cdm.model.name.NameRelationship;
 import eu.etaxonomy.cdm.model.name.TaxonNameBase;
-import eu.etaxonomy.cdm.model.occurrence.DerivedUnitBase;
+import eu.etaxonomy.cdm.model.occurrence.DerivedUnit;
 import eu.etaxonomy.cdm.model.occurrence.SpecimenOrObservationBase;
+import eu.etaxonomy.cdm.model.occurrence.SpecimenOrObservationType;
 import eu.etaxonomy.cdm.model.reference.Reference;
 import eu.etaxonomy.cdm.model.taxon.TaxonBase;
 import eu.etaxonomy.taxeditor.preference.IPreferenceKeys;
@@ -48,16 +49,16 @@ import eu.etaxonomy.taxeditor.preference.PreferencesUtil;
  * @version 1.0
  */
 public class SearchManager {
-       
+
        public static final List NO_RESULTS = Arrays.asList(new Object[]{});
-       
+
        public static final String WILDCARD = "*";
-       
+
        public static int NO_COUNT = -1;
-       
+
        // TODO make this configurable via preferences
-       private static final int MAX_RESULTS_BEFORE_WARNING = 500; 
-       
+       private static final int MAX_RESULTS_BEFORE_WARNING = 500;
+
        /**
         * <p>findNames</p>
         *
@@ -70,25 +71,25 @@ public class SearchManager {
                }
                return NO_RESULTS;
        }
-       
+
        public List<NameRelationship> findNameRelationships(
                        IIdentifiableEntityServiceConfigurator configurator) {
                if(true){
                        return NO_RESULTS;
                }
-               
-               List<NameRelationship> relationships = new ArrayList<NameRelationship>(); 
+
+               List<NameRelationship> relationships = new ArrayList<NameRelationship>();
                List<RelationshipBase> all = CdmStore.getService(INameService.class).getAllRelationships(0, 0);
-               
+
                for (RelationshipBase relationship : all){
                        if(relationship instanceof NameRelationship){
                                relationships.add((NameRelationship) relationship);
                        }
                }
-               
-               
+
+
                return relationships;
-               
+
        }
 
        /**
@@ -97,11 +98,13 @@ public class SearchManager {
         * @param configurator a {@link eu.etaxonomy.cdm.api.service.config.ITaxonServiceConfigurator} object.
         * @return a {@link java.util.List} object.
         */
-       public List<UuidAndTitleCache<TaxonBase>> findTaxaAndNames(ITaxonServiceConfigurator configurator){
+       public List<UuidAndTitleCache<IdentifiableEntity>> findTaxaAndNames(IFindTaxaAndNamesConfigurator<TaxonBase> configurator){
                return CdmStore.getService(ITaxonService.class).findTaxaAndNamesForEditor(configurator);
        }
+
        
        
+
        /**
         * <p>findReferences</p>
         *
@@ -114,8 +117,8 @@ public class SearchManager {
                }
                return NO_RESULTS;
        }
-       
-       
+
+
        /**
         * <p>findAgents</p>
         *
@@ -139,57 +142,100 @@ public class SearchManager {
                configurator.setClazz(TeamOrPersonBase.class);
                return findAgents(configurator);
        }
-       
-       
+
        /**
-        * <p>findOccurrences</p>
+        * Searches for {@link SpecimenOrObservationBase} with the parameters specified in the
+        * {@link IIdentifiableEntityServiceConfigurator}<br>
+        * <br>
+        * Note: FieldUnits are omitted by default. See {@link #findOccurrences(IIdentifiableEntityServiceConfigurator, boolean)}
         *
-        * @param configurator a {@link eu.etaxonomy.cdm.api.service.config.IIdentifiableEntityServiceConfigurator} object.
-        * @return a {@link java.util.List} object.
+        * @param configurator the configurator to use for the search
+        * @return a list of the SpecimenOrObservationBases matching the search parameters found
         */
        public List<SpecimenOrObservationBase> findOccurrences(IIdentifiableEntityServiceConfigurator configurator){
-               // by default we do not show field observations. This may be configured via preferences
-               boolean showFieldObservations = PreferencesUtil.getPreferenceStore().getBoolean(IPreferenceKeys.BULK_EDITOR_OCCURRENCE_SHOW_FIELD_OBSERVATIONS);
-               if(! showFieldObservations){
-                       configurator.setClazz(DerivedUnitBase.class);
+           // by default we do not show field units. This may be configured via preferences
+           return findOccurrences(configurator, PreferencesUtil.getPreferenceStore().getBoolean(IPreferenceKeys.BULK_EDITOR_OCCURRENCE_SHOW_FIELD_UNITS));
+       }
+
+
+       /**
+        * Searches for {@link SpecimenOrObservationBase} with the parameters specified in the
+        * {@link IIdentifiableEntityServiceConfigurator}
+        *
+        * @param configurator the configurator to use for the search
+        * @return a list of the SpecimenOrObservationBases found
+        * @param showFieldUnits if <code>true</code> then also FieldUnits are searched
+        * @return
+        */
+       public List<SpecimenOrObservationBase> findOccurrences(IIdentifiableEntityServiceConfigurator configurator, boolean showFieldUnits){
+               if(! showFieldUnits){
+                       configurator.setClazz(DerivedUnit.class);
                }
                if(checkLargeResult(CdmStore.getService(IOccurrenceService.class).countByTitle(configurator))){
                        return CdmStore.getService(IOccurrenceService.class).findByTitle(configurator).getRecords();
                }
                return NO_RESULTS;
        }
-       
-       
+
+       /**
+     * Searches for {@link SpecimenOrObservationBase} with the parameters specified in the {@link IIdentifiableEntityServiceConfigurator}
+     * which match the given {@link SpecimenOrObservationType}
+        * @param configurator the configurator to use for the search
+        * @param type the type/record basis the specimens must have
+        * @return a list of the SpecimenOrObservationBases matching the search parameters found
+
+        * @deprecated method needs to be optimized with a direct SQL query instead of iterating over all specimens
+        */
+       @Deprecated
+       //TODO: method needs to be optimized with a direct SQL query instead of iterating over all specimens
+    public List<SpecimenOrObservationBase> findOccurrencesByType(IIdentifiableEntityServiceConfigurator configurator, SpecimenOrObservationType type){
+           List<SpecimenOrObservationBase> filteredOccurrences = new ArrayList<SpecimenOrObservationBase>();
+           List<SpecimenOrObservationBase> occurrences = findOccurrences(configurator, true);
+           if(type!=null){
+               for(SpecimenOrObservationBase occurrence:occurrences){
+                   if(occurrence.getRecordBasis().equals(type)
+                           || occurrence.getRecordBasis().isKindOf(type)
+                           || type == SpecimenOrObservationType.Unknown){
+                       filteredOccurrences.add(occurrence);
+                   }
+               }
+           }
+           else{
+               filteredOccurrences = occurrences;
+           }
+           return filteredOccurrences;
+       }
+
        public List<User> findUsers(IIdentifiableEntityServiceConfigurator configurator){
                String userNameSearchString = sqlizeTitleSearchString(configurator);
                // TODO why are users not identifiable entities?
                return CdmStore.getService(IUserService.class).listByUsername(userNameSearchString, null, null, null, null, null, null);
        }
-       
-       
+
+
        public List<Group> findGroups(IIdentifiableEntityServiceConfigurator configurator){
                String groupNameSearchString = sqlizeTitleSearchString(configurator);
                // TODO why are groups not identifiable entities?
                return CdmStore.getService(IGroupService.class).listByName(groupNameSearchString, null, null, null, null, null, null);
        }
-       
-       
+
+
        /**
         * @param count
         * @return
         */
        private boolean checkLargeResult(int count) {
                if(count > MAX_RESULTS_BEFORE_WARNING){
-                       return MessageDialog.openConfirm(Display.getDefault().getActiveShell(), "Large result expected", 
+                       return MessageDialog.openConfirm(Display.getDefault().getActiveShell(), "Large result expected",
                                        String.format("The current search will return %s objects. This will " +
                                                        "take a long time and/or might render the editor unusable. Please consider refining your search.", count));
                }else{
                        return true;
-               }               
+               }
        }
-       
+
        /**
-        * 
+        *
         * @param configurator
         * @return
         */
@@ -197,5 +243,12 @@ public class SearchManager {
                return configurator.getTitleSearchString().replace(WILDCARD, "%");
        }
 
+       public List findTaxa(IIdentifiableEntityServiceConfigurator configurator) {
+               if(checkLargeResult(CdmStore.getService(ITaxonService.class).countByTitle(configurator))){
+                       return CdmStore.getService(ITaxonService.class).findByTitle(configurator).getRecords();
+               }
+               return NO_RESULTS;
+       }
+
 
 }