View Javadoc

1   /**
2    * Copyright 2005-2013 The Kuali Foundation
3    *
4    * Licensed under the Educational Community License, Version 2.0 (the "License");
5    * you may not use this file except in compliance with the License.
6    * You may obtain a copy of the License at
7    *
8    * http://www.opensource.org/licenses/ecl2.php
9    *
10   * Unless required by applicable law or agreed to in writing, software
11   * distributed under the License is distributed on an "AS IS" BASIS,
12   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13   * See the License for the specific language governing permissions and
14   * limitations under the License.
15   */
16  package org.kuali.rice.krms.impl.repository;
17  
18  import org.apache.commons.lang.StringUtils;
19  import org.kuali.rice.core.api.exception.RiceIllegalStateException;
20  import org.kuali.rice.krad.service.BusinessObjectService;
21  import org.kuali.rice.krms.api.repository.language.NaturalLanguageTemplate;
22  import org.kuali.rice.krms.api.repository.language.NaturalLanguageTemplaterContract;
23  import org.kuali.rice.krms.api.repository.type.KrmsAttributeDefinition;
24  import org.kuali.rice.krms.impl.util.KrmsImplConstants;
25  
26  import java.util.Collection;
27  import java.util.Collections;
28  import java.util.HashMap;
29  import java.util.HashSet;
30  import java.util.LinkedList;
31  import java.util.List;
32  import java.util.Map;
33  import java.util.Set;
34  import org.kuali.rice.core.api.exception.RiceIllegalArgumentException;
35  import org.kuali.rice.krms.impl.repository.language.SimpleNaturalLanguageTemplater;
36  
37  /**
38   * Implementation of the @{link NaturalLanguageTemplateBoService} interface for accessing  {@link NaturalLanguageTemplateBo} related business objects.
39   * 
40   * @author Kuali Rice Team (rice.collab@kuali.org)
41   * 
42   */
43  public final class NaturalLanguageTemplateBoServiceImpl
44      implements NaturalLanguageTemplateBoService
45  {
46  
47      private BusinessObjectService businessObjectService;
48      private KrmsAttributeDefinitionService attributeDefinitionService;
49      private NaturalLanguageTemplaterContract naturalLanguageTemplater = new SimpleNaturalLanguageTemplater ();
50  
51      /**
52       * Sets the value of BusinessObjectService to the given value.
53       * 
54       * @param businessObjectService the BusinessObjectService value to set.
55       * 
56       */
57      public void setBusinessObjectService(BusinessObjectService businessObjectService) {
58          this.businessObjectService = businessObjectService;
59      }
60  
61      public void setAttributeDefinitionService(KrmsAttributeDefinitionService attributeDefinitionService) {
62          this.attributeDefinitionService = attributeDefinitionService;
63      }
64  
65      public KrmsAttributeDefinitionService getAttributeDefinitionService() {
66          if (attributeDefinitionService == null) {
67              attributeDefinitionService = KrmsRepositoryServiceLocator.getKrmsAttributeDefinitionService();
68          }
69          return attributeDefinitionService;
70      }
71  
72      public NaturalLanguageTemplaterContract getNaturalLanguageTemplater() {
73          return naturalLanguageTemplater;
74      }
75  
76      public void setNaturalLanguageTemplater(NaturalLanguageTemplaterContract naturalLanguageTemplater) {
77          this.naturalLanguageTemplater = naturalLanguageTemplater;
78      }
79  
80      @Override
81      public NaturalLanguageTemplate createNaturalLanguageTemplate(NaturalLanguageTemplate naturalLanguageTemplate) {
82          incomingParamCheck(naturalLanguageTemplate , "naturalLanguageTemplate");
83          final String naturalLanguageTemplateIdKey = naturalLanguageTemplate.getId();
84          final NaturalLanguageTemplate existing = getNaturalLanguageTemplate(naturalLanguageTemplateIdKey);
85          if (existing != null){ throw new IllegalStateException("the NaturalLanguageTemplate to create already exists: " + naturalLanguageTemplate);	}
86          NaturalLanguageTemplateBo bo = (NaturalLanguageTemplateBo)businessObjectService.save(from(naturalLanguageTemplate));
87          return NaturalLanguageTemplateBo.to(bo);
88      }
89  
90      @Override
91      public NaturalLanguageTemplate getNaturalLanguageTemplate(String naturalLanguageTemplateId) {
92          incomingParamCheck(naturalLanguageTemplateId , "naturalLanguageTemplateId");
93          NaturalLanguageTemplateBo bo = businessObjectService.findBySinglePrimaryKey(NaturalLanguageTemplateBo.class, naturalLanguageTemplateId);
94          return NaturalLanguageTemplateBo.to(bo);
95      }
96  
97      @Override
98      public void updateNaturalLanguageTemplate(NaturalLanguageTemplate naturalLanguageTemplate) {
99          incomingParamCheck(naturalLanguageTemplate , "naturalLanguageTemplate");
100         final NaturalLanguageTemplate existing = getNaturalLanguageTemplate(naturalLanguageTemplate.getId());
101         if (existing == null){ throw new IllegalStateException("the NaturalLanguageTemplate to update does not exists: " + naturalLanguageTemplate);}
102         final NaturalLanguageTemplate toUpdate;
103         if (!existing.getId().equals(naturalLanguageTemplate.getId())){
104             // if passed in id does not match existing id, correct it
105             final NaturalLanguageTemplate.Builder builder = NaturalLanguageTemplate.Builder.create(naturalLanguageTemplate);
106             builder.setId(existing.getId());
107             toUpdate = builder.build();
108         } else {
109             toUpdate = naturalLanguageTemplate;
110         }
111 
112         // copy all updateable fields to bo
113         NaturalLanguageTemplateBo boToUpdate = from(toUpdate);
114 
115         // delete any old, existing attributes
116         Map<String,String> fields = new HashMap<String,String>(1);
117         fields.put(KrmsImplConstants.PropertyNames.NaturalLanguageTemplate.NATURAL_LANGUAGE_TEMPLATE_ID, toUpdate.getId()); // TODO verify PropertyNames.NaturalLanguageTemplate.NATURAL_LANGUAGE_TEMPLATE_ID
118         businessObjectService.deleteMatching(NaturalLanguageTemplateAttributeBo.class, fields);
119 
120         // update the rule and create new attributes
121          businessObjectService.save(boToUpdate);
122     }
123 
124     @Override
125     public void deleteNaturalLanguageTemplate(String naturalLanguageTemplateId) {
126         incomingParamCheck(naturalLanguageTemplateId , "naturalLanguageTemplateId");
127         final NaturalLanguageTemplate existing = getNaturalLanguageTemplate(naturalLanguageTemplateId);
128         if (existing == null){ throw new IllegalStateException("the NaturalLanguageTemplate to delete does not exists: " + naturalLanguageTemplateId);}
129         businessObjectService.delete(from(existing));
130     }
131 
132     @Override
133     public List<NaturalLanguageTemplate> findNaturalLanguageTemplatesByAttributes(Map attributes) {
134         if (attributes == null) {
135             throw new IllegalArgumentException("attributes is null");
136         }
137         final Map<String, Object> map = new HashMap<String, Object>();
138         map.put("attributes", attributes);
139         List<NaturalLanguageTemplateBo> bos = (List<NaturalLanguageTemplateBo>) businessObjectService.findMatching(NaturalLanguageTemplateBo.class, map);
140         return convertBosToImmutables(bos);
141     }
142 
143     @Override
144     public List<NaturalLanguageTemplate> findNaturalLanguageTemplatesByLanguageCode(String languageCode) {
145         if (org.apache.commons.lang.StringUtils.isBlank(languageCode)) {
146             throw new IllegalArgumentException("languageCode is null or blank");
147         }
148         final Map<String, Object> map = new HashMap<String, Object>();
149         map.put("languageCode", languageCode);
150         List<NaturalLanguageTemplateBo> bos = (List<NaturalLanguageTemplateBo>) businessObjectService.findMatching(NaturalLanguageTemplateBo.class, map);
151         return convertBosToImmutables(bos);
152     }
153 
154     @Override
155     public NaturalLanguageTemplate findNaturalLanguageTemplateByLanguageCodeTypeIdAndNluId(String languageCode,
156             String typeId,
157             String naturalLanguageUsageId) {
158         if (org.apache.commons.lang.StringUtils.isBlank(languageCode)) {
159             throw new IllegalArgumentException("languageCode is null or blank");
160         }
161 
162         final Map<String, Object> map = new HashMap<String, Object>();
163         map.put("languageCode", languageCode);
164         map.put("naturalLanguageUsageId", naturalLanguageUsageId);
165         map.put("typeId", typeId);
166         List<NaturalLanguageTemplateBo> bos = (List<NaturalLanguageTemplateBo>) businessObjectService.findMatching(NaturalLanguageTemplateBo.class, map);
167 
168         if (bos.isEmpty()) {
169             return null;
170         }
171 
172         if (bos.size() > 1) {
173             throw new RiceIllegalArgumentException (languageCode + typeId +  naturalLanguageUsageId + " is supposed to be unique");
174         }
175 
176         return convertBosToImmutables(bos).get(0);
177     }
178 
179     @Override
180     public List<NaturalLanguageTemplate> findNaturalLanguageTemplatesByNaturalLanguageUsage(String naturalLanguageUsageId) {
181         if (org.apache.commons.lang.StringUtils.isBlank(naturalLanguageUsageId)) {
182             throw new IllegalArgumentException("naturalLanguageUsageId is null or blank");
183         }
184         final Map<String, Object> map = new HashMap<String, Object>();
185         map.put("naturalLanguageUsageId", naturalLanguageUsageId);
186         List<NaturalLanguageTemplateBo> bos = (List<NaturalLanguageTemplateBo>) businessObjectService.findMatching(NaturalLanguageTemplateBo.class, map);
187         return convertBosToImmutables(bos);
188     }
189 
190     @Override
191     public List<NaturalLanguageTemplate> findNaturalLanguageTemplatesByType(String typeId) {
192         if (org.apache.commons.lang.StringUtils.isBlank(typeId)) {
193             throw new IllegalArgumentException("typeId is null or blank");
194         }
195         final Map<String, Object> map = new HashMap<String, Object>();
196         map.put("typeId", typeId);
197         List<NaturalLanguageTemplateBo> bos = (List<NaturalLanguageTemplateBo>) businessObjectService.findMatching(NaturalLanguageTemplateBo.class, map);
198         return convertBosToImmutables(bos);
199     }
200 
201     @Override
202     public List<NaturalLanguageTemplate> findNaturalLanguageTemplatesByTemplate(String template) {
203         if (org.apache.commons.lang.StringUtils.isBlank(template)) {
204             throw new IllegalArgumentException("template is null or blank");
205         }
206         final Map<String, Object> map = new HashMap<String, Object>();
207         map.put("template", template);
208         List<NaturalLanguageTemplateBo> bos = (List<NaturalLanguageTemplateBo>) businessObjectService.findMatching(NaturalLanguageTemplateBo.class, map);
209         return convertBosToImmutables(bos);
210     }
211 
212     public List<NaturalLanguageTemplate> convertBosToImmutables(final Collection<NaturalLanguageTemplateBo> naturalLanguageTemplateBos) {
213         List<NaturalLanguageTemplate> immutables = new LinkedList<NaturalLanguageTemplate>();
214         if (naturalLanguageTemplateBos != null) {
215             NaturalLanguageTemplate immutable = null;
216             for (NaturalLanguageTemplateBo bo : naturalLanguageTemplateBos ) {
217                 immutable = to(bo);
218                 immutables.add(immutable);
219             }
220         }
221         return Collections.unmodifiableList(immutables);
222     }
223 
224     @Override
225     public NaturalLanguageTemplate to(NaturalLanguageTemplateBo naturalLanguageTemplateBo) {
226         return NaturalLanguageTemplateBo.to(naturalLanguageTemplateBo);
227     }
228 
229     public NaturalLanguageTemplateBo from(NaturalLanguageTemplate naturalLanguageTemplate) {
230         return NaturalLanguageTemplateBo.from(naturalLanguageTemplate);
231     }
232 
233     private Collection<NaturalLanguageTemplateAttributeBo> buildAttributes(NaturalLanguageTemplate im, Collection<NaturalLanguageTemplateAttributeBo> attributes) {
234         // build a map from attribute name to definition
235         Map<String, KrmsAttributeDefinition> attributeDefinitionMap = new HashMap<String, KrmsAttributeDefinition>();
236 
237         List<KrmsAttributeDefinition> attributeDefinitions = getAttributeDefinitionService().findAttributeDefinitionsByType(im.getTypeId());
238 
239         for (KrmsAttributeDefinition attributeDefinition : attributeDefinitions) {
240             attributeDefinitionMap.put(attributeDefinition.getName(), attributeDefinition);
241         }
242 
243         // for each entry, build a NaturalLanguageTemplateAttributeBo and add it
244         if (im.getAttributes() != null) {
245             for (Map.Entry<String,String> entry  : im.getAttributes().entrySet()) {
246                 KrmsAttributeDefinition attrDef = attributeDefinitionMap.get(entry.getKey());
247 
248                 if (attrDef != null) {
249                     NaturalLanguageTemplateAttributeBo attributeBo = new NaturalLanguageTemplateAttributeBo();
250                     attributeBo.setNaturalLanguageTemplateId( im.getId() );
251                     attributeBo.setAttributeDefinitionId(attrDef.getId());
252                     attributeBo.setValue(entry.getValue());
253                     attributeBo.setAttributeDefinition(KrmsAttributeDefinitionBo.from(attrDef));
254                     attributes.add(attributeBo);
255                 } else {
256                     throw new RiceIllegalStateException("there is no attribute definition with the name '" +
257                                  entry.getKey() + "' that is valid for the naturalLanguageTemplate type with id = '" + im.getTypeId() +"'");
258                 }
259             }
260         }
261         return attributes;
262     }
263 
264     private Set<NaturalLanguageTemplateAttributeBo> buildAttributeBoSet(NaturalLanguageTemplate im) {
265         Set<NaturalLanguageTemplateAttributeBo> attributes = new HashSet<NaturalLanguageTemplateAttributeBo>();
266         return (Set)buildAttributes(im, attributes);
267     }
268 
269     private List<NaturalLanguageTemplateAttributeBo> buildAttributeBoList(NaturalLanguageTemplate im) {
270         List<NaturalLanguageTemplateAttributeBo> attributes = new LinkedList<NaturalLanguageTemplateAttributeBo>();
271         return (List)buildAttributes(im, attributes);
272     }
273 
274     private void incomingParamCheck(Object object, String name) {
275         if (object == null) {
276             throw new IllegalArgumentException(name + " was null");
277         } else if (object instanceof String
278                 && StringUtils.isBlank((String)object)) {
279             throw new IllegalArgumentException(name + " was blank");
280         }
281     }
282 
283 }