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 cmd, 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 를 호출하면(자), 가상 머신은 즉시 슛다운 해 종료하는 것이라고 보여집니다. 가상 머신이 유저 로그 오프 또는 시스템 슛다운으로 종료하면(자), 기본이 되는 operating system는 슛다운 또는 종료할 때까지의 일정시간을 줍니다. 따라서, 슛다운 훅중에 유저와의 대화 처리를 하거나 장시간의 계산을 하는 것은 추천할 수 없습니다.

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

보기 드문 케이스로서 가상 머신이 「이상종료(ABEND)」하는 일이 있습니다. 즉, 슛다운이 정상적으로 행해지지 않고 실행이 중지되는 경우입니다. 이것은 가상 머신이 외부에서 정지되었을 경우에 일어납니다. 예를 들어, Unix 의 경우의 SIGKILL 시그널 또는 Win32 의 경우의 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

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 

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

command 인수는 토큰에 구문 분석 되어 그 후 독립한 프로세스로서 실행됩니다. 토큰의 구문 분석은 다음의 호출로 작성되는 StringTokenizer 가 실행합니다.

 new StringTokenizer(command)
 

이 때, 캐릭터 카테고리가 더 이상 변경될 것은 없습니다. 이 메소드의 기능은 exec(command, null) 와 완전히 같습니다.

파라미터:

command - 지정된 시스템 커멘드

반환값:

서브 프로세스를 관리하는 Process 오브젝트

예외:

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

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

관련 항목:

exec(java.lang.String, java.lang.String[]) , SecurityManager.checkExec(java.lang.String)

exec

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

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

이 메소드는 command 의 캐릭터 라인을 토큰 으로 분해하고 나서, 토큰을 캐릭터 라인 토크나이자로 생성된 차례로 저장하는 새로운 배열 cmdarray 를 작성합니다. 그 다음에 메소드는 exec(cmdarray, envp) 라고 하는 호출을 실행합니다. 토큰의 구문 분석은 다음의 호출로 작성되는 StringTokenizer 가 실행합니다.

 new StringTokenizer(command)
 

이 때, 캐릭터 카테고리가 더 이상 변경될 것은 없습니다.

환경 변수 설정은 envp 로 지정합니다. envp 가 null 의 경우는 서브 프로세스는 현재의 프로세스의 환경 설정을 계승합니다.

파라미터:

cmd - 지정된 시스템 커멘드

envp - 캐릭터 라인의 배열. 배열의 각 요소는 name=value 라고 하는 형식에서 환경 변수 설정을 보관 유지한다

반환값:

서브 프로세스를 관리하는 Process 오브젝트

예외:

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

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

관련 항목:

exec(java.lang.String[]) , exec(java.lang.String[], java.lang.String[]) , SecurityManager.checkExec(java.lang.String)

exec

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

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

이 메소드는 command 의 캐릭터 라인을 토큰 으로 분해하고 나서, 토큰을 캐릭터 라인 토크나이자로 생성된 차례로 저장하는 새로운 배열 cmdarray 를 작성합니다. 그 다음에 메소드는 exec(cmdarray, envp) 라고 하는 호출을 실행합니다. 토큰의 구문 분석은 다음의 호출로 작성되는 StringTokenizer 가 실행합니다.

 new StringTokenizer(command)
 

이 때, 캐릭터 카테고리가 더 이상 변경될 것은 없습니다.

환경 변수 설정은 envp 로 지정합니다. envp 가 null 의 경우는 서브 프로세스는 현재의 프로세스의 환경 설정을 계승합니다.

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

파라미터:

command - 지정된 시스템 커멘드

envp - 캐릭터 라인의 배열. 배열의 각 요소는 name=value 라고 하는 형식에서 환경 변수 설정을 보관 유지하는

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

반환값:

서브 프로세스를 관리하는 Process 오브젝트

예외:

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

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

도입된 버젼:

1.3

관련 항목:

exec(java.lang.String[], java.lang.String[], File) , SecurityManager.checkExec(java.lang.String)

exec

public Process  exec(String [] cmdarray)
             throws IOException 

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

cmdarray 인수로 지정한 커멘드 토큰은 독립한 프로세스로 커멘드로서 실행됩니다. 이 메소드의 기능은 exec(cmdarray, null) 와 완전히 같습니다.

시큐러티 매니저가 존재하는 경우, 그 checkExec 메소드가, 배열 cmdarray 의 1 번째의 요소를 인수로서 불려 갑니다. 이 결과, 시큐러티 예외가 발생할 가능성이 있습니다.

파라미터:

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

반환값:

서브 프로세스를 관리하는 Process 오브젝트

예외:

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

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

관련 항목:

exec(java.lang.String[], java.lang.String[]) , SecurityManager.checkExec(java.lang.String)

exec

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

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

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

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

파라미터:

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

envp - 캐릭터 라인의 배열. 배열의 각 요소는 name=value 라고 하는 형식에서 환경 변수 설정을 보관 유지한다

반환값:

서브 프로세스를 관리하는 Process 오브젝트

예외:

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

NullPointerException - cmdarray 가 null 의 경우

IndexOutOfBoundsException - cmdarray 가 길이가 0 의 하늘의 배열의 경우

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

관련 항목:

Process , SecurityException , SecurityManager.checkExec(java.lang.String)

exec

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

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

시큐러티 매니저가 존재하는 경우, 그 checkExec 메소드가, 배열 cmdarray 의 1 번째의 요소를 인수로서 불려 갑니다. 이 결과, 시큐러티 예외가 발생할 가능성이 있습니다.

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

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

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

파라미터:

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

envp - 캐릭터 라인의 배열. 배열의 각 요소는 name=value 라고 하는 형식에서 환경 변수 설정을 보관 유지하는

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

반환값:

서브 프로세스를 관리하는 Process 오브젝트

예외:

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

NullPointerException - cmdarray 가 null 의 경우

IndexOutOfBoundsException - cmdarray 가 길이가 0 의 하늘의 배열의 경우

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

도입된 버젼:

1.3

관련 항목:

Process , SecurityException , SecurityManager.checkExec(java.lang.String)

availableProcessors

public int availableProcessors()

Java 가상 머신이 이용 가능한 프로세서의 수를 돌려줍니다.

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

반환값:

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

freeMemory

public long freeMemory()

Java 가상 머신내의 빈메모리의 양을 돌려줍니다. gc 메소드를 호출하면(자),freeMemory 에 의해 돌려주어지는 값이 증가하는 경우가 있습니다.

반환값:

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

totalMemory

public long totalMemory()

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

임의의 지정된 형태의 오브젝트를 저장하는데 필요한 메모리 용량은 구현에 따라서 다릅니다.

반환값:

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

maxMemory

public long maxMemory()

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

반환값:

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

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 - 파일이 존재하지 않는 경우

관련 항목:

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 - 프로그램 라이브러리가 존재하지 않는 경우

관련 항목:

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

getLocalizedInputStream

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

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)