001// --------------------------------------------------------------------------------
002// Copyright 2002-2024 Echo Three, LLC
003//
004// Licensed under the Apache License, Version 2.0 (the "License");
005// you may not use this file except in compliance with the License.
006// You may obtain a copy of the License at
007//
008//     http://www.apache.org/licenses/LICENSE-2.0
009//
010// Unless required by applicable law or agreed to in writing, software
011// distributed under the License is distributed on an "AS IS" BASIS,
012// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013// See the License for the specific language governing permissions and
014// limitations under the License.
015// --------------------------------------------------------------------------------
016
017package com.echothree.control.user.core.server.command;
018
019import com.echothree.control.user.core.common.edit.ApplicationEdit;
020import com.echothree.control.user.core.common.edit.CoreEditFactory;
021import com.echothree.control.user.core.common.form.EditApplicationForm;
022import com.echothree.control.user.core.common.result.CoreResultFactory;
023import com.echothree.control.user.core.common.result.EditApplicationResult;
024import com.echothree.control.user.core.common.spec.ApplicationSpec;
025import com.echothree.model.control.party.common.PartyTypes;
026import com.echothree.model.control.security.common.SecurityRoleGroups;
027import com.echothree.model.control.security.common.SecurityRoles;
028import com.echothree.model.data.core.server.entity.Application;
029import com.echothree.model.data.core.server.entity.ApplicationDescription;
030import com.echothree.model.data.core.server.entity.ApplicationDetail;
031import com.echothree.model.data.core.server.value.ApplicationDescriptionValue;
032import com.echothree.model.data.core.server.value.ApplicationDetailValue;
033import com.echothree.model.data.user.common.pk.UserVisitPK;
034import com.echothree.util.common.message.ExecutionErrors;
035import com.echothree.util.common.validation.FieldDefinition;
036import com.echothree.util.common.validation.FieldType;
037import com.echothree.util.common.command.EditMode;
038import com.echothree.util.server.control.BaseAbstractEditCommand;
039import com.echothree.util.server.control.CommandSecurityDefinition;
040import com.echothree.util.server.control.PartyTypeDefinition;
041import com.echothree.util.server.control.SecurityRoleDefinition;
042import java.util.Arrays;
043import java.util.Collections;
044import java.util.List;
045
046public class EditApplicationCommand
047        extends BaseAbstractEditCommand<ApplicationSpec, ApplicationEdit, EditApplicationResult, Application, Application> {
048    
049    private final static CommandSecurityDefinition COMMAND_SECURITY_DEFINITION;
050    private final static List<FieldDefinition> SPEC_FIELD_DEFINITIONS;
051    private final static List<FieldDefinition> EDIT_FIELD_DEFINITIONS;
052    
053    static {
054        COMMAND_SECURITY_DEFINITION = new CommandSecurityDefinition(Collections.unmodifiableList(Arrays.asList(
055                new PartyTypeDefinition(PartyTypes.UTILITY.name(), null),
056                new PartyTypeDefinition(PartyTypes.EMPLOYEE.name(), Collections.unmodifiableList(Arrays.asList(
057                        new SecurityRoleDefinition(SecurityRoleGroups.Application.name(), SecurityRoles.Edit.name())
058                        )))
059                )));
060        
061        SPEC_FIELD_DEFINITIONS = Collections.unmodifiableList(Arrays.asList(
062                new FieldDefinition("ApplicationName", FieldType.ENTITY_NAME, true, null, null)
063                ));
064        
065        EDIT_FIELD_DEFINITIONS = Collections.unmodifiableList(Arrays.asList(
066                new FieldDefinition("ApplicationName", FieldType.ENTITY_NAME, true, null, null),
067                new FieldDefinition("IsDefault", FieldType.BOOLEAN, true, null, null),
068                new FieldDefinition("SortOrder", FieldType.SIGNED_INTEGER, true, null, null),
069                new FieldDefinition("Description", FieldType.STRING, false, 1L, 132L)
070                ));
071    }
072    
073    /** Creates a new instance of EditApplicationCommand */
074    public EditApplicationCommand(UserVisitPK userVisitPK, EditApplicationForm form) {
075        super(userVisitPK, form, COMMAND_SECURITY_DEFINITION, SPEC_FIELD_DEFINITIONS, EDIT_FIELD_DEFINITIONS);
076    }
077    
078    @Override
079    public EditApplicationResult getResult() {
080        return CoreResultFactory.getEditApplicationResult();
081    }
082
083    @Override
084    public ApplicationEdit getEdit() {
085        return CoreEditFactory.getApplicationEdit();
086    }
087
088    @Override
089    public Application getEntity(EditApplicationResult result) {
090        var coreControl = getCoreControl();
091        Application application;
092        String applicationName = spec.getApplicationName();
093
094        if(editMode.equals(EditMode.LOCK) || editMode.equals(EditMode.ABANDON)) {
095            application = coreControl.getApplicationByName(applicationName);
096        } else { // EditMode.UPDATE
097            application = coreControl.getApplicationByNameForUpdate(applicationName);
098        }
099
100        if(application == null) {
101            addExecutionError(ExecutionErrors.UnknownApplicationName.name(), applicationName);
102        }
103
104        return application;
105    }
106
107    @Override
108    public Application getLockEntity(Application application) {
109        return application;
110    }
111
112    @Override
113    public void fillInResult(EditApplicationResult result, Application application) {
114        var coreControl = getCoreControl();
115
116        result.setApplication(coreControl.getApplicationTransfer(getUserVisit(), application));
117    }
118
119    @Override
120    public void doLock(ApplicationEdit edit, Application application) {
121        var coreControl = getCoreControl();
122        ApplicationDescription applicationDescription = coreControl.getApplicationDescription(application, getPreferredLanguage());
123        ApplicationDetail applicationDetail = application.getLastDetail();
124
125        edit.setApplicationName(applicationDetail.getApplicationName());
126        edit.setIsDefault(applicationDetail.getIsDefault().toString());
127        edit.setSortOrder(applicationDetail.getSortOrder().toString());
128
129        if(applicationDescription != null) {
130            edit.setDescription(applicationDescription.getDescription());
131        }
132    }
133
134    @Override
135    public void canUpdate(Application application) {
136        var coreControl = getCoreControl();
137        String applicationName = edit.getApplicationName();
138        Application duplicateApplication = coreControl.getApplicationByName(applicationName);
139
140        if(duplicateApplication != null && !application.equals(duplicateApplication)) {
141            addExecutionError(ExecutionErrors.DuplicateApplicationName.name(), applicationName);
142        }
143    }
144
145    @Override
146    public void doUpdate(Application application) {
147        var coreControl = getCoreControl();
148        var partyPK = getPartyPK();
149        ApplicationDetailValue applicationDetailValue = coreControl.getApplicationDetailValueForUpdate(application);
150        ApplicationDescription applicationDescription = coreControl.getApplicationDescriptionForUpdate(application, getPreferredLanguage());
151        String description = edit.getDescription();
152
153        applicationDetailValue.setApplicationName(edit.getApplicationName());
154        applicationDetailValue.setIsDefault(Boolean.valueOf(edit.getIsDefault()));
155        applicationDetailValue.setSortOrder(Integer.valueOf(edit.getSortOrder()));
156
157        coreControl.updateApplicationFromValue(applicationDetailValue, partyPK);
158
159        if(applicationDescription == null && description != null) {
160            coreControl.createApplicationDescription(application, getPreferredLanguage(), description, partyPK);
161        } else {
162            if(applicationDescription != null && description == null) {
163                coreControl.deleteApplicationDescription(applicationDescription, partyPK);
164            } else {
165                if(applicationDescription != null && description != null) {
166                    ApplicationDescriptionValue applicationDescriptionValue = coreControl.getApplicationDescriptionValue(applicationDescription);
167
168                    applicationDescriptionValue.setDescription(description);
169                    coreControl.updateApplicationDescriptionFromValue(applicationDescriptionValue, partyPK);
170                }
171            }
172        }
173    }
174    
175}