java.lang
클래스 Runtime

java.lang.Object 
  java.lang.Runtime

public class Runtime
extends Object 

Java 어플리케이션은 모두, Runtime 클래스의 단일의 인스턴스를 가집니다. 이 클래스는 어플리케이션과 어플리케이션 실행 환경과의 인터페이스가 됩니다. 현재의 실행시 객체는 getRuntime 메서드에 의해 취득할 수 있습니다.

어플리케이션은 자신의 Runtime 클래스의 인스턴스를 작성할 수 없습니다.

도입된 버전 :

JDK1. 0

관련 항목:

getRuntime()

메서드 개요

void	addShutdownHook (Thread hook) 새로운 가상 머신의 셧다운 훅을 등록합니다.
int	availableProcessors () Java 가상 머신이 이용 가능한 프로세서의 수를 리턴합니다.
Process	exec (String command) 지정된 캐릭터 라인 커멘드를, 독립한 프로세스로 실행합니다.
Process	exec (String [] cmdarray) 지정된 커멘드와 인수를, 독립한 프로세스로 실행합니다.
Process	exec (String [] cmdarray, String [] envp) 지정된 커멘드와 인수를, 지정된 환경을 가지는 독립한 프로세스로 실행합니다.
Process	exec (String [] cmdarray, String [] envp, File dir) 지정된 커멘드와 인수를, 지정된 환경과 작업 디렉토리를 가지는 독립한 프로세스로 실행합니다.
Process	exec (String command, String [] envp) 지정된 캐릭터 라인 커멘드를, 지정된 환경을 가지는 독립한 프로세스로 실행합니다.
Process	exec (String command, String [] envp, File dir) 지정된 캐릭터 라인 커멘드를, 지정된 환경과 작업 디렉토리를 가지는 독립한 프로세스로 실행합니다.
void	exit (int status) 현재 실행하고 있는 Java 가상 머신을 셧다운 순서를 개시해 종료합니다.
long	freeMemory () Java 가상 머신내의 빈메모리의 양을 리턴합니다.
void	gc () 가비지 컬렉터를 실행합니다.
InputStream	getLocalizedInputStream (InputStream in) 추천하지 않습니다. JDK 1. 1 에서는 로컬인 인코딩의 바이트 스트림을 Unicode 문자 스트림로 변환하려면, InputStreamReader 클래스와 BufferedReader 클래스를 사용하는 (분)편이 적절합니다.
OutputStream	getLocalizedOutputStream (OutputStream out) 추천하지 않습니다. JDK 1. 1 에서는 Unicode 문자 스트림을 로컬인 인코딩의 바이트 스트림로 변환하려면, OutputStreamWriter 클래스, BufferedWriter 클래스 및 PrintWriter 클래스를 사용하는 (분)편이 적절합니다.
static Runtime	getRuntime () 현재의 Java 어플리케이션에 관련한 Runtime 객체를 리턴합니다.
void	halt (int status) 현재 실행중의 Java 가상 머신을 강제 종료합니다.
void	load (String filename) 지정된 파일명을 다이나믹 라이브러리로서 로드합니다.
void	loadLibrary (String libname) 지정된 라이브러리명을 가지는 다이나믹 라이브러리를 로드합니다.
long	maxMemory () Java 가상 머신이 사용을 시도하는 최대 메모리 용량을 리턴합니다.
boolean	removeShutdownHook (Thread hook) 이미 등록한 가상 머신의 셧다운 훅을 등록 해제합니다.
void	runFinalization () 파이나라이즈를 중단하고 있는 객체의 finalize 메서드를 실행합니다.
static void	runFinalizersOnExit (boolean value) 추천하지 않습니다. 이 메서드는 본질적으로 안전하지는 않습니다. 다른 thread가 동시에 그러한 객체를 조작하고 있을 때, 생존중의 객체에 대해서 파이나라이자가 불려가 이것에 의해 에러 동작 또는 데드 록이 발생합니다.
long	totalMemory () Java 가상 머신의 메모리의 총용량을 리턴합니다.
void	traceInstructions (boolean on) 명령의 트레이스를 유효 또는 무효로 합니다.
void	traceMethodCalls (boolean on) 메서드 호출의 트레이스를 유효 또는 무효로 합니다.

클래스 java.lang. Object 로부터 상속된 메서드

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

메서드의 상세

getRuntime

public static Runtime  getRuntime()

현재의 Java 어플리케이션에 관련한 Runtime 객체를 리턴합니다. Runtime 클래스의 메서드의 대부분은 인스턴스 메서드이며, 현재의 런타임 객체에 대응해 불려가 지 않으면 안됩니다.

반환값:

현재의 Java 어플리케이션에 관련한 Runtime 객체

exit

public void exit(int status)

현재 실행하고 있는 Java 가상 머신을 셧다운 순서를 개시해 종료합니다. 이 메서드는 정상적으로 복귀할 것은 없습니다. 인수는 스테이터스 코드로서 작용합니다. 통례, 제로 이외의 스테이터스 코드는 이상종료(ABEND)를 나타냅니다.

가상 머신의 셧다운 순서는 2개의 단계로 구성됩니다. 제 1 단계에서는 모든 등록을 마친셧다운 훅 은 (있는 경우), 특히 지정하고 있지 않는 순서로 시작해, 종료할 때까지 동시에 실행할 수 있습니다 . 제 2 단계에서는 종료시의 파이나라이즈가 유효하게 되어 있는 경우에 불려가 지 않은 모든 파이나라이자가 실행됩니다. 이것이 종료하면 가상 머신은정지 합니다.

가상 머신이 셧다운 순서를 개시한 뒤에 이 메서드가 불려가 면, 셧다운 훅이 이 메서드를 실행하고 있는 경우는 무기한으로 블록 됩니다. 셧다운 훅이 이미 실행되어 있어 종료시의 파이나라이즈가 유효하게 되어 있을 때는 스테이터스가 제로 이외의 경우는 가상 머신을 지정한 스테이터스 코드로 정지해, 그렇지 않은 경우는 무기한으로 블록 합니다.

이 메서드를 호출하려면, System.exit 메서드가 일반적이고 편리합니다.

파라미터:

status - 종료 스테이터스. 통례, 제로 이외의 스테이터스 코드는 이상종료(ABEND)를 나타낸다

예외:

SecurityException - 시큐러티 매니저가 존재할 경우에 시큐러티 매니저의 checkExit 메서드가 지정된 스테이터스에서의 종료를 허가하지 않는 경우

관련 항목:

SecurityException, SecurityManager.checkExit(int), addShutdownHook(java.lang.Thread), removeShutdownHook(java.lang.Thread), runFinalizersOnExit(boolean), halt(int)

addShutdownHook

public void addShutdownHook(Thread  hook)

새로운 가상 머신의 셧다운 훅을 등록합니다.

2 종류의 이벤트에 응답해 Java 가상 머신을 「셧다운」합니다.

• 마지막 demon가 아닌 thread가 종료하든가 또는 exit (System.exit 와 동등) 메서드가 불려가 면, 프로그램은 정상적으로 종료 (exit)한다

• 가상 머신은, ^C 입력등에 한 사용자 인터럽트나, 사용자 로그 오프 또는 시스템 셧다운과 같은 시스템 전체의 이벤트에 응답해 종료 (terminate)한다

「셧다운 훅」은 초기화된 것만으로 시작하고 있지 않는 thread입니다. 가상 머신이 셧다운 순서를 개시하면, 모든 등록이 끝난 셧다운 훅을 지정되어 있지 않은 순서로 시작해 동시 실행합니다. 훅이 모두 종료하면, 종료시의 파이나라이즈가 유효한 경우는 모든 불려가 지 않은 파이나라이자를 실행합니다. 마지막으로 가상 머신은 정지합니다. exit 를 호출해 셧다운이 개시되었을 경우는 demon가 아닌 thread와 같이, demon thread는 셧다운 순서의 사이, 실행을 계속합니다.

일단 셧다운 순서가 시작하면, 강제적으로 가상 머신을 정지시키는 halt 메서드를 호출했을 경우만 중지할 수 있습니다.

일단 셧다운 순서를 시작하면, 새로운 셧다운 훅을 등록하거나 이전에 등록한 훅의 등록을 해제하거나 할 수 없습니다. 이러한 오퍼레이션의 어떤 것인지를 실행하려고 하면, IllegalStateException 가 발생 됩니다.

셧다운 훅은 가상 머신의 라이프 사이클의 미묘한 시기에 시작하기 위해, 코딩 하는 경우는 조심할 필요가 있습니다. 특히, thread 세이프에 출력할 필요가 있어, 할 수 있는 한 데드 록을 피할 필요가 있습니다. 셧다운 훅을 등록한 서비스를 그대로 받아들이지 않고, 셧다운이 진행중에 등록할 필요가 있습니다.

셧다운 훅은 신속히 종료할 필요도 있습니다. 프로그램이 exit 를 호출하면, 가상 머신은 즉시 셧다운의해 종료하는 것이라고 보여집니다. 가상 머신이 사용자 로그 오프 또는 시스템 셧다운으로 종료하면, 기본이 되는 OS 는 셧다운 또는 종료할 때까지의 일정시간을 줍니다. 따라서, 셧다운 훅중에 사용자와의 대화 처리를 하거나 장시간의 계산을 하는 것은 추천하지 않습니다.

캐치되어 있지 않은 예외는 다른 thread와 같게, thread ThreadGroup 객체의 uncaughtException 메서드를 호출해 셧다운 훅으로 처리됩니다. 이 메서드의 디폴트 구현은 System.err 에 의 예외 스택 트레이스를 출력해 thread를 정지합니다. 가상 머신의 종료 또는 정지는 하지 않습니다.

보기 드문 케이스로서 가상 머신이 「이상종료(ABEND)」하는 일이 있습니다. 즉, 셧다운이 정상적으로 행해지지 않고 실행이 중지되는 경우입니다. 이것은 가상 머신이 외부에서 정지되었을 경우에 일어납니다. 예를 들어 Unix인 경우의 SIGKILL 시그널 또는 Microsoft Windows인 경우의 TerminateProcess 호출이 그 예입니다. 가상 머신은 예를 들어 내부 데이터 구조의 파괴, 존재하지 않는 메모리에의 액세스등과 같이 네이티브 메서드가 실패했을 경우에도 이상종료(ABEND) 합니다. 가상 머신이 이상종료(ABEND) 하면 셧다운 훅의 실행은 보증할 수 없습니다.

파라미터:

hook - 초기화는 되었지만 시작하고 있지 않는 Thread 객체

예외:

IllegalArgumentException - 지정한 훅이 이미 등록되어 있는 경우, 혹은 훅이 이미 실행중이다, 또는 실행이 완료했다고 판정되는 경우

IllegalStateException - 가상 머신이 이미 셧다운 진행중인 경우

SecurityException - 시큐러티 매니저가 존재해, RuntimePermission ("shutdownHooks")를 거부했을 경우

도입된 버전 :

1.3

관련 항목:

removeShutdownHook(java.lang.Thread), halt(int), exit(int)

removeShutdownHook

public boolean removeShutdownHook(Thread  hook)

이미 등록한 가상 머신의 셧다운 훅을 등록 해제합니다.

파라미터:

hook - 삭제하는 훅

반환값:

지정한 훅이 이미 등록되어 문제 없게 등록 해제되었을 경우는 true, 그렇지 않은 경우는 false

예외:

IllegalStateException - 가상 머신이 이미 셧다운 진행중인 경우

SecurityException - 시큐러티 매니저가 존재해, RuntimePermission ("shutdownHooks")를 거부했을 경우

도입된 버전 :

1.3

관련 항목:

addShutdownHook(java.lang.Thread), exit(int)

halt

public void halt(int status)

현재 실행중의 Java 가상 머신을 강제 종료합니다. 이 메서드는 일반적으로 복귀하지 않습니다.

이 메서드의 사용에는 세심의 주의가 필요합니다. exit 메서드와는 달라, 이 메서드에서는 셧다운 훅을 시작하지 못하고, 종료시의 파이나라이즈가 유효한 경우는 불려가 지 않은 파이나라이자를 실행하지 않습니다. 이미 셧다운 순서가 개시되고 있는 경우는 이 메서드는 실행중의 셧다운 훅 또는 파이나라이자를 대기하지 않고 종료합니다.

파라미터:

status - 종료 스테이터스. 통례, 제로 이외의 스테이터스 코드는 이상종료(ABEND)를 나타낸다. exit (System.exit 와 동등) 메서드가 이미 불려가 고 있는 경우는 그 메서드에게 건네진 스테이터스 코드를 오버라이드(override) 한다

예외:

SecurityException - 시큐러티 매니저가 존재할 경우에 시큐러티 매니저의 checkExit 메서드가 지정된 스테이터스에서의 종료를 허가하지 않는 경우

도입된 버전 :

1.3

관련 항목:

exit(int), addShutdownHook(java.lang.Thread), removeShutdownHook(java.lang.Thread)

runFinalizersOnExit

@Deprecated 
public static void runFinalizersOnExit(boolean value)

추천하지 않습니다. 이 메서드는 본질적으로 안전하지는 않습니다. 다른 thread가 동시에 그러한 객체를 조작하고 있을 때, 생존중의 객체에 대해서 파이나라이자가 불려가 이것에 의해 에러 동작 또는 데드 록이 발생합니다.

종료시의 파이나라이즈를 유효 또는 무효로 합니다. 이것을 실행하는 것에의해 자동적으로 불려가 지 않은 파이나라이자를 가지는 모든 객체의 파이나라이자가 불려가 Java Runtime 종료전에 실행되게 됩니다. 디폴트에서는 종료시의 파이나라이즈는 무효가 되어 있습니다.

시큐러티 매니저가 존재하는 경우는 확실히 종료가 허가되도록, 최초로 인수를 0 으로서 checkExit 메서드가 호출됩니다. 이 결과, SecurityException가 발생되는 일이 있습니다.

파라미터:

value - 종료시의 파이나라이즈를 유효하게 하는 경우는 true, 무효로 하는 경우는 false

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkExit 메서드가 종료를 허가하지 않는 경우

도입된 버전 :

JDK1. 1

관련 항목:

exit(int), gc(), SecurityManager.checkExit(int)

exec

public Process  exec(String  command)
             throws IOException 

지정된 캐릭터 라인 커멘드를, 독립한 프로세스로 실행합니다.

이것은 간이 메서드입니다. 이 메서드를 exec(command) 형식에서 호출했을 경우, exec (command, null, null) 호출과 같은 결과를 얻을 수 있습니다.

파라미터:

command - 지정된 시스템 커멘드

반환값:

서브 프로세스를 관리하기 위한 새로운 Process 객체

예외:

SecurityException - 시큐러티 매니저가 존재해, checkExec 메서드가 서브 프로세스의 작성을 허가하지 않는 경우

IOException - 입출력 에러가 발생했을 경우

NullPointerException - command가 null인 경우

IllegalArgumentException - command가 비어있는 경우

관련 항목:

exec(String[], String[], File), ProcessBuilder

exec

public Process  exec(String  command,
                    String [] envp)
             throws IOException 

지정된 캐릭터 라인 커멘드를, 지정된 환경을 가지는 독립한 프로세스로 실행합니다.

이것은 간이 메서드입니다. 이 메서드를 exec(command, envp) 형식에서 호출했을 경우, exec (command, envp, null) 호출과 같은 결과를 얻을 수 있습니다.

파라미터:

command - 지정된 시스템 커멘드

envp - 캐릭터 라인의 배열. 배열의 각 요소는 name=value 라고 하는 형식에서 환경 변수 설정을 보관 유지한다. 또는 서브 프로세스가 현재의 프로세스의 환경을 상속하는 경우는 null

반환값:

서브 프로세스를 관리하기 위한 새로운 Process 객체

예외:

SecurityException - 시큐러티 매니저가 존재해, checkExec 메서드가 서브 프로세스의 작성을 허가하지 않는 경우

IOException - 입출력 에러가 발생했을 경우

NullPointerException - command가 null인 경우, 또는 envp 어떤 것인가의 요소가 null인 경우

IllegalArgumentException - command가 비어있는 경우

관련 항목:

exec(String[], String[], File), ProcessBuilder

exec

public Process  exec(String  command,
                    String [] envp,
                    File  dir)
             throws IOException 

지정된 캐릭터 라인 커멘드를, 지정된 환경과 작업 디렉토리를 가지는 독립한 프로세스로 실행합니다.

이것은 간이 메서드입니다. 이 메서드를 exec(command, envp, dir) 형식에서 호출했을 경우, exec (cmdarray, envp, dir) 호출과 같은 결과를 얻을 수 있습니다. 여기서, cmdarray는 command에 있는 모든 토큰의 배열입니다.

보다 정확하게는 command 캐릭터 라인은 문자 카테고리가 더 이상 변경되는 일 없이, new StringTokenizer (command) 호출로 작성된 StringTokenizer를 사용해 토큰에 분할됩니다. 토크나이자로 생성된 토큰은 같은 순서로 새로운 캐릭터 라인 배열의 cmdarray에 배치됩니다.

파라미터:

command - 지정된 시스템 커멘드

envp - 캐릭터 라인의 배열. 배열의 각 요소는 name=value 라고 하는 형식에서 환경 변수 설정을 보관 유지한다. 또는 서브 프로세스가 현재의 프로세스의 환경을 상속하는 경우는 null

dir - 서브 프로세스가 현재의 프로세스의 작업 디렉토리를 상속하는 경우는 서브 프로세스의 작업 디렉토리, 또는 null

반환값:

서브 프로세스를 관리하기 위한 새로운 Process 객체

예외:

SecurityException - 시큐러티 매니저가 존재해, checkExec 메서드가 서브 프로세스의 작성을 허가하지 않는 경우

IOException - 입출력 에러가 발생했을 경우

NullPointerException - command가 null인 경우, 또는 envp 어떤 것인가의 요소가 null인 경우

IllegalArgumentException - command가 비어있는 경우

도입된 버전 :

1.3

관련 항목:

ProcessBuilder

exec

public Process  exec(String [] cmdarray)
             throws IOException 

지정된 커멘드와 인수를, 독립한 프로세스로 실행합니다.

이것은 간이 메서드입니다. 이 메서드를 exec(cmdarray) 형식에서 호출했을 경우, exec (cmdarray, null, null) 호출과 같은 결과를 얻을 수 있습니다.

파라미터:

cmdarray - 실행하는 커멘드와 인수를 포함한 배열

반환값:

서브 프로세스를 관리하기 위한 새로운 Process 객체

예외:

SecurityException - 시큐러티 매니저가 존재해, checkExec 메서드가 서브 프로세스의 작성을 허가하지 않는 경우

IOException - 입출력 에러가 발생했을 경우

NullPointerException - cmdarray가 null인 경우, 또는 cmdarray 어떤 것인가의 요소가 null인 경우

IndexOutOfBoundsException - cmdarray가 길이가 0 비어있는 배열의 경우

관련 항목:

ProcessBuilder

exec

public Process  exec(String [] cmdarray,
                    String [] envp)
             throws IOException 

지정된 커멘드와 인수를, 지정된 환경을 가지는 독립한 프로세스로 실행합니다.

이것은 간이 메서드입니다. 이 메서드를 exec(cmdarray, envp) 형식에서 호출했을 경우, exec (cmdarray, envp, null) 호출과 같은 결과를 얻을 수 있습니다.

파라미터:

cmdarray - 실행하는 커멘드와 인수를 포함한 배열

envp - 캐릭터 라인의 배열. 배열의 각 요소는 name=value 라고 하는 형식에서 환경 변수 설정을 보관 유지한다. 또는 서브 프로세스가 현재의 프로세스의 환경을 상속하는 경우는 null

반환값:

서브 프로세스를 관리하기 위한 새로운 Process 객체

예외:

SecurityException - 시큐러티 매니저가 존재해, checkExec 메서드가 서브 프로세스의 작성을 허가하지 않는 경우

IOException - 입출력 에러가 발생했을 경우

NullPointerException - cmdarray가 null인 경우, 또는 cmdarray 요소의 어떤 것인가가 null인 경우, 혹은 envp 요소의 어떤 것인가가 null인 경우

IndexOutOfBoundsException - cmdarray가 길이가 0 비어있는 배열의 경우

관련 항목:

ProcessBuilder

exec

public Process  exec(String [] cmdarray,
                    String [] envp,
                    File  dir)
             throws IOException 

지정된 커멘드와 인수를, 지정된 환경과 작업 디렉토리를 가지는 독립한 프로세스로 실행합니다.

커멘드행의 토큰을 나타내는 캐릭터 라인의 배열 cmdarray 및 환경 변수의 설정을 나타내는 캐릭터 라인의 배열 envp를 지정하면, 이 메서드는 지정된 커멘드를 실행하기 위한 새로운 프로세스를 작성합니다.

이 메서드는 cmdarray가 유효한 OS 커멘드인 것을 확인합니다. 어느 커멘드가 유효한가는 시스템 존입니다만, 커멘드는 적어도 null 이외의 캐릭터 라인의 비어있지 않은 리스트가 아니면 안됩니다.

envp가 null인 경우, 서브 프로세스는 현재의 프로세스의 환경 설정을 상속합니다.

현재, ProcessBuilder.start() 는 변경된 환경을 가지는 프로세스를 시작하는 방법으로서 추천 되고 있습니다.

새로운 서브 프로세스의 작업 디렉토리는 dir로 지정합니다. dir가 null인 경우는 서브 프로세스는 현재의 프로세스의 현재의 작업 디렉토리를 상속합니다.

시큐러티 매니저가 존재하는 경우는 cmdarray 배열의 최초의 컴퍼넌트를 인수로서 사용해 checkExec 메서드가 호출됩니다. 이 결과, SecurityException이 발생되는 일이 있습니다.

OS 프로세스의 시작은 극히 시스템에 의존합니다. 발생할 가능성이 있는 불편은 다음과 같습니다.

• OS 프로그램 파일이 발견되지 않았다
• 프로그램 파일에의 접근 권한이 거부되었다
• 작업 디렉토리가 존재하지 않는다

이상의 케이스에서는 예외가 발생 됩니다. 예외의 정확한 특성은 시스템에 의존합니다만, 이것은 항상 IOException 서브 클래스가 됩니다.

파라미터:

cmdarray - 실행하는 커멘드와 인수를 포함한 배열

envp - 캐릭터 라인의 배열. 배열의 각 요소는 name=value 라고 하는 형식에서 환경 변수 설정을 보관 유지한다. 또는 서브 프로세스가 현재의 프로세스의 환경을 상속하는 경우는 null

dir - 서브 프로세스가 현재의 프로세스의 작업 디렉토리를 상속하는 경우는 서브 프로세스의 작업 디렉토리, 또는 null

반환값:

서브 프로세스를 관리하기 위한 새로운 Process 객체

예외:

SecurityException - 시큐러티 매니저가 존재해, checkExec 메서드가 서브 프로세스의 작성을 허가하지 않는 경우

IOException - 입출력 에러가 발생했을 경우

NullPointerException - cmdarray가 null인 경우, 또는 cmdarray 요소의 어떤 것인가가 null인 경우, 혹은 envp 요소의 어떤 것인가가 null인 경우

IndexOutOfBoundsException - cmdarray가 길이가 0 비어있는 배열의 경우

도입된 버전 :

1.3

관련 항목:

ProcessBuilder

availableProcessors

public int availableProcessors()

Java 가상 머신이 이용 가능한 프로세서의 수를 리턴합니다.

이 값은 가상 머신에의 특정의 호출중으로 변경될 가능성이 있습니다. 이 때문에 이용 가능한 프로세서수에 영향을 받는 어플리케이션은 이 프로퍼티를 가끔 폴링 해, 자원 사용법을 조정할 필요가 있습니다.

반환값:

가상 머신으로부터 이용 가능한 최대 프로세서수. 이 값이 1 보다 작아질 것은 없는

도입된 버전 :

1.4

freeMemory

public long freeMemory()

Java 가상 머신내의 빈메모리의 양을 리턴합니다. gc 메서드를 호출하면, freeMemory에 의해 리턴된 값이 증가하는 경우가 있습니다.

반환값:

장래 할당할 수 있는 객체에 이용 가능한 현재의 메모리의 총용량 (바이트 단위)

totalMemory

public long totalMemory()

Java 가상 머신의 메모리의 총용량을 리턴합니다. 호스트의 환경에 따라서는 이 메서드에 의해 리턴된 값이 시간과 함께 변화하는 경우가 있습니다.

임의의 지정된 형태의 객체를 포함하는데 필요한 메모리 용량은 구현에 따라서 다릅니다.

반환값:

현재 및 장래의 객체에 이용 가능한 현재의 메모리의 총용량 (바이트 단위)

maxMemory

public long maxMemory()

Java 가상 머신이 사용을 시도하는 최대 메모리 용량을 리턴합니다. 고유의 제한이 존재하지 않는 경우, 값 Long.MAX_VALUE 가 리턴됩니다 .

반환값:

가상 머신이 사용을 시도하는 최대 메모리 용량 (단위는 바이트)

도입된 버전 :

1.4

gc

public void gc()

가비지 컬렉터를 실행합니다. 이 메서드를 호출하면, Java 가상 머신은 사용하고 있지 않는 객체를 리사이클해, 사용중의 메모리를 재빠르게 재이용 가능한 상태로 합니다. 메서드 호출로부터 제어가 되돌려진 시점에서 가상 머신은 파기된 객체를 모두 재이용하도록 최선을 다한 것이 됩니다.

gc 라고 하는 메서드명은 「garbage collector」의 두자를 취한 것입니다. gc가 명시적으로는 불려가 지 않았던 경우에서도, 가상 머신은 이 재이용 프로세스를 필요에 따라서 자동적으로 다른 thread로 실행합니다.

이 메서드를 호출하려면, System.gc() 메서드가 일반적이고 편리합니다.

runFinalization

public void runFinalization()

파이나라이즈를 중단하고 있는 객체의 finalize 메서드를 실행합니다. 이 메서드를 호출하면, Java 가상 머신은 파기되었음에도 불구하고 finalize 메서드가 실행되어 있지 않은 객체의 finalize 메서드를 실행하려고 합니다. 메서드 호출로부터 제어가 되돌려진 시점에서 가상 머신은 모든 파이나라이즈를 완료하도록 최선을 다한 것이 됩니다.

runFinalization 메서드가 명시적으로는 불려가 지 않았던 경우에서도, 가상 머신은 이 파이나라이즈프로세스를 필요에 따라서 자동적으로 다른 thread로 실행합니다.

이 메서드를 호출하려면, System.runFinalization() 메서드가 일반적이고 편리합니다.

관련 항목:

Object.finalize()

traceInstructions

public void traceInstructions(boolean on)

명령의 트레이스를 유효 또는 무효로 합니다. boolean인수가 true인 경우, 이 메서드를 호출하면, Java 가상 머신은 가상 머신내의 각 명령의 디버그 정보를 실행시에 출력합니다. 이 정보의 서식이나, 출력처가 되는 파일등의 출력 스트림은 호스트 환경에 의해 다릅니다. 이 기능을 지원 하지 않는 경우, 가상 머신은 요구를 무시하는 경우가 있습니다. 트레이스의 출력처는 시스템에 따라서 다릅니다.

boolean인수에 false를 지정하면, 가상 머신은 명령의 상세 트레이스의 출력을 정지합니다.

파라미터:

on - 메서드의 트레이스를 실시하는 경우는 true, 이 기능을 무효로 하는 경우는 false

traceMethodCalls

public void traceMethodCalls(boolean on)

메서드 호출의 트레이스를 유효 또는 무효로 합니다. boolean인수가 true인 경우, 이 메서드를 호출하면, Java 가상 머신은 가상 머신내의 각 메서드의 디버그 정보를 그 메서드 호출의 시점에서 출력합니다. 이 정보의 서식이나, 출력처가 되는 파일등의 출력 스트림은 호스트 환경에 의해 다릅니다. 이 기능을 지원 하지 않는 경우, 가상 머신은 요구를 무시하는 경우가 있습니다.

인수를 false 로의해 이 메서드를 호출하면, 가상 머신은 호출할 것의 디버그 정보의 출력을 정지합니다.

파라미터:

on - 메서드의 트레이스를 실시하는 경우는 true, 이 기능을 무효로 하는 경우는 false

load

public void load(String  filename)

지정된 파일명을 다이나믹 라이브러리로서 로드합니다. filename 인수에는 절대 패스명을 지정합니다. java_g로 부터 이용하면, 「. so」의 전에 「_g」가 자동적으로 삽입됩니다 (Runtime.getRuntime(). load("/home/avh/lib/libX11.so"); 등).

우선, 시큐러티 매니저가 존재하는 경우, 그 checkLink 메서드를 호출합니다. 인수에는 filename를 지정합니다. 이 결과, 시큐러티 예외가 발생되는 경우가 있습니다.

이것은 loadLibrary(String) 메서드와 닮아 있습니다만, 라이브러리명은 아니고 일반적인 파일명을 인수로서 지정할 수 있기 때문에 native code로 쓰여진 임의의 파일이 로드 가능하게 됩니다.

이 메서드를 호출하려면, System.load(String) 메서드가 일반적이고 편리합니다.

파라미터:

filename - 로드하는 파일

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkLink 메서드가 지정된 다이나믹 라이브러리의 로드를 허가하지 않는 경우

UnsatisfiedLinkError - 파일이 존재하지 않는 경우

NullPointerException - filename가 null인 경우

관련 항목:

getRuntime(), SecurityException, SecurityManager.checkLink(java.lang.String)

loadLibrary

public void loadLibrary(String  libname)

지정된 라이브러리명을 가지는 다이나믹 라이브러리를 로드합니다. native code가 쓰여져 있는 파일은 로컬 파일 시스템의, 라이브러리 파일을 보통 의 방법으로 취득할 수 있는 장소에서 로드 됩니다. 이 프로세스의자세한 내용은 구현에 따라서 다릅니다. 라이브러리명을 특정의 파일명에 대응 붙이는 처리는 시스템 특유의 방법으로 행해집니다.

우선, 시큐러티 매니저가 존재하는 경우, 그 checkLink 메서드를 호출합니다. 인수에는 libname를 지정합니다. 이 결과, 시큐러티 예외가 발생되는 경우가 있습니다.

이 메서드를 호출하려면, System.loadLibrary(String) 메서드가 일반적이고 편리합니다. 네이티브 메서드를 클래스의 구현으로 사용하는 경우, 표준적으로는 native code를 라이브러리 파일 (여기에서는 설명상 LibFile로 한다)에 넣고 나서, 클래스 선언에 다음의 static 초기화자를 넣습니다.

 static { System.loadLibrary("LibFile");
 }

이렇게 하면, 클래스가 로드 및 초기화될 때, 네이티브 메서드에 필요한 native code의 구현도 똑같이 로드 됩니다.

같은 라이브러리명을 지정해 이 메서드를 여러 차례 호출해도, 2번째 이후의 호출은 무시됩니다.

파라미터:

libname - 라이브러리의 이름

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkLink 메서드가 지정된 다이나믹 라이브러리의 로드를 허가하지 않는 경우

UnsatisfiedLinkError - 라이브러리가 존재하지 않는 경우

NullPointerException - libname가 null인 경우

관련 항목:

SecurityException, SecurityManager.checkLink(java.lang.String)

getLocalizedInputStream

@Deprecated 
public InputStream  getLocalizedInputStream(InputStream  in)

추천하지 않습니다. JDK 1. 1 에서는 로컬인 인코딩의 바이트 스트림을 Unicode 문자 스트림로 변환하려면, InputStreamReader 클래스와 BufferedReader 클래스를 사용하는 (분)편이 적절합니다.

지역 대응된 입력 스트림을 작성합니다. 이 메서드는 InputStream를 받아, 지역 대응되고 있는 이외는 인수의 스트림과 완전히 같은 InputStream를 리턴합니다. 로컬 캐릭터셋의 문자를 스트림로부터 읽어들이려면, 로컬 캐릭터셋로부터 Unicode에 자동적으로 변환합니다.

인수로 지정한 스트림이 지역 대응이 끝난 상태인 경우는 그대로 결과적으로 리턴됩니다 .

파라미터:

in - 지역 대응하는 InputStream

반환값:

지역 대응된 입력 스트림

관련 항목:

InputStream, BufferedReader.BufferedReader(java.io.Reader), InputStreamReader.InputStreamReader(java.io.InputStream)

getLocalizedOutputStream

@Deprecated 
public OutputStream  getLocalizedOutputStream(OutputStream  out)

추천하지 않습니다. JDK 1. 1 에서는 Unicode 문자 스트림을 로컬인 인코딩의 바이트 스트림로 변환하려면, OutputStreamWriter 클래스, BufferedWriter 클래스 및 PrintWriter 클래스를 사용하는 (분)편이 적절합니다.

지역 대응된 출력 스트림을 작성합니다. 이 메서드는 OutputStream를 받아, 지역 대응되고 있는 이외는 인수의 스트림과 완전히 같은 OutputStream를 리턴합니다. Unicode를 스트림에 출력하려면, Unicode 로부터 로컬 캐릭터셋에 자동적으로 변환합니다.

인수로 지정한 스트림이 지역 대응이 끝난 상태인 경우는 그대로 결과적으로 리턴됩니다 .

파라미터:

out - 지역 대응하는 OutputStream

반환값:

지역 대응된 출력 스트림

관련 항목:

OutputStream, BufferedWriter.BufferedWriter(java.io.Writer), OutputStreamWriter.OutputStreamWriter(java.io.OutputStream), PrintWriter.PrintWriter(java.io.OutputStream)