View Javadoc

1   /**
2    * Copyright 2005-2012 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.krad.service.impl;
17  
18  import org.apache.commons.lang.StringUtils;
19  import org.kuali.rice.core.api.config.property.ConfigurationService;
20  import org.kuali.rice.core.api.search.SearchOperator;
21  import org.kuali.rice.kns.service.KNSServiceLocator;
22  import org.kuali.rice.krad.dao.LookupDao;
23  import org.kuali.rice.krad.service.LookupService;
24  
25  import java.util.Collection;
26  import java.util.Iterator;
27  import java.util.List;
28  import java.util.Map;
29  
30  /**
31   * Service implementation for the Lookup structure. It Provides a generic search
32   * mechanism against Business Objects. This is the default implementation, that
33   * is delivered with Kuali.
34   * 
35   * @author Kuali Rice Team (rice.collab@kuali.org)
36   */
37  public class LookupServiceImpl implements LookupService {
38      private static final org.apache.log4j.Logger LOG = org.apache.log4j.Logger.getLogger(LookupServiceImpl.class);
39  
40      private LookupDao lookupDao;
41      private ConfigurationService kualiConfigurationService;
42  
43      public <T extends Object> Collection<T> findCollectionBySearchUnbounded(Class<T> example,
44              Map<String, String> formProps) {
45          return findCollectionBySearchHelper(example, formProps, true);
46      }
47  
48      /**
49       * Returns a collection of objects based on the given search parameters.
50       * 
51       * @return Collection returned from the search
52       */
53      public <T extends Object> Collection<T> findCollectionBySearch(Class<T> example, Map<String, String> formProps) {
54          return findCollectionBySearchHelper(example, formProps, false);
55      }
56  
57      public <T extends Object> Collection<T> findCollectionBySearchHelper(Class<T> example,
58              Map<String, String> formProps, boolean unbounded) {
59          return lookupDao.findCollectionBySearchHelper(example, formProps, unbounded,
60                  allPrimaryKeyValuesPresentAndNotWildcard(example, formProps));
61      }
62  
63      /**
64       * Retrieves a Object based on the search criteria, which should uniquely
65       * identify a record.
66       * 
67       * @return Object returned from the search
68       */
69      public <T extends Object> T findObjectBySearch(Class<T> example, Map<String, String> formProps) {
70          if (example == null || formProps == null) {
71              throw new IllegalArgumentException("Object and Map must not be null");
72          }
73  
74          T obj = null;
75          try {
76              obj = example.newInstance();
77          } catch (IllegalAccessException e) {
78              throw new RuntimeException("Cannot get new instance of " + example.getName(), e);
79          } catch (InstantiationException e) {
80              throw new RuntimeException("Cannot instantiate " + example.getName(), e);
81          }
82  
83          return lookupDao.findObjectByMap(obj, formProps);
84      }
85  
86      public boolean allPrimaryKeyValuesPresentAndNotWildcard(Class<?> boClass, Map<String, String> formProps) {
87          List<String> pkFields = KNSServiceLocator.getBusinessObjectMetaDataService().listPrimaryKeyFieldNames(
88                  boClass);
89          Iterator<String> pkIter = pkFields.iterator();
90          boolean returnVal = true;
91          while (returnVal && pkIter.hasNext()) {
92              String pkName = pkIter.next();
93              String pkValue = formProps.get(pkName);
94  
95              if (StringUtils.isBlank(pkValue)) {
96                  returnVal = false;
97              } else {
98                  for (SearchOperator op : SearchOperator.QUERY_CHARACTERS) {
99                      if (pkValue.contains(op.op())) {
100                         returnVal = false;
101                         break;
102                     }
103                 }
104             }
105         }
106         return returnVal;
107     }
108 
109     /**
110      * @return Returns the lookupDao.
111      */
112     public LookupDao getLookupDao() {
113         return lookupDao;
114     }
115 
116     /**
117      * @param lookupDao The lookupDao to set.
118      */
119     public void setLookupDao(LookupDao lookupDao) {
120         this.lookupDao = lookupDao;
121     }
122 
123     public ConfigurationService getKualiConfigurationService() {
124         return kualiConfigurationService;
125     }
126 
127     public void setKualiConfigurationService(ConfigurationService kualiConfigurationService) {
128         this.kualiConfigurationService = kualiConfigurationService;
129     }
130 }