001// --------------------------------------------------------------------------------
002// Copyright 2002-2026 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.CoreEditFactory;
020import com.echothree.control.user.core.common.edit.LinkCardinalityEdit;
021import com.echothree.control.user.core.common.result.CoreResultFactory;
022import com.echothree.control.user.core.common.result.EditLinkCardinalityResult;
023import com.echothree.control.user.core.common.spec.LinkCardinalityUniversalSpec;
024import com.echothree.model.control.core.server.control.LinkCardinalityControl;
025import com.echothree.model.control.core.server.logic.LinkCardinalityLogic;
026import com.echothree.model.control.party.common.PartyTypes;
027import com.echothree.model.control.security.common.SecurityRoleGroups;
028import com.echothree.model.control.security.common.SecurityRoles;
029import com.echothree.model.data.core.server.entity.LinkCardinality;
030import com.echothree.util.common.message.ExecutionErrors;
031import com.echothree.util.common.validation.FieldDefinition;
032import com.echothree.util.common.validation.FieldType;
033import com.echothree.util.server.control.BaseAbstractEditCommand;
034import com.echothree.util.server.control.CommandSecurityDefinition;
035import com.echothree.util.server.control.PartyTypeDefinition;
036import com.echothree.util.server.control.SecurityRoleDefinition;
037import java.util.List;
038import javax.enterprise.context.Dependent;
039import javax.inject.Inject;
040
041@Dependent
042public class EditLinkCardinalityCommand
043        extends BaseAbstractEditCommand<LinkCardinalityUniversalSpec, LinkCardinalityEdit, EditLinkCardinalityResult, LinkCardinality, LinkCardinality> {
044
045    private final static CommandSecurityDefinition COMMAND_SECURITY_DEFINITION;
046    private final static List<FieldDefinition> SPEC_FIELD_DEFINITIONS;
047    private final static List<FieldDefinition> EDIT_FIELD_DEFINITIONS;
048
049    static {
050        COMMAND_SECURITY_DEFINITION = new CommandSecurityDefinition(List.of(
051                new PartyTypeDefinition(PartyTypes.UTILITY.name(), null),
052                new PartyTypeDefinition(PartyTypes.EMPLOYEE.name(), List.of(
053                        new SecurityRoleDefinition(SecurityRoleGroups.LinkCardinality.name(), SecurityRoles.Edit.name())
054                ))
055        ));
056
057        SPEC_FIELD_DEFINITIONS = List.of(
058                new FieldDefinition("LinkCardinalityName", FieldType.ENTITY_NAME, false, null, null),
059                new FieldDefinition("EntityRef", FieldType.ENTITY_REF, false, null, null),
060                new FieldDefinition("Uuid", FieldType.UUID, false, null, null)
061        );
062
063        EDIT_FIELD_DEFINITIONS = List.of(
064                new FieldDefinition("LinkCardinalityName", FieldType.ENTITY_NAME, true, null, null),
065                new FieldDefinition("IsDefault", FieldType.BOOLEAN, true, null, null),
066                new FieldDefinition("SortOrder", FieldType.SIGNED_INTEGER, true, null, null),
067                new FieldDefinition("Description", FieldType.STRING, false, 1L, 132L)
068        );
069    }
070
071    @Inject
072    LinkCardinalityControl linkCardinalityControl;
073
074    @Inject
075    LinkCardinalityLogic linkCardinalityLogic;
076
077    /** Creates a new instance of EditLinkCardinalityCommand */
078    public EditLinkCardinalityCommand() {
079        super(COMMAND_SECURITY_DEFINITION, SPEC_FIELD_DEFINITIONS, EDIT_FIELD_DEFINITIONS);
080    }
081
082    @Override
083    public EditLinkCardinalityResult getResult() {
084        return CoreResultFactory.getEditLinkCardinalityResult();
085    }
086
087    @Override
088    public LinkCardinalityEdit getEdit() {
089        return CoreEditFactory.getLinkCardinalityEdit();
090    }
091
092    @Override
093    public LinkCardinality getEntity(EditLinkCardinalityResult result) {
094        var linkCardinality = linkCardinalityLogic.getLinkCardinalityByUniversalSpec(this, spec, false,
095                editModeToEntityPermission(editMode));
096
097        if(!hasExecutionErrors()) {
098            result.setLinkCardinality(linkCardinalityControl.getLinkCardinalityTransfer(getUserVisit(), linkCardinality));
099        }
100
101        return linkCardinality;
102    }
103
104    @Override
105    public LinkCardinality getLockEntity(LinkCardinality linkCardinality) {
106        return linkCardinality;
107    }
108
109    @Override
110    public void fillInResult(EditLinkCardinalityResult result, LinkCardinality linkCardinality) {
111        result.setLinkCardinality(linkCardinalityControl.getLinkCardinalityTransfer(getUserVisit(), linkCardinality));
112    }
113
114    @Override
115    public void doLock(LinkCardinalityEdit edit, LinkCardinality linkCardinality) {
116        var linkCardinalityDescription = linkCardinalityControl.getLinkCardinalityDescription(linkCardinality, getPreferredLanguage());
117        var linkCardinalityDetail = linkCardinality.getLastDetail();
118
119        edit.setLinkCardinalityName(linkCardinalityDetail.getLinkCardinalityName());
120        edit.setIsDefault(linkCardinalityDetail.getIsDefault().toString());
121        edit.setSortOrder(linkCardinalityDetail.getSortOrder().toString());
122
123        if(linkCardinalityDescription != null) {
124            edit.setDescription(linkCardinalityDescription.getDescription());
125        }
126    }
127
128    @Override
129    public void canUpdate(LinkCardinality linkCardinality) {
130        var linkCardinalityName = edit.getLinkCardinalityName();
131        var duplicateLinkCardinality = linkCardinalityControl.getLinkCardinalityByName(linkCardinalityName);
132
133        if(duplicateLinkCardinality != null && !linkCardinality.equals(duplicateLinkCardinality)) {
134            addExecutionError(ExecutionErrors.DuplicateLinkCardinalityName.name(), linkCardinalityName);
135        }
136    }
137
138    @Override
139    public void doUpdate(LinkCardinality linkCardinality) {
140        var partyPK = getPartyPK();
141        var linkCardinalityDetailValue = linkCardinalityControl.getLinkCardinalityDetailValueForUpdate(linkCardinality);
142        var linkCardinalityDescription = linkCardinalityControl.getLinkCardinalityDescriptionForUpdate(linkCardinality, getPreferredLanguage());
143        var description = edit.getDescription();
144
145        linkCardinalityDetailValue.setLinkCardinalityName(edit.getLinkCardinalityName());
146        linkCardinalityDetailValue.setIsDefault(Boolean.valueOf(edit.getIsDefault()));
147        linkCardinalityDetailValue.setSortOrder(Integer.valueOf(edit.getSortOrder()));
148
149        linkCardinalityLogic.updateLinkCardinalityFromValue(linkCardinalityDetailValue, partyPK);
150
151        if(linkCardinalityDescription == null && description != null) {
152            linkCardinalityControl.createLinkCardinalityDescription(linkCardinality, getPreferredLanguage(), description, partyPK);
153        } else {
154            if(linkCardinalityDescription != null && description == null) {
155                linkCardinalityControl.deleteLinkCardinalityDescription(linkCardinalityDescription, partyPK);
156            } else {
157                if(linkCardinalityDescription != null && description != null) {
158                    var linkCardinalityDescriptionValue = linkCardinalityControl.getLinkCardinalityDescriptionValue(linkCardinalityDescription);
159
160                    linkCardinalityDescriptionValue.setDescription(description);
161                    linkCardinalityControl.updateLinkCardinalityDescriptionFromValue(linkCardinalityDescriptionValue, partyPK);
162                }
163            }
164        }
165    }
166
167}