java.lang.instrument
인터페이스 Instrumentation

public interface Instrumentation

이 클래스는 Java 프로그램 언어 코드를 파악 하기 위한 서비스를 제공합니다. 인스트르멘테이션이란 툴로 사용하는 데이터를 수집하는 것을 목적으로의해 메서드에 바이트 코드를 추가하는 것입니다. 변경은 단지 추가되기 때문에 이러한 툴은 어플리케이션 상태나 동작을 변경하지 않습니다. 상태나 동작에 영향을 미치지 않는 이런 종류의 툴에는 감시 에이전트, 프로 filer, 카버리지 analyzer 및 이벤트 로거등이 있습니다.

Instrumentation인터페이스의 인스턴스에 액세스 하는 유일한 방법은 에이전트 클래스를 지정하는 방법으로 JVM를 시작하는 것입니다 (the package specification를 참조). Instrumentation인스턴스는 그 에이전트 클래스의 premain 메서드에게 건네집니다. 에이전트가 Instrumentation인스턴스를 취득하면, 인스턴스상의 메서드를 언제라도 호출할 수 있습니다 .

도입된 버전 :

JDK1. 5

메서드 개요

void	addTransformer (ClassFileTransformer transformer) 제공된 트랜스 포머를 등록합니다.
Class []	getAllLoadedClasses () JVM에 의해 현재 로드 사라질 수 있어 모든 클래스의 배열을 리턴합니다.
Class []	getInitiatedClasses (ClassLoader loader) loader가 시작 로더인 모든 클래스의 배열을 리턴합니다.
long	getObjectSize (Object objectToSize) 지정된 객체에 의해 소비되는 기억 영역의 용량의 구현 고유의 근사치를 리턴합니다.
boolean	isRedefineClassesSupported () 현재의 JVM 구성이 클래스의 재정의를 지원 하고 있을지 어떨지를 리턴합니다.
void	redefineClasses (ClassDefinition [] definitions) 제공된 클래스 파일을 사용해 제공된 클래스세트를 재정의합니다.
boolean	removeTransformer (ClassFileTransformer transformer) 제공된 트랜스 포머의 등록을 해제합니다.

메서드의 상세

addTransformer

void addTransformer(ClassFileTransformer  transformer)

제공된 트랜스 포머를 등록합니다. 이것에 의해 등록된 트랜스 포머가 의존된 클래스의 정의를 제외해, 장래의 모든 클래스 정의는 트랜스 포머에 의해 확인됩니다. 복수의 트랜스 포머가 등록되었을 경우, 추가된 순서에 호출합니다. 트랜스 포머가 실행중에 예외를 Throw 하면, JVM는 등록되어 있는 그 외의 트랜스 포머를 순서에 호출합니다. 같은 트랜스 포머를 여러 차례 추가할 수 있습니다. addTransformer를 사용해 등록된 모든 트랜스 포머는 외부의 JVMTI ClassFileLoadHook 이벤트 리스너가 확인하기 전에 항상 모든 클래스 파일을 확인합니다.

이 메서드는 class specification 로 기술되고 있도록, 인스트르멘테이션으로 사용하는 것입니다.

파라미터:

transformer - 등록하는 트랜스 포머

예외:

NullPointerException - null 트랜스 포머를 건네주었을 경우

removeTransformer

boolean removeTransformer(ClassFileTransformer  transformer)

제공된 트랜스 포머의 등록을 해제합니다. 등록 해제된 트랜스 포머는 장래 클래스 정의를 확인할 수 없게 됩니다. 직전에 추가된 일치하는 트랜스 포머의 인스턴스를 삭제합니다. 클래스 로딩의 multi-thread적 성질에의해 삭제된 후에도 트랜스 포머를 호출할 수 있습니다 . 이러한 상황을 고려해, 신중하게 트랜스 포머를 기술할 필요가 있습니다.

파라미터:

transformer - 등록을 해제하는 트랜스 포머

반환값:

트랜스 포머가 발견되어, 삭제되었을 경우는 true. 트랜스 포머가 발견되지 않았던 경우는 false

예외:

NullPointerException - null 트랜스 포머를 건네주었을 경우

isRedefineClassesSupported

boolean isRedefineClassesSupported()

현재의 JVM 구성이 클래스의 재정의를 지원 하고 있을지 어떨지를 리턴합니다. 이미 로드 되고 있는 클래스를 재정의하는 기능은 JVM 옵션의 기능입니다. 단일의 JVM 1개의 인스턴스 생성동안에 이 메서드에 복수의 호출을 실시하면, 항상 같은 대답이 리턴됩니다 .

반환값:

현재의 JVM 구성이 클래스의 재정의를 지원하는인 경우는 true, 지원 하지 않는 경우는 false

관련 항목:

redefineClasses(java.lang.instrument.ClassDefinition[])

redefineClasses

void redefineClasses(ClassDefinition [] definitions)
                     throws ClassNotFoundException,

                            UnmodifiableClassException 

제공된 클래스 파일을 사용해 제공된 클래스세트를 재정의합니다. 동시에 1개 이상의 클래스에 대해서 인터락 된 변경 (클래스 A 재정의는 클래스 B 재정의를 필요로 하는 등)을 가능하게 하기 위해서 세트상에서 동작합니다.

재정의된 메서드가 활성화된 스택 프레임을 가지는 경우, 활성화된 스택 프레임은 원의 메서드의 바이트 코드를 계속해 실행합니다. 재정의된 메서드는 새로운 호출로 사용됩니다.

이 메서드는 관행의 JVM 시멘틱스아래에서 발생하는 초기화를 제외해, 초기화를 발생시키지 않습니다. 즉, 클래스의 재정의에서는 클래스의 초기화자는 실행되지 않습니다. static 변수의 값은 호출해 전의 값대로 유지됩니다.

재정의된 클래스의 인스턴스는 영향을 받지 않습니다.

등록된 트랜스 포머는 재정의 조작이 적용되기 전에 호출합니다.

재정의에서는 메서드의 본문, 정수 풀 및 속성의 변경이 가능합니다. 다만, 재정의에서는 필드 또는 메서드의 추가 삭제, 혹은 이름의 변경, 메서드의 시그니쳐의 변경, 혹은 상속의 변경은 할 수 없습니다. 이러한 제약은 장래 버전 으로 해소될 가능성이 있습니다.

길이 제로의 definitions 배열은 사용할 수 있습니다만, 사용했을 경우, 이 메서드는 아무것도 실행하지 않습니다.

이 메서드가 예외를 Throw 했을 경우, 클래스의 재정의는 행해지지 않습니다.

이 메서드는 class specification 로 기술되고 있도록, 인스트르멘테이션으로 사용하는 것입니다.

파라미터:

definitions - 대응하는 정의를 사용해 재정의하는 클래스의 배열

예외:

ClassNotFoundException - 지정된 클래스가 발견되지 않는 경우

UnmodifiableClassException - 지정된 클래스를 변경할 수 없는 경우

UnsupportedOperationException - JVM 현재의 구성이 재정의 (isRedefineClassesSupported() 가 false)를 허가하지 않는지, 재정의로 지원 되어 있지 않은 변경을 실시했을 경우

ClassFormatError - 데이터가 유효한 클래스를 포함하지 않았던 경우

NoClassDefFoundError - 클래스 파일의 이름이 클래스의 이름과 동일하지 않은 경우

UnsupportedClassVersionError - 클래스 파일 버전 번호가 지원 되어 있지 않은 경우

ClassCircularityError - 새로운 클래스가 순환을 포함한 경우

LinkageError - 링키지 에러가 발생했을 경우

NullPointerException - 제공된 정의 배열 또는 그 컴퍼넌트가 null인 경우

관련 항목:

isRedefineClassesSupported(), addTransformer(java.lang.instrument.ClassFileTransformer), ClassFileTransformer

getAllLoadedClasses

Class [] getAllLoadedClasses()

JVM에 의해 현재 로드 사라질 수 있어 모든 클래스의 배열을 리턴합니다.

반환값:

JVM에 의해 로드 된 모든 클래스를 포함한 배열. 클래스가 없는 경우는 길이 제로의 배열

getInitiatedClasses

Class [] getInitiatedClasses(ClassLoader  loader)

loader가 시작 로더인 모든 클래스의 배열을 리턴합니다. 제공된 로더가 null인 경우, bootstrap 클래스 로더에 의해 시작된 클래스가 리턴됩니다 .

파라미터:

loader - 시작한 클래스 리스트가 리턴된 로더

반환값:

로더가 시작 로더인 모든 클래스를 포함한 배열. 클래스가 없는 경우는 길이 제로의 배열

getObjectSize

long getObjectSize(Object  objectToSize)

지정된 객체에 의해 소비되는 기억 영역의 용량의 구현 고유의 근사치를 리턴합니다. 결과에는 객체의 오버헤드의 일부 또는 모든 것이 포함될 가능성이 있습니다. 따라서, 구현내에서의 비교에는 도움이 됩니다만, 구현간에서의 비교에는 도움이 되지 않습니다. JVM 단일의 호출동안에 근사값이 바뀔 가능성이 있습니다.

파라미터:

objectToSize - 사이즈를 평가하는 객체

반환값:

지정된 객체에 의해 소비되는 기억 영역의 용량의 구현 고유의 근사치

예외:

NullPointerException - 제공된 객체가 null인 경우