001    /*
002     * Copyright 2010-2015 JetBrains s.r.o.
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    
017    package org.jetbrains.kotlin.resolve.calls.model;
018    
019    import org.jetbrains.annotations.NotNull;
020    import org.jetbrains.annotations.Nullable;
021    import org.jetbrains.kotlin.descriptors.CallableDescriptor;
022    import org.jetbrains.kotlin.descriptors.TypeParameterDescriptor;
023    import org.jetbrains.kotlin.descriptors.ValueParameterDescriptor;
024    import org.jetbrains.kotlin.psi.Call;
025    import org.jetbrains.kotlin.psi.ValueArgument;
026    import org.jetbrains.kotlin.resolve.calls.results.ResolutionStatus;
027    import org.jetbrains.kotlin.resolve.calls.tasks.ExplicitReceiverKind;
028    import org.jetbrains.kotlin.resolve.scopes.receivers.ReceiverValue;
029    import org.jetbrains.kotlin.types.KotlinType;
030    
031    import java.util.List;
032    import java.util.Map;
033    
034    public interface ResolvedCall<D extends CallableDescriptor> {
035        @NotNull
036        ResolutionStatus getStatus();
037    
038        /** The call that was resolved to this ResolvedCall */
039        @NotNull
040        Call getCall();
041    
042        /** A target callable descriptor as it was accessible in the corresponding scope, i.e. with type arguments not substituted */
043        @NotNull
044        D getCandidateDescriptor();
045    
046        /** Type arguments are substituted. This descriptor is guaranteed to have NO declared type parameters */
047        @NotNull
048        D getResultingDescriptor();
049    
050        /** If the target was an extension function or property, this is the value for its receiver parameter */
051        @NotNull
052        ReceiverValue getExtensionReceiver();
053    
054        /** If the target was a member of a class, this is the object of that class to call it on */
055        @NotNull
056        ReceiverValue getDispatchReceiver();
057    
058        /** Determines whether receiver argument or this object is substituted for explicit receiver */
059        @NotNull
060        ExplicitReceiverKind getExplicitReceiverKind();
061    
062        /** Values (arguments) for value parameters */
063        @NotNull
064        Map<ValueParameterDescriptor, ResolvedValueArgument> getValueArguments();
065    
066        /** Values (arguments) for value parameters indexed by parameter index */
067        @Nullable
068        List<ResolvedValueArgument> getValueArgumentsByIndex();
069    
070        /** The result of mapping the value argument to a parameter */
071        @NotNull
072        ArgumentMapping getArgumentMapping(@NotNull ValueArgument valueArgument);
073    
074        /** What's substituted for type parameters */
075        @NotNull
076        Map<TypeParameterDescriptor, KotlinType> getTypeArguments();
077    
078        /** Data flow info for each argument and the result data flow info */
079        @NotNull
080        DataFlowInfoForArguments getDataFlowInfoForArguments();
081    
082        boolean isSafeCall();
083    }