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.chain.server.graphql;
018
019import com.echothree.model.control.chain.server.control.ChainControl;
020import com.echothree.model.control.graphql.server.graphql.BaseEntityInstanceObject;
021import com.echothree.model.control.graphql.server.graphql.TimeObject;
022import com.echothree.model.data.chain.server.entity.ChainInstance;
023import com.echothree.model.data.chain.server.entity.ChainInstanceDetail;
024import com.echothree.model.data.chain.server.entity.ChainInstanceStatus;
025import com.echothree.util.server.persistence.Session;
026import graphql.annotations.annotationTypes.GraphQLDescription;
027import graphql.annotations.annotationTypes.GraphQLField;
028import graphql.annotations.annotationTypes.GraphQLName;
029import graphql.annotations.annotationTypes.GraphQLNonNull;
030import graphql.schema.DataFetchingEnvironment;
031
032@GraphQLDescription("chain instance object")
033@GraphQLName("ChainInstance")
034public class ChainInstanceObject
035        extends BaseEntityInstanceObject {
036    
037    private final ChainInstance chainInstance; // Always Present
038    
039    public ChainInstanceObject(ChainInstance chainInstance) {
040        super(chainInstance.getPrimaryKey());
041        
042        this.chainInstance = chainInstance;
043    }
044
045    private ChainInstanceDetail chainInstanceDetail; // Optional, use getChainInstanceDetail()
046    
047    private ChainInstanceDetail getChainInstanceDetail() {
048        if(chainInstanceDetail == null) {
049            chainInstanceDetail = chainInstance.getLastDetail();
050        }
051        
052        return chainInstanceDetail;
053    }
054    
055    private ChainInstanceStatus chainInstanceStatus; // Optional, use getChainInstanceStatus()
056    private boolean chainInstanceStatusLoaded = false;
057
058    private ChainInstanceStatus getChainInstanceStatus() {
059        if(!chainInstanceStatusLoaded) {
060            var chainControl = Session.getModelController(ChainControl.class);
061            
062            chainInstanceStatus = chainControl.getChainInstanceStatus(chainInstance);  // May be null
063            chainInstanceStatusLoaded = true;
064        }
065
066        return chainInstanceStatus;
067    }
068
069    @GraphQLField
070    @GraphQLDescription("chain instance name")
071    @GraphQLNonNull
072    public String getChainInstanceName() {
073        return getChainInstanceDetail().getChainInstanceName();
074    }
075
076    @GraphQLField
077    @GraphQLDescription("chain")
078    public ChainObject getChain(final DataFetchingEnvironment env) {
079        return ChainSecurityUtils.getHasChainAccess(env) ? new ChainObject(getChainInstanceDetail().getChain()) : null;
080    }
081
082    @GraphQLField
083    @GraphQLDescription("next chain action set")
084    public ChainActionSetObject getNextChainActionSet(final DataFetchingEnvironment env) {
085        var chainInstanceStatus = getChainInstanceStatus();
086        ChainActionSetObject nextChainActionSet = null;
087
088        if(chainInstanceStatus != null) {
089            var chainActionSet = chainInstanceStatus.getNextChainActionSet();
090
091            if(chainActionSet != null) {
092                nextChainActionSet = ChainSecurityUtils.getHasChainActionSetAccess(env) ? new ChainActionSetObject(chainActionSet) : null;
093            }
094        }
095
096        return nextChainActionSet;
097    }
098
099    @GraphQLField
100    @GraphQLDescription("next chain action set time")
101    public TimeObject getNextChainActionSetTime() {
102        var chainInstanceStatus = getChainInstanceStatus();
103        TimeObject nextChainActionSetTime = null;
104
105        if(chainInstanceStatus != null) {
106            var time = chainInstanceStatus.getNextChainActionSetTime();
107
108            if(time != null) {
109                nextChainActionSetTime = new TimeObject(time);
110            }
111        }
112
113        return nextChainActionSetTime;
114    }
115
116}