Project

General

Profile

Download (11.1 KB) Statistics
| Branch: | Tag: | Revision:
1
/**
2
* Copyright (C) 2007 EDIT
3
* European Distributed Institute of Taxonomy
4
* http://www.e-taxonomy.eu
5
*
6
* The contents of this file are subject to the Mozilla Public License Version 1.1
7
* See LICENSE.TXT at the top of this package for the full license terms.
8
*/
9

    
10
package eu.etaxonomy.taxeditor.store;
11

    
12
import java.util.ArrayList;
13
import java.util.Arrays;
14
import java.util.List;
15
import java.util.UUID;
16

    
17
import org.eclipse.jface.dialogs.MessageDialog;
18
import org.eclipse.swt.widgets.Display;
19

    
20
import eu.etaxonomy.cdm.api.conversation.ConversationHolder;
21
import eu.etaxonomy.cdm.api.service.IAgentService;
22
import eu.etaxonomy.cdm.api.service.IGroupService;
23
import eu.etaxonomy.cdm.api.service.IMediaService;
24
import eu.etaxonomy.cdm.api.service.INameService;
25
import eu.etaxonomy.cdm.api.service.IOccurrenceService;
26
import eu.etaxonomy.cdm.api.service.IReferenceService;
27
import eu.etaxonomy.cdm.api.service.IService;
28
import eu.etaxonomy.cdm.api.service.ITaxonService;
29
import eu.etaxonomy.cdm.api.service.IUserService;
30
import eu.etaxonomy.cdm.api.service.config.IFindTaxaAndNamesConfigurator;
31
import eu.etaxonomy.cdm.api.service.config.IIdentifiableEntityServiceConfigurator;
32
import eu.etaxonomy.cdm.model.agent.AgentBase;
33
import eu.etaxonomy.cdm.model.agent.TeamOrPersonBase;
34
import eu.etaxonomy.cdm.model.common.Group;
35
import eu.etaxonomy.cdm.model.common.ICdmBase;
36
import eu.etaxonomy.cdm.model.common.IdentifiableEntity;
37
import eu.etaxonomy.cdm.model.common.RelationshipBase;
38
import eu.etaxonomy.cdm.model.common.User;
39
import eu.etaxonomy.cdm.model.media.Media;
40
import eu.etaxonomy.cdm.model.name.NameRelationship;
41
import eu.etaxonomy.cdm.model.name.TaxonName;
42
import eu.etaxonomy.cdm.model.occurrence.SpecimenOrObservationBase;
43
import eu.etaxonomy.cdm.model.reference.Reference;
44
import eu.etaxonomy.cdm.model.taxon.TaxonBase;
45
import eu.etaxonomy.cdm.persistence.dto.UuidAndTitleCache;
46
import eu.etaxonomy.taxeditor.l10n.Messages;
47
import eu.etaxonomy.taxeditor.preference.IPreferenceKeys;
48
import eu.etaxonomy.taxeditor.preference.PreferencesUtil;
49

    
50
/**
51
 * @author n.hoffmann
52
 * @created Dec 8, 2010
53
 */
54
public class SearchManager {
55

    
56
	public static final List NO_RESULTS = Arrays.asList(new Object[]{});
57

    
58
	public static final String WILDCARD = "*"; //$NON-NLS-1$
59

    
60
	public static int NO_COUNT = -1;
61

    
62
    private static final int MAX_RESULTS_BEFORE_WARNING = 500;
63

    
64
	public List<TaxonName> findNames(IIdentifiableEntityServiceConfigurator configurator, ConversationHolder conversation){
65

    
66
		if(checkLargeResult(CdmStore.getService(INameService.class).countByTitle(configurator))){
67
	    List<TaxonName> records = CdmStore.getService(INameService.class).findByTitle(configurator).getRecords();
68
	    addUuidSearchResults(records, configurator, INameService.class);
69
	    return records;
70
	}
71
		return NO_RESULTS;
72
	}
73

    
74
	public List<NameRelationship> findNameRelationships(
75
			IIdentifiableEntityServiceConfigurator configurator) {
76
		if(true){
77
		    //if activated again remember to add uuid search results like in other searches
78
			return NO_RESULTS;
79
		}
80

    
81
		List<NameRelationship> relationships = new ArrayList<>();
82
		List<RelationshipBase> all = CdmStore.getService(INameService.class).getAllRelationships(0, 0);
83

    
84
		for (RelationshipBase<?,?,?> relationship : all){
85
			if(relationship instanceof NameRelationship){
86
				relationships.add((NameRelationship) relationship);
87
			}
88
		}
89
		return relationships;
90
	}
91

    
92
	public List<UuidAndTitleCache<? extends IdentifiableEntity>> findTaxaAndNames(IFindTaxaAndNamesConfigurator<TaxonBase> configurator){
93
		return CdmStore.getService(ITaxonService.class).findTaxaAndNamesForEditor(configurator);
94
	}
95

    
96
	public List<Reference> findReferences(IIdentifiableEntityServiceConfigurator configurator){
97
		if(checkLargeResult(CdmStore.getService(IReferenceService.class).countByTitle(configurator))){
98
	    List<Reference> records = CdmStore.getService(IReferenceService.class).findByTitle(configurator).getRecords();
99
	    addUuidSearchResults(records, configurator, IReferenceService.class);
100
	    return records;
101
	}
102
		return NO_RESULTS;
103
	}
104

    
105
	public List<AgentBase> findAgents(IIdentifiableEntityServiceConfigurator configurator){
106

    
107
		if(checkLargeResult(CdmStore.getService(IAgentService.class).countByTitle(configurator))){
108
		    List<AgentBase> records = CdmStore.getService(IAgentService.class).findByTitle(configurator).getRecords();
109
		    addUuidSearchResults(records, configurator, IAgentService.class);
110
		    return records;
111
		}
112
		return NO_RESULTS;
113
	}
114

    
115
    /**
116
     * Check search string if it is a {@link UUID} and, if <code>true</code>, search for the corresponding entity.
117
     * @param records the list to which the search results are added
118
     * @param configurator the configurator holding the search string
119
     * @param service the service to use for searching
120
     */
121
    private <T extends ICdmBase> void addUuidSearchResults(List<T> records, IIdentifiableEntityServiceConfigurator configurator, Class<? extends IService<T>> service) {
122
        String titleSearchString = configurator.getTitleSearchString();
123
		try {
124
		    UUID uuid = UUID.fromString(titleSearchString);
125
		    T foundRecord = (T) CdmStore.getService(service).load(uuid, configurator.getPropertyPaths());
126
		    if(foundRecord!=null){
127
		        records.add(foundRecord);
128
		    }
129
		} catch (IllegalArgumentException e) {
130
		    //search string was no UUID
131
		}
132
    }
133

    
134
	@SuppressWarnings("unchecked")
135
	public List<TeamOrPersonBase> findTeamOrPersons(IIdentifiableEntityServiceConfigurator configurator){
136
	    configurator.setClazz(TeamOrPersonBase.class);
137
	    return (List)findAgents(configurator);
138
	}
139

    
140
	/**
141
	 * Searches for {@link SpecimenOrObservationBase} with the parameters specified in the
142
	 * {@link IIdentifiableEntityServiceConfigurator}<br>
143
	 * <br>
144
	 * Note: FieldUnits are omitted by default. See {@link #findOccurrences(IIdentifiableEntityServiceConfigurator, boolean)}
145
	 *
146
	 * @param configurator the configurator to use for the search
147
	 * @return a list of the SpecimenOrObservationBases matching the search parameters found
148
	 */
149
	public List<SpecimenOrObservationBase> findOccurrences(IIdentifiableEntityServiceConfigurator configurator, boolean showCountWarning){
150
	    // by default we do not show field units. This may be configured via preferences
151
	    return findOccurrences(configurator, PreferencesUtil.getPreferenceStore().getBoolean(IPreferenceKeys.BULK_EDITOR_OCCURRENCE_SHOW_FIELD_UNITS), showCountWarning);
152
	}
153

    
154

    
155
	/**
156
	 * Searches for {@link SpecimenOrObservationBase} with the parameters specified in the
157
	 * {@link IIdentifiableEntityServiceConfigurator}
158
	 *
159
	 * @param configurator the configurator to use for the search
160
	 * @return a list of the SpecimenOrObservationBases found
161
	 * @param showFieldUnits if <code>true</code> then also FieldUnits are searched
162
	 * @return
163
	 */
164
	public List<SpecimenOrObservationBase> findOccurrences(IIdentifiableEntityServiceConfigurator<SpecimenOrObservationBase> configurator, boolean showFieldUnits,
165
	        boolean showCountWarning){
166
	    List<SpecimenOrObservationBase> records = new ArrayList<SpecimenOrObservationBase>();
167
		final List<String> BASE_OCCURRENCE_INIT_STRATEGY = Arrays.asList(new String[] {
168
		        "collection", //$NON-NLS-1$
169
		        "descriptions", //$NON-NLS-1$
170
		        "identifiers", //$NON-NLS-1$
171
		        "derivationEvents.originals", //$NON-NLS-1$
172
		        "derivedFrom.originals", //$NON-NLS-1$
173
		        "gatheringEvent.country.representations", //$NON-NLS-1$
174
		        "gatheringEvent.collector", //$NON-NLS-1$
175
		        "gatheringEvent.locality", //$NON-NLS-1$
176
		        "descriptions.descriptionElements", //$NON-NLS-1$
177
		        "kindOfUnit", //$NON-NLS-1$
178
		        "amplificationResults", //$NON-NLS-1$
179
		        "sequences.singleReadAlignments", //$NON-NLS-1$
180
		        "mediaSpecimen" //$NON-NLS-1$
181
		});
182

    
183
		List<String> occurrencePropertyPaths = new ArrayList<String>();
184
		occurrencePropertyPaths.addAll(BASE_OCCURRENCE_INIT_STRATEGY);
185
		for(String propertyPath:BASE_OCCURRENCE_INIT_STRATEGY) {
186
		    occurrencePropertyPaths.add("derivationEvents.derivatives." + propertyPath); //$NON-NLS-1$
187
		}
188
		configurator.setPropertyPaths(occurrencePropertyPaths);
189

    
190
        if(showCountWarning && checkLargeResult(CdmStore.getService(IOccurrenceService.class).countOccurrences(configurator))){
191
            records = CdmStore.getService(IOccurrenceService.class).findByTitle(configurator).getRecords();
192
        }
193
        else{
194
            records = CdmStore.getService(IOccurrenceService.class).findByTitle(configurator).getRecords();
195
        }
196
		addUuidSearchResults(records, configurator, IOccurrenceService.class);
197
		return records;
198
	}
199

    
200
	public List<User> findUsers(IIdentifiableEntityServiceConfigurator configurator){
201
		String userNameSearchString = sqlizeTitleSearchString(configurator);
202
		// TODO why are users not identifiable entities?
203
        List<User> records = CdmStore.getService(IUserService.class).listByUsername(userNameSearchString,
204
                configurator.getMatchMode(), configurator.getCriteria(), configurator.getPageSize(),
205
                configurator.getPageNumber(), configurator.getOrderHints(), configurator.getPropertyPaths());
206
        addUuidSearchResults(records, configurator, IUserService.class);
207
        return records;
208
	}
209

    
210

    
211

    
212
    private boolean checkLargeResult(long count) {
213
        return checkLargeResult(count, MAX_RESULTS_BEFORE_WARNING);
214
    }
215

    
216
    private boolean checkLargeResult(long count, int maxBeforWarning) {
217
        if(count > maxBeforWarning){
218
            return MessageDialog.openConfirm(Display.getDefault().getActiveShell(), Messages.SearchManager_LARGE_RESULT_EXPECTED,
219
                    String.format(Messages.SearchManager_LONG_SEARCH_WARNING, count));
220
        }else{
221
            return true;
222
        }
223
    }
224
    
225
	public List<Group> findGroups(IIdentifiableEntityServiceConfigurator configurator){
226
		String groupNameSearchString = sqlizeTitleSearchString(configurator);
227
		// TODO why are groups not identifiable entities?
228
        List<Group> records = CdmStore.getService(IGroupService.class).listByName(groupNameSearchString,
229
                configurator.getMatchMode(), configurator.getCriteria(), configurator.getPageSize(),
230
                configurator.getPageNumber(), configurator.getOrderHints(), configurator.getPropertyPaths());
231
        addUuidSearchResults(records, configurator, IGroupService.class);
232
        return records;
233
	}
234

    
235

    
236
	private String sqlizeTitleSearchString(IIdentifiableEntityServiceConfigurator configurator){
237
		return configurator.getTitleSearchString().replace(WILDCARD, "%"); //$NON-NLS-1$
238
	}
239

    
240
	public List findTaxa(IIdentifiableEntityServiceConfigurator configurator) {
241
		if(checkLargeResult(CdmStore.getService(ITaxonService.class).countByTitle(configurator))){
242
	    List<TaxonBase> records = CdmStore.getService(ITaxonService.class).findByTitle(configurator).getRecords();
243
	    addUuidSearchResults(records, configurator, ITaxonService.class);
244
	    return records;
245
	}
246
		return NO_RESULTS;
247
	}
248

    
249
	public List findMedia(IIdentifiableEntityServiceConfigurator configurator) {
250
        if(checkLargeResult(CdmStore.getService(IMediaService.class).countByTitle(configurator))){
251
	    List<Media> records = CdmStore.getService(IMediaService.class).findByTitle(configurator).getRecords();
252
	    addUuidSearchResults(records, configurator, IMediaService.class);
253
	    return records;
254
    }
255
        return NO_RESULTS;
256
    }
257

    
258

    
259
}
(9-9/14)