summaryrefslogtreecommitdiff
path: root/src/msil/ch/epfl/lamp/compiler/msil/ICustomAttributeProvider.java
blob: 4eafc37ef3492e7158c7e91b23f9afe5c080a1cc (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
/*
 * System.Reflection-like API for access to .NET assemblies (DLL & EXE)
 */

// $Id$

package ch.epfl.lamp.compiler.msil;

/**
 * Provides custom attributes for reflection objects that support them.
 *
 * @author Nikolay Mihaylov
 * @version 1.0
 */
public interface ICustomAttributeProvider {

    //##########################################################################
    // interface method definitions

    /** Returns an array of all of the custom attributes
     *  defined on this member, excluding named attributes,
     * 	or an empty array if there are no custom attributes.
     *
     *  @param inherit - When true, look up the hierarchy chain
     *                   for the inherited custom attribute.
     *  @return - An array of Objects representing custom attributes,
     *            or an empty array.
     */
    public Object[] GetCustomAttributes(boolean inherit);


    /** Returns an array of custom attributes defined on this member,
     *  identified by type, or an empty array
     *  if there are no custom attributes of that type.
     *
     *  @param attributeType - The type of the custom attributes.
     *  @param inherit - When true, look up the hierarchy chain
     *                   for the inherited custom attribute.
     *  @return - An array of Objects representing custom attributes,
     *            or an empty array.
     */
    public Object[] GetCustomAttributes(Type attributeType, boolean inherit);


    /** Indicates whether one or more instance of attributeType
     *  is defined on this member
     *
     *  @param attributeType - The type of the custom attributes
     *  @param inherit - When true, look up the hierarchy chain
     *                   for the inherited custom attribute.
     *  @return - true if the attributeType is defined on this member;
     *            false otherwise.
     */
    public boolean IsDefined(Type attributeType, boolean inherit);

    //##########################################################################

}  // interface ICustomAttributeProvider