001/* 002 * Copyright 2015 Anyware Services 003 * 004 * Licensed under the Apache License, Version 2.0 (the "License"); 005 * you may not use this file except in compliance with the License. 006 * You may obtain a copy of the License at 007 * 008 * http://www.apache.org/licenses/LICENSE-2.0 009 * 010 * Unless required by applicable law or agreed to in writing, software 011 * distributed under the License is distributed on an "AS IS" BASIS, 012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 013 * See the License for the specific language governing permissions and 014 * limitations under the License. 015 */ 016package org.ametys.plugins.glossary; 017 018import java.text.Normalizer; 019import java.text.Normalizer.Form; 020import java.util.ArrayList; 021import java.util.Collections; 022import java.util.HashMap; 023import java.util.List; 024import java.util.Map; 025import java.util.Set; 026 027import org.apache.avalon.framework.component.Component; 028import org.apache.avalon.framework.logger.AbstractLogEnabled; 029import org.apache.avalon.framework.service.ServiceException; 030import org.apache.avalon.framework.service.ServiceManager; 031import org.apache.avalon.framework.service.Serviceable; 032import org.apache.commons.lang.StringUtils; 033 034import org.ametys.core.ui.Callable; 035import org.ametys.plugins.repository.AmetysObjectIterable; 036import org.ametys.plugins.repository.AmetysObjectResolver; 037import org.ametys.plugins.repository.AmetysRepositoryException; 038import org.ametys.plugins.repository.ModifiableAmetysObject; 039import org.ametys.plugins.repository.ModifiableTraversableAmetysObject; 040import org.ametys.plugins.repository.TraversableAmetysObject; 041import org.ametys.plugins.repository.UnknownAmetysObjectException; 042import org.ametys.plugins.repository.jcr.NameHelper; 043import org.ametys.web.repository.site.SiteManager; 044 045/** 046 * DAO for manipulating glossary. 047 * 048 */ 049public class GlossaryDAO extends AbstractLogEnabled implements Serviceable, Component 050{ 051 /** The Avalon role */ 052 public static final String ROLE = GlossaryDAO.class.getName(); 053 054 /** The site manager */ 055 protected SiteManager _siteManager; 056 057 /** Ametys object resolver */ 058 protected AmetysObjectResolver _resolver; 059 060 @Override 061 public void service(ServiceManager manager) throws ServiceException 062 { 063 _siteManager = (SiteManager) manager.lookup(SiteManager.ROLE); 064 _resolver = (AmetysObjectResolver) manager.lookup(AmetysObjectResolver.ROLE); 065 } 066 067 /** 068 * Get the word definitions 069 * @param siteName The site name 070 * @param lang The language 071 * @return The word definitions 072 */ 073 @Callable (rights = "Glossary_Rights_Definitions_Handle") 074 public Map<String, Object> getDefinitions(String siteName, String lang) 075 { 076 Map<String, Object> result = new HashMap<>(); 077 078 List<Map<String, Object>> definitions = new ArrayList<>(); 079 080 TraversableAmetysObject definitionsNode = GlossaryHelper.getDefinitionsNode(_siteManager.getSite(siteName), lang); 081 082 try (AmetysObjectIterable<DefaultDefinition> wordDefinitions = definitionsNode.getChildren()) 083 { 084 for (DefaultDefinition wordDefinition : wordDefinitions) 085 { 086 definitions.add(getDefinition(wordDefinition)); 087 } 088 } 089 090 result.put("definitions", definitions); 091 092 return result; 093 } 094 095 /** 096 * Get properties of a word definition 097 * @param id the id of definition 098 * @return the properties 099 */ 100 @Callable (rights = "Glossary_Rights_Definitions_Handle") 101 public Map<String, Object> getDefinition (String id) 102 { 103 DefaultDefinition wordDefinition = _resolver.resolveById(id); 104 105 return getDefinition(wordDefinition); 106 } 107 108 /** 109 * Get the definition in JSON 110 * @param wordDefinition the word definition 111 * @return the JSON for the word definition 112 */ 113 public Map<String, Object> getDefinition (DefaultDefinition wordDefinition) 114 { 115 Map<String, Object> properties = new HashMap<>(); 116 117 properties.put("id", wordDefinition.getId()); 118 properties.put("lang", wordDefinition.getLanguage()); 119 properties.put("siteName", wordDefinition.getSiteName()); 120 properties.put("word", wordDefinition.getWord()); 121 String firstLetter = Normalizer.normalize(wordDefinition.getWord().substring(0, 1), Form.NFD).replaceAll("\\p{InCombiningDiacriticalMarks}+", ""); 122 properties.put("firstLetter", firstLetter); 123 properties.put("variants", wordDefinition.getVariants()); 124 properties.put("content", wordDefinition.getContent()); 125 properties.put("displayOnText", wordDefinition.displayOnText()); 126 127 return properties; 128 } 129 130 /** 131 * Creates a word definition. 132 * @param word The word 133 * @param variants The variants 134 * @param content The content 135 * @param display The value of displayOnText 136 * @param siteName The site name 137 * @param language The language 138 * @return The id of the created word, or an error 139 */ 140 @Callable (rights = "Glossary_Rights_Definitions_Handle") 141 public Map<String, String> createDefinition (String word, String variants, String content, String display, String siteName, String language) 142 { 143 Map<String, String> result = new HashMap<>(); 144 145 String capitalizedWord = StringUtils.capitalize(word); 146 List<String> variantList = new ArrayList<>(); 147 if (StringUtils.isNotBlank(variants)) 148 { 149 for (String variant : StringUtils.split(variants, ",")) 150 { 151 String trimVariant = variant.trim(); 152 if (StringUtils.isNotEmpty(trimVariant)) 153 { 154 variantList.add(StringUtils.capitalize(trimVariant)); 155 } 156 } 157 } 158 159 // Check that the word doesn't already exist. 160 if (_wordExists(capitalizedWord, siteName, language)) 161 { 162 result.put("error", "word-already-exists"); 163 return result; 164 } 165 166 // Check that none of the variant already exists. 167 for (String variant : variantList) 168 { 169 if (_wordExists(variant, siteName, language)) 170 { 171 result.put("error", "word-already-exists"); 172 return result; 173 } 174 } 175 176 ModifiableTraversableAmetysObject rootNode = GlossaryHelper.getDefinitionsNode(_siteManager.getSite(siteName), language); 177 178 String originalName = NameHelper.filterName(capitalizedWord); 179 180 // Find unique name 181 String name = originalName; 182 int index = 2; 183 while (rootNode.hasChild(name)) 184 { 185 name = originalName + "-" + (index++); 186 } 187 188 DefaultDefinition def = rootNode.createChild(name, DefaultDefinitionFactory.DEFINITION_NODE_TYPE); 189 def.setWord(capitalizedWord); 190 def.setVariants(variantList); 191 def.setContent(content); 192 def.setDisplayOnText("true".equals(display)); 193 194 rootNode.saveChanges(); 195 196 result.put("id", def.getId()); 197 198 return result; 199 } 200 201 /** 202 * Edits a word definition. 203 * @param id The id of the word to edit 204 * @param word The new word 205 * @param variants The new variants 206 * @param content The new content 207 * @param display The new value of displayOnText 208 * @param siteName The site name 209 * @param language The language 210 * @return The id of the edited word, or an error 211 */ 212 @Callable (rights = "Glossary_Rights_Definitions_Handle") 213 public Map<String, String> editDefinition (String id, String word, String variants, String content, String display, String siteName, String language) 214 { 215 Map<String, String> result = new HashMap<>(); 216 217 String capitalizedWord = StringUtils.capitalize(word); 218 List<String> variantList = new ArrayList<>(); 219 if (StringUtils.isNotBlank(variants)) 220 { 221 for (String variant : StringUtils.split(variants, ",")) 222 { 223 String trimVariant = variant.trim(); 224 if (StringUtils.isNotEmpty(trimVariant)) 225 { 226 variantList.add(StringUtils.capitalize(variant.trim())); 227 } 228 } 229 } 230 231 try 232 { 233 DefaultDefinition definition = _resolver.resolveById(id); 234 235 Set<String> allForms = definition.getAllForms(); 236 237 // If the word was changed, check that the new word doesn't already exist. 238 if (!allForms.contains(word) && _wordExists(word, siteName, language)) 239 { 240 return Collections.singletonMap("error", "word-already-exists"); 241 } 242 243 // If the word was changed, check that none of the variant already exists. 244 for (String variant : variantList) 245 { 246 if (!allForms.contains(variant) && _wordExists(variant, siteName, language)) 247 { 248 return Collections.singletonMap("error", "word-already-exists"); 249 } 250 } 251 252 definition.setWord(capitalizedWord.trim()); 253 definition.setVariants(variantList); 254 definition.setContent(content); 255 definition.setDisplayOnText("true".equals(display)); 256 257 definition.saveChanges(); 258 259 result.put("id", definition.getId()); 260 } 261 catch (UnknownAmetysObjectException e) 262 { 263 result.put("error", "unknown-definition"); 264 getLogger().error("Unable to edit definition of id '" + id + ", because it does not not exist.", e); 265 } 266 267 return result; 268 } 269 270 /** 271 * Deletes word definitions. 272 * @param ids The ids of definitions to delete 273 * @return The ids of the deleted words, the ids of the unknown words, and maybe an error 274 */ 275 @Callable (rights = "Glossary_Rights_Definitions_Handle") 276 public Map<String, Object> deleteDefinitions (ArrayList<String> ids) 277 { 278 Map<String, Object> result = new HashMap<>(); 279 List<String> deletedDefinitions = new ArrayList<>(); 280 List<String> unknownIds = new ArrayList<>(); 281 282 for (String id : ids) 283 { 284 try 285 { 286 DefaultDefinition definition = _resolver.resolveById(id); 287 288 ModifiableAmetysObject parent = definition.getParent(); 289 definition.remove(); 290 291 parent.saveChanges(); 292 293 deletedDefinitions.add(id); 294 } 295 catch (UnknownAmetysObjectException e) 296 { 297 result.put("error", "unknown-definition"); 298 getLogger().error("Unable to delete the definition of id '" + id + ", because it does not exist.", e); 299 unknownIds.add(id); 300 } 301 } 302 303 result.put("ids", deletedDefinitions); 304 result.put("unknown-ids", unknownIds); 305 306 return result; 307 } 308 309 /** 310 * Tests if the specified word exists in the glossary. 311 * @param word The word to test. 312 * @param siteName The site name. 313 * @param language The language. 314 * @return true if the word exists. 315 * @throws AmetysRepositoryException if a repository error occurs. 316 */ 317 protected boolean _wordExists(String word, String siteName, String language) throws AmetysRepositoryException 318 { 319 String xpathQuery = GlossaryHelper.getWordExistsQuery(siteName, language, word); 320 321 try (AmetysObjectIterable<DefaultDefinition> defs = _resolver.query(xpathQuery)) 322 { 323 return defs.iterator().hasNext(); 324 } 325 } 326}