/** * Copyright or © or Copr. Ministère Français chargé de la Culture * et de la Communication (2013) * <p/> * contact.gincoculture_at_gouv.fr * <p/> * This software is a computer program whose purpose is to provide a thesaurus * management solution. * <p/> * This software is governed by the CeCILL license under French law and * abiding by the rules of distribution of free software. You can use, * modify and/ or redistribute the software under the terms of the CeCILL * license as circulated by CEA, CNRS and INRIA at the following URL * "http://www.cecill.info". * <p/> * As a counterpart to the access to the source code and rights to copy, * modify and redistribute granted by the license, users are provided only * with a limited warranty and the software's author, the holder of the * economic rights, and the successive licensors have only limited liability. * <p/> * In this respect, the user's attention is drawn to the risks associated * with loading, using, modifying and/or developing or reproducing the * software by the user in light of its specific status of free software, * that may mean that it is complicated to manipulate, and that also * therefore means that it is reserved for developers and experienced * professionals having in-depth computer knowledge. Users are therefore * encouraged to load and test the software's suitability as regards their * requirements in conditions enabling the security of their systemsand/or * data to be ensured and, more generally, to use and operate it in the * same conditions as regards security. * <p/> * The fact that you are presently reading this means that you have had * knowledge of the CeCILL license and that you accept its terms. */ package fr.mcc.ginco.utils; import fr.mcc.ginco.beans.Language; import fr.mcc.ginco.beans.ThesaurusTerm; import fr.mcc.ginco.exceptions.BusinessException; import org.springframework.beans.factory.annotation.Value; import org.springframework.stereotype.Component; import java.util.ArrayList; import java.util.List; /** * Utility class providing methods workign with terms */ @Component("thesaurusTermUtils") public class ThesaurusTermUtils { /** * Application default language */ @Value("${ginco.default.language}") private String defaultLang; /** * Returns the list of preferred terms from the given list * * @param listOfTerms * @return */ public final List<ThesaurusTerm> getPreferedTerms(List<ThesaurusTerm> listOfTerms) { List<ThesaurusTerm> preferedTerms = new ArrayList<ThesaurusTerm>(); for (ThesaurusTerm thesaurusTerm : listOfTerms) { if (thesaurusTerm.getPrefered()) { preferedTerms.add(thesaurusTerm); } } return preferedTerms; } /** * Checks 2 conditions * - the list must contain at least one term * - the list can not contains two preferred terms with the same language and the same lexical value * * @param terms */ public boolean checkTerms(List<ThesaurusTerm> terms) { List<ThesaurusTerm> preferedTerms = getPreferedTerms(terms); if (preferedTerms.size() == 0) { throw new BusinessException("A concept must have a prefered term", "missing-preferred-term-for-concept"); } List<Language> termsLangs = new ArrayList<Language>(); for (ThesaurusTerm term : preferedTerms) { Language currentLang = term.getLanguage(); if (termsLangs.contains(currentLang)) { throw new BusinessException("A concept must have one prefered term per language", "too-many-preferred-terms-for-a-language-found"); } termsLangs.add(currentLang); } return true; } /** * This method generates text for term labels (term title + lang if different to the application default language) * * @param terms * @return label : String label of the term with language if needed */ public String generatePrefTermsText(List<ThesaurusTerm> terms) { String result = ""; if (terms.size() == 1) { result = generatePrefTermText(terms.get(0)); } else { for (ThesaurusTerm term : terms) { result += term.getLexicalValue() + " (" + term.getLanguage().getId() + "), "; } result = result.substring(0, result.length() - 2); } return result; } public String generatePrefTermText(ThesaurusTerm term) { return LabelUtil.getLocalizedLabel(term.getLexicalValue(), term.getLanguage(), defaultLang); } /** * Returns the list of preferred terms from the given list and language id * * @param listOfTerms * @param language id * @return */ public final List<ThesaurusTerm> getPreferedTermsByLang(List<ThesaurusTerm> listOfTerms, String languageId) { List<ThesaurusTerm> preferedTerms = new ArrayList<ThesaurusTerm>(); for (ThesaurusTerm thesaurusTerm : listOfTerms) { if (thesaurusTerm.getPrefered() && thesaurusTerm.getLanguage().getId().equals(languageId)) { preferedTerms.add(thesaurusTerm); } } return preferedTerms; } }