java.lang
クラス Class

java.lang.Object
  |
  +--java.lang.Class

すべての実装インタフェース:

Serializable

public final class Class

extends Object

implements Serializable

クラス Class のインスタンスは、実行中の Java アプリケーションのクラスおよびインタフェースを表します。同様にどの配列も、同じ要素型および次元数を持つ配列によって共有される Class オブジェクトとしてリフレクトされるクラスに属します。Java のプリミティブ型 (boolean、byte、char、short、int、long、float、double) のほか、キーワード void も Class オブジェクトで表されます。

Class には、public コンストラクタはありません。Class オブジェクトは、クラスがロードされる際に Java Virtual Machine によって、およびクラスローダの defineClass メソッドの呼び出しによって自動的に構築されます。

以下の例では、Class オブジェクトを使ってオブジェクトのクラス名を出力します。

     void printClassName(Object obj) {
         System.out.println("The class of " + obj +
                            " is " + obj.getClass().getName());
     }
 

導入されたバージョン:

JDK1.0

関連項目:

ClassLoader.defineClass(byte[], int, int), 直列化された形式

メソッドの概要

static Class	forName(String className) 指定された文字列名を持つクラスまたはインタフェースに関連付けられた、Class オブジェクトを返します。
static Class	forName(String name, boolean initialize, ClassLoader loader) 指定されたクラスローダを使って、指定された文字列名を持つクラスまたはインタフェースに関連付けられた Class オブジェクトを返します。
Class[]	getClasses() この Class オブジェクトが表すクラスのメンバである、すべての public クラスおよびインタフェースを表す Class オブジェクトを格納している配列を返します。
ClassLoader	getClassLoader() クラスのクラスローダを返します。
Class	getComponentType() 配列のコンポーネント型を表す Class を返します。
Constructor	getConstructor(Class[] parameterTypes) この Class オブジェクトが表すクラスの指定された public コンストラクタをリフレクトする Constructor オブジェクトを返します。
Constructor[]	getConstructors() この Class オブジェクトが表すクラスのすべての public コンストラクタをリフレクトする Constructor オブジェクトを格納している配列を返します。
Class[]	getDeclaredClasses() この Class オブジェクトが表すクラスのメンバとして宣言された、すべてのクラスおよびインタフェースをリフレクトする、Class オブジェクトの配列を返します。
Constructor	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 オブジェクトを返します。
Field	getField(String name) この Class オブジェクトが表すクラスまたはインタフェースの指定された public メンバフィールドをリフレクトする Field オブジェクトを返します。
Field[]	getFields() この Class オブジェクトが表すクラスまたはインタフェースのすべてのアクセス可能な public フィールドをリフレクトする、Field オブジェクトを保持している配列を返します。
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() このクラスの署名者を取得します。
Class	getSuperclass() この Class で表されるエンティティ (クラス、インタフェース、プリミティブ型、または void) のスーパークラスを表す Class を返します。
boolean	isArray() この Class オブジェクトが配列クラスを表すかどうかを判定します。
boolean	isAssignableFrom(Class cls) この Class オブジェクトが表すクラスまたはインタフェースが、指定された Class パラメータが表すクラスまたはインタフェースと等しいかどうか、あるいはそのスーパークラスあるいはスーパーインタフェースであるかどうかを判定します。
boolean	isInstance(Object obj) 指定された Object が、この Class が表すオブジェクトと代入互換の関係にあるかどうかを判定します。
boolean	isInterface() 指定された Class オブジェクトがインタフェース型を表すかどうかを判定します。
boolean	isPrimitive() 指定された Class オブジェクトがプリミティブ型を表すかどうかを判定します。
Object	newInstance() この Class オブジェクトが表すクラスの新しいインスタンスを生成します。
String	toString() オブジェクトを文字列に変換します。

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

メソッドの詳細

toString

public String toString()

オブジェクトを文字列に変換します。その文字列は、「class」または「interface」などの文字列、続いてスペース、続いて getName が返す形式の完全指定のクラス名という構成で表現されます。この Class オブジェクトがプリミティブ型を表す場合、このメソッドはプリミティブ型の名前を返し、void を表す場合は、「void」を返します。

オーバーライド:

クラス Object 内の toString

戻り値:

このオブジェクトの文字列表現

forName

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 - クラスが見つからなかった場合

forName

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())
 

ただし、このメソッドは、「Java 言語仕様」のセクション 12.2、12.3、12.4 で指定された、ロード、リンク、または初期化に関連するエラーをスローします。

loader が null で、セキュリティマネージャが存在し、呼び出し側のクラスローダが null でない場合、このメソッドはセキュリティマネージャの checkPermission メソッドを RuntimePermission("getClassLoader") のアクセス権を使って呼び出すことによって、ブートストラップクラスローダに問題なくアクセスできることを保証します。

パラメータ:

name - 要求するクラスの完全指定の名前

initialize - クラスを初期化する必要の有無

loader - クラスのロード元である必要があるクラスローダ

戻り値:

要求するクラスを表すクラスオブジェクト

例外:

LinkageError - リンケージに失敗した場合

ExceptionInInitializerError - このメソッドによる初期化に失敗した場合

ClassNotFoundException - 指定されたクラスローダによってクラスが見つからなかった場合

導入されたバージョン:

1.2

関連項目:

forName(String), ClassLoader

newInstance

public Object newInstance()
                   throws InstantiationException,
                          IllegalAccessException

この Class オブジェクトが表すクラスの新しいインスタンスを生成します。new 式に空の引数リストを指定した場合と同じように、クラスのインスタンスが生成されます。クラスは、初期化されていなければ初期化されます。

セキュリティマネージャが存在する場合、このメソッドはまず this と Member.PUBLIC を引数に指定してセキュリティマネージャの checkMemberAccess メソッドを呼び出します。クラスがパッケージ内にあった場合、このメソッドはパッケージ名を引数に指定してセキュリティマネージャの checkPackageAccess メソッドも呼び出します。これらの呼び出しによって、SecurityException が発生する場合があります。

戻り値:

このオブジェクトが表す、クラスの新しく割り当てられたインスタンス

例外:

IllegalAccessException - クラスまたは初期化子にアクセスできない場合

InstantiationException - この Class が abstract クラス、インタフェース、配列クラス、プリミティブ型、または void を表す場合、あるいはインスタンスの生成がほかの理由で失敗した場合

ExceptionInInitializerError - このメソッドによる初期化に失敗した場合

SecurityException - 新規インスタンスを生成するアクセス権がない場合

isInstance

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 が このクラスのインスタンスの場合は true

導入されたバージョン:

JDK1.1

isAssignableFrom

public 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 の場合

導入されたバージョン:

JDK1.1

isInterface

public boolean isInterface()

指定された Class オブジェクトがインタフェース型を表すかどうかを判定します。

戻り値:

このオブジェクトがインタフェースを表す場合は true、そうでない場合は false

isArray

public boolean isArray()

この Class オブジェクトが配列クラスを表すかどうかを判定します。

戻り値:

このオブジェクトが配列クラスを表す場合は true、そうでない場合は false

導入されたバージョン:

JDK1.1

isPrimitive

public boolean isPrimitive()

指定された Class オブジェクトがプリミティブ型を表すかどうかを判定します。

8 つの Java のプリミティブ型と void を表す、9 つの定義済み Class オブジェクトがあります。これらは Java Virtual Machine が作成し、該当するプリミティブ型と同じ名前を持ちます。つまり、boolean、byte、char、short、int、long、float、double、および void です。

これらのオブジェクトには、以下の public static final 変数を使う方法によってのみアクセスできます。また、このメソッドが true を返すのは、これらの 9 つの Class オブジェクトに限定されます。

戻り値:

このクラスがプリミティブ型を表す場合に限り true

導入されたバージョン:

JDK1.1

関連項目:

Boolean.TYPE, Character.TYPE, Byte.TYPE, Short.TYPE, Integer.TYPE, Long.TYPE, Float.TYPE, Double.TYPE, Void.TYPE

getName

public String getName()

この Class オブジェクトが表すエンティティ (クラス、インタフェース、配列クラス、プリミティブ型、または void) の完全指定の名前を、String として返します。

この Class オブジェクトが配列のクラスを表す場合、名前の内部形式では、先頭に配列の入れ子の深さを表すいくつかの "[" 文字が付き、そのあとに Java のシグニチャー形式の要素型の名前が続きます。したがって、

 (new Object[3]).getClass().getName()
 

は "[Ljava.lang.Object;" を返し、

 (new int[3][4][5][6][7][8][9]).getClass().getName()
 

は "[[[[[[[I" を返します。要素型の名前は、次のように符号化します。

 B            byte
 C            char
 D            double
 F            float
 I            int
 J            long
 Lclassname;  クラスまたはインタフェース
 S            short
 Z            boolean
 

クラス名またはインタフェース名の classname は、上記の例のように完全指定の名前で指定されます。

戻り値:

このオブジェクトが表すクラスまたはインタフェースの完全指定の名前

getClassLoader

public ClassLoader getClassLoader()

クラスのクラスローダを返します。実装によっては、null を使ってブートストラップクラスローダを表すこともできます。このメソッドは、このクラスがブートストラップクラスローダでロードされた場合に、そのような実装で null を返します。

セキュリティマネージャが存在し、呼び出し側のクラスローダが null でなく、クラスローダが必要とされるクラスのクラスローダの上位ローダでもない場合、このメソッドはセキュリティマネージャの checkPermission メソッドを RuntimePermission("getClassLoader") のアクセス権を使って呼び出すことによってクラスのクラスローダに問題なくアクセスできることを保証します。

このオブジェクトがプリミティブ型または void を表す場合は、null が返されます。

戻り値:

このオブジェクトが表すクラスまたはインタフェースをロードしたクラスローダ

例外:

SecurityException - セキュリティマネージャが存在し、その checkPermission メソッドがクラスのクラスローダへのアクセスを拒否する場合

関連項目:

ClassLoader, SecurityManager.checkPermission(java.security.Permission), RuntimePermission

getSuperclass

public Class getSuperclass()

この Class で表されるエンティティ (クラス、インタフェース、プリミティブ型、または void) のスーパークラスを表す Class を返します。この Class が、Object クラス、インタフェース、プリミティブ型、または void の場合は、null が返されます。このオブジェクトが配列クラスを表す場合は、Object クラスを表す Class オブジェクトが返されます。

戻り値:

このオブジェクトが表すクラスのスーパークラス

getPackage

public Package getPackage()

このクラスのパッケージを取得します。パッケージを探すには、このクラスのクラスローダが使用されます。ブートストラップクラスローダがクラスをロードした場合、CLASSPATH からロードされたパッケージのセットを検索してクラスのパッケージを見つけます。このクラスのクラスローダがパッケージオブジェクトを生成しなかった場合は、null が返されます。

クラスに付属するマニフェストで情報が定義された場合と、クラスローダがマニフェストの属性を持つパッケージインスタンスを生成した場合にだけ、パッケージはバージョンと仕様の属性を持ちます。

戻り値:

クラスのパッケージ。アーカイブまたはコードベースのパッケージの情報が利用できない場合は null

getInterfaces

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 の配列を返します。

戻り値:

このクラスによって実装されるインタフェースの配列

getComponentType

public Class getComponentType()

配列のコンポーネント型を表す Class を返します。このクラスが配列クラスを表さない場合、このメソッドは null を返します。

戻り値:

このクラスが配列の場合、このクラスのコンポーネント型を示す Class

導入されたバージョン:

JDK1.1

関連項目:

Array

getModifiers

public int getModifiers()

このクラスまたはインタフェースの Java 言語修飾子を整数型に符号化して返します。修飾子は、public、protected、private、final、static、abstract、および interface 用の Java Virtual Machine の定数から構成されます。これらは、Modifier クラスのメソッドを使って復号化しなければなりません。

基本となるクラスが配列クラスの場合、public、private、および protected の各修飾子はコンポーネント型の修飾子と同じです。この Class がプリミティブ型または void の場合、public の各修飾子は常に true で、protected および private 修飾子は常に false です。このオブジェクトが配列クラス、プリミティブ型、または void を表す場合、final 修飾子は常に true で、そのインタフェース修飾子は常に false です。ほかの修飾子の値は、この指定では判定されません。

修飾子の符号化は、「Java Virtual Machine 仕様」の表 4.1 で定義しています。

戻り値:

このクラスの修飾子を表す int

導入されたバージョン:

JDK1.1

関連項目:

Modifier

getSigners

public Object[] getSigners()

このクラスの署名者を取得します。

戻り値:

このクラスの署名者。署名者がない場合は null。特にこのメソッドは、このオブジェクトがプリミティブ型または void を表す場合には null を返す

導入されたバージョン:

JDK1.1

getDeclaringClass

public Class getDeclaringClass()

この Class オブジェクトが表すクラスまたはインタフェースが別のクラスのメンバの場合は、それが宣言されたクラスを表す Class オブジェクトを返します。このクラスまたはインタフェースがほかのクラスのメンバでない場合は、null を返します。この Class オブジェクトが配列クラス、プリミティブ型、または void を表す場合、このメソッドは null を返します。

戻り値:

このクラスを宣言するクラス

導入されたバージョン:

JDK1.1

getClasses

public Class[] getClasses()

この Class オブジェクトが表すクラスのメンバである、すべての public クラスおよびインタフェースを表す Class オブジェクトを格納している配列を返します。スーパークラスから継承した public クラスおよびインタフェースのメンバ、ならびにクラスが宣言した public クラスとインタフェースのメンバも含まれます。この Class オブジェクトが public メンバクラスやインタフェースを持たない場合や、プリミティブ型、配列クラス、または void を表す場合には、長さが 0 の配列を返します。

このクラスおよびこのクラスのそれぞれのスーパークラスに対して、次のセキュリティチェックが実行されます。セキュリティマネージャが存在する場合、その checkMemberAccess メソッドは this と Member.PUBLIC を引数に指定して呼び出されます (this はメンバを取得する対象のクラスまたはスーパークラス)。クラスがパッケージ内にあった場合、セキュリティマネージャの checkPackageAccess メソッドがパッケージ名を引数に指定して呼び出されます。これらの呼び出しは、SecurityException になる場合があります。

戻り値:

このクラスの public メンバを表す Class オブジェクトの配列

例外:

SecurityException - 情報へのアクセスが拒否された場合

導入されたバージョン:

JDK1.1

関連項目:

SecurityManager.checkMemberAccess(Class, int), SecurityManager.checkPackageAccess(String)

getFields

public Field[] getFields()
                  throws SecurityException

この Class オブジェクトが表すクラスまたはインタフェースのすべてのアクセス可能な public フィールドをリフレクトする、Field オブジェクトを保持している配列を返します。返された配列内の要素は、ソートされていたり、特定の順序になっていることはありません。クラスまたはインタフェースにアクセス可能な public フィールドがない場合や、クラスまたはインタフェースが配列クラス、プリミティブ型、または void を表す場合は、長さが 0 の配列を返します。

特に、この Class オブジェクトがクラスを表す場合、このメソッドはこのクラスとそのすべてのスーパークラスの public フィールドを返します。この Class オブジェクトがインタフェースを表す場合は、このインタフェースとすべてのスーパーインタフェースのフィールドを返します。

セキュリティマネージャが存在する場合、このメソッドはまず this と Member.PUBLIC を引数に指定してセキュリティマネージャの checkMemberAccess メソッドを呼び出します。クラスがパッケージ内にあった場合、このメソッドはパッケージ名を引数に指定してセキュリティマネージャの checkPackageAccess メソッドも呼び出します。これらの呼び出しによって、SecurityException が発生する場合があります。

このメソッドは、配列クラスの暗黙的な長さフィールドをリフレクトしません。ユーザコードで配列を操作するには、Array クラスのメソッドを使う必要があります。

「Java 言語仕様」のセクション 8.2 と 8.3 を参照してください。

戻り値:

public フィールドを表す Field オブジェクトの配列

例外:

SecurityException - 情報へのアクセスが拒否された場合

導入されたバージョン:

JDK1.1

関連項目:

Field, SecurityManager.checkMemberAccess(Class, int), SecurityManager.checkPackageAccess(String)

getMethods

public Method[] getMethods()
                    throws SecurityException

この Class オブジェクトが表すクラスまたはインタフェースのすべての public メンバメソッドをリフレクトする Method オブジェクトを格納している配列を返します。クラスまたはインタフェースが宣言したもの、およびスーパークラスやスーパーインタフェースから継承されたものも含まれます。返された配列内の要素は、ソートされていたり、特定の順序になっていることはありません。この Class オブジェクトが public メンバメソッドがないクラスまたはインタフェースを表す場合や、配列クラス、プリミティブ型、または void を表す場合は、長さが 0 の配列を返します。

セキュリティマネージャが存在する場合、このメソッドはまず this と Member.PUBLIC を引数に指定してセキュリティマネージャの checkMemberAccess メソッドを呼び出します。クラスがパッケージ内にあった場合、このメソッドはパッケージ名を引数に指定してセキュリティマネージャの checkPackageAccess メソッドも呼び出します。これらの呼び出しによって、SecurityException が発生する場合があります。

クラス初期化メソッド <clinit> は、返される配列に入っていません。クラスが複数の public メンバメソッドを同じパラメータ型で宣言すると、そのようなメソッドはすべて返された配列に入ります。

「Java 言語仕様」のセクション 8.2 と 8.4 を参照してください。

戻り値:

このクラスの public メソッドを表す Method オブジェクトの配列

例外:

SecurityException - 情報へのアクセスが拒否された場合

導入されたバージョン:

JDK1.1

関連項目:

Method, SecurityManager.checkMemberAccess(Class, int), SecurityManager.checkPackageAccess(String)

getConstructors

public Constructor[] getConstructors()
                              throws SecurityException

この Class オブジェクトが表すクラスのすべての public コンストラクタをリフレクトする Constructor オブジェクトを格納している配列を返します。クラスに public コンストラクタがない場合、クラスが配列クラスの場合、またはクラスがプリミティブ型または void をリフレクトする場合には、長さが 0 の配列を返します。

セキュリティマネージャが存在する場合、このメソッドはまず this と Member.PUBLIC を引数に指定してセキュリティマネージャの checkMemberAccess メソッドを呼び出します。クラスがパッケージ内にあった場合、このメソッドはパッケージ名を引数に指定してセキュリティマネージャの checkPackageAccess メソッドも呼び出します。これらの呼び出しによって、SecurityException が発生する場合があります。

戻り値:

このクラスの宣言されたすべての public コンストラクタが指定された parameterTypes と一致する場合、Method オブジェクトを含む配列

例外:

SecurityException - 情報へのアクセスが拒否された場合

導入されたバージョン:

JDK1.1

関連項目:

Constructor, SecurityManager.checkMemberAccess(Class, int), SecurityManager.checkPackageAccess(String)

getField

public Field getField(String name)
               throws NoSuchFieldException,
                      SecurityException

この Class オブジェクトが表すクラスまたはインタフェースの指定された public メンバフィールドをリフレクトする Field オブジェクトを返します。name パラメータは、要求されるフィールドの単純な名前を指定する String です。

セキュリティマネージャが存在する場合、このメソッドはまず this と Member.PUBLIC を引数に指定してセキュリティマネージャの checkMemberAccess メソッドを呼び出します。クラスがパッケージ内にあった場合、このメソッドはパッケージ名を引数に指定してセキュリティマネージャの checkPackageAccess メソッドも呼び出します。これらの呼び出しによって、SecurityException が発生する場合があります。

リフレクトされるフィールドは、次のアルゴリズムで決定されます。ここでは、このオブジェクトが表すクラスを C とします。

1. C が指定された名前を持つ public フィールドを宣言すると、それがリフレクトされるフィールドになります。
2. 上記のステップ 1 でフィールドが見つからなかった場合は、このアルゴリズムを C のそれぞれの直接スーパーインタフェースに再帰的に適用します。直接スーパーインタフェースは宣言された順序で検索されます。
3. 上記のステップ 1 と 2 でフィールドが見つからない場合、および C がスーパークラス S を持つ場合は、このアルゴリズムは S により再帰的に呼び出されます。C がスーパークラスを持たない場合は、NoSuchFieldException がスローされます。

「Java 言語仕様」のセクション 8.2 と 8.3 を参照してください。

パラメータ:

name - フィールド名

戻り値:

name で指定されたこのクラスの Field オブジェクト

例外:

NoSuchFieldException - 指定された名前のフィールドが見つからない場合

SecurityException - 情報へのアクセスが拒否された場合

導入されたバージョン:

JDK1.1

関連項目:

Field, SecurityManager.checkMemberAccess(Class, int), SecurityManager.checkPackageAccess(String)

getMethod

public Method getMethod(String name,
                        Class[] parameterTypes)
                 throws NoSuchMethodException,
                        SecurityException

この Class オブジェクトが表すクラスまたはインタフェースの指定された public メンバメソッドをリフレクトする Method オブジェクトを返します。name パラメータは、要求されるメソッドに単純な名前を指定する String です。parameterTypes パラメータは、メソッドの仮パラメータ型を宣言された順序で識別する Class オブジェクトの配列です。parameterTypes が null の場合は、空の配列のように扱われます。

セキュリティマネージャが存在する場合、このメソッドはまず this と Member.PUBLIC を引数に指定してセキュリティマネージャの checkMemberAccess メソッドを呼び出します。クラスがパッケージ内にあった場合、このメソッドはパッケージ名を引数に指定してセキュリティマネージャの checkPackageAccess メソッドも呼び出します。これらの呼び出しによって、SecurityException が発生する場合があります。

name が "<init>" または "<clinit>" の場合、NoSuchMethodException がスローされます。そうでない場合、リフレクトされるメソッドは、次のアルゴリズムで指定されます。ここでは、このオブジェクトが表すクラスを C とします。

1. C を検索して、「一致するメソッド」を見つけます。一致するメソッドが見つからない場合は、ステップ 1 のアルゴリズムが C のスーパークラスに対して再帰的に呼び出されます。
2. 上記のステップ 1 でメソッドが見つからなかった場合は、C のスーパーインタフェースを検索して一致するメソッドを見つけます。一致するメソッドが見つかった場合は、それがリフレクトされます。

C: クラスでの一致するメソッドは、次のようにして見つけられます。C が、同じ仮パラメータ型を持ち、指定された名前を持つ public メソッドをただ 1 つ宣言する場合、そのメソッドはリフレクトされます。そのようなメソッドが C で複数見つかって、そのメソッドの 1 つがそれ以外のどれよりも明確な戻り型を持つ場合には、そのメソッドがリフレクトされます。そうでない場合は、相応するメソッドの 1 つが任意に選択されます。

「Java 言語仕様」のセクション 8.2 と 8.4 を参照してください。

パラメータ:

name - メソッドの名前

parameterTypes - パラメータのリスト

戻り値:

指定された name と parameterTypes と一致する Method オブジェクト

例外:

NoSuchMethodException - 一致するメソッドが見つからない場合、あるいは名前が "<init>" または "<clinit>" の場合

SecurityException - 情報へのアクセスが拒否された場合

導入されたバージョン:

JDK1.1

関連項目:

Method, SecurityManager.checkMemberAccess(Class, int), SecurityManager.checkPackageAccess(String)

getConstructor

public Constructor getConstructor(Class[] parameterTypes)
                           throws NoSuchMethodException,
                                  SecurityException

この Class オブジェクトが表すクラスの指定された public コンストラクタをリフレクトする Constructor オブジェクトを返します。parameterTypes パラメータは、コンストラクタの仮パラメータ型を宣言された順序で識別する Class オブジェクトの配列です。

リフレクトするコンストラクタは、parameterTypes に指定された型と一致する仮パラメータ型を持つこの Class オブジェクトが表すクラスの public コンストラクタです。

セキュリティマネージャが存在する場合、このメソッドはまず this と Member.PUBLIC を引数に指定してセキュリティマネージャの checkMemberAccess メソッドを呼び出します。クラスがパッケージ内にあった場合、このメソッドはパッケージ名を引数に指定してセキュリティマネージャの checkPackageAccess メソッドも呼び出します。これらの呼び出しによって、SecurityException が発生する場合があります。

パラメータ:

parameterTypes - パラメータ配列

戻り値:

指定された parameterTypes と一致する public コンストラクタの Method オブジェクト

例外:

NoSuchMethodException - 一致するメソッドが見つからない場合

SecurityException - 情報へのアクセスが拒否された場合

導入されたバージョン:

JDK1.1

関連項目:

Constructor, SecurityManager.checkMemberAccess(Class, int), SecurityManager.checkPackageAccess(String)

getDeclaredClasses

public Class[] getDeclaredClasses()
                           throws SecurityException

この Class オブジェクトが表すクラスのメンバとして宣言された、すべてのクラスおよびインタフェースをリフレクトする、Class オブジェクトの配列を返します。これには、クラスが宣言した public、protected、デフォルト (package) アクセス、および private クラスとインタフェースは含まれますが、継承クラスとインタフェースは含まれません。このメソッドは、クラスがメンバとしてクラスまたはインタフェースを宣言していない場合や、この Class オブジェクトがプリミティブ型、配列クラス、または void を表す場合には、長さが 0 の配列を返します。

セキュリティマネージャが存在する場合、このメソッドはまず this と Member.PUBLIC を引数に指定してセキュリティマネージャの checkMemberAccess メソッドを呼び出します。クラスがパッケージ内にあった場合、このメソッドはパッケージ名を引数に指定してセキュリティマネージャの checkPackageAccess メソッドも呼び出します。これらの呼び出しによって、SecurityException が発生する場合があります。

戻り値:

このクラスの宣言されたすべてのメンバを表す Class オブジェクトの配列

例外:

SecurityException - 情報へのアクセスが拒否された場合

導入されたバージョン:

JDK1.1

関連項目:

SecurityManager.checkMemberAccess(Class, int), SecurityManager.checkPackageAccess(String)

getDeclaredFields

public Field[] getDeclaredFields()
                          throws SecurityException

この Class オブジェクトが表すクラスまたはインタフェースが宣言した、すべてのフィールドをリフレクトする、Field オブジェクトの配列を返します。これには、public、protected、デフォルト (package) アクセス、および private フィールドは含まれますが、継承フィールドは含まれません。返された配列内の要素は、ソートされていたり、特定の順序になっていることはありません。このメソッドは、クラスまたはインタフェースがフィールドを宣言しない場合や、この Class オブジェクトがプリミティブ型、配列クラス、または void を表す場合には、長さが 0 の配列を返します。

「Java 言語仕様」のセクション 8.2 と 8.3 を参照してください。

セキュリティマネージャが存在する場合、このメソッドはまず this と Member.CECLARED を引数に指定してセキュリティマネージャの checkMemberAccess メソッドを呼び出します。クラスがパッケージ内にあった場合、このメソッドはパッケージ名を引数に指定してセキュリティマネージャの checkPackageAccess メソッドも呼び出します。これらの呼び出しによって、SecurityException が発生する場合があります。

戻り値:

このクラスの宣言されたすべてのメンバを表す Field オブジェクトの配列

例外:

SecurityException - 情報へのアクセスが拒否された場合

導入されたバージョン:

JDK1.1

関連項目:

Field, SecurityManager.checkMemberAccess(Class, int), SecurityManager.checkPackageAccess(String)

getDeclaredMethods

public Method[] getDeclaredMethods()
                            throws SecurityException

この Class オブジェクトが表すクラスまたはインタフェースが宣言した、すべてのメソッドをリフレクトする、Method オブジェクトの配列を返します。これには、public、protected、デフォルト (package) アクセス、および private メソッドは含まれますが、継承メソッドは含まれません。返された配列内の要素は、ソートされていたり、特定の順序になっていることはありません。このメソッドは、クラスまたはインタフェースがメソッドを宣言しない場合や、この Class オブジェクトがプリミティブ型、配列クラス、または void を表す場合は、長さが 0 の配列を返します。クラス初期化メソッド <clinit> は、返された配列にはありません。クラスが同じパラメータ型を持つ複数の public メンバメソッドを宣言する場合、それらのメソッドは、すべて返された配列にあります。

「Java 言語仕様」のセクション 8.2 を参照してください。

セキュリティマネージャが存在する場合、このメソッドはまず this と Member.DECLARED を引数に指定してセキュリティマネージャの checkMemberAccess メソッドを呼び出します。クラスがパッケージ内にあった場合、このメソッドはパッケージ名を引数に指定してセキュリティマネージャの checkPackageAccess メソッドも呼び出します。これらの呼び出しによって、SecurityException が発生する場合があります。

戻り値:

このクラスの宣言されたすべてのメソッドを表す Method オブジェクトの配列

例外:

SecurityException - 情報へのアクセスが拒否された場合

導入されたバージョン:

JDK1.1

関連項目:

Method, SecurityManager.checkMemberAccess(Class, int), SecurityManager.checkPackageAccess(String)

getDeclaredConstructors

public Constructor[] getDeclaredConstructors()
                                      throws SecurityException

この Class オブジェクトが表すクラスが宣言したすべてのコンストラクタをリフレクトする Constructor オブジェクトの配列を返します。これらは、public、protected、デフォルト (package) アクセス、および private コンストラクタです。返された配列内の要素は、ソートされていたり、特定の順序になっていることはありません。クラスがデフォルトのコンストラクタを持つ場合、このコンストラクタは返された配列にあります。このメソッドは、この Class オブジェクトがインタフェース、プリミティブ型、配列クラス、または void を表す場合には長さが 0 の配列を返します。

「Java 言語仕様」のセクション 8.2 を参照してください。

セキュリティマネージャが存在する場合、このメソッドはまず this と Member.DECLARED を引数に指定してセキュリティマネージャの checkMemberAccess メソッドを呼び出します。クラスがパッケージ内にあった場合、このメソッドはパッケージ名を引数に指定してセキュリティマネージャの checkPackageAccess メソッドも呼び出します。これらの呼び出しによって、SecurityException が発生する場合があります。

戻り値:

このクラスの宣言されたすべてのコンストラクタを表す Method オブジェクトの配列

例外:

SecurityException - 情報へのアクセスが拒否された場合

導入されたバージョン:

JDK1.1

関連項目:

Constructor, SecurityManager.checkMemberAccess(Class, int), SecurityManager.checkPackageAccess(String)

getDeclaredField

public Field getDeclaredField(String name)
                       throws NoSuchFieldException,
                              SecurityException

この Class オブジェクトが表すクラスまたはインタフェースの指定の宣言フィールドをリフレクトする Field オブジェクトを返します。name パラメータは、要求されたフィールドの単純な名前を指定する String です。このメソッドが配列クラスの length フィールドをリフレクトすることはありません。

セキュリティマネージャが存在する場合、このメソッドはまず this と Member.DECLARED を引数に指定してセキュリティマネージャの checkMemberAccess メソッドを呼び出します。クラスがパッケージ内にあった場合、このメソッドはパッケージ名を引数に指定してセキュリティマネージャの checkPackageAccess メソッドも呼び出します。これらの呼び出しによって、SecurityException が発生する場合があります。

パラメータ:

name - フィールドの名前

戻り値:

このクラスに指定されたフィールドの Field オブジェクト

例外:

NoSuchFieldException - 指定された名前のフィールドが見つからない場合

SecurityException - 情報へのアクセスが拒否された場合

導入されたバージョン:

JDK1.1

関連項目:

Field, SecurityManager.checkMemberAccess(Class, int), SecurityManager.checkPackageAccess(String)

getDeclaredMethod

public Method getDeclaredMethod(String name,
                                Class[] parameterTypes)
                         throws NoSuchMethodException,
                                SecurityException

この Class オブジェクトが表すクラスまたはインタフェースの指定の宣言メソッドをリフレクトする Method オブジェクトを返します。name パラメータは、要求されたメソッドの単純な名前を指定する String です。parameterTypes パラメータは、メソッドの仮パラメータ型を宣言順に識別する Class オブジェクトの配列です。同じパラメータ型を持つ複数のメソッドが 1 つのクラスで宣言され、そうしたメソッドの 1 つがそれ以外のどれよりも明確な戻り型を持つ場合には、そのメソッドが返されます。そうでない場合、メソッドの 1 つが任意に選択されます。名前が "<init>" または "<clinit>" の場合は、NoSuchMethodException がスローされます。

セキュリティマネージャが存在する場合、このメソッドはまず this と Member.DECLARED を引数に指定してセキュリティマネージャの checkMemberAccess メソッドを呼び出します。クラスがパッケージ内にあった場合、このメソッドはパッケージ名を引数に指定してセキュリティマネージャの checkPackageAccess メソッドも呼び出します。これらの呼び出しによって、SecurityException が発生する場合があります。

パラメータ:

name - メソッドの名前

parameterTypes - パラメータ配列

戻り値:

このクラスの指定された名前とパラメータと一致するメソッドの Method オブジェクト

例外:

NoSuchMethodException - 一致するメソッドが見つからない場合

SecurityException - 情報へのアクセスが拒否された場合

導入されたバージョン:

JDK1.1

関連項目:

Method, SecurityManager.checkMemberAccess(Class, int), SecurityManager.checkPackageAccess(String)

getDeclaredConstructor

public Constructor getDeclaredConstructor(Class[] parameterTypes)
                                   throws NoSuchMethodException,
                                          SecurityException

この Class オブジェクトが表すクラスまたはインタフェースの指定のコンストラクタをリフレクトする Constructor オブジェクトを返します。parameterTypes パラメータは、コンストラクタの仮パラメータ型を宣言順に識別する Class オブジェクトの配列です。

セキュリティマネージャが存在する場合、このメソッドはまず this と Member.DECLARED を引数に指定してセキュリティマネージャの checkMemberAccess メソッドを呼び出します。クラスがパッケージ内にあった場合、このメソッドはパッケージ名を引数に指定してセキュリティマネージャの checkPackageAccess メソッドも呼び出します。これらの呼び出しによって、SecurityException が発生する場合があります。

パラメータ:

parameterTypes - パラメータ配列

戻り値:

指定されたパラメータリストを持つコンストラクタの Method オブジェクト

例外:

NoSuchMethodException - 一致するメソッドが見つからない場合

SecurityException - 情報へのアクセスが拒否された場合

導入されたバージョン:

JDK1.1

関連項目:

Constructor, SecurityManager.checkMemberAccess(Class, int), SecurityManager.checkPackageAccess(String)

getResourceAsStream

public InputStream getResourceAsStream(String name)

指定された名前のリソースを検索します。このメソッドは、この名前を持つリソースが見つからない場合は、null を返します。あるクラスに関連したリソースを検索する規則は、クラスの定義側クラスローダによって実装されます。

このメソッドは、リソース名に次のような変更を加えたあとで呼び出しをそのクラスローダに委譲します。「/」で始まるリソース名は、そのまま使います。それ以外の場合は、「.」から「/」に変換したあとで、パッケージの名前を付けます。このオブジェクトがブートストラップローダでロードされると、呼び出しは ClassLoader.getSystemResourceAsStream に委譲されます。

パラメータ:

name - 要求されるリソースの名前

戻り値:

java.io.InputStream オブジェクト

導入されたバージョン:

JDK1.1

関連項目:

ClassLoader

getResource

public URL getResource(String name)

指定された名前のリソースを探します。このメソッドは、指定された名前のリソースが見つからない場合は null を返します。あるクラスに関連したリソースを検索する規則は、クラスの定義側クラスローダによって実装されます。

このメソッドは、リソース名に次のような変更を加えたあとで呼び出しをそのクラスローダに委譲します。「/」で始まるリソース名は、そのまま使います。それ以外の場合は、「.」から「/」に変換したあとで、パッケージの名前を付けます。このオブジェクトがブートストラップローダでロードされると、呼び出しは ClassLoader.getSystemResource に委譲されます。

パラメータ:

name - 要求されるリソースの名前

戻り値:

java.net.URL オブジェクト

導入されたバージョン:

JDK1.1

関連項目:

ClassLoader

getProtectionDomain

public ProtectionDomain getProtectionDomain()

このクラスの ProtectionDomain を返します。セキュリティマネージャがインストールされていると、このメソッドはまずセキュリティマネージャの checkPermission メソッドを RuntimePermission("getProtectionDomain") アクセス権を使って呼び出すことによって ProtectionDomain を問題なく取得できることを保証します。

戻り値:

このクラスの ProtectionDomain

例外:

SecurityException - セキュリティマネージャが存在し、その checkPermission メソッドが ProtectionDomain の取得を許可しない場合

導入されたバージョン:

1.2

関連項目:

ProtectionDomain, SecurityManager.checkPermission(java.security.Permission), RuntimePermission