/**
    * Copyright 2005-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.util;
  
  import org.apache.commons.lang.StringUtils;
  import org.kuali.rice.core.api.config.property.ConfigurationService;
  import org.kuali.rice.kns.datadictionary.MaintainableCollectionDefinition;
  import org.kuali.rice.kns.datadictionary.MaintainableFieldDefinition;
  import org.kuali.rice.kns.datadictionary.MaintainableItemDefinition;
  import org.kuali.rice.kns.datadictionary.MaintainableSectionDefinition;
  import org.kuali.rice.kns.lookup.LookupUtils;
  import org.kuali.rice.kns.maintenance.Maintainable;
  import org.kuali.rice.kns.service.KNSServiceLocator;
  import org.kuali.rice.kns.service.MaintenanceDocumentDictionaryService;
  import org.kuali.rice.kns.web.ui.Field;
  import org.kuali.rice.kns.web.ui.Row;
  import org.kuali.rice.kns.web.ui.Section;
  import org.kuali.rice.krad.bo.BusinessObject;
  import org.kuali.rice.krad.datadictionary.AttributeSecurity;
  import org.kuali.rice.kns.datadictionary.MaintenanceDocumentEntry;
  import org.kuali.rice.krad.exception.ValidationException;
  import org.kuali.rice.krad.lookup.SelectiveReferenceRefresher;
  import org.kuali.rice.krad.service.DataDictionaryService;
  import org.kuali.rice.krad.service.KRADServiceLocator;
  import org.kuali.rice.krad.service.KRADServiceLocatorWeb;
  import org.kuali.rice.krad.service.KualiExceptionIncidentService;
  import org.kuali.rice.krad.service.MaintenanceDocumentService;
  import org.kuali.rice.krad.util.KRADConstants;
  import org.kuali.rice.krad.workflow.service.WorkflowDocumentService;
  
  import java.util.Collection;
  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;
  
  public final class MaintenanceUtils {
      private static final org.apache.log4j.Logger LOG = org.apache.log4j.Logger.getLogger(MaintenanceUtils.class);
  
      private static MaintenanceDocumentService maintenanceDocumentService;
      private static WorkflowDocumentService workflowDocumentService;
      private static ConfigurationService kualiConfigurationService;
      private static KualiExceptionIncidentService kualiExceptionIncidentService;
      private static MaintenanceDocumentDictionaryService maintenanceDocumentDictionaryService;
      private static DataDictionaryService dataDictionaryService;
  
      private MaintenanceUtils() {
          throw new UnsupportedOperationException("do not call");
      }
  
      /**
       * Returns the field templates defined in the maint dictionary xml files. Field templates are used in multiple value lookups.
       * When doing a MV lookup on a collection, the returned BOs are not necessarily of the same type as the elements of the
       * collection. Therefore, a means of mapping between the fields for the 2 BOs are necessary. The template attribute of
       * <maintainableField>s contained within <maintainableCollection>s tells us this mapping. Example: a
       * <maintainableField name="collectionAttrib" template="lookupBOAttrib"> definition means that when a list of BOs are
       * returned, the lookupBOAttrib value of the looked up BO will be placed into the collectionAttrib value of the BO added to the
       * collection
       *
       * @param sections       the sections of a document
       * @param collectionName the name of a collection. May be a nested collection with indices (e.g. collA[1].collB)
       * @return
       */
      public static Map<String, String> generateMultipleValueLookupBOTemplate(List<MaintainableSectionDefinition> sections, String collectionName) {
          MaintainableCollectionDefinition definition = findMaintainableCollectionDefinition(sections, collectionName);
          if (definition == null) {
              return null;
          }
          Map<String, String> template = null;
  
          for (MaintainableFieldDefinition maintainableField : definition.getMaintainableFields()) {
              String templateString = maintainableField.getTemplate();
              if (StringUtils.isNotBlank(templateString)) {
                  if (template == null) {
                      template = new HashMap<String, String>();
                  }
                  template.put(maintainableField.getName(), templateString);
              }
          }
          return template;
      }
  
      /**
      * Finds the MaintainableCollectionDefinition corresponding to the given collection name. For example, if the collection name is
      * "A.B.C", it will attempt to find the MaintainableCollectionDefinition for C that is nested in B that is nested under A. This
      * may not work correctly if there are duplicate collection definitions within the sections
      *
      * @param sections       the sections of a maint doc
      * @param collectionName the name of a collection, relative to the root of the BO being maintained. This value may have index
      *                       values (e.g. [1]), but these are ignored.
      * @return
      */
     public static MaintainableCollectionDefinition findMaintainableCollectionDefinition(List<MaintainableSectionDefinition> sections, String collectionName) {
         String[] collectionNameParts = StringUtils.split(collectionName, ".");
         for (MaintainableSectionDefinition section : sections) {
             MaintainableCollectionDefinition collDefinition = findMaintainableCollectionDefinitionHelper(section.getMaintainableItems(), collectionNameParts, 0);
             if (collDefinition != null) {
                 return collDefinition;
             }
         }
         return null;
     }
 
     private static <E extends MaintainableItemDefinition> MaintainableCollectionDefinition findMaintainableCollectionDefinitionHelper(Collection<E> items, String[] collectionNameParts, int collectionNameIndex) {
         if (collectionNameParts.length <= collectionNameIndex) {
             // we've gone too far down the nesting without finding it
             return null;
         }
 
         // we only care about the coll name, and not the index, since the coll definitions do not include the indexing characters,
         // i.e. [ and ]
         String collectionToFind = StringUtils.substringBefore(collectionNameParts[collectionNameIndex], "[");
         for (MaintainableItemDefinition item : items) {
             if (item instanceof MaintainableCollectionDefinition) {
                 MaintainableCollectionDefinition collection = (MaintainableCollectionDefinition) item;
                 if (collection.getName().equals(collectionToFind)) {
                     // we found an appropriate coll, now we have to see if we need to recurse even more (more nested collections),
                     // or just return the one we found.
                     if (collectionNameIndex == collectionNameParts.length - 1) {
                         // we're at the last part of the name, so we return
                         return collection;
                     } else {
                         // go deeper
                         return findMaintainableCollectionDefinitionHelper(collection.getMaintainableCollections(), collectionNameParts, collectionNameIndex + 1);
                     }
                 }
             }
         }
         return null;
     }
 
     /**
      * Checks to see if there has been an override lookup declared for the maintenance field. If so, the override will be used for
      * the quickfinder and lookup utils will not be called. If no override was given, LookupUtils.setFieldQuickfinder will be called
      * to set the system generated quickfinder based on the attributes relationship to the parent business object.
      *
      * @return Field with quickfinder set if one was found
      */
     public static final Field setFieldQuickfinder(BusinessObject businessObject, String attributeName, MaintainableFieldDefinition maintainableFieldDefinition, Field field, List<String> displayedFieldNames, SelectiveReferenceRefresher srr) {
         if (maintainableFieldDefinition.getOverrideLookupClass() != null && StringUtils.isNotBlank(maintainableFieldDefinition.getOverrideFieldConversions())) {
             field.setQuickFinderClassNameImpl(maintainableFieldDefinition.getOverrideLookupClass().getName());
             field.setFieldConversions(maintainableFieldDefinition.getOverrideFieldConversions());
             field.setBaseLookupUrl(LookupUtils.getBaseLookupUrl(false));
             field.setReferencesToRefresh(LookupUtils.convertReferencesToSelectCollectionToString(
                     srr.getAffectedReferencesFromLookup(businessObject, attributeName, "")));
             return field;
         }
         if (maintainableFieldDefinition.isNoLookup()) {
             return field;
         }
         return LookupUtils.setFieldQuickfinder(businessObject, null, false, 0, attributeName, field, displayedFieldNames, maintainableFieldDefinition.isNoLookup());
     }
 
     public static final Field setFieldQuickfinder(BusinessObject businessObject, String collectionName, boolean addLine, int index,
                                                   String attributeName, Field field, List<String> displayedFieldNames, Maintainable maintainable, MaintainableFieldDefinition maintainableFieldDefinition) {
         if (maintainableFieldDefinition.getOverrideLookupClass() != null && StringUtils.isNotBlank(maintainableFieldDefinition.getOverrideFieldConversions())) {
             if (maintainable != null) {
                 String collectionPrefix = "";
                 if (collectionName != null) {
                     if (addLine) {
                         collectionPrefix = KRADConstants.MAINTENANCE_ADD_PREFIX + collectionName + ".";
                     } else {
                         collectionPrefix = collectionName + "[" + index + "].";
                     }
                 }
                 field.setQuickFinderClassNameImpl(maintainableFieldDefinition.getOverrideLookupClass().getName());
 
                 String prefixedFieldConversions = prefixFieldConversionsDestinationsWithCollectionPrefix(maintainableFieldDefinition.getOverrideFieldConversions(), collectionPrefix);
                 field.setFieldConversions(prefixedFieldConversions);
                 field.setBaseLookupUrl(LookupUtils.getBaseLookupUrl(false));
                 field.setReferencesToRefresh(LookupUtils.convertReferencesToSelectCollectionToString(
                         maintainable.getAffectedReferencesFromLookup(businessObject, attributeName, collectionPrefix)));
             }
             return field;
         }
         if (maintainableFieldDefinition.isNoLookup()) {
             return field;
         }
         return LookupUtils.setFieldQuickfinder(businessObject, collectionName, addLine, index,
                 attributeName, field, displayedFieldNames, maintainable);
     }
 
     private static String prefixFieldConversionsDestinationsWithCollectionPrefix(String originalFieldConversions, String collectionPrefix) {
         StringBuilder buf = new StringBuilder();
         StringTokenizer tok = new StringTokenizer(originalFieldConversions, KRADConstants.FIELD_CONVERSIONS_SEPARATOR);
         boolean needsSeparator = false;
         while (tok.hasMoreTokens()) {
             String conversionPair = tok.nextToken();
             if (StringUtils.isBlank(conversionPair)) {
                 continue;
             }
 
             String fromValue = StringUtils.substringBefore(conversionPair, KRADConstants.FIELD_CONVERSION_PAIR_SEPARATOR);
             String toValue = StringUtils.substringAfter(conversionPair, KRADConstants.FIELD_CONVERSION_PAIR_SEPARATOR);
 
             if (needsSeparator) {
                 buf.append(KRADConstants.FIELD_CONVERSIONS_SEPARATOR);
             }
             needsSeparator = true;
 
             buf.append(fromValue).append(KRADConstants.FIELD_CONVERSION_PAIR_SEPARATOR).append(collectionPrefix).append(toValue);
         }
         return buf.toString();
     }
 
     public static final void setFieldDirectInquiry(BusinessObject businessObject, String attributeName, MaintainableFieldDefinition maintainableFieldDefinition, Field field, List<String> displayedFieldNames) {
         LookupUtils.setFieldDirectInquiry(businessObject, attributeName, field);
     }
 
     public static final void setFieldDirectInquiry(BusinessObject businessObject, String collectionName, boolean addLine, int index,
                                                    String attributeName, Field field, List<String> displayedFieldNames, Maintainable maintainable, MaintainableFieldDefinition maintainableFieldDefinition) {
         LookupUtils.setFieldDirectInquiry(businessObject, attributeName, field);
     }
 
     /**
      * Given a section, returns a comma delimited string of all fields, representing the error keys that exist for a section
      *
      * @param section a section
      * @return
      */
     public static String generateErrorKeyForSection(Section section) {
         Set<String> fieldPropertyNames = new HashSet<String>();
         addRowsToErrorKeySet(section.getRows(), fieldPropertyNames);
 
         StringBuilder buf = new StringBuilder();
         buf.append(section.getSectionId()).append(",");
 
         Iterator<String> nameIter = fieldPropertyNames.iterator();
         while (nameIter.hasNext()) {
             buf.append(nameIter.next());
             if (nameIter.hasNext()) {
                 buf.append(",");
             }
         }
 
         if (section.getContainedCollectionNames() != null && section.getContainedCollectionNames().size() > 0) {
             buf.append(",");
 
             Iterator<String> collectionIter = section.getContainedCollectionNames().iterator();
             while (collectionIter.hasNext()) {
                 buf.append(KRADConstants.MAINTENANCE_NEW_MAINTAINABLE + collectionIter.next());
                 if (collectionIter.hasNext()) {
                     buf.append(",");
                 }
             }
         }
 
         return buf.toString();
     }
 
     /**
      * This method recurses through all the fields of the list of rows and adds each field's property name to the set if it starts
      * with Constants.MAINTENANCE_NEW_MAINTAINABLE
      *
      * @param listOfRows
      * @param errorKeys
      * @see KRADConstants#MAINTENANCE_NEW_MAINTAINABLE
      */
     protected static void addRowsToErrorKeySet(List<Row> listOfRows, Set<String> errorKeys) {
         if (listOfRows == null) {
             return;
         }
         for (Row row : listOfRows) {
             List<Field> fields = row.getFields();
             if (fields == null) {
                 continue;
             }
             for (Field field : fields) {
                 String fieldPropertyName = field.getPropertyName();
                 if (fieldPropertyName != null && fieldPropertyName.startsWith(KRADConstants.MAINTENANCE_NEW_MAINTAINABLE)) {
                     errorKeys.add(field.getPropertyName());
                 }
                 addRowsToErrorKeySet(field.getContainerRows(), errorKeys);
             }
         }
     }
 
     /**
      * This method will throw a {@link ValidationException} if there is a valid locking document in existence and throwExceptionIfLocked is true.
      */
     public static void checkForLockingDocument(Maintainable maintainable, boolean throwExceptionIfLocked) {
         LOG.info("starting checkForLockingDocument (by Maintainable)");
 
         // get the docHeaderId of the blocking docs, if any are locked and blocking
         //String blockingDocId = getMaintenanceDocumentService().getLockingDocumentId(maintainable, null);
         String blockingDocId = maintainable.getLockingDocumentId();
         org.kuali.rice.krad.maintenance.MaintenanceUtils
                 .checkDocumentBlockingDocumentId(blockingDocId, throwExceptionIfLocked);
     }
 
     private static MaintenanceDocumentDictionaryService getMaintenanceDocumentDictionaryService() {
         if (maintenanceDocumentDictionaryService == null) {
             maintenanceDocumentDictionaryService = KNSServiceLocator.getMaintenanceDocumentDictionaryService();
         }
         return maintenanceDocumentDictionaryService;
     }
 
     private static DataDictionaryService getDataDictionaryService() {
         if (dataDictionaryService == null) {
             dataDictionaryService = KRADServiceLocatorWeb.getDataDictionaryService();
         }
         return dataDictionaryService;
     }
 
     public static Map<String, AttributeSecurity> retrievePropertyPathToAttributeSecurityMappings(String docTypeName) {
         Map<String, AttributeSecurity> results = new HashMap<String, AttributeSecurity>();
         MaintenanceDocumentEntry entry = getMaintenanceDocumentDictionaryService().getMaintenanceDocumentEntry(docTypeName);
         String className = entry.getDataObjectClass().getName();
 
         for (MaintainableSectionDefinition section : entry.getMaintainableSections()) {
             for (MaintainableItemDefinition item : section.getMaintainableItems()) {
                 if (item instanceof MaintainableFieldDefinition) {
                     MaintainableFieldDefinition field = (MaintainableFieldDefinition) item;
                     AttributeSecurity attributeSecurity = getDataDictionaryService().getAttributeSecurity(className, field.getName());
                     if (attributeSecurity != null) {
                         results.put(field.getName(), attributeSecurity);
                     }
                 } else if (item instanceof MaintainableCollectionDefinition) {
                     addMaintenanceDocumentCollectionPathToSecurityMappings(results, "", (MaintainableCollectionDefinition) item);
                 }
             }
         }
         return results;
     }
 
     private static void addMaintenanceDocumentCollectionPathToSecurityMappings(Map<String, AttributeSecurity> mappings, String propertyPathPrefix, MaintainableCollectionDefinition collectionDefinition) {
         propertyPathPrefix = propertyPathPrefix + collectionDefinition.getName() + ".";
         String boClassName = collectionDefinition.getBusinessObjectClass().getName();
         for (MaintainableFieldDefinition field : collectionDefinition.getMaintainableFields()) {
             AttributeSecurity attributeSecurity = getDataDictionaryService().getAttributeSecurity(boClassName, field.getName());
             if (attributeSecurity != null) {
                 mappings.put(propertyPathPrefix + field.getName(), attributeSecurity);
             }
         }
         for (MaintainableCollectionDefinition nestedCollection : collectionDefinition.getMaintainableCollections()) {
             addMaintenanceDocumentCollectionPathToSecurityMappings(mappings, propertyPathPrefix, nestedCollection);
         }
     }
 
     private static MaintenanceDocumentService getMaintenanceDocumentService() {
         if (maintenanceDocumentService == null) {
             maintenanceDocumentService = KRADServiceLocatorWeb.getMaintenanceDocumentService();
         }
         return maintenanceDocumentService;
     }
 
     private static WorkflowDocumentService getWorkflowDocumentService() {
         if (workflowDocumentService == null) {
             workflowDocumentService = KRADServiceLocatorWeb.getWorkflowDocumentService();
         }
         return workflowDocumentService;
     }
 
     private static ConfigurationService getKualiConfigurationService() {
         if (kualiConfigurationService == null) {
             kualiConfigurationService = KRADServiceLocator.getKualiConfigurationService();
         }
         return kualiConfigurationService;
     }
 
     private static KualiExceptionIncidentService getKualiExceptionIncidentService() {
         if (kualiExceptionIncidentService == null) {
             kualiExceptionIncidentService = KRADServiceLocatorWeb.getKualiExceptionIncidentService();
         }
         return kualiExceptionIncidentService;
     }
 }