/*

  * Copyright 2006-2011 The Kuali Foundation

  *

  * Licensed under the Educational Community License, Version 2.0 (the "License");

  * you may not use this file except in compliance with the License.

  * You may obtain a copy of the License at

  *

  * http://www.opensource.org/licenses/ecl2.php

  *

  * Unless required by applicable law or agreed to in writing, software

  * distributed under the License is distributed on an "AS IS" BASIS,

  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

  * See the License for the specific language governing permissions and

  * limitations under the License.

  */

 package org.kuali.rice.kns.lookup;

 import java.sql.Date;

 import java.sql.Timestamp;

 import java.text.ParseException;

 import java.util.ArrayList;

 import java.util.Calendar;

 import java.util.Collection;

 import java.util.Comparator;

 import java.util.HashMap;

 import java.util.HashSet;

 import java.util.Iterator;

 import java.util.List;

 import java.util.Map;

 import java.util.Set;

 import java.util.StringTokenizer;

 import org.apache.commons.lang.StringUtils;

 import org.apache.ojb.broker.query.Criteria;

 import org.kuali.rice.core.api.config.property.ConfigurationService;

 import org.kuali.rice.core.api.datetime.DateTimeService;

 import org.kuali.rice.core.api.encryption.EncryptionService;

 import org.kuali.rice.core.framework.persistence.platform.DatabasePlatform;

 import org.kuali.rice.core.framework.services.CoreFrameworkServiceLocator;

 import org.kuali.rice.kns.bo.BusinessObject;

 import org.kuali.rice.kns.bo.BusinessObjectRelationship;

 import org.kuali.rice.kns.datadictionary.RelationshipDefinition;

 import org.kuali.rice.kns.datadictionary.control.ControlDefinition;

 import org.kuali.rice.kns.datadictionary.exception.UnknownBusinessClassAttributeException;

 import org.kuali.rice.kns.exception.ClassNotPersistableException;

 import org.kuali.rice.kns.service.BusinessObjectDictionaryService;

 import org.kuali.rice.kns.service.BusinessObjectMetaDataService;

 import org.kuali.rice.kns.service.DataDictionaryService;

 import org.kuali.rice.kns.service.KNSServiceLocator;

 import org.kuali.rice.kns.service.PersistenceStructureService;

 import org.kuali.rice.kns.util.KNSConstants;

 import org.kuali.rice.kns.util.KNSPropertyConstants;

 import org.kuali.rice.kns.util.ObjectUtils;

 import org.kuali.rice.kns.web.comparator.NullValueComparator;

 import org.kuali.rice.kns.web.ui.Field;

 import org.kuali.rice.kns.web.ui.ResultRow;

 /**

  * Not a static utility class for Lookup related utilities and helper methods.

  */

 public class LookupUtils {

     private static final org.apache.log4j.Logger LOG = org.apache.log4j.Logger.getLogger(LookupUtils.class);

     private static DataDictionaryService dataDictionaryService;

     private static PersistenceStructureService persistenceStructureService;

     private static BusinessObjectDictionaryService businessObjectDictionaryService;

     private static BusinessObjectMetaDataService businessObjectMetaDataService;

     private static DateTimeService dateTimeService;

     public LookupUtils() {

         // default constructor for Spring to call to start up initialization process

     }

     public void setBusinessObjectDictionaryService(BusinessObjectDictionaryService businessObjectDictionaryService) {

         LookupUtils.businessObjectDictionaryService = businessObjectDictionaryService;

     }

     public void setDataDictionaryService(DataDictionaryService ddService) {

         LookupUtils.dataDictionaryService = ddService;

     }

     public void setPersistenceStructureService(PersistenceStructureService persistenceStructureService) {

         LookupUtils.persistenceStructureService = persistenceStructureService;

     }

     public void setDateTimeService(DateTimeService dateTimeService) {

                 LookupUtils.dateTimeService = dateTimeService;

         }

         /**

      * Sets the businessObjectMetaDataService attribute value.

      * @param businessObjectMetaDataService The businessObjectMetaDataService to set.

      */

     public void setBusinessObjectMetaDataService(BusinessObjectMetaDataService businessObjectMetaDataService) {

         LookupUtils.businessObjectMetaDataService = businessObjectMetaDataService;

     }

     /**

     * Uses the DataDictionary to determine whether to force uppercase the value, and if it should, then it does the

     * uppercase, and returns the upper-cased value.

     *

     * @param dataObjectClass Parent DO class that the fieldName is a member of.

     * @param fieldName Name of the field to be forced to uppercase.

     * @param fieldValue Value of the field that may be uppercased.

     * @return The correctly uppercased fieldValue if it should be uppercased, otherwise fieldValue is returned unchanged.

     *

     */

    public static String forceUppercase(Class<?> dataObjectClass, String fieldName, String fieldValue) {

        // short-circuit to exit if there isnt enough information to do the forceUppercase

        if (StringUtils.isBlank(fieldValue)) {

            return fieldValue;

        }

        // parameter validation

        if (dataObjectClass == null) {

            throw new IllegalArgumentException("Parameter dataObjectClass passed in with null value.");

        }

        if (StringUtils.isBlank(fieldName)) {

            throw new IllegalArgumentException("Parameter fieldName passed in with empty value.");

        }

        if (!dataDictionaryService.isAttributeDefined(dataObjectClass, fieldName).booleanValue()) {

            return fieldValue;

        }

        boolean forceUpperCase = false;

        try {

            forceUpperCase = dataDictionaryService.getAttributeForceUppercase(dataObjectClass, fieldName).booleanValue();

        }

        catch (UnknownBusinessClassAttributeException ubae) {

            // do nothing, don't alter the fieldValue

        }

        if (forceUpperCase && !fieldValue.endsWith(EncryptionService.ENCRYPTION_POST_PREFIX)) {

            return fieldValue.toUpperCase();

        }

        return fieldValue;

    }

    /**

     * Uses the DataDictionary to determine whether to force uppercase the values, and if it should, then it does the

     * uppercase, and returns the upper-cased Map of fieldname/fieldValue pairs.

     *

     * @param dataObjectClass Parent DO class that the fieldName is a member of.

     * @param fieldValues A Map<String,String> where the key is the fieldName and the value is the fieldValue.

     * @return The same Map is returned, with the appropriate values uppercased (if any).

     *

     */

    public static Map<String, String> forceUppercase(Class<?> dataObjectClass, Map<String, String> fieldValues) {

        if (dataObjectClass == null) {

            throw new IllegalArgumentException("Parameter boClass passed in with null value.");

        }

        if (fieldValues == null) {

            throw new IllegalArgumentException("Parameter fieldValues passed in with null value.");

        }

        for (String fieldName : fieldValues.keySet()) {

            fieldValues.put(fieldName, LookupUtils.forceUppercase(dataObjectClass, fieldName, (String) fieldValues.get(fieldName)));

        }

        return fieldValues;

    }

     /**

      * This method applies the search results limit to the search criteria for this BO

      *

      * @param businessObjectClass BO class to search on / get limit for

      * @param criteria search criteria

      * @param platform database platform

      */

     public static void applySearchResultsLimit(Class businessObjectClass, Criteria criteria, DatabasePlatform platform) {

         Integer limit = getSearchResultsLimit(businessObjectClass);

         if (limit != null) {

             platform.applyLimit(limit, criteria);

         }

     }

     /**

      * This method applies the search results limit to the search criteria for this BO (JPA)

      *

      * @param businessObjectClass BO class to search on / get limit for

      * @param criteria search criteria

      */

     public static void applySearchResultsLimit(Class businessObjectClass, org.kuali.rice.core.framework.persistence.jpa.criteria.Criteria criteria) {

         Integer limit = getSearchResultsLimit(businessObjectClass);

         if (limit != null) {

                 criteria.setSearchLimit(limit);

                 }

     }

     /**

      * This method parses and returns the lookup result set limit, checking first for the limit

      * for the BO being looked up, and then the global application limit if there isn't a limit

      * specific to this BO.

      *

      * @param businessObjectClass BO class to search on / get limit for.  If the passed in type is not of type

      * {@link BusinessObject}, then the application-wide default limit is used.

      * @return result set limit (or null if there isn't one)

      */

     public static Integer getSearchResultsLimit(Class businessObjectClass) {

         Integer limit = null;

         if (BusinessObject.class.isAssignableFrom(businessObjectClass)) {

             limit = getBusinessObjectSearchResultsLimit(businessObjectClass);

         }

         if (limit == null) {

             limit = getApplicationSearchResultsLimit();

         }

         return limit;

     }

     /**

      *

      */

     private static Integer getApplicationSearchResultsLimit() {

         String limitString = CoreFrameworkServiceLocator.getParameterService().getParameterValueAsString(KNSConstants.KNS_NAMESPACE, KNSConstants.DetailTypes.LOOKUP_PARM_DETAIL_TYPE, KNSConstants.SystemGroupParameterNames.LOOKUP_RESULTS_LIMIT);

         if (limitString != null) {

             return Integer.valueOf(limitString);

         }

         return null;

     }

     /**

      * This method parses and returns the lookup result set limit for the passed in BO (if one exists)

      *

      * @param businessObjectClass

      * @return result set limit for this BO (or null if the BO doesn't have a limit)

      */

     private static Integer getBusinessObjectSearchResultsLimit(Class businessObjectClass) {

         return businessObjectDictionaryService.getLookupResultSetLimit(businessObjectClass);

     }

     /**

      * This method the maximum rows per page in a multiple value lookup

      *

      * @see org.kuali.KNSConstants.SystemGroupParameterNames#MULTIPLE_VALUE_LOOKUP_RESULTS_PER_PAGE

      * @return

      */

     public static Integer getApplicationMaximumSearchResulsPerPageForMultipleValueLookups() {

         String limitString = CoreFrameworkServiceLocator.getParameterService().getParameterValueAsString(KNSConstants.KNS_NAMESPACE, KNSConstants.DetailTypes.LOOKUP_PARM_DETAIL_TYPE, KNSConstants.SystemGroupParameterNames.MULTIPLE_VALUE_LOOKUP_RESULTS_PER_PAGE);

         if (limitString != null) {

             return Integer.valueOf(limitString);

         }

         return null;

     }

     /**

      * This makes a , delimited String list of fields separated by a , into a List of target --> lookup readOnlyFieldsList.

      *

      * @param readOnlyFields

      * @return the List representation of the readOnlyFields  String provided.

      */

     public static List<String> translateReadOnlyFieldsToList(String readOnlyFieldsString) {

         List<String> readOnlyFieldsList = new ArrayList<String>();

         if (StringUtils.isNotEmpty(readOnlyFieldsString)) {

             if (readOnlyFieldsString.indexOf(",") > 0) {

                 StringTokenizer token = new StringTokenizer(readOnlyFieldsString, ",");

                 while (token.hasMoreTokens()) {

                     String element = token.nextToken();

                     readOnlyFieldsList.add(element);

                 }

             }

             else {

                 readOnlyFieldsList.add(readOnlyFieldsString);

             }

         }

       return readOnlyFieldsList;

     }

     /**

      * This translates a , delimited list of pairs separated by a : into a Map of target --> lookup field conversions.

      *

      * @param conversionFields

      * @return the Map representation of the fieldConversions String provided.

      */

     public static Map translateFieldConversions(String fieldConversionsString) {

         Map fieldConversionsMap = new HashMap();

         if (StringUtils.isNotEmpty(fieldConversionsString)) {

             if (fieldConversionsString.indexOf(",") > 0) {

                 StringTokenizer token = new StringTokenizer(fieldConversionsString, ",");

                 while (token.hasMoreTokens()) {

                     String element = token.nextToken();

                     fieldConversionsMap.put(element.substring(0, element.indexOf(":")), element.substring(element.indexOf(":") + 1));

                 }

             }

             else {

                 fieldConversionsMap.put(fieldConversionsString.substring(0, fieldConversionsString.indexOf(":")), fieldConversionsString.substring(fieldConversionsString.indexOf(":") + 1));

             }

         }

         return fieldConversionsMap;

     }

     @Deprecated

     public static Field setFieldQuickfinder(BusinessObject businessObject,

             String attributeName, Field field, List displayedFieldNames) {

         return setFieldQuickfinder( businessObject, (String)null, false, 0, attributeName, field, displayedFieldNames );

     }

     @Deprecated

     public static Field setFieldQuickfinder(BusinessObject businessObject,

             String attributeName, Field field, List displayedFieldNames, SelectiveReferenceRefresher srr) {

         return setFieldQuickfinder( businessObject, (String)null, false, 0, attributeName, field, displayedFieldNames, srr );

     }

     /**

      * Sets a fields quickfinder class and field conversions for an attribute.

      */

     @Deprecated

     public static Field setFieldQuickfinder(BusinessObject businessObject, String collectionName, boolean addLine, int index,

             String attributeName, Field field, List displayedFieldNames, SelectiveReferenceRefresher srr) {

         field = setFieldQuickfinder(businessObject, collectionName, addLine, index, attributeName, field, displayedFieldNames);

         if (srr != null) {

             String collectionPrefix = "";

             if ( collectionName != null ) {

                 if (addLine) {

                     collectionPrefix = KNSConstants.MAINTENANCE_ADD_PREFIX + collectionName + ".";

                 }

                 else {

                     collectionPrefix = collectionName + "[" + index + "].";

                 }

             }

             field.setReferencesToRefresh(convertReferencesToSelectCollectionToString(

                     srr.getAffectedReferencesFromLookup(businessObject, attributeName, collectionPrefix)));

         }

         return field;

     }

     /**

      * Sets a fields quickfinder class and field conversions for an attribute.

      */

     @Deprecated

     public static Field setFieldQuickfinder(BusinessObject businessObject, String collectionName, boolean addLine, int index,

                                             String attributeName, Field field, List displayedFieldNames) {

         boolean noLookup = false;

         if (businessObject == null) {

             return field;

         }

         Boolean noLookupField = businessObjectDictionaryService.noLookupFieldLookup(businessObject.getClass(), attributeName);

         if (noLookupField != null && noLookupField) {

             noLookup = true;

         }

          return setFieldQuickfinder(businessObject, collectionName, addLine, index, attributeName, field, displayedFieldNames, noLookup);

     }

     @Deprecated

     public static Field setFieldQuickfinder(BusinessObject businessObject, String collectionName, boolean addLine, int index, String attributeName, Field field, List displayedFieldNames, boolean noLookupField)

     {

          if (businessObject == null) {

             return field;

         }

         if (noLookupField) {

             return field;

         }

         BusinessObjectRelationship relationship = null;

         if ( LOG.isDebugEnabled() ) {

             LOG.debug( "setFieldQuickfinder("+businessObject.getClass().getName()+","+attributeName+","+field+","+displayedFieldNames+")" );

         }

         relationship = businessObjectMetaDataService.getBusinessObjectRelationship(businessObject, businessObject.getClass(), attributeName, "", false);

         String collectionPrefix = "";

         if ( collectionName != null ) {

             if (addLine) {

                 collectionPrefix = KNSConstants.MAINTENANCE_ADD_PREFIX + collectionName + ".";

             }

             else {

                 collectionPrefix = collectionName + "[" + index + "].";

             }

         }

         if (relationship == null) {

             Class c = ObjectUtils.getPropertyType(businessObject, attributeName, persistenceStructureService);

             if(c!=null) {

                 if (attributeName.contains(".")) {

                     attributeName = StringUtils.substringBeforeLast( attributeName, "." );

                 }

                 RelationshipDefinition ddReference = businessObjectMetaDataService.getBusinessObjectRelationshipDefinition(businessObject, attributeName);

                 relationship = businessObjectMetaDataService.getBusinessObjectRelationship(ddReference, businessObject, businessObject.getClass(), attributeName, "", false);

                 if(relationship!=null) {

                     field.setQuickFinderClassNameImpl(relationship.getRelatedClass().getName());

                     field.setFieldConversions(generateFieldConversions( businessObject, collectionPrefix, relationship, field.getPropertyPrefix(), displayedFieldNames, null));

                     field.setLookupParameters(generateLookupParameters( businessObject, collectionPrefix, relationship, field.getPropertyPrefix(), displayedFieldNames, null));

                     field.setBaseLookupUrl(LookupUtils.getBaseLookupUrl(false));

                     field.setImageSrc(businessObjectDictionaryService.getSearchIconOverride(businessObject.getClass()));

                 }

             }

             return field;

         }

         if (ObjectUtils.isNestedAttribute(attributeName)) {

             //first determine the prefix and the attribute we are referring to

             String nestedAttributePrefix = StringUtils.substringBeforeLast(attributeName, ".");

             field.setQuickFinderClassNameImpl(relationship.getRelatedClass().getName());

             field.setFieldConversions( generateFieldConversions( businessObject, collectionPrefix, relationship, field.getPropertyPrefix(), displayedFieldNames, nestedAttributePrefix ) );

             field.setLookupParameters( generateLookupParameters( businessObject, collectionPrefix, relationship, field.getPropertyPrefix(), displayedFieldNames, nestedAttributePrefix ) );

             field.setBaseLookupUrl(LookupUtils.getBaseLookupUrl(false));

         } else {

             field.setQuickFinderClassNameImpl(relationship.getRelatedClass().getName());

             field.setFieldConversions( generateFieldConversions( businessObject, collectionPrefix, relationship, field.getPropertyPrefix(), displayedFieldNames, null ) );

             field.setLookupParameters( generateLookupParameters( businessObject, collectionPrefix, relationship, field.getPropertyPrefix(), displayedFieldNames, null ) );

             field.setBaseLookupUrl(LookupUtils.getBaseLookupUrl(false));

         }

         field.setImageSrc(businessObjectDictionaryService.getSearchIconOverride(businessObject.getClass()));

         return field;

     }

     private static String BASE_LOOKUP_ACTION_URL = null;

     private static String BASE_MULTIPLE_VALUE_LOOKUP_ACTION_URL = null;

     private static String BASE_INQUIRY_ACTION_URL = null;

     @Deprecated

     public static String getBaseLookupUrl(boolean isMultipleValue) {

         ConfigurationService kualiConfigurationService = KNSServiceLocator.getKualiConfigurationService();

             if ( isMultipleValue ) {

                     if ( BASE_MULTIPLE_VALUE_LOOKUP_ACTION_URL == null ) {

                             String lookupUrl = kualiConfigurationService.getPropertyString(KNSConstants.APPLICATION_URL_KEY);

                             if (!lookupUrl.endsWith("/")) {

                                     lookupUrl = lookupUrl + "/";

                             }

                                 lookupUrl += "kr/" + KNSConstants.MULTIPLE_VALUE_LOOKUP_ACTION;

                                 BASE_MULTIPLE_VALUE_LOOKUP_ACTION_URL = lookupUrl;

                     }

                     return BASE_MULTIPLE_VALUE_LOOKUP_ACTION_URL;

             } else {

                     if ( BASE_LOOKUP_ACTION_URL == null ) {

                             String lookupUrl = kualiConfigurationService.getPropertyString(KNSConstants.APPLICATION_URL_KEY);

                             if (!lookupUrl.endsWith("/")) {

                                     lookupUrl = lookupUrl + "/";

                             }

                                 lookupUrl += "kr/" + KNSConstants.LOOKUP_ACTION;

                                 BASE_LOOKUP_ACTION_URL = lookupUrl;

                     }

                     return BASE_LOOKUP_ACTION_URL;

             }

     }

     @Deprecated

     public static String getBaseInquiryUrl() {

             if ( BASE_INQUIRY_ACTION_URL == null ) {

                     StringBuffer inquiryUrl = new StringBuffer( 

                                     KNSServiceLocator.getKualiConfigurationService().getPropertyString(KNSConstants.APPLICATION_URL_KEY) );

                         if (inquiryUrl.charAt(inquiryUrl.length()-1) != '/' ) {

                                 inquiryUrl.append( '/' );

                         }

                         inquiryUrl.append("kr/");

                         inquiryUrl.append( KNSConstants.INQUIRY_ACTION );

                         BASE_INQUIRY_ACTION_URL = inquiryUrl.toString();

             }

             return BASE_INQUIRY_ACTION_URL;

     }

     public static String transformLookupUrlToMultiple(String lookupUrl) {

             return lookupUrl.replace("kr/" + KNSConstants.LOOKUP_ACTION, "kr/" + KNSConstants.MULTIPLE_VALUE_LOOKUP_ACTION);

     }

     /**

      * Sets whether a field should have direct inquiries enabled.  The direct inquiry is the functionality on a page such that if the primary key for

      * a quickfinder is filled in and the direct inquiry button is pressed, then a new window will popup showing an inquiry page without going through

      * the lookup first.

      *

      * For this method to work properly, it must be called after setFieldQuickfinder

      * //TODO: chb: that should not be the case -- the relationship object the two rely upon should be established outside of the lookup/quickfinder code

      *

      *

      * @param field

      */

     private static void setFieldDirectInquiry(Field field) {

         if (StringUtils.isNotBlank(field.getFieldConversions())) {

             boolean directInquiriesEnabled = CoreFrameworkServiceLocator.getParameterService().getParameterValueAsBoolean(KNSConstants.KNS_NAMESPACE, KNSConstants.DetailTypes.ALL_DETAIL_TYPE, KNSConstants.SystemGroupParameterNames.ENABLE_DIRECT_INQUIRIES_IND);

             if (directInquiriesEnabled) {

                 if (StringUtils.isNotBlank(field.getFieldConversions())) {

                     String fieldConversions = field.getFieldConversions();

                     String newInquiryParameters = KNSConstants.EMPTY_STRING;

                     String[] conversions = StringUtils.split(fieldConversions, KNSConstants.FIELD_CONVERSIONS_SEPARATOR);

                     for (int l = 0; l < conversions.length; l++) {

                         String conversion = conversions[l];

                         //String[] conversionPair = StringUtils.split(conversion, KNSConstants.FIELD_CONVERSION_PAIR_SEPARATOR);

                         String[] conversionPair = StringUtils.split(conversion, KNSConstants.FIELD_CONVERSION_PAIR_SEPARATOR, 2);

                         String conversionFrom = conversionPair[0];

                         String conversionTo = conversionPair[1];

                         newInquiryParameters += (conversionTo + KNSConstants.FIELD_CONVERSION_PAIR_SEPARATOR + conversionFrom);

                         if (l < conversions.length - 1) {

                             newInquiryParameters += KNSConstants.FIELD_CONVERSIONS_SEPARATOR;

                         }

                     }

                     field.setInquiryParameters(newInquiryParameters);

                 }

             }

             field.setFieldDirectInquiryEnabled(directInquiriesEnabled);

         }

         else {

             field.setFieldDirectInquiryEnabled(false);

         }

     }

     /**

      *

      * @param field

      * @return the altered Field object

      */

     public static Field setFieldDirectInquiry(BusinessObject businessObject, String attributeName, Field field)

     {

                 if (businessObject == null)

                 {

             return field;

         }

         Boolean noDirectInquiry = businessObjectDictionaryService.noDirectInquiryFieldLookup(businessObject.getClass(), attributeName);

         //check if noDirectInquiry is present and true, but if it's not set in existing data dictionary definitions, don't create a direct inquiry

         if (noDirectInquiry != null && noDirectInquiry.booleanValue() || noDirectInquiry == null) {

             return field;

         }

         setFieldDirectInquiry(field);

         return field;

     }

     private static Map<Class,Map<String,Map>> referencesForForeignKey = new HashMap<Class, Map<String,Map>>();

     @Deprecated

     public static Map getPrimitiveReference(BusinessObject businessObject, String attributeName) {

         Map chosenReferenceByKeySize = new HashMap();

         Map chosenReferenceByFieldName = new HashMap();

         Map referenceClasses = null;

         try {

             // add special caching of these relationships since the Spring caching is so expensive

             Map<String,Map> propMap = referencesForForeignKey.get(businessObject.getClass());

             if ( propMap == null ) {

                 propMap = new HashMap<String, Map>();

                 referencesForForeignKey.put(businessObject.getClass(), propMap);

             }

             if ( propMap.containsKey(attributeName) ) {

                 referenceClasses = propMap.get( attributeName );

             } else {

                     //KFSMI-709: Make Inquiry Framework use BusinessObjectMetadataService instead of just PersistenceStructureService

                     referenceClasses = businessObjectMetaDataService.getReferencesForForeignKey(businessObject, attributeName);

                     if(referenceClasses==null || referenceClasses.isEmpty()) {

                         if ( persistenceStructureService.isPersistable(businessObject.getClass()) ) {

                             referenceClasses = persistenceStructureService.getReferencesForForeignKey(businessObject.getClass(), attributeName);

                         }

                     }

                 propMap.put(attributeName, referenceClasses);

             }

         } catch ( ClassNotPersistableException ex ) {

             // do nothing, there is no quickfinder

             Map<String,Map> propMap = referencesForForeignKey.get(businessObject.getClass());

             propMap.put(attributeName, null);

         }

         // if field is not fk to any reference class, return field object w no quickfinder

         if (referenceClasses == null || referenceClasses.isEmpty()) {

             return chosenReferenceByKeySize;

         }

         /*

          * if field is fk to more than one reference, take the class with the least # of pk fields, this should give the correct

          * grain for the attribute

          */

         int minKeys = Integer.MAX_VALUE;

         for (Iterator iter = referenceClasses.keySet().iterator(); iter.hasNext();) {

             String attr = (String) iter.next();

             Class clazz = (Class) referenceClasses.get(attr);

             List pkNames = businessObjectMetaDataService.listPrimaryKeyFieldNames(clazz);

             // Compare based on key size.

             if (pkNames.size() < minKeys) {

                 minKeys = pkNames.size();

                 chosenReferenceByKeySize.clear();

                 chosenReferenceByKeySize.put(attr, clazz);

             }

             // Compare based on field name.

             if (attributeName.startsWith(attr)) {

                 chosenReferenceByFieldName.clear();

                 chosenReferenceByFieldName.put(attr, clazz);

             }

         }

         // If a compatible key was found based on field names, prefer it, otherwise use choice by key size.

         return chosenReferenceByFieldName.isEmpty() ? chosenReferenceByKeySize : chosenReferenceByFieldName;

     }

     /**

      *

      * This method walks through the nested attribute and finds the last business object in the chain and returns it (excluding the

      * last parameter which is the actual attribute)

      *

      * @param attributeName

      * @return

      */

     public static BusinessObject getNestedBusinessObject(BusinessObject bo, String attributeName) {

         String[] nestedAttributes = StringUtils.split(attributeName, ".");

         BusinessObject childBO = null;

         String attributeRefName = "";

         Class clazz = null;

         if (nestedAttributes.length > 1) {

             String attributeStringSoFar = "";

             for (int i = 0; i < nestedAttributes.length - 1; i++) {

                 // we need to build a string of the attribute names depending on which iteration we're in.

                 // so if the original attributeName string we're using is "a.b.c.d.e", then first iteration would use

                 // "a", 2nd "a.b", 3rd "a.b.c", etc.

                 if (i != 0) {

                     attributeStringSoFar = attributeStringSoFar + ".";

                 }

                 attributeStringSoFar = attributeStringSoFar + nestedAttributes[i];

                 clazz = ObjectUtils.getPropertyType( bo, attributeStringSoFar, persistenceStructureService );

                 if (clazz != null && BusinessObject.class.isAssignableFrom(clazz)) {

                     try {

                             childBO = (BusinessObject) ObjectUtils.createNewObjectFromClass(clazz);

                     }

                     catch (Exception e) {

                         return null;

                     }

                 }

             }

         }

         return childBO;

     }

     public static Class getNestedReferenceClass(BusinessObject businessObject, String attributeName) {

         BusinessObject bo = getNestedBusinessObject(businessObject, attributeName);

         return null == bo ? null : bo.getClass();

     }

     @Deprecated

     private static String generateFieldConversions(BusinessObject businessObject, String collectionName, BusinessObjectRelationship relationship, String propertyPrefix, List displayedFieldNames, String nestedObjectPrefix) {

         String fieldConversions = "";

         if ( LOG.isDebugEnabled() ) {

             LOG.debug( "generateFieldConversions(" + businessObject.getClass().getName() + "," + collectionName + ",\n" + relationship + "\n," + propertyPrefix + "," + displayedFieldNames + "," + nestedObjectPrefix + ")" );

         }

         // get the references for the given property

         for ( Map.Entry<String,String> entry : relationship.getParentToChildReferences().entrySet() ) {

             String fromField = entry.getValue();

             String toField = entry.getKey();

             // find the displayed to field mapping

             if (!displayedFieldNames.contains(toField)) {

                 toField = translateToDisplayedField(businessObject.getClass(), toField, displayedFieldNames);

             }

             if (StringUtils.isNotBlank(fieldConversions)) {

                 fieldConversions += ",";

             }

             if ( StringUtils.isNotEmpty( propertyPrefix ) ) {

                 toField = propertyPrefix + "." + toField;

             }

             if ( StringUtils.isNotEmpty( collectionName ) ) {

                 toField = collectionName + toField;

             }

             fieldConversions += fromField + ":" + toField;

         }

         return fieldConversions;

     }

     @Deprecated

     private static String generateLookupParameters(BusinessObject businessObject, String collectionName, BusinessObjectRelationship relationship, String propertyPrefix, List displayedFieldNames, String nestedObjectPrefix) {

         String lookupParameters = "";

         List displayedQFFieldNames = businessObjectDictionaryService.getLookupFieldNames(relationship.getRelatedClass());

         for ( Map.Entry<String,String> entry : relationship.getParentToChildReferences().entrySet() ) {

             String fromField = entry.getKey();

             String toField = entry.getValue();

             if ( relationship.getUserVisibleIdentifierKey() == null || relationship.getUserVisibleIdentifierKey().equals( fromField ) ) {

                 // find the displayed from field mapping

                 if (!displayedFieldNames.contains(fromField)) {

                     fromField = translateToDisplayedField(businessObject.getClass(), fromField, displayedFieldNames);

                 }

                 // translate to field

                 if (displayedQFFieldNames != null && !displayedQFFieldNames.contains(toField)) {

                     toField = translateToDisplayedField(relationship.getRelatedClass(), toField, displayedQFFieldNames);

                 }

                 if (StringUtils.isNotBlank(lookupParameters)) {

                     lookupParameters += ",";

                 }

                 if (propertyPrefix != null && !propertyPrefix.equals("")) {

                     fromField = propertyPrefix + "." + fromField;

                 }

                 if ( StringUtils.isNotEmpty( collectionName ) ) {

                     fromField = collectionName + fromField;

                 }

                 lookupParameters += fromField + ":" + toField;

             }

         }

         return lookupParameters;

     }

     @Deprecated

     private static String translateToDisplayedField(Class businessObjectClass, String fieldName, List displayedFieldNames) {        

         if ( persistenceStructureService.isPersistable(businessObjectClass) ) {

             Map nestedFkMap = persistenceStructureService.getNestedForeignKeyMap(businessObjectClass);

             // translate to primitive fk if nested

             /*

              * if (ObjectUtils.isNestedAttribute(fieldName) && nestedFkMap.containsKey(fieldName)) { fieldName = (String)

              * nestedFkMap.get(fieldName); }

              */

             if (!displayedFieldNames.contains(fieldName)) {

                 for (Iterator iterator = displayedFieldNames.iterator(); iterator.hasNext();) {

                     String dispField = (String) iterator.next();

                     if (nestedFkMap.containsKey(dispField) && nestedFkMap.get(dispField).equals(fieldName)) {

                         fieldName = dispField;

                     }

                 }

             }

         }

         return fieldName;

     }

     public static String convertReferencesToSelectCollectionToString(Collection<String> referencesToRefresh) {

         StringBuilder buf = new StringBuilder();

         for (String reference : referencesToRefresh) {

             buf.append(reference).append(KNSConstants.REFERENCES_TO_REFRESH_SEPARATOR);

         }

         if (!referencesToRefresh.isEmpty()) {

             // we appended one too many separators, remove it

             buf.delete(buf.length() - KNSConstants.REFERENCES_TO_REFRESH_SEPARATOR.length(), buf.length());

         }

         return buf.toString();

     }

     public static String convertSetOfObjectIdsToString(Set<String> objectIds) {

         if (objectIds.isEmpty()) {

             return "";

         }

         StringBuilder buf = new StringBuilder();

         for (String objectId : objectIds) {

             if (objectId.contains(KNSConstants.MULTIPLE_VALUE_LOOKUP_OBJ_IDS_SEPARATOR)) {

                 throw new RuntimeException("object ID " + objectId + " contains the selected obj ID separator");

             }

             buf.append(objectId).append(KNSConstants.MULTIPLE_VALUE_LOOKUP_OBJ_IDS_SEPARATOR);

         }

         // added one extra separator, remove it

         buf.delete(buf.length() - KNSConstants.MULTIPLE_VALUE_LOOKUP_OBJ_IDS_SEPARATOR.length(), buf.length());

         return buf.toString();

     }

     public static Set<String> convertStringOfObjectIdsToSet(String objectIdsString) {

         Set<String> set = new HashSet<String>();

         if (StringUtils.isNotBlank(objectIdsString)) {

             String[] objectIds = StringUtils.splitByWholeSeparator(objectIdsString, KNSConstants.MULTIPLE_VALUE_LOOKUP_OBJ_IDS_SEPARATOR);

             for (String objectId : objectIds) {

                 set.add(objectId);

             }

         }

         return set;

     }

     /**

      * Given a list of results from a lookup, determines the best comparator to use on the String values of each of these columns

      *

      * This method exists because each cell (represented by the Column object) lists the comparator that should be used within it based on the property value class,

      * so we gotta go thru the whole list and determine the best comparator to use

      *

      * @param resultsTable

      * @param column

      * @return

      */

     public static Comparator findBestValueComparatorForColumn(List<ResultRow> resultTable, int column) {

         // BIG HACK

         Comparator comp = NullValueComparator.getInstance();

         for (ResultRow row : resultTable) {

             Comparator tempComp = row.getColumns().get(column).getValueComparator();

             if (tempComp != null && !NullValueComparator.class.equals(tempComp.getClass())) {

                 return tempComp;

             }

         }

         return comp;

     }

     /**

      * Given 3 sets of object IDs: the set of selected object IDs before rendering the current page,

      * the set of object IDs rendered on the page, and the set of object IDs selected on the page, computes

      * the total set of selected object IDs.

      *

      * Instead of storing it in a set, returns it in a map with the selected object ID as both the key and value

      * @param previouslySelectedObjectIds

      * @param displayedObjectIds

      * @param selectedObjectIds

      * @return

      */

     public static Map<String, String> generateCompositeSelectedObjectIds(Set<String> previouslySelectedObjectIds, Set<String> displayedObjectIds, Set<String> selectedObjectIds) {

         Map<String, String> tempMap = new HashMap<String, String>();

         // Equivalent to the set operation:

         // (P - D) union C, where - is the set difference operator

         // P is the list of object IDs previously passed in, D is the set of displayed object IDs, and C is the set of checked obj IDs

         // since HTML does not pass a value for non-selected dcheckboxes

         // first build a map w/ all the previouslySelectedObjectIds as keys

         for (String previouslySelectedObjectId : previouslySelectedObjectIds) {

             tempMap.put(previouslySelectedObjectId, previouslySelectedObjectId);

         }

         // then remove all the displayed elements (any selected displayed elements will be added back in the next loop)

         for (String displayedObjectId : displayedObjectIds) {

             tempMap.remove(displayedObjectId);

         }

         // put back the selected IDs

         for (String selectedObjectId : selectedObjectIds) {

             tempMap.put(selectedObjectId, selectedObjectId);

         }

         return tempMap;

     }

     /**

      * Removes fields identified in the data dictionary as hidden from the lookup field values.

      * (This will remove Universal User ID and Person name from search requests when a user ID is entered.)

      *

      * @param fieldValues

      */

     public static void removeHiddenCriteriaFields( Class businessObjectClass, Map fieldValues ) {

         List<String> lookupFieldAttributeList = businessObjectMetaDataService.getLookupableFieldNames(businessObjectClass);

         if (lookupFieldAttributeList != null) {

             for (Iterator iter = lookupFieldAttributeList.iterator(); iter.hasNext();) {

                 String attributeName = (String) iter.next();

                 if (fieldValues.containsKey(attributeName)) {

                     ControlDefinition controlDef = dataDictionaryService.getAttributeControlDefinition(businessObjectClass, attributeName);

                     if (controlDef != null && controlDef.isHidden() ) {

                         fieldValues.remove(attributeName);

                     }

                 }

             }

         }

         }

     /**

      * Determines what Timestamp should be used for active queries on effective dated records. Determination made as

      * follows:

      * <ul>

      *   <li>Use activeAsOfDate value from search values Map if value is not empty</li>

      *   <li>If search value given, try to convert to sql date, if conversion fails, try to convert to Timestamp</li>

      *   <li>If search value empty, use current Date</li>

      *   <li>If Timestamp value not given, create Timestamp from given Date setting the time as 1 second before midnight

      * </ul>

      * 

      * @param searchValues - Map containing search key/value pairs

      * @return Timestamp to be used for active criteria

      */

         public static Timestamp getActiveDateTimestampForCriteria(Map searchValues) {

                 Date activeDate = dateTimeService.getCurrentSqlDate();

                 Timestamp activeTimestamp = null;

                 if (searchValues.containsKey(KNSPropertyConstants.ACTIVE_AS_OF_DATE)) {

                         String activeAsOfDate = (String) searchValues.get(KNSPropertyConstants.ACTIVE_AS_OF_DATE);

                         if (StringUtils.isNotBlank(activeAsOfDate)) {

                                 try {

                                         activeDate = dateTimeService.convertToSqlDate(ObjectUtils.clean(activeAsOfDate));

                                 } catch (ParseException e) {

                                         // try to parse as timestamp

                                         try {

                                                 activeTimestamp = dateTimeService.convertToSqlTimestamp(ObjectUtils.clean(activeAsOfDate));

                                         } catch (ParseException e1) {

                                                 throw new RuntimeException("Unable to convert date: " + ObjectUtils.clean(activeAsOfDate));

                                         }

                                 }

                         }

                 }

                 // if timestamp not given set to 1 second before midnight on the given date

                 if (activeTimestamp == null) {

                         Calendar cal = Calendar.getInstance();

                         cal.setTime(activeDate);

                         cal.set(Calendar.HOUR, cal.getMaximum(Calendar.HOUR));

                         cal.set(Calendar.MINUTE, cal.getMaximum(Calendar.MINUTE));

                         cal.set(Calendar.SECOND, cal.getMaximum(Calendar.SECOND));

                         activeTimestamp = new Timestamp(cal.getTime().getTime());

                 }

                 return activeTimestamp;

         }

 }