/*******************************************************************************
* Copyright (c) 2005, 2008 BEA Systems, Inc.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* tyeung@bea.com - initial API and implementation
* IBM Corporation - changed interface to extend IBinding
* IBM Corporation - renamed from IResolvedAnnotation to IAnnotationBinding
*******************************************************************************/
package org.eclipse.jdt.core.dom;
/**
* Represents a resolved annotation. Resolved annotations are computed along with other bindings;
* they correspond to {@link Annotation} nodes.
*
* @since 3.2
* @noimplement This interface is not intended to be implemented by clients.
*/
public interface IAnnotationBinding extends IBinding {
/**
* Returns the complete list of member value pairs for this annotation, including ones
* explicitly listed in the annotation as well as entries for annotation type members with
* default values that are implied.
*
* @return a possibly empty list of resolved member value pairs
*/
IMemberValuePairBinding[] getAllMemberValuePairs();
/**
* Returns the type of the annotation. The resulting type binding will always return
* <code>true</code> to <code>ITypeBinding.isAnnotation()</code>.
*
* @return the type of the annotation
*/
ITypeBinding getAnnotationType();
/**
* Returns the list of declared member value pairs for this annotation. Returns an empty list
* for a {@link MarkerAnnotation}, a one element list for a {@link SingleMemberAnnotation}, and
* one entry for each of the explicitly listed values in a {@link NormalAnnotation}.
* <p>
* Note that the list only includes entries for annotation type members that are explicitly
* mentioned in the annotation. The list does not include any annotation type members with
* default values that are merely implied. Use {@link #getAllMemberValuePairs()} to get those as
* well.
* </p>
*
* @return a possibly empty list of resolved member value pairs
*/
IMemberValuePairBinding[] getDeclaredMemberValuePairs();
/**
* Returns the name of the annotation type.
*
* @return the name of the annotation type
*/
public String getName();
}