Coverage Report - org.kuali.student.lum.workflow.MajorDisciplineStateChangeServiceImpl
 
Classes in this File Line Coverage Branch Coverage Complexity
MajorDisciplineStateChangeServiceImpl
0%
0/86
0%
0/32
2.7
 
 1  
 package org.kuali.student.lum.workflow;
 2  
 
 3  
 import java.util.Date;
 4  
 import java.util.List;
 5  
 
 6  
 import org.kuali.student.common.dto.DtoConstants;
 7  
 import org.kuali.student.common.exceptions.DoesNotExistException;
 8  
 import org.kuali.student.common.exceptions.InvalidParameterException;
 9  
 import org.kuali.student.common.exceptions.MissingParameterException;
 10  
 import org.kuali.student.common.exceptions.OperationFailedException;
 11  
 import org.kuali.student.common.versionmanagement.dto.VersionDisplayInfo;
 12  
 import org.kuali.student.core.atp.dto.AtpInfo;
 13  
 import org.kuali.student.core.atp.service.AtpService;
 14  
 import org.kuali.student.core.statement.dto.StatementTreeViewInfo;
 15  
 import org.kuali.student.lum.program.dto.MajorDisciplineInfo;
 16  
 import org.kuali.student.lum.program.dto.ProgramRequirementInfo;
 17  
 import org.kuali.student.lum.program.dto.ProgramVariationInfo;
 18  
 import org.kuali.student.lum.program.service.ProgramService;
 19  
 import org.kuali.student.lum.program.service.ProgramServiceConstants;
 20  
 import org.springframework.transaction.annotation.Transactional;
 21  
 
 22  
 /**
 23  
  * This class is called whenever the state of a major discipline changes.
 24  
  * <p>
 25  
  * We have a separate class because the operations need to be marked with the @Transactional annotation.
 26  
  * <p>
 27  
  * THIS CLASS IS DUPLICATED FOR MAJOR DISCIPLINE, CORE, AND CREDENTIAL PROGRAMS SINCE THERE ARE
 28  
  * DIFFERENT SERVICE METHODS FOR EACH OF THESE TYPES (THOUGH THEY ARE SIMILAR)
 29  
  * <P>
 30  
  * 
 31  
  * @author Kuali Rice Team (kuali-rice@googlegroups.com)
 32  
  */
 33  
 @Transactional(noRollbackFor = {DoesNotExistException.class}, rollbackFor = {Throwable.class})
 34  0
 public class MajorDisciplineStateChangeServiceImpl implements StateChangeService{
 35  
 
 36  
     /**
 37  
      * The program service - injected by spring.
 38  
      */
 39  
     private ProgramService programService;
 40  
     private AtpService atpService;
 41  
 
 42  
     /**
 43  
      * This method is called by workflow when the state changes.
 44  
      * 
 45  
      * @param majorDisciplineId
 46  
      * @param state
 47  
      * @return
 48  
      * @throws Exception
 49  
      */
 50  
     public void changeState(String majorDisciplineId, String newState) throws Exception {
 51  
         // This method will be called from workflow.
 52  
         // Since we cannot activate a program from the workflow we do not need to add endEntryTerm and endEnrollTerm
 53  0
         changeState(null, null, null, majorDisciplineId, newState);
 54  0
     }
 55  
 
 56  
     /**
 57  
      * This method is called from the UI (servlet) when state changes.
 58  
      * 
 59  
      * @param endEntryTerm
 60  
      * @param endEnrollTerm
 61  
      * @param programType
 62  
      * @param majorDisciplineId
 63  
      * @param newState
 64  
      * @return
 65  
      * @throws Exception
 66  
      */
 67  
     public void changeState(String endEntryTerm, String endEnrollTerm, String endInstAdmitTerm, String majorDisciplineId, String newState) throws Exception {
 68  
 
 69  
         // A null state is valid in some cases!
 70  
         // If rice work flow returned a code that LUM is not going to process, then
 71  
         // our ProgramPostProcessorBase will return null 
 72  
         // So, if we see a null, assume we are not supposed to process the code and simply return from
 73  
         // the method without changing state
 74  
         // 1. Blanket Approve Proposal
 75  
         // 1.1 When blanket approved is selected, rice will change status through the following codes:
 76  
         // 1.2 Workflow Status Code = R  ... Change LUM state to "Draft", create new version, update state of all objects
 77  
         // 1.3 Workflow Status Code = A  ... Code 'A' is not processed.  Do not change state in LUM.
 78  
         // 1.4 Workflow Status Code = P  ... Change LUM state to "Approved", do not create new version, update requirements and variations to state "Approved"
 79  
 
 80  0
         if (newState == null){
 81  0
             return;
 82  
         }
 83  
         
 84  
         
 85  
 
 86  
         
 87  
            
 88  
         // The version selected in the UI
 89  0
         MajorDisciplineInfo selectedVersion = programService.getMajorDiscipline(majorDisciplineId);
 90  
 
 91  
         // If we are activating this version we need to mark the previous version superseded,
 92  
         // update the previous version end terms, and make the selected version current.
 93  0
         if (newState.equals(DtoConstants.STATE_ACTIVE)) {
 94  
 
 95  
             // Find the previous version
 96  0
             MajorDisciplineInfo previousVersion = findPreviousVersion(selectedVersion);
 97  
 
 98  0
             if (previousVersion != null) {
 99  
 
 100  
                 // Set end terms on previous version
 101  0
                 setEndTerms(previousVersion, endEntryTerm, endEnrollTerm, endInstAdmitTerm);
 102  
 
 103  
                 // Mark previous version as superseded and update state on all associated objects
 104  0
                 updateMajorDisciplineInfoState(previousVersion, DtoConstants.STATE_SUPERSEDED);
 105  
             }
 106  
 
 107  
             // Update state of all associated objects for current version
 108  
             // NOTE: we must update state BEFORE making the version current
 109  0
             updateMajorDisciplineInfoState(selectedVersion, newState);
 110  
 
 111  
             // Make this the current version
 112  0
             makeCurrent(selectedVersion);
 113  0
         } else {
 114  
 
 115  
             // Update state of all associated objects for current version
 116  0
             updateMajorDisciplineInfoState(selectedVersion, newState);
 117  
         }
 118  
 
 119  
       
 120  
 
 121  0
     }
 122  
 
 123  
     /**
 124  
      * This method updates the end terms for the major discipline passed into it.
 125  
      * <p>
 126  
      * You must still call updateState() to save the object using the web service.
 127  
      * 
 128  
      * @param majorDisciplineInfo
 129  
      * @param endEntryTerm
 130  
      * @param endEnrollTerm
 131  
      * @param endInstAdmitTerm 
 132  
      * @throws OperationFailedException 
 133  
      * @throws MissingParameterException 
 134  
      * @throws InvalidParameterException 
 135  
      * @throws DoesNotExistException 
 136  
      */
 137  
     private void setEndTerms(MajorDisciplineInfo majorDisciplineInfo, String endEntryTerm, String endEnrollTerm, String endInstAdmitTerm) throws InvalidParameterException, MissingParameterException, OperationFailedException, DoesNotExistException {
 138  
         
 139  
             //Set the end terms on the major discipline
 140  0
             majorDisciplineInfo.setEndProgramEntryTerm(endEntryTerm);
 141  0
         majorDisciplineInfo.setEndTerm(endEnrollTerm);
 142  0
         majorDisciplineInfo.getAttributes().put("endInstAdmitTerm", endInstAdmitTerm);
 143  
         
 144  
         //Check if there are variations to process
 145  0
         if(!majorDisciplineInfo.getVariations().isEmpty()){
 146  
                 
 147  
                 //Find the major's end term atps and obtain their date information
 148  0
                            AtpInfo majorEndEntryTermAtp = atpService.getAtp(endEntryTerm);
 149  0
                            Date majorEndEntryTermEndDate = majorEndEntryTermAtp.getEndDate();
 150  0
                            AtpInfo majorEndEnrollTermAtp = atpService.getAtp(endEnrollTerm);
 151  0
                            Date majorEndEnrollTermEndDate = majorEndEnrollTermAtp.getEndDate();
 152  0
                        AtpInfo majorEndInstAdmitTermAtp = atpService.getAtp(endInstAdmitTerm);
 153  0
                        Date majorEndInstAdmitTermEndDate = majorEndInstAdmitTermAtp.getEndDate();
 154  
     
 155  
                        //Loop through the variations
 156  0
                 for(ProgramVariationInfo variation:majorDisciplineInfo.getVariations()){
 157  
                         //compare dates to get the older of the two end terms
 158  0
                             if(variation.getEndProgramEntryTerm() != null){
 159  0
                                     AtpInfo variationEndEntryTermAtp = atpService.getAtp(variation.getEndProgramEntryTerm());
 160  0
                                     Date variationEndEntryTermEndDate = variationEndEntryTermAtp.getEndDate();
 161  0
                                     if(majorEndEnrollTermEndDate.compareTo(variationEndEntryTermEndDate)<=0){
 162  0
                                             variation.setEndProgramEntryTerm(endEntryTerm);
 163  
                                     }
 164  0
                             }else{
 165  0
                                     variation.setEndProgramEntryTerm(endEntryTerm);
 166  
                             }
 167  
                             //compare dates to get the older of the two end terms
 168  0
                             if(variation.getEndTerm() != null){
 169  0
                                     AtpInfo variationEndTermAtp = atpService.getAtp(variation.getEndTerm());
 170  0
                                     Date variationEndTermEndDate = variationEndTermAtp.getEndDate();
 171  0
                                     if(majorEndEntryTermEndDate.compareTo(variationEndTermEndDate)<=0){
 172  0
                                             variation.setEndTerm(endEnrollTerm);
 173  
                                     }
 174  0
                             }else{
 175  0
                                     variation.setEndTerm(endEnrollTerm);
 176  
                             }
 177  
                             //compare dates to get the older of the two end terms
 178  0
                             if(variation.getAttributes().get("endInstAdmitTerm") != null){
 179  0
                                     AtpInfo variationEndInstAdmitAtp = atpService.getAtp(variation.getAttributes().get("endInstAdmitTerm"));
 180  0
                                     Date variationEndInstAdmitEndDate = variationEndInstAdmitAtp.getEndDate();
 181  0
                                     if(majorEndInstAdmitTermEndDate.compareTo(variationEndInstAdmitEndDate)<=0){
 182  0
                                             variation.getAttributes().put("endInstAdmitTerm", endInstAdmitTerm);
 183  
                                     }
 184  0
                             }else{
 185  0
                                     variation.getAttributes().put("endInstAdmitTerm", endInstAdmitTerm);
 186  
                             }
 187  
                             
 188  
                 }
 189  
         }
 190  0
     }
 191  
 
 192  
     /**
 193  
      * This method will update the state of this object and all associated objects.
 194  
      * <p>
 195  
      * It is needed because we need to make separate web service calls to update the state of these objects.
 196  
      * 
 197  
      * @param majorDisciplineInfo
 198  
      * @param newState
 199  
      */
 200  
     private void updateMajorDisciplineInfoState(MajorDisciplineInfo majorDisciplineInfo, String newState) throws Exception {
 201  
         // Update the statement tree
 202  0
         List<String> programRequirementIds = majorDisciplineInfo.getProgramRequirements();
 203  0
         updateRequirementsState(programRequirementIds, newState);
 204  
 
 205  
         
 206  
         // Update any variations 
 207  0
         List<ProgramVariationInfo> variationList = majorDisciplineInfo.getVariations();
 208  0
         updateVariationsRequirementsState(variationList, newState);
 209  
         
 210  
         
 211  
         // Update major discipline
 212  0
         majorDisciplineInfo.setState(newState);
 213  0
         programService.updateMajorDiscipline(majorDisciplineInfo);
 214  0
     }
 215  
 
 216  
     /**
 217  
      * This method will make this version of the major discipline the current one.
 218  
      * 
 219  
      * @param majorDisciplineInfo
 220  
      */
 221  
     private void makeCurrent(MajorDisciplineInfo majorDisciplineInfo) throws Exception {
 222  
 
 223  
         // Check if this is the current version before trying to make it current
 224  
         // (the web service will error if you try to make a version current that is already current)
 225  0
         VersionDisplayInfo currentVersion = programService.getCurrentVersion(ProgramServiceConstants.PROGRAM_NAMESPACE_MAJOR_DISCIPLINE_URI, majorDisciplineInfo.getVersionInfo().getVersionIndId());
 226  
 
 227  
         // If this is not the current version, then make it current
 228  0
         if (!currentVersion.getSequenceNumber().equals(majorDisciplineInfo.getVersionInfo().getSequenceNumber())) {
 229  0
             programService.setCurrentMajorDisciplineVersion(majorDisciplineInfo.getId(), null);
 230  
         }
 231  0
     }
 232  
 
 233  
     /**
 234  
      * This method finds the previous version (the version right before this one).
 235  
      * <p>
 236  
      * e.g. v1 = ACTIVE v2 = APPROVED
 237  
      * <p>
 238  
      * If you passed v2 into this method, it would return v1.
 239  
      * <p>
 240  
      * If there is only one major discipline this method will return null.
 241  
      * 
 242  
      * @param majorDisciplineInfo
 243  
      * @return
 244  
      */
 245  
     private MajorDisciplineInfo findPreviousVersion(MajorDisciplineInfo majorDisciplineInfo) throws Exception {
 246  
         // Find all previous versions using the version independent indicator
 247  0
         List<VersionDisplayInfo> versions = programService.getVersions(ProgramServiceConstants.PROGRAM_NAMESPACE_MAJOR_DISCIPLINE_URI, majorDisciplineInfo.getVersionInfo().getVersionIndId());
 248  
 
 249  
         // Take the sequence number for this version
 250  0
         Long sequenceNumber = majorDisciplineInfo.getVersionInfo().getSequenceNumber();
 251  
 
 252  
         // And subtract 1 from the sequence number to get the previous version
 253  0
         sequenceNumber -= 1;
 254  
 
 255  
         // Loop over all versions and find the previous version based on the sequence number
 256  
         /*
 257  
          * NOTE: Dan suggested we loop over all versions and change any version with state=active to state=superseded.
 258  
          * However, we decided not to go that route because we would need to pull back all data for each version to determine
 259  
          * if a version is active, since versioninfo does not have a getState() method
 260  
          */
 261  0
         MajorDisciplineInfo previousVersion = null;
 262  0
         for (VersionDisplayInfo versionInfo : versions) {
 263  0
             if (versionInfo.getSequenceNumber().equals(sequenceNumber)) {
 264  0
                 previousVersion = programService.getMajorDiscipline(versionInfo.getId());
 265  0
                 break;
 266  
             }
 267  
         }
 268  0
         return previousVersion;
 269  
     }
 270  
 
 271  
     /**
 272  
      * This method will update the requirement state.
 273  
      * <p>
 274  
      * Note that it uses StatementUtil to update the statement tree.
 275  
      * 
 276  
      * @param majorDisciplineInfo
 277  
      * @param newState
 278  
      * @throws Exception
 279  
      */
 280  
     public void updateRequirementsState(List<String> programRequirementIds, String newState) throws Exception {
 281  
     
 282  0
         for (String programRequirementId : programRequirementIds) {
 283  
 
 284  
             // Get program requirement from the program service
 285  0
             ProgramRequirementInfo programRequirementInfo = programService.getProgramRequirement(programRequirementId, null, null);
 286  
 
 287  
             // Look in the requirement for the statement tree
 288  0
             StatementTreeViewInfo statementTree = programRequirementInfo.getStatement();
 289  
 
 290  
             // And recursively update the entire tree with the new state
 291  0
             StatementUtil.updateStatementTreeViewInfoState(newState, statementTree);
 292  
 
 293  
             // Update the state of the requirement object
 294  0
             programRequirementInfo.setState(newState);
 295  
 
 296  
             // The write the requirement back to the program service
 297  0
             programService.updateProgramRequirement(programRequirementInfo);
 298  
 
 299  0
         }
 300  0
     }
 301  
 
 302  
     /**
 303  
      * This method will update the requirements of each variation.
 304  
      * <p>
 305  
      * We need to do this here as opposed to in the assemblers, since we need
 306  
      * to make calls out to a separate web service.  Also, this needs to be done here
 307  
      * because changing state no longer calls the save function.
 308  
      * <p>
 309  
      * Note that core and credential programs do not have variations so
 310  
      * this method isn't necessary.
 311  
      * <p>
 312  
      * 
 313  
      * @param majorDisciplineInfo
 314  
      * @param newState
 315  
      * @throws Exception
 316  
      */
 317  
     public void updateVariationsRequirementsState(List<ProgramVariationInfo> variationList, String newState) throws Exception {
 318  
 
 319  
         // Iterate over all variations
 320  0
         for (ProgramVariationInfo variation : variationList) {
 321  
      
 322  
             // Get the requirements 
 323  0
             List<String> programRequirementIds = variation.getProgramRequirements();
 324  
             
 325  
             // Call the method that will update the requirements state for the program
 326  
             // This will also update the statement tree
 327  0
             updateRequirementsState(programRequirementIds, newState);
 328  0
          }
 329  0
     }
 330  
     
 331  
 
 332  
     /**
 333  
      * This method is used by Spring to inject the program service into this bean.
 334  
      * 
 335  
      * @param programService
 336  
      */
 337  
     public void setProgramService(ProgramService programService) {
 338  0
         this.programService = programService;
 339  0
     }
 340  
 
 341  
     public void setAtpService(AtpService atpService) {
 342  0
                 this.atpService = atpService;
 343  0
         }
 344  
 
 345  
 }