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.model.control.associate.server.logic;
018
019import com.echothree.control.user.associate.common.spec.AssociateUniversalSpec;
020import com.echothree.model.control.associate.common.exception.CannotDeleteAssociateInUseException;
021import com.echothree.model.control.associate.common.exception.DuplicateAssociateNameException;
022import com.echothree.model.control.associate.common.exception.UnknownAssociateNameException;
023import com.echothree.model.control.associate.common.exception.UnknownDefaultAssociateProgramException;
024import com.echothree.model.control.associate.server.control.AssociateControl;
025import com.echothree.model.control.core.common.ComponentVendors;
026import com.echothree.model.control.core.common.EntityTypes;
027import com.echothree.model.control.core.common.exception.InvalidParameterCountException;
028import com.echothree.model.control.core.server.logic.EntityInstanceLogic;
029import com.echothree.model.data.associate.server.entity.Associate;
030import com.echothree.model.data.associate.server.entity.AssociateProgram;
031import com.echothree.model.data.core.server.entity.MimeType;
032import com.echothree.model.data.party.server.entity.Party;
033import com.echothree.util.common.message.ExecutionErrors;
034import com.echothree.util.common.persistence.BasePK;
035import com.echothree.util.server.control.BaseLogic;
036import com.echothree.util.server.message.ExecutionErrorAccumulator;
037import com.echothree.util.server.persistence.EntityPermission;
038import com.echothree.util.server.validation.ParameterUtils;
039import javax.enterprise.context.ApplicationScoped;
040import javax.inject.Inject;
041
042@ApplicationScoped
043public class AssociateLogic
044        extends BaseLogic {
045
046    @Inject
047    AssociateControl associateControl;
048
049    @Inject
050    EntityInstanceLogic entityInstanceLogic;
051
052    @Inject
053    AssociateProgramLogic associateProgramLogic;
054
055    protected AssociateLogic() {
056        super();
057    }
058
059    public Associate createAssociate(final ExecutionErrorAccumulator eea, final String associateProgramName,
060            final String associateName, final Party party, final String description, final MimeType summaryMimeType,
061            final String summary, final BasePK createdBy) {
062        var associateProgram = associateProgramLogic.getAssociateProgramByName(eea, associateProgramName);
063        Associate associate = null;
064
065        if(eea == null || !eea.hasExecutionErrors()) {
066            associate = createAssociate(eea, associateProgram, associateName, party, description, summaryMimeType,
067                    summary, createdBy);
068        }
069
070        return associate;
071    }
072
073    public Associate createAssociate(final ExecutionErrorAccumulator eea, final AssociateProgram associateProgram,
074            final String associateName, final Party party, final String description, final MimeType summaryMimeType,
075            final String summary, final BasePK createdBy) {
076        var associate = associateControl.getAssociateByName(associateProgram, associateName);
077
078        if(associate == null) {
079            associate = associateControl.createAssociate(associateProgram, associateName, party, description,
080                    summaryMimeType, summary, createdBy);
081        } else {
082            handleExecutionError(DuplicateAssociateNameException.class, eea,
083                    ExecutionErrors.DuplicateAssociateName.name(), associateName);
084        }
085
086        return associate;
087    }
088
089    public Associate getAssociateByName(final ExecutionErrorAccumulator eea, final AssociateProgram associateProgram,
090            final String associateName, final EntityPermission entityPermission) {
091        var associate = associateControl.getAssociateByName(associateProgram, associateName, entityPermission);
092
093        if(associate == null) {
094            handleExecutionError(UnknownAssociateNameException.class, eea, ExecutionErrors.UnknownAssociateName.name(),
095                    associateProgram.getLastDetail().getAssociateProgramName(), associateName);
096        }
097
098        return associate;
099    }
100
101    public Associate getAssociateByName(final ExecutionErrorAccumulator eea, final AssociateProgram associateProgram,
102            final String associateName) {
103        return getAssociateByName(eea, associateProgram, associateName, EntityPermission.READ_ONLY);
104    }
105
106    public Associate getAssociateByNameForUpdate(final ExecutionErrorAccumulator eea,
107            final AssociateProgram associateProgram, final String associateName) {
108        return getAssociateByName(eea, associateProgram, associateName, EntityPermission.READ_WRITE);
109    }
110
111    public Associate getAssociateByName(final ExecutionErrorAccumulator eea, final String associateProgramName,
112            final String associateName, final EntityPermission entityPermission) {
113        var associateProgram = associateProgramLogic.getAssociateProgramByName(eea, associateProgramName);
114        Associate associate = null;
115
116        if(eea == null || !eea.hasExecutionErrors()) {
117            associate = getAssociateByName(eea, associateProgram, associateName, entityPermission);
118        }
119
120        return associate;
121    }
122
123    public Associate getAssociateByName(final ExecutionErrorAccumulator eea, final String associateProgramName,
124            final String associateName) {
125        return getAssociateByName(eea, associateProgramName, associateName, EntityPermission.READ_ONLY);
126    }
127
128    public Associate getAssociateByNameForUpdate(final ExecutionErrorAccumulator eea,
129            final String associateProgramName, final String associateName) {
130        return getAssociateByName(eea, associateProgramName, associateName, EntityPermission.READ_WRITE);
131    }
132
133    public Associate getAssociateByUniversalSpec(final ExecutionErrorAccumulator eea,
134            final AssociateUniversalSpec universalSpec, final boolean allowDefault,
135            final EntityPermission entityPermission) {
136        var associateProgramName = universalSpec.getAssociateProgramName();
137        var associateName = universalSpec.getAssociateName();
138        var nameParameterCount = ParameterUtils.getInstance().countNonNullParameters(associateProgramName,
139                associateName);
140        var possibleEntitySpecs = entityInstanceLogic.countPossibleEntitySpecs(universalSpec);
141        Associate associate = null;
142
143        if(nameParameterCount < 3 && possibleEntitySpecs == 0) {
144            AssociateProgram associateProgram = null;
145
146            if(associateProgramName == null) {
147                if(allowDefault) {
148                    associateProgram = associateControl.getDefaultAssociateProgram();
149
150                    if(associateProgram == null) {
151                        handleExecutionError(UnknownDefaultAssociateProgramException.class, eea,
152                                ExecutionErrors.UnknownDefaultAssociateProgram.name());
153                    }
154                } else {
155                    handleExecutionError(InvalidParameterCountException.class, eea,
156                            ExecutionErrors.InvalidParameterCount.name());
157                }
158            } else {
159                associateProgram = associateProgramLogic.getAssociateProgramByName(eea, associateProgramName);
160            }
161
162            if(eea == null || !eea.hasExecutionErrors()) {
163                if(associateName == null) {
164                    handleExecutionError(InvalidParameterCountException.class, eea,
165                            ExecutionErrors.InvalidParameterCount.name());
166                } else {
167                    associate = getAssociateByName(eea, associateProgram, associateName, entityPermission);
168                }
169            }
170        } else if(nameParameterCount == 0 && possibleEntitySpecs == 1) {
171            var entityInstance = entityInstanceLogic.getEntityInstance(eea, universalSpec,
172                    ComponentVendors.ECHO_THREE.name(), EntityTypes.Associate.name());
173
174            if(eea == null || !eea.hasExecutionErrors()) {
175                associate = associateControl.getAssociateByEntityInstance(entityInstance, entityPermission);
176            }
177        } else {
178            handleExecutionError(InvalidParameterCountException.class, eea,
179                    ExecutionErrors.InvalidParameterCount.name());
180        }
181
182        return associate;
183    }
184
185    public Associate getAssociateByUniversalSpec(final ExecutionErrorAccumulator eea,
186            final AssociateUniversalSpec universalSpec, final boolean allowDefault) {
187        return getAssociateByUniversalSpec(eea, universalSpec, allowDefault, EntityPermission.READ_ONLY);
188    }
189
190    public Associate getAssociateByUniversalSpecForUpdate(final ExecutionErrorAccumulator eea,
191            final AssociateUniversalSpec universalSpec, final boolean allowDefault) {
192        return getAssociateByUniversalSpec(eea, universalSpec, allowDefault, EntityPermission.READ_WRITE);
193    }
194
195    public void deleteAssociate(final ExecutionErrorAccumulator eea, final Associate associate,
196            final BasePK deletedBy) {
197        var associatePartyContactMechanismCount = associateControl
198                .countAssociatePartyContactMechanismsByAssociate(associate);
199        var associateReferralCount = associateControl.countAssociateReferralsByAssociate(associate);
200
201        if(associatePartyContactMechanismCount == 0 && associateReferralCount == 0) {
202            associateControl.deleteAssociate(associate, deletedBy);
203        } else {
204            var associateDetail = associate.getLastDetail();
205
206            handleExecutionError(CannotDeleteAssociateInUseException.class, eea,
207                    ExecutionErrors.CannotDeleteAssociateInUse.name(),
208                    associateDetail.getAssociateProgram().getLastDetail().getAssociateProgramName(),
209                    associateDetail.getAssociateName());
210        }
211    }
212
213}