1 /*
   2  * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.  Oracle designates this
   8  * particular file as subject to the "Classpath" exception as provided
   9  * by Oracle in the LICENSE file that accompanied this code.
  10  *
  11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package java.lang.reflect;
  27 
  28 /**
  29  * Member is an interface that reflects identifying information about
  30  * a single member (a field or a method) or a constructor.
  31  *
  32  * @see java.lang.Class
  33  * @see Field
  34  * @see Method
  35  * @see Constructor
  36  *
  37  * @author Nakul Saraiya
  38  * @since 1.1
  39  */
  40 public
  41 interface Member {
  42 
  43     /**
  44      * Identifies the set of all public members of a class or interface,
  45      * including inherited members.
  46      */
  47     public static final int PUBLIC = 0;
  48 
  49     /**
  50      * Identifies the set of declared members of a class or interface.
  51      * Inherited members are not included.
  52      */
  53     public static final int DECLARED = 1;
  54 
  55     /**
  56      * Returns the Class object representing the class or interface
  57      * that declares the member or constructor represented by this Member.
  58      *
  59      * @return an object representing the declaring class of the
  60      * underlying member
  61      */
  62     public Class<?> getDeclaringClass();
  63 
  64     /**
  65      * Returns the simple name of the underlying member or constructor
  66      * represented by this Member.
  67      *
  68      * @return the simple name of the underlying member
  69      */
  70     public String getName();
  71 
  72     /**
  73      * Returns the Java language modifiers for the member or
  74      * constructor represented by this Member, as an integer.  The
  75      * Modifier class should be used to decode the modifiers in
  76      * the integer.
  77      *
  78      * @return the Java language modifiers for the underlying member
  79      * @see Modifier
  80      */
  81     public int getModifiers();
  82 
  83     /**
  84      * Returns {@code true} if this member was introduced by
  85      * the compiler; returns {@code false} otherwise.
  86      *
  87      * @return true if and only if this member was introduced by
  88      * the compiler.
  89      * @jls 13.1 The Form of a Binary
  90      * @since 1.5
  91      */
  92     public boolean isSynthetic();
  93 }