/*
    * Copyright 2005 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.ole.fp.document;
  
  import static org.kuali.ole.sys.OLEConstants.FROM;
  import static org.kuali.ole.sys.OLEConstants.TO;
  
  import org.apache.commons.lang.StringUtils;
  import org.kuali.ole.fp.businessobject.GECSourceAccountingLine;
  import org.kuali.ole.fp.businessobject.GECTargetAccountingLine;
  import org.kuali.ole.integration.cam.CapitalAssetManagementModuleService;
  import org.kuali.ole.sys.businessobject.GeneralLedgerPendingEntry;
  import org.kuali.ole.sys.businessobject.GeneralLedgerPendingEntrySourceDetail;
  import org.kuali.ole.sys.context.SpringContext;
  import org.kuali.ole.sys.document.AmountTotaling;
  import org.kuali.ole.sys.document.Correctable;
  import org.kuali.ole.sys.document.validation.impl.AccountingDocumentRuleBaseConstants.GENERAL_LEDGER_PENDING_ENTRY_CODE;
  import org.kuali.rice.kew.framework.postprocessor.DocumentRouteStatusChange;
  import org.kuali.rice.kns.service.DataDictionaryService;
  import org.kuali.rice.krad.document.Copyable;
  import org.kuali.rice.krad.rules.rule.event.KualiDocumentEvent;
  import org.kuali.rice.krad.rules.rule.event.SaveDocumentEvent;
  
  
  /**
   * This is the business object that represents the GeneralErrorCorrectionDocument in Kuali. This is a transactional document that
   * will eventually post transactions to the G/L. It integrates with workflow and also contains two groupings of accounting lines:
   * from and to. From lines are the source lines, to lines are the target lines.
   */
  public class GeneralErrorCorrectionDocument extends CapitalAccountingLinesDocumentBase implements Copyable, Correctable, AmountTotaling, CapitalAssetEditable {
      protected static org.apache.log4j.Logger LOG = org.apache.log4j.Logger.getLogger(GeneralErrorCorrectionDocument.class);
  
      protected transient CapitalAssetManagementModuleService capitalAssetManagementModuleService;
  
      /**
       * Initializes the array lists and some basic info.
       */
      public GeneralErrorCorrectionDocument() {
          super();
      }
  
      /**
       * Overrides the base implementation to return "From".
       * 
       * @see org.kuali.ole.sys.document.AccountingDocument#getSourceAccountingLinesSectionTitle()
       */
      @Override
      public String getSourceAccountingLinesSectionTitle() {
          return FROM;
      }
  
      /**
       * Overrides the base implementation to return "To".
       * 
       * @see org.kuali.ole.sys.document.AccountingDocument#getTargetAccountingLinesSectionTitle()
       */
      @Override
      public String getTargetAccountingLinesSectionTitle() {
          return TO;
      }
  
      /**
       * @see org.kuali.ole.sys.document.AccountingDocumentBase#getSourceAccountingLineClass()
       */
      @Override
      public Class getSourceAccountingLineClass() {
          return GECSourceAccountingLine.class;
      }
  
      /**
       * @see org.kuali.ole.sys.document.AccountingDocumentBase#getTargetAccountingLineClass()
       */
      @Override
      public Class getTargetAccountingLineClass() {
          return GECTargetAccountingLine.class;
      }
  
      /**
       * Customizes a GLPE by setting financial document number, financial system origination code and document type code to null
       * 
       * @param transactionalDocument submitted accounting document
       * @param accountingLine accounting line in document
       * @param explicitEntry general ledger pending entry
       * @see FinancialDocumentRuleBase#customizeExplicitGeneralLedgerPendingEntry(FinancialDocument, AccountingLine,
       *      GeneralLedgerPendingEntry)
       */
     @Override
     public void customizeExplicitGeneralLedgerPendingEntry(GeneralLedgerPendingEntrySourceDetail postable, GeneralLedgerPendingEntry explicitEntry) {
         explicitEntry.setTransactionLedgerEntryDescription(buildTransactionLedgerEntryDescriptionUsingRefOriginAndRefDocNumber(postable));
 
         // Clearing fields that are already handled by the parent algorithm - we don't actually want
         // these to copy over from the accounting lines b/c they don't belong in the GLPEs
         // if the aren't nulled, then GECs fail to post
         explicitEntry.setReferenceFinancialDocumentNumber(null);
         explicitEntry.setReferenceFinancialSystemOriginationCode(null);
         explicitEntry.setReferenceFinancialDocumentTypeCode(null);
     }
 
     /**
      * Builds an appropriately formatted string to be used for the <code>transactionLedgerEntryDescription</code>. It is built
      * using information from the <code>{@link AccountingLine}</code>. Format is "01-12345: blah blah blah".
      * 
      * @param line accounting line
      * @param transactionalDocument submitted accounting document
      * @return String formatted string to be used for transaction ledger entry description
      */
     protected String buildTransactionLedgerEntryDescriptionUsingRefOriginAndRefDocNumber(GeneralLedgerPendingEntrySourceDetail line) {
         String description = "";
         description = line.getReferenceOriginCode() + "-" + line.getReferenceNumber();
 
         if (StringUtils.isNotBlank(line.getFinancialDocumentLineDescription())) {
             description += ": " + line.getFinancialDocumentLineDescription();
         }
         else {
             description += ": " + getDocumentHeader().getDocumentDescription();
         }
 
         if (description.length() > GENERAL_LEDGER_PENDING_ENTRY_CODE.GLPE_DESCRIPTION_MAX_LENGTH) {
             description = description.substring(0, GENERAL_LEDGER_PENDING_ENTRY_CODE.GLPE_DESCRIPTION_MAX_LENGTH - 3) + "...";
         }
 
         return description;
     }
 
     /**
      * @see org.kuali.ole.sys.document.GeneralLedgerPostingDocumentBase#doRouteStatusChange()
      */
     @Override
     public void doRouteStatusChange(DocumentRouteStatusChange statusChangeEvent) {
         super.doRouteStatusChange(statusChangeEvent);
         this.getCapitalAssetManagementModuleService().deleteDocumentAssetLocks(this);
     }
 
 
     /**
      * @see org.kuali.rice.krad.document.DocumentBase#postProcessSave(org.kuali.rice.krad.rule.event.KualiDocumentEvent)
      */
     @Override
     public void postProcessSave(KualiDocumentEvent event) {
         super.postProcessSave(event);
         if (!(event instanceof SaveDocumentEvent)) { // don't lock until they route
             String documentTypeName = SpringContext.getBean(DataDictionaryService.class).getDocumentTypeNameByClass(this.getClass());
             this.getCapitalAssetManagementModuleService().generateCapitalAssetLock(this, documentTypeName);
         }
     }
 
     /**
      * @return CapitalAssetManagementModuleService
      */
     public CapitalAssetManagementModuleService getCapitalAssetManagementModuleService() {
         if (capitalAssetManagementModuleService == null) {
             capitalAssetManagementModuleService = SpringContext.getBean(CapitalAssetManagementModuleService.class);
         }
         return capitalAssetManagementModuleService;
     }
 }