001/*
002 * Copyright 2010-2013 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
017package org.jetbrains.jet.lang.descriptors;
018
019import org.jetbrains.annotations.NotNull;
020import org.jetbrains.annotations.Nullable;
021import org.jetbrains.jet.lang.descriptors.annotations.Annotated;
022import org.jetbrains.jet.lang.types.TypeSubstitutor;
023
024public interface DeclarationDescriptor extends Annotated, Named {
025    /**
026     * @return The descriptor that corresponds to the original declaration of this element.
027     *         A descriptor can be obtained from its original by substituting type arguments (of the declaring class
028     *         or of the element itself).
029     *         returns <code>this</code> object if the current descriptor is original itself
030     */
031    @NotNull
032    DeclarationDescriptor getOriginal();
033
034    @Nullable
035    DeclarationDescriptor getContainingDeclaration();
036
037    @Nullable
038    DeclarationDescriptor substitute(@NotNull TypeSubstitutor substitutor);
039
040    <R, D> R accept(DeclarationDescriptorVisitor<R, D> visitor, D data);
041    void acceptVoid(DeclarationDescriptorVisitor<Void, Void> visitor);
042}