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.subscription.server.logic;
018
019import com.echothree.control.user.subscription.common.spec.SubscriptionUniversalSpec;
020import com.echothree.model.control.core.common.ComponentVendors;
021import com.echothree.model.control.core.common.EntityTypes;
022import com.echothree.model.control.core.common.exception.InvalidParameterCountException;
023import com.echothree.model.control.core.server.logic.EntityInstanceLogic;
024import com.echothree.model.control.subscription.common.exception.UnknownSubscriptionNameException;
025import com.echothree.model.control.subscription.server.control.SubscriptionControl;
026import com.echothree.model.data.party.server.entity.Party;
027import com.echothree.model.data.subscription.server.entity.Subscription;
028import com.echothree.model.data.subscription.server.entity.SubscriptionType;
029import com.echothree.util.common.message.ExecutionErrors;
030import com.echothree.util.common.persistence.BasePK;
031import com.echothree.util.server.control.BaseLogic;
032import com.echothree.util.server.message.ExecutionErrorAccumulator;
033import com.echothree.util.server.persistence.EntityPermission;
034import com.echothree.util.server.persistence.Session;
035import javax.enterprise.context.ApplicationScoped;
036import javax.inject.Inject;
037
038@ApplicationScoped
039public class SubscriptionLogic
040        extends BaseLogic {
041
042    @Inject
043    SubscriptionControl subscriptionControl;
044
045    @Inject
046    EntityInstanceLogic entityInstanceLogic;
047
048    @Inject
049    SubscriptionChainLogic subscriptionChainLogic;
050
051    protected SubscriptionLogic() {
052        super();
053    }
054
055    public Subscription createSubscription(final ExecutionErrorAccumulator eea, final Session session, final SubscriptionType subscriptionType, final Party party,
056            final Long endTime, final BasePK createdBy) {
057        var subscription = subscriptionControl.createSubscription(subscriptionType, party, session.getStartTime(), endTime, createdBy);
058
059        subscriptionChainLogic.createSubscriptionInitialChainInstance(eea, subscription, createdBy);
060
061        return subscription;
062    }
063
064    public Subscription getSubscriptionByName(final ExecutionErrorAccumulator eea, final String subscriptionName,
065            final EntityPermission entityPermission) {
066        var subscription = subscriptionControl.getSubscriptionByName(subscriptionName, entityPermission);
067
068        if(subscription == null) {
069            handleExecutionError(UnknownSubscriptionNameException.class, eea, ExecutionErrors.UnknownSubscriptionName.name(), subscriptionName);
070        }
071
072        return subscription;
073    }
074
075    public Subscription getSubscriptionByName(final ExecutionErrorAccumulator eea, final String subscriptionName) {
076        return getSubscriptionByName(eea, subscriptionName, EntityPermission.READ_ONLY);
077    }
078
079    public Subscription getSubscriptionByNameForUpdate(final ExecutionErrorAccumulator eea, final String subscriptionName) {
080        return getSubscriptionByName(eea, subscriptionName, EntityPermission.READ_WRITE);
081    }
082
083    public Subscription getSubscriptionByUniversalSpec(final ExecutionErrorAccumulator eea,
084            final SubscriptionUniversalSpec universalSpec, final EntityPermission entityPermission) {
085        Subscription subscription = null;
086        var subscriptionName = universalSpec.getSubscriptionName();
087        var parameterCount = (subscriptionName == null ? 0 : 1) + entityInstanceLogic.countPossibleEntitySpecs(universalSpec);
088
089        switch(parameterCount) {
090            case 1 -> {
091                if(subscriptionName == null) {
092                    var entityInstance = entityInstanceLogic.getEntityInstance(eea, universalSpec,
093                            ComponentVendors.ECHO_THREE.name(), EntityTypes.Subscription.name());
094
095                    if(eea == null || !eea.hasExecutionErrors()) {
096                        subscription = subscriptionControl.getSubscriptionByEntityInstance(entityInstance, entityPermission);
097                    }
098                } else {
099                    subscription = getSubscriptionByName(eea, subscriptionName, entityPermission);
100                }
101            }
102            default ->
103                    handleExecutionError(InvalidParameterCountException.class, eea, ExecutionErrors.InvalidParameterCount.name());
104        }
105
106        return subscription;
107    }
108
109    public Subscription getSubscriptionByUniversalSpec(final ExecutionErrorAccumulator eea,
110            final SubscriptionUniversalSpec universalSpec) {
111        return getSubscriptionByUniversalSpec(eea, universalSpec, EntityPermission.READ_ONLY);
112    }
113
114    public Subscription getSubscriptionByUniversalSpecForUpdate(final ExecutionErrorAccumulator eea,
115            final SubscriptionUniversalSpec universalSpec) {
116        return getSubscriptionByUniversalSpec(eea, universalSpec, EntityPermission.READ_WRITE);
117    }
118
119}