java.lang.Class<T>
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
java.lang.Object
T - この Class オブジェクトによりモデル化されるクラスの型。たとえば、String.class の型は Class<String> である。モデル化されるクラスが不明の場合は、Class<?> を使用するpublic final class Class<T>
Class クラスのインスタンスは、実行中の Java アプリケーションのクラスおよびインタフェースを表します。列挙はクラスの一種、注釈はインタフェースの一種です。同様にどの配列も、同じ要素型および次元数を持つすべての配列により共有される Class オブジェクトとしてリフレクトされるクラスに属します。Java のプリミティブ型 (boolean、byte、char、short、int、long、float、double) に加え、キーワード void も Class オブジェクトで表されます。
Class には、public コンストラクタはありません。Class オブジェクトは、クラスがロードされる際に Java 仮想マシンによって、およびクラスローダーの defineClass メソッドの呼び出しによって自動的に構築されます。
以下の例では、Class オブジェクトを使ってオブジェクトのクラス名を出力します。
void printClassName(Object obj) {
System.out.println("The class of " + obj +
" is " + obj.getClass().getName());
}
クラスリテラルを使って、名前付き型 (または void) のための Class オブジェクトを取得することもできます (JLS セクション 15.8.2)。例を示します。
System.out.println("The name of class Foo is: "+Foo.class.getName());
ClassLoader.defineClass(byte[], int, int),
直列化された形式| メソッドの概要 | ||
|---|---|---|
|
asSubclass(Class<U> clazz)
指定されたクラスオブジェクトによって表されるクラスのサブクラスを表すためにこの Class オブジェクトをキャストします。 |
|
T |
cast(Object obj)
この Class オブジェクトが表すクラスまたはインタフェースにオブジェクトをキャストします。 |
|
boolean |
desiredAssertionStatus()
このメソッドの呼び出し時にこのクラスを初期化する場合、クラスに割り当てられる宣言ステータスを返します。 |
|
static Class<?> |
forName(String className)
指定された文字列名を持つクラスまたはインタフェースに関連付けられた、 Class オブジェクトを返します。 |
|
static Class<?> |
forName(String name,
boolean initialize,
ClassLoader loader)
指定されたクラスローダーを使って、指定された文字列名を持つクラスまたはインタフェースに関連付けられた Class オブジェクトを返します。 |
|
|
getAnnotation(Class<A> annotationClass)
指定された型の注釈が存在する場合は、指定された型の要素の注釈を返します。 |
|
Annotation[] |
getAnnotations()
この要素に存在するすべての注釈を返します(この要素に注釈がない場合は長さゼロの配列を返します)。 |
|
String |
getCanonicalName()
『Java 言語仕様』の定義に従って、基本となるクラスの正規名を返します。 |
|
Class<?>[] |
getClasses()
この Class オブジェクトが表すクラスのメンバーである、すべての public クラスおよびインタフェースを表す Class オブジェクトを格納している配列を返します。 |
|
ClassLoader |
getClassLoader()
クラスのクラスローダーを返します。 |
|
Class<?> |
getComponentType()
配列のコンポーネント型を表す Class を返します。 |
|
Constructor<T> |
getConstructor(Class<?>... parameterTypes)
この Class オブジェクトが表すクラスの指定された public コンストラクタをリフレクトする Constructor オブジェクトを返します。 |
|
Constructor<?>[] |
getConstructors()
この Class オブジェクトが表すクラスのすべての public コンストラクタをリフレクトする Constructor オブジェクトを格納している配列を返します。 |
|
Annotation[] |
getDeclaredAnnotations()
この要素に直接存在するすべての注釈を返します。 |
|
Class<?>[] |
getDeclaredClasses()
この Class オブジェクトが表すクラスのメンバーとして宣言されたすべてのクラスおよびインタフェースをリフレクトする Class オブジェクトの配列を返します。 |
|
Constructor<T> |
getDeclaredConstructor(Class<?>... parameterTypes)
この Class オブジェクトが表すクラスまたはインタフェースの指定されたコンストラクタをリフレクトする Constructor オブジェクトを返します。 |
|
Constructor<?>[] |
getDeclaredConstructors()
この Class オブジェクトが表すクラスによって宣言されたすべてのコンストラクタをリフレクトする Constructor オブジェクトの配列を返します。 |
|
Field |
getDeclaredField(String name)
この Class オブジェクトが表すクラスまたはインタフェースの指定された宣言フィールドをリフレクトする Field オブジェクトを返します。 |
|
Field[] |
getDeclaredFields()
この Class オブジェクトが表すクラスまたはインタフェースによって宣言されたすべてのフィールドをリフレクトする Field オブジェクトの配列を返します。 |
|
Method |
getDeclaredMethod(String name,
Class<?>... parameterTypes)
この Class オブジェクトが表すクラスまたはインタフェースの指定された宣言メソッドをリフレクトする Method オブジェクトを返します。 |
|
Method[] |
getDeclaredMethods()
この Class オブジェクトが表すクラスまたはインタフェースによって宣言されたすべてのメソッドをリフレクトする Method オブジェクトの配列を返します。 |
|
Class<?> |
getDeclaringClass()
この Class オブジェクトが表すクラスまたはインタフェースが別のクラスのメンバーの場合は、それが宣言されたクラスを表す Class オブジェクトを返します。 |
|
Class<?> |
getEnclosingClass()
基本となるクラスを直接囲むクラスを返します。 |
|
Constructor<?> |
getEnclosingConstructor()
この Class オブジェクトが、コンストラクタ内のローカルクラスまたは匿名クラスを表す場合は、基本となるクラスを直接囲むコンストラクタを表す Constructor オブジェクトを返します。 |
|
Method |
getEnclosingMethod()
この Class オブジェクトが、メソッド内のローカルクラスまたは匿名クラスを表す場合は、基本となるクラスを直接囲むメソッドを表す Method オブジェクトを返します。 |
|
T[] |
getEnumConstants()
この enum クラスの要素を返すか、この Class オブジェクトが enum 型を表さない場合は null を返します。 |
|
Field |
getField(String name)
この Class オブジェクトが表すクラスまたはインタフェースの指定された public メンバーフィールドをリフレクトする Field オブジェクトを返します。 |
|
Field[] |
getFields()
この Class オブジェクトが表すクラスまたはインタフェースのすべてのアクセス可能な public フィールドをリフレクトする、Field オブジェクトを保持している配列を返します。 |
|
Type[] |
getGenericInterfaces()
このオブジェクトによって表されるインタフェースまたはクラスによって直接実装されるインタフェースを表す Type を返します。 |
|
Type |
getGenericSuperclass()
この Class で表されるエンティティー (クラス、インタフェース、プリミティブ型、または void) の直接のスーパークラスを表す Type を返します。 |
|
Class<?>[] |
getInterfaces()
このオブジェクトが表すクラスまたはインタフェースによって実装されるインタフェースを取得します。 |
|
Method |
getMethod(String name,
Class<?>... parameterTypes)
この Class オブジェクトが表すクラスまたはインタフェースの指定された public メンバーメソッドをリフレクトする Method オブジェクトを返します。 |
|
Method[] |
getMethods()
この Class オブジェクトが表すクラスまたはインタフェースのすべての public 「メンバー」メソッドをリフレクトする Method オブジェクトを格納している配列を返します。 |
|
int |
getModifiers()
このクラスまたはインタフェースの Java 言語修飾子を整数型に符号化して返します。 |
|
String |
getName()
この Class オブジェクトが表すエンティティー (クラス、インタフェース、配列クラス、プリミティブ型、または void) の名前を、String として返します。 |
|
Package |
getPackage()
このクラスのパッケージを取得します。 |
|
ProtectionDomain |
getProtectionDomain()
このクラスの ProtectionDomain を返します。 |
|
URL |
getResource(String name)
指定された名前のリソースを探します。 |
|
InputStream |
getResourceAsStream(String name)
指定された名前のリソースを探します。 |
|
Object[] |
getSigners()
このクラスの署名者を取得します。 |
|
String |
getSimpleName()
ソースコード内で指定されたとおり、基本となるクラスの単純名を返します。 |
|
Class<? super T> |
getSuperclass()
この Class で表されるエンティティー (クラス、インタフェース、プリミティブ型、または void) のスーパークラスを表す Class を返します。 |
|
TypeVariable<Class<T>>[] |
getTypeParameters()
GenericDeclaration オブジェクトによって表される総称宣言で宣言された型変数を表す TypeVariable オブジェクトの配列を宣言順に返します。 |
|
boolean |
isAnnotation()
Class オブジェクトが注釈型を表す場合は true を返します。 |
|
boolean |
isAnnotationPresent(Class<? extends Annotation> annotationClass)
指定された型の注釈がこの要素に存在する場合は true を返し、そうでない場合は false を返します。 |
|
boolean |
isAnonymousClass()
基本となるクラスが匿名クラスである場合だけ true を返します。 |
|
boolean |
isArray()
この Class オブジェクトが配列クラスを表すかどうかを判定します。 |
|
boolean |
isAssignableFrom(Class<?> cls)
この Class オブジェクトが表すクラスまたはインタフェースが、指定された Class パラメータが表すクラスまたはインタフェースと等しいかどうか、あるいはそのスーパークラスあるいはスーパーインタフェースであるかどうかを判定します。 |
|
boolean |
isEnum()
このクラスがソースコードで enum として宣言された場合だけ true を返します。 |
|
boolean |
isInstance(Object obj)
指定された Object が、この Class が表すオブジェクトと代入互換の関係にあるかどうかを判定します。 |
|
boolean |
isInterface()
指定された Class オブジェクトがインタフェース型を表すかどうかを判定します。 |
|
boolean |
isLocalClass()
基本となるクラスがローカルクラスである場合だけ true を返します。 |
|
boolean |
isMemberClass()
基本となるクラスがメンバークラスである場合だけ true を返します。 |
|
boolean |
isPrimitive()
指定された Class オブジェクトがプリミティブ型を表すかどうかを判定します。 |
|
boolean |
isSynthetic()
このクラスが合成クラスである場合は true を返し、そうでない場合は false を返します。 |
|
T |
newInstance()
この Class オブジェクトが表すクラスの新しいインスタンスを生成します。 |
|
String |
toString()
オブジェクトを文字列に変換します。 |
|
| クラス java.lang.Object から継承されたメソッド |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| メソッドの詳細 |
|---|
public String toString()
getName が返す形式の完全指定クラス名という順序で表現されます。この Class オブジェクトがプリミティブ型を表す場合、このメソッドはプリミティブ型の名前を返し、void を表す場合は、「void」を返します。
Object 内の toString
public static Class<?> forName(String className)
throws ClassNotFoundException
Class オブジェクトを返します。このメソッドを呼び出すことは、次の記述に相当します。
ここで、Class.forName(className, true, currentLoader)
currentLoader は、現在のクラスを定義するクラスローダを示します。
たとえば以下の記述は、java.lang.Thread という名前のクラスの実行時における Class 記述子を返します。
Class t = Class.forName("java.lang.Thread")
forName("X") の呼び出しによって、X というクラスが初期化されます。
className - 要求するクラスの完全指定の名前
Class オブジェクト
LinkageError - リンケージに失敗した場合
ExceptionInInitializerError - このメソッドによる初期化に失敗した場合
ClassNotFoundException - クラスが見つからなかった場合
public static Class<?> forName(String name,
boolean initialize,
ClassLoader loader)
throws ClassNotFoundException
Class オブジェクトを返します。クラスまたはインタフェースの完全指定名を (getName が返す形式と同じ形式で) 指定すると、このメソッドはクラスまたはインタフェースを見つけ、ロードして、リンクしようとします。クラスまたはインタフェースをロードする際には、指定されたクラスローダーが使用されます。loader パラメータが null の場合、クラスはブートストラップクラスローダーを使ってロードされます。initialize パラメータが true で、それまでに初期化されていない場合だけ、クラスは初期化されます。
name がプリミティブ型または void を示す場合、無名パッケージ内で name という名前のユーザー定義のクラスを見つけようとします。このため、このメソッドを使って、プリミティブ型または void を表す Class オブジェクトを取得することはできません。
name が配列クラスを示す場合、配列クラスのコンポーネント型はロードされますが、初期化されません。
たとえば、インスタンスメソッドでは、
Class.forName("Foo")
Class.forName("Foo", true, this.getClass().getClassLoader())
loader が null で、セキュリティマネージャが存在し、呼び出し側のクラスローダが null でない場合、このメソッドはセキュリティマネージャの checkPermission メソッドを RuntimePermission("getClassLoader") のアクセス権を使って呼び出すことによって、ブートストラップクラスローダに問題なくアクセスできることを保証します。
name - 要求するクラスの完全指定の名前initialize - クラスを初期化する必要の有無loader - クラスのロード元である必要があるクラスローダ
LinkageError - リンケージに失敗した場合
ExceptionInInitializerError - このメソッドによる初期化に失敗した場合
ClassNotFoundException - 指定されたクラスローダによってクラスが見つからなかった場合forName(String),
ClassLoader
public T newInstance()
throws InstantiationException,
IllegalAccessException
new 式に空の引数リストを指定した場合と同じように、クラスのインスタンスが生成されます。クラスは、初期化されていなければ初期化されます。
このメソッドは確認済み例外など、引数なしのコンストラクタによってスローされた例外を送ることに注意してください。このメソッドを使用することで、その他の場合にはコンパイラによって実行されるコンパイル時の例外確認を効果的にバイパスできます。Constructor.newInstance メソッドは、(確認済みの) InvocationTargetException のコンストラクタによってスローされた例外をラップすることで、この問題を回避します。
IllegalAccessException - クラスまたはその引数なしのコンストラクタにアクセスできない場合
InstantiationException - この Class が abstract クラス、インタフェース、配列クラス、プリミティブ型、または void を表す場合、クラスが引数なしのコンストラクタを保持しない場合、あるいはインスタンスの生成がほかの理由で失敗した場合
ExceptionInInitializerError - このメソッドによる初期化が失敗した場合
SecurityException - セキュリティーマネージャー s が存在し、次の条件のどれかが満たされる場合
s.checkMemberAccess(this, Member.PUBLIC) の呼び出しがこのクラスの新規インスタンスの作成を許可しない
s.checkPackageAccess() の呼び出しがこのクラスのパッケージへのアクセスを許可しない
public boolean isInstance(Object obj)
Object が、この Class が表すオブジェクトと代入互換の関係にあるかどうかを判定します。このメソッドは、Java 言語の instanceof 演算子と動的に等価です。指定された Object 引数が null ではなく、この Class オブジェクトが表す参照型に ClassCastException をスローすることなくキャストできる場合、このメソッドは true を返します。そうでない場合は、false を返します。
特に、この Class オブジェクトが宣言クラスを表すときには、このメソッドは、指定された Object 引数が表現クラス (またはそのサブクラス) のインスタンスの場合に true を、そうでない場合に false を返します。この Class オブジェクトが配列クラスを表すときには、恒等変換または拡張参照変換を用いて指定された Object 引数を配列クラスのオブジェクトに変換できる場合に true を、そうでない場合に false を返します。この Class オブジェクトがインタフェースを表すときには、指定された Object 引数のクラスまたはスーパークラスがこのインタフェースを実装する場合に true を、そうでない場合に false を返します。この Class オブジェクトがプリミティブ型を表す場合は false を返します。
obj - チェック対象のオブジェクト
obj が このクラスのインスタンスの場合は truepublic boolean isAssignableFrom(Class<?> cls)
Class オブジェクトが表すクラスまたはインタフェースが、指定された Class パラメータが表すクラスまたはインタフェースと等しいかどうか、あるいはそのスーパークラスあるいはスーパーインタフェースであるかどうかを判定します。どちらかに当てはまる場合は true を、そうでない場合は false を返します。この Class オブジェクトがプリミティブ型を表すときには、指定された Class パラメータとこの Class オブジェクトが一致する場合に true を、そうでない場合に false を返します。
特にこのメソッドは、指定された Class パラメータが表現する型を、恒等変換または拡張参照変換を使って、この Class オブジェクトが表す型に変換できるかどうかを調べます。詳細は、『Java 言語仕様』のセクション 5.1.1 と 5.1.4 を参照してください。
cls - チェック対象の Class オブジェクト
cls 型のオブジェクトがこのクラスに割り当てられるかどうかを示す boolean 値
NullPointerException - 指定された Class パラメータが null の場合public boolean isInterface()
Class オブジェクトがインタフェース型を表すかどうかを判定します。
true、そうでない場合は falsepublic boolean isArray()
Class オブジェクトが配列クラスを表すかどうかを判定します。
true、そうでない場合は falsepublic boolean isPrimitive()
Class オブジェクトがプリミティブ型を表すかどうかを判定します。
8 つの Java のプリミティブ型と void を表す、9 つの定義済み Class オブジェクトがあります。これらは Java 仮想マシンが作成し、該当するプリミティブ型と同じ名前を持ちます。 つまり、boolean、byte、char、short、int、long、float、double、および void です。
これらのオブジェクトには、以下の public static final 変数を使う方法によってのみアクセスできます。また、このメソッドが true を返すのは、これらの 9 つの Class オブジェクトに限定されます。
Boolean.TYPE,
Character.TYPE,
Byte.TYPE,
Short.TYPE,
Integer.TYPE,
Long.TYPE,
Float.TYPE,
Double.TYPE,
Void.TYPEpublic boolean isAnnotation()
isInterface() も true を返します。
public boolean isSynthetic()
public String getName()
『Java 言語仕様、第 2 版』で規定されているように、このクラスオブジェクトが配列型ではない参照型を表す場合は、クラスのバイナリ名が返されます。
このクラスオブジェクトがプリミティブ型または void を表す場合、返される名前はプリミティブ型または void に対応する Java 言語キーワードと等価な String です。
このクラスオブジェクトが配列のクラスを表す場合、名前の内部形式は、配列の入れ子の深さを表す 1 つ以上の「[」文字、要素型の名前という順序で構成されます。要素型の名前のエンコーディングは、次のとおりです。
Element Type 符号化 boolean Z byte B char C class または interface Lclassname; double D float F int I long J short S
クラス名またはインタフェース名の classname は、上記の例のようにクラスのバイナリ名で指定されます。
例:
String.class.getName()
returns "java.lang.String"
byte.class.getName()
returns "byte"
(new Object[3]).getClass().getName()
returns "[Ljava.lang.Object;"
(new int[3][4][5][6][7][8][9]).getClass().getName()
returns "[[[[[[[I"
public ClassLoader getClassLoader()
セキュリティマネージャが存在し、呼び出し側のクラスローダが null でなく、クラスローダが必要とされるクラスのクラスローダの上位ローダでもない場合、このメソッドはセキュリティマネージャの checkPermission メソッドを RuntimePermission("getClassLoader") のアクセス権を使って呼び出すことによってクラスのクラスローダに問題なくアクセスできることを保証します。
このオブジェクトがプリミティブ型または void を表す場合は、null が返されます。
SecurityException - セキュリティマネージャが存在し、その checkPermission メソッドがクラスのクラスローダへのアクセスを拒否する場合ClassLoader,
SecurityManager.checkPermission(java.security.Permission),
RuntimePermissionpublic TypeVariable<Class<T>>[] getTypeParameters()
GenericDeclaration 内の getTypeParametersGenericSignatureFormatError - この総称宣言の総称署名が『Java 仮想マシン仕様第 3 版』で規定される書式に適合しない場合public Class<? super T> getSuperclass()
Class で表されるエンティティー (クラス、インタフェース、プリミティブ型、または void) のスーパークラスを表す Class を返します。この Class が、Object クラス、インタフェース、プリミティブ型、または void を表す場合、null が返されます。このオブジェクトが配列クラスを表す場合、Object クラスを表す Class オブジェクトが返されます。
public Type getGenericSuperclass()
スーパークラスがパラメータ化された型の場合、返される Type オブジェクトは、ソースコードで使用される実際の型パラメータを反映しなければいけません。スーパークラスを表すパラメータ化された型は、以前作成されていなかった場合に作成されます。パラメータ化された型の作成プロセスのセマンティクスについては、ParameterizedType の宣言を参照してください。この Class が、Object クラス、インタフェース、プリミティブ型、または void を表す場合、null が返されます。このオブジェクトが配列クラスを表す場合は、Object クラスを表す Class オブジェクトが返されます。
GenericSignatureFormatError - この総称クラスの署名が『Java 仮想マシン仕様第 3 版』で規定される書式に適合しない場合
TypeNotPresentException - 総称スーパークラスが、存在しない型宣言を参照する場合
MalformedParameterizedTypeException - 総称スーパークラスが、何らかの理由によりインスタンス化できないパラメータ化された型を参照する場合public Package getPackage()
クラスに付属するマニフェストで情報が定義された場合と、クラスローダがマニフェストの属性を持つパッケージインスタンスを生成した場合にだけ、パッケージはバージョンと仕様の属性を持ちます。
public Class<?>[] getInterfaces()
このオブジェクトがクラスを表す場合、戻り値は、クラスによって実装されるすべてのインタフェースを表すオブジェクトを格納している配列です。配列内のインタフェースオブジェクトの順序は、このオブジェクトが表すクラスを宣言する implements 節内のインタフェース名の順序に一致します。たとえば、
class Shimmer implements FloorWax, DessertTopping { ... }
s の値が Shimmer のインスタンスであるとします。
という式の値はs.getClass().getInterfaces()[0]
FloorWax インタフェースを表す Class オブジェクトであり、
という式の値は、s.getClass().getInterfaces()[1]
DessertTopping インタフェースを表す Class オブジェクトです。
このオブジェクトがインタフェースを表す場合、そのインタフェースによって拡張されたすべてのインタフェースを表すオブジェクトが配列内に入ります。配列内のインタフェースオブジェクトの順序は、このオブジェクトが表すインタフェースを宣言する extends 節内のインタフェース名の順序に一致します。
このオブジェクトがインタフェースを実装しないクラスまたはインタフェースを表す場合、このメソッドは長さが 0 の配列を返します。
このオブジェクトがプリミティブ型または void を表す場合、このメソッドは長さが 0 の配列を返します。
public Type[] getGenericInterfaces()
スーパーインタフェースがパラメータ化された型の場合、返される Type オブジェクトは、ソースコードで使用される実際の型パラメータを反映しなければいけません。スーパーインタフェースを表すパラメータ化された型は、以前作成されていなかった場合に作成されます。パラメータ化された型の作成プロセスのセマンティクスについては、ParameterizedType の宣言を参照してください。
このオブジェクトがクラスを表す場合、戻り値は、クラスによって実装されるすべてのインタフェースを表すオブジェクトを格納している配列です。配列内のインタフェースオブジェクトの順序は、このオブジェクトが表すクラスを宣言する implements 節内のインタフェース名の順序に一致します。配列クラスの場合、Cloneable インタフェースと Serializable インタフェースはその順序で返されます。
このオブジェクトがインタフェースを表す場合、そのインタフェースによって拡張されたすべてのインタフェースを表すオブジェクトが配列内に入ります。配列内のインタフェースオブジェクトの順序は、このオブジェクトが表すインタフェースを宣言する extends 節内のインタフェース名の順序に一致します。
このオブジェクトがインタフェースを実装しないクラスまたはインタフェースを表す場合、このメソッドは長さが 0 の配列を返します。
このオブジェクトがプリミティブ型または void を表す場合、このメソッドは長さが 0 の配列を返します。
GenericSignatureFormatError - この総称クラスの署名が『Java 仮想マシン仕様第 3 版』で規定される書式に適合しない場合
TypeNotPresentException - 総称スーパーインタフェースのどれかが、存在しない型宣言を参照する場合
MalformedParameterizedTypeException - 総称スーパーインタフェースのどれかが、何らかの理由によりインスタンス化できないパラメータ化された型を参照する場合public Class<?> getComponentType()
Class を返します。このクラスが配列クラスを表さない場合、このメソッドは null を返します。
ClassArraypublic int getModifiers()
public、protected、private、final、static、abstract、および interface 用の Java 仮想マシンの定数から構成されます。 これらは、Modifier クラスのメソッドを使って復号化しなければいけません。
基本となるクラスが配列クラスの場合、public、private、および protected の各修飾子はコンポーネント型の修飾子と同じです。この Class がプリミティブ型または void の場合、public の各修飾子は常に true で、protected および private 修飾子は常に false です。このオブジェクトが配列クラス、プリミティブ型、または void を表す場合、final 修飾子は常に true で、そのインタフェース修飾子は常に false です。その他の修飾子の値は、この仕様では判定されません。
修飾子の符号化は、「Java Virtual Machine 仕様」の表 4.1 で定義しています。
intModifierpublic Object[] getSigners()
public Method getEnclosingMethod()
Method オブジェクトを返します。そうでない場合は null を返します。
特に、基本となるクラスが、型宣言、インスタンス初期化子、またはスタティック初期化子により直接囲まれるローカルクラスまたは匿名クラスである場合、このメソッドは null を返します。
public Constructor<?> getEnclosingConstructor()
Constructor オブジェクトを返します。そうでない場合は null を返します。特に、基本となるクラスが、型宣言、インスタンス初期化子、またはスタティック初期化子により直接囲まれるローカルクラスまたは匿名クラスである場合、このメソッドは null を返します。
public Class<?> getDeclaringClass()
Class オブジェクトが表すクラスまたはインタフェースが別のクラスのメンバーの場合は、それが宣言されたクラスを表す Class オブジェクトを返します。このクラスまたはインタフェースがほかのクラスのメンバーでない場合は、null を返します。この Class オブジェクトが配列クラス、プリミティブ型、または void を表す場合、このメソッドは null を返します。
public Class<?> getEnclosingClass()
public String getSimpleName()
配列の単純名は、「[]」が付加されたコンポーネント型の単純名です。特に、コンポーネント型が匿名である配列の単純名は、「[]」です。
public String getCanonicalName()
public boolean isAnonymousClass()
public boolean isLocalClass()
public boolean isMemberClass()
public Class<?>[] getClasses()
Class オブジェクトが表すクラスのメンバーである、すべての public クラスおよびインタフェースを表す Class オブジェクトを格納している配列を返します。スーパークラスから継承した public クラスおよびインタフェースのメンバー、ならびにクラスが宣言した public クラスとインタフェースのメンバーも含まれます。この Class オブジェクトが public メンバークラスやインタフェースを持たない場合や、プリミティブ型、配列クラス、または void を表す場合には、長さが 0 の配列を返します。
Class オブジェクトの配列
SecurityException - セキュリティーマネージャー s が存在し、次の条件のどれかが満たされる場合
s.checkMemberAccess(this, Member.PUBLIC) のメソッドの呼び出しがこのクラス内のクラスへのアクセスを許可しない
s.checkPackageAccess() の呼び出しがこのクラスのパッケージへのアクセスを許可しない
public Field[] getFields()
throws SecurityException
Class オブジェクトが表すクラスまたはインタフェースのすべてのアクセス可能な public フィールドをリフレクトする、Field オブジェクトを保持している配列を返します。返された配列内の要素は、ソートされていたり、特定の順序になっていたりすることはありません。クラスまたはインタフェースにアクセス可能な public フィールドがない場合や、クラスまたはインタフェースが配列クラス、プリミティブ型、または void を表す場合は、長さが 0 の配列を返します。
特に、この Class オブジェクトがクラスを表す場合、このメソッドはこのクラスとそのすべてのスーパークラスの public フィールドを返します。この Class オブジェクトがインタフェースを表す場合は、このインタフェースとすべてのスーパーインタフェースのフィールドを返します。
このメソッドは、配列クラスの暗黙的な長さフィールドをリフレクトしません。ユーザーコードで配列を操作するには、Array クラスのメソッドを使う必要があります。
「Java 言語仕様」のセクション 8.2 と 8.3 を参照してください。
Field オブジェクトの配列
SecurityException - セキュリティーマネージャー s が存在し、次の条件のどれかが満たされる場合
s.checkMemberAccess(this, Member.PUBLIC) の呼び出しがこのクラス内のフィールドへのアクセスを許可しない
s.checkPackageAccess() の呼び出しがこのクラスのパッケージへのアクセスを許可しない
public Method[] getMethods()
throws SecurityException
Class オブジェクトが表すクラスまたはインタフェースのすべての public 「メンバー」メソッドをリフレクトする Method オブジェクトを格納している配列を返します。 クラスまたはインタフェースが宣言したもの、およびスーパークラスやスーパーインタフェースから継承されたものも含まれます。配列クラスは、Object クラスから継承されたすべての (public) メンバーメソッドを返します。返された配列内の要素は、ソートされていたり、特定の順序になっていたりすることはありません。この Class オブジェクトが public メンバーメソッドがないクラスまたはインタフェースを表す場合や、プリミティブ型または void を表す場合は、このメソッドは長さが 0 の配列を返します。
クラス初期化メソッド <clinit> は、返された配列にはありません。クラスが同じパラメータ型を持つ複数の public メンバーメソッドを宣言する場合、それらのメソッドは、すべて返された配列にあります。
「Java 言語仕様」のセクション 8.2 と 8.4 を参照してください。
Method オブジェクトの配列
SecurityException - セキュリティーマネージャー s が存在し、次の条件のどれかが満たされる場合
s.checkMemberAccess(this, Member.PUBLIC) の呼び出しがこのクラス内のメソッドへのアクセスを許可しない
s.checkPackageAccess() の呼び出しがこのクラスのパッケージへのアクセスを許可しない
public Constructor<?>[] getConstructors()
throws SecurityException
Class オブジェクトが表すクラスのすべての public コンストラクタをリフレクトする Constructor オブジェクトを格納している配列を返します。クラスに public コンストラクタがない場合、クラスが配列クラスの場合、またはクラスがプリミティブ型または void をリフレクトする場合には、長さが 0 の配列を返します。
このメソッドは Constructor<T> オブジェクトの配列 (このクラスからのコンストラクタの配列) を返しますが、このメソッドの戻り値の型は Constructor<?>[] であり、予想される Constructor<T>[] ではありません。この情報の少ない戻り値の型は、このメソッドから返されたあとで必要になり、この配列はさまざまなクラスの Constructor オブジェクトを保持するよう変更されることがあります。これは、Constructor<T>[] の型保証に違反します。
Constructor オブジェクトの配列
SecurityException - セキュリティーマネージャー s が存在し、次の条件のどれかが満たされる場合
s.checkMemberAccess(this, Member.PUBLIC) の呼び出しがこのクラス内のコンストラクタへのアクセスを許可しない
s.checkPackageAccess() の呼び出しがこのクラスのパッケージへのアクセスを許可しない
public Field getField(String name)
throws NoSuchFieldException,
SecurityException
Class オブジェクトが表すクラスまたはインタフェースの指定された public メンバーフィールドをリフレクトする Field オブジェクトを返します。name パラメータは、要求されるフィールドの単純名を指定する String です。
リフレクトされるフィールドは、次のアルゴリズムで決定されます。ここでは、このオブジェクトが表すクラスを C とします。
NoSuchFieldException がスローされます。「Java 言語仕様」のセクション 8.2 と 8.3 を参照してください。
name - フィールド名
name で指定されたこのクラスの Field オブジェクト
NoSuchFieldException - 指定された名前のフィールドが見つからない場合
NullPointerException - name が null の場合
SecurityException - セキュリティーマネージャー s が存在し、次の条件のどれかが満たされる場合
s.checkMemberAccess(this, Member.PUBLIC) の呼び出しがこのフィールドへのアクセスを許可しない
s.checkPackageAccess() の呼び出しがこのクラスのパッケージへのアクセスを許可しない
public Method getMethod(String name,
Class<?>... parameterTypes)
throws NoSuchMethodException,
SecurityException
Class オブジェクトが表すクラスまたはインタフェースの指定された public メンバーメソッドをリフレクトする Method オブジェクトを返します。name パラメータは、要求されるメソッドに単純名を指定する String です。parameterTypes パラメータは、メソッドの仮パラメータ型を宣言された順序で識別する Class オブジェクトの配列です。parameterTypes が null の場合は、空の配列のように扱われます。
name が 「<init>;」または「<clinit>」の場合は、NoSuchMethodException がスローされます。そうでない場合、リフレクトされるメソッドは、次のアルゴリズムで指定されます。ここでは、このオブジェクトが表すクラスを C とします。
Java 言語は、署名は同じでも戻り値の型が異なる複数のメソッドを宣言するクラスを禁止しますが、Java 仮想マシンはこれを禁止しないため、クラス内に一致するメソッドが複数存在することがあります。仮想マシンのこのような柔軟性を使用して、さまざまな言語機能を実装することができます。たとえば、共変のリターンは bridge メソッド で実装できます。この bridge メソッドとオーバーライドされるメソッドは同じ署名を持ちますが、戻り値の型はさまざまです。
「Java 言語仕様」のセクション 8.2 と 8.4 を参照してください。
name - メソッドの名前parameterTypes - パラメータのリスト
name と parameterTypes と一致する Method オブジェクト
NoSuchMethodException - 一致するメソッドが見つからない場合、あるいは名前が「<init>」または「<clinit>」の場合
NullPointerException - name が null の場合
SecurityException - セキュリティーマネージャー s が存在し、次の条件のどれかが満たされる場合
s.checkMemberAccess(this, Member.PUBLIC) の呼び出しがこのメソッドへのアクセスを許可しない
s.checkPackageAccess() の呼び出しがこのクラスのパッケージへのアクセスを許可しない
public Constructor<T> getConstructor(Class<?>... parameterTypes)
throws NoSuchMethodException,
SecurityException
Class オブジェクトが表すクラスの指定された public コンストラクタをリフレクトする Constructor オブジェクトを返します。parameterTypes パラメータは、コンストラクタの仮パラメータ型を宣言順に識別する Class オブジェクトの配列です。
この Class オブジェクトが非 static コンテキストに宣言された内部クラスを表す場合、仮パラメータ型には最初のパラメータとして明示的な囲むインスタンスが含まれます。
リフレクトするコンストラクタは、parameterTypes に指定された型と一致する仮パラメータ型を持つこの Class オブジェクトが表すクラスの public コンストラクタです。
parameterTypes - パラメータ配列
parameterTypes と一致する public コンストラクタの Constructor オブジェクト
NoSuchMethodException - 一致するメソッドが見つからない場合
SecurityException - セキュリティーマネージャー s が存在し、次の条件のどれかが満たされる場合
s.checkMemberAccess(this, Member.PUBLIC) の呼び出しがこのコンストラクタへのアクセスを許可しない
s.checkPackageAccess() の呼び出しがこのクラスのパッケージへのアクセスを許可しない
public Class<?>[] getDeclaredClasses()
throws SecurityException
Class オブジェクトが表すクラスのメンバーとして宣言されたすべてのクラスおよびインタフェースをリフレクトする Class オブジェクトの配列を返します。これには、クラスが宣言した public、protected、デフォルト (package) アクセス、および private クラスとインタフェースは含まれますが、継承クラスとインタフェースは含まれません。このメソッドは、クラスがメンバーとしてクラスまたはインタフェースを宣言していない場合や、この Class オブジェクトがプリミティブ型、配列クラス、または void を表す場合には、長さが 0 の配列を返します。
Class オブジェクトの配列
SecurityException - セキュリティーマネージャー s が存在し、次の条件のどれかが満たされる場合
s.checkMemberAccess(this, Member.DECLARED) の呼び出しがこのクラス内の宣言されたクラスへのアクセスを許可しない
s.checkPackageAccess() の呼び出しがこのクラスのパッケージへのアクセスを許可しない
public Field[] getDeclaredFields()
throws SecurityException
Class オブジェクトが表すクラスまたはインタフェースによって宣言されたすべてのフィールドをリフレクトする Field オブジェクトの配列を返します。これには、public、protected、デフォルト (package) アクセス、および private フィールドは含まれますが、継承フィールドは含まれません。返された配列内の要素は、ソートされていたり、特定の順序になっていたりすることはありません。このメソッドは、クラスまたはインタフェースがフィールドを宣言しない場合や、この Class オブジェクトがプリミティブ型、配列クラス、または void を表す場合には、長さが 0 の配列を返します。
「Java 言語仕様」のセクション 8.2 と 8.3 を参照してください。
Field オブジェクトの配列
SecurityException - セキュリティーマネージャー s が存在し、次の条件のどれかが満たされる場合
s.checkMemberAccess(this, Member.DECLARED) の呼び出しがこのクラス内の宣言されたフィールドへのアクセスを許可しない
s.checkPackageAccess() の呼び出しがこのクラスのパッケージへのアクセスを許可しない
public Method[] getDeclaredMethods()
throws SecurityException
Class オブジェクトが表すクラスまたはインタフェースによって宣言されたすべてのメソッドをリフレクトする Method オブジェクトの配列を返します。これには、public、protected、デフォルト (package) アクセス、および private メソッドは含まれますが、継承メソッドは含まれません。返された配列内の要素は、ソートされていたり、特定の順序になっていたりすることはありません。このメソッドは、クラスまたはインタフェースがメソッドを宣言しない場合や、この Class オブジェクトがプリミティブ型、配列クラス、または void を表す場合は、長さが 0 の配列を返します。クラス初期化メソッド <clinit> は、返された配列にはありません。クラスが同じパラメータ型を持つ複数の public メンバーメソッドを宣言する場合、それらのメソッドは、すべて返された配列にあります。
「Java 言語仕様」のセクション 8.2 を参照してください。
Method オブジェクトの配列
SecurityException - セキュリティーマネージャー s が存在し、次の条件のどれかが満たされる場合
s.checkMemberAccess(this, Member.DECLARED) の呼び出しがこのクラス内の宣言されたメソッドへのアクセスを許可しない
s.checkPackageAccess() の呼び出しがこのクラスのパッケージへのアクセスを許可しない
public Constructor<?>[] getDeclaredConstructors()
throws SecurityException
Class オブジェクトが表すクラスによって宣言されたすべてのコンストラクタをリフレクトする Constructor オブジェクトの配列を返します。これらは、public、protected、デフォルト (package) アクセス、および private コンストラクタです。返された配列内の要素は、ソートされていたり、特定の順序になっていたりすることはありません。クラスがデフォルトのコンストラクタを持つ場合、このコンストラクタは返された配列にあります。このメソッドは、この Class オブジェクトがインタフェース、プリミティブ型、配列クラス、または void を表す場合には長さが 0 の配列を返します。
「Java 言語仕様」のセクション 8.2 を参照してください。
Constructor オブジェクトの配列
SecurityException - セキュリティーマネージャー s が存在し、次の条件のどれかが満たされる場合
s.checkMemberAccess(this, Member.DECLARED) の呼び出しがこのクラス内の宣言されたコンストラクタへのアクセスを許可しない
s.checkPackageAccess() の呼び出しがこのクラスのパッケージへのアクセスを許可しない
public Field getDeclaredField(String name)
throws NoSuchFieldException,
SecurityException
Class オブジェクトが表すクラスまたはインタフェースの指定された宣言フィールドをリフレクトする Field オブジェクトを返します。name パラメータは、要求されたフィールドの単純名を指定する String です。このメソッドが配列クラスの length フィールドをリフレクトすることはありません。
name - フィールドの名前
Field オブジェクト
NoSuchFieldException - 指定された名前のフィールドが見つからない場合
NullPointerException - name が null の場合
SecurityException - セキュリティーマネージャー s が存在し、次の条件のどれかが満たされる場合
s.checkMemberAccess(this, Member.DECLARED) の呼び出しが宣言されたフィールドへのアクセスを許可しない
s.checkPackageAccess() の呼び出しがこのクラスのパッケージへのアクセスを許可しない
public Method getDeclaredMethod(String name,
Class<?>... parameterTypes)
throws NoSuchMethodException,
SecurityException
Class オブジェクトが表すクラスまたはインタフェースの指定された宣言メソッドをリフレクトする Method オブジェクトを返します。name パラメータは、要求されたメソッドの単純名を指定する String です。 parameterTypes パラメータは、メソッドの仮パラメータ型を宣言順に識別する Class オブジェクトの配列です。同じパラメータ型を持つ複数のメソッドが 1 つのクラスで宣言され、そうしたメソッドの 1 つがそれ以外のどれよりも明確な戻り値の型を持つ場合には、そのメソッドが返されます。そうでない場合、メソッドの 1 つが任意に選択されます。 名前が 「<init>」または「<clinit>」の場合は、NoSuchMethodException がスローされます。
name - メソッドの名前parameterTypes - パラメータ配列
Method オブジェクト
NoSuchMethodException - 一致するメソッドが見つからない場合
NullPointerException - name が null の場合
SecurityException - セキュリティーマネージャー s が存在し、次の条件のどれかが満たされる場合
s.checkMemberAccess(this, Member.DECLARED) の呼び出しが宣言されたメソッドへのアクセスを許可しない
s.checkPackageAccess() の呼び出しがこのクラスのパッケージへのアクセスを許可しない
public Constructor<T> getDeclaredConstructor(Class<?>... parameterTypes)
throws NoSuchMethodException,
SecurityException
Class オブジェクトが表すクラスまたはインタフェースの指定されたコンストラクタをリフレクトする Constructor オブジェクトを返します。parameterTypes パラメータは、コンストラクタの仮パラメータ型を宣言順に識別する Class オブジェクトの配列です。
この Class オブジェクトが非 static コンテキストに宣言された内部クラスを表す場合、仮パラメータ型には最初のパラメータとして明示的な囲むインスタンスが含まれます。
parameterTypes - パラメータ配列
Constructor オブジェクト
NoSuchMethodException - 一致するメソッドが見つからない場合
SecurityException - セキュリティーマネージャー s が存在し、次の条件のどれかが満たされる場合
s.checkMemberAccess(this, Member.DECLARED) の呼び出しが宣言されたコンストラクタへのアクセスを許可しない
s.checkPackageAccess() の呼び出しがこのクラスのパッケージへのアクセスを許可しない
public InputStream getResourceAsStream(String name)
ClassLoader.getSystemResourceAsStream(java.lang.String) に委譲されます。
委譲の前に、このアルゴリズムを使って指定されたリソース名から絶対リソース名が構築されます。
modified_package_name/name
ここで、modified_package_name は、「. 」(「\u002e 」) を「/」に置き換えたこのオブジェクトのパッケージ名になる
name - 要求されるリソースの名前
InputStream オブジェクト、 この名前のリソースが見つからなかった場合は null
NullPointerException - name が null の場合public URL getResource(String name)
ClassLoader.getSystemResource(java.lang.String) に委譲されます。
委譲の前に、このアルゴリズムを使って指定されたリソース名から絶対リソース名が構築されます。
modified_package_name/name
ここで、modified_package_name は、「. 」(「\u002e 」) を「/」に置き換えたこのオブジェクトのパッケージ名になる
name - 要求されるリソースの名前
URL オブジェクト、 この名前のリソースが見つからなかった場合は nullpublic ProtectionDomain getProtectionDomain()
ProtectionDomain を返します。セキュリティーマネージャーがインストールされていると、このメソッドはまずセキュリティーマネージャーの checkPermission メソッドを RuntimePermission("getProtectionDomain") アクセス権を使って呼び出すことによって ProtectionDomain を問題なく取得できることを確認します。
SecurityException - セキュリティーマネージャーが存在し、その checkPermission メソッドが ProtectionDomain の取得を許可しない場合ProtectionDomain,
SecurityManager.checkPermission(java.security.Permission),
RuntimePermissionpublic boolean desiredAssertionStatus()
これは JRE 自体で使用するためのメソッドであるため、プログラマがこのメソッドを必要とすることはほとんどありません(このメソッドにより、初期化時に宣言が有効かどうかをクラスが判別できる)。指定されたクラスの初期化時に、このメソッドが、クラスに関連付けられた実際の宣言ステータスを返すとは限らないことに留意してください。
ClassLoader.setClassAssertionStatus(java.lang.String, boolean),
ClassLoader.setPackageAssertionStatus(java.lang.String, boolean),
ClassLoader.setDefaultAssertionStatus(boolean)public boolean isEnum()
public T[] getEnumConstants()
public T cast(Object obj)
obj - キャストされるオブジェクト
ClassCastException - 指定されたオブジェクトが null 以外であり、型 T に割り当てられない場合public <U> Class<? extends U> asSubclass(Class<U> clazz)
このメソッドは、受け取る側の Class オブジェクトを制限する API に渡すために、クライアントが Class オブジェクトの型をナロー変換する必要がある場合に役立ちます。(総称型はイレイジャーによって実装されるので) キャストの正確性を実行時に確認することはできないため、キャストによってコンパイル時の警告が生成されます。
ClassCastException - この Class オブジェクトが指定されたクラスのサブクラスを表さない場合 (「サブクラス」はクラス自体を含む)public <A extends Annotation> A getAnnotation(Class<A> annotationClass)
AnnotatedElement の記述:
AnnotatedElement 内の getAnnotationannotationClass - 注釈型に対応する Class オブジェクト
NullPointerException - 指定された注釈クラスが null の場合public boolean isAnnotationPresent(Class<? extends Annotation> annotationClass)
AnnotatedElement の記述:
AnnotatedElement 内の isAnnotationPresentannotationClass - 注釈型に対応する Class オブジェクト
NullPointerException - 指定された注釈クラスが null の場合public Annotation[] getAnnotations()
AnnotatedElement の記述:
AnnotatedElement 内の getAnnotationspublic Annotation[] getDeclaredAnnotations()
AnnotatedElement の記述:
AnnotatedElement 内の getDeclaredAnnotations
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。