java.lang
클래스 System

java.lang.Object 
  java.lang.System

public final class System
extends Object 

System 클래스에는 유용한 클래스 필드 및 메서드가 있습니다. 인스턴스화할 수 없습니다.

System 클래스에 의해 얻을 수 있는 기능에는 표준 입력, 표준 출력 및 에러 출력 스트림, 외부적으로 정의된 프로퍼티 및 환경 변수에의 액세스, 파일 및 라이브러리의 로딩 방법, 배열의 일부를 재빠르게 카피하는 유틸리티 메서드가 있습니다.

도입된 버전 :

JDK1. 0

필드 개요

static PrintStream	err 「표준」에러 출력 스트림입니다.
static InputStream	in 「표준」입력 스트림입니다.
static PrintStream	out 「표준」출력 스트림입니다.

메서드 개요

static void	arraycopy (Object src, int srcPos, Object dest, int destPos, int length) 지정 위치에서 개시하는 지정 소스 배열로부터, 전송처 배열의 지정 위치에 배열을 카피합니다.
static String	clearProperty (String key) 지정된 키에 의해 나타난 시스템 프로퍼티를 삭제합니다.
static long	currentTimeMillis () 현재의 시간을 밀리 세컨드로 리턴합니다.
static void	exit (int status) 현재 실행하고 있는 Java 가상 머신을 종료합니다.
static void	gc () 가비지 컬렉터를 실행합니다.
static Map <String, String >	getenv () 현재의 시스템 환경의 변경할 수 없는 캐릭터 라인 맵의 뷰를 리턴합니다.
static String	getenv (String name) 지정된 환경 변수의 값을 취득합니다.
static Properties	getProperties () 현재의 시스템 프로퍼티를 결정합니다.
static String	getProperty (String key) 지정된 키에 의해 나타나는 시스템 프로퍼티를 취득합니다.
static String	getProperty (String key, String def) 지정된 키에 의해 나타나는 시스템 프로퍼티를 취득합니다.
static SecurityManager	getSecurityManager () system security 인터페이스를 취득합니다.
static int	identityHashCode (Object x) 지정된 객체의 클래스가 hashCode()를 오버라이드(override) 하고 있을지 어떨지에 관계없이, 디폴트의 hashCode() 메서드에 의해 리턴된 것과 같은 지정된 객체의 해시 코드를 리턴합니다.
static Channel	inheritedChannel () Java 가상 머신을 작성한 엔티티로부터 상속된 채널을 리턴합니다.
static void	load (String filename) 지정된 파일명을 가지는 코드 파일을 다이나믹 라이브러리로서 로컬 파일 시스템으로부터 로드합니다.
static void	loadLibrary (String libname) 인수 libname에 의해 지정되는 시스템 라이브러리를 로드합니다.
static String	mapLibraryName (String libname) 라이브러리명을 네이티브 라이브러리를 나타내는 플랫폼 존의 캐릭터 라인에 매핑 합니다.
static long	nanoTime () 이용 가능해도와 도 정확한 시스템 타이머-의 현재의 값을 나노초단위로 리턴합니다.
static void	runFinalization () 파이나라이즈를 보류하고 있는 객체의 파이나라이즈메서드를 실행합니다.
static void	runFinalizersOnExit (boolean value) 추천하지 않습니다. 이 메서드는 본질적으로 안전하지는 않습니다. 다른 thread가 동시에 그러한 객체를 조작하고 있을 때, 생존중의 객체에 대해서 파이나라이자가 불려가 이것에 의해 에러 동작 또는 데드 록이 발생합니다.
static void	setErr (PrintStream err) 「표준」에러 출력 스트림을 다시 할당 합니다.
static void	setIn (InputStream in) 「표준」입력 스트림을 다시 할당 합니다.
static void	setOut (PrintStream out) 「표준」출력 스트림을 다시 할당 합니다.
static void	setProperties (Properties props) 시스템 프로퍼티를 인수 Properties로 설정합니다.
static String	setProperty (String key, String value) 지정된 키에 의해 나타나는 시스템 프로퍼티를 설정합니다.
static void	setSecurityManager (SecurityManager s) system security를 설정합니다.

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

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

필드의 상세

in

public static final InputStream  in

「표준」입력 스트림입니다. 이 스트림은 이미 열려 있어, 입력 데이터의 공급이 가능합니다. 보통, 이 스트림은 키보드 입력, 또는 호스트 환경이나 사용자에 의해 지정되는 그 외의 입력 소스와 일치하고 있습니다.

out

public static final PrintStream  out

「표준」출력 스트림입니다. 이 스트림은 이미 열려 있어, 출력 데이터의 수취가 가능합니다. 보통, 이 스트림은 디스플레이 출력, 또는 호스트 환경이나 사용자에 의해 지정되는 그 외의 출력처와 일치하고 있습니다.

단순한 스탠드얼론의 Java 어플리케이션에 대해, 출력 데이터의 행을 출력하는 일반적인 방법은 이하대로입니다.

 System.out.println(data) 

PrintStream 클래스의 println 메서드를 참조하십시오.

관련 항목:

PrintStream.println(), PrintStream.println(boolean), PrintStream.println(char), PrintStream.println(char[]), PrintStream.println(double), PrintStream.println(float), PrintStream.println(int), PrintStream.println(long), PrintStream.println(java.lang.Object), PrintStream.println(java.lang.String)

err

public static final PrintStream  err

「표준」에러 출력 스트림입니다. 이 스트림은 이미 열려 있어, 출력 데이터의 수취가 가능합니다.

보통, 이 스트림은 디스플레이 출력, 또는 호스트 환경이나 사용자에 의해 지정되는 출력처의 출력과 일치합니다. 주된 출력 스트림인 변수 out값이 일반적으로 계속적으로는 감시되어 있지 않은 파일 또는 그 외의 전송 먼저 리다이렉트 하고 있는 경우에서도, 사용자에 게 주의를 재촉하기 위한 에러 메세지 또는 그 외의 정보를 표시하기 위해서 통례 이 출력 스트림이 사용됩니다.

메서드의 상세

setIn

public static void setIn(InputStream  in)

「표준」입력 스트림을 다시 할당 합니다.

시큐러티 매니저가 존재하는 경우는 표준 입력 스트림을 다시 할당 해도 좋은지 어떤지를 확인하기 위해서 RuntimePermission("setIO") 접근 권한을 사용해 checkPermission 메서드가 호출됩니다.

파라미터:

in - 새로운 표준 입력 스트림

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPermission 메서드가 표준 입력 스트림의 재할인 맞히고를 허가하지 않는 경우

도입된 버전 :

JDK1. 1

관련 항목:

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

setOut

public static void setOut(PrintStream  out)

「표준」출력 스트림을 다시 할당 합니다.

시큐러티 매니저가 존재하는 경우는 표준 출력 스트림을 다시 할당 해도 좋은지 어떤지를 확인하기 위해서 RuntimePermission("setIO") 접근 권한을 사용해 checkPermission 메서드가 호출됩니다.

파라미터:

out - 새로운 표준 출력 스트림

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPermission 메서드가 표준 출력 스트림의 재할인 맞히고를 허가하지 않는 경우

도입된 버전 :

JDK1. 1

관련 항목:

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

setErr

public static void setErr(PrintStream  err)

「표준」에러 출력 스트림을 다시 할당 합니다.

시큐러티 매니저가 존재하는 경우는 표준 에러 출력 스트림을 다시 할당 해도 좋은지 어떤지를 확인하기 위해서 RuntimePermission("setIO") 접근 권한을 사용해 checkPermission 메서드가 호출됩니다.

파라미터:

err - 새로운 표준 에러 출력 스트림

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPermission 메서드가 표준 에러 출력 스트림의 재할인 맞히고를 허가하지 않는 경우

도입된 버전 :

JDK1. 1

관련 항목:

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

inheritedChannel

public static Channel  inheritedChannel()
                                throws IOException 

Java 가상 머신을 작성한 엔티티로부터 상속된 채널을 리턴합니다.

이 메서드는 시스템 전체의 디폴트 SelectorProvider 객체의 inheritedChannel 메서드를 호출하는 것에 의해 취득한 채널을 리턴합니다.

이 메서드는 inheritedChannel 로 정의되고 있는 네트워크 지향의 채널에 가세해, 장래 다른 종류의 채널을 돌려줄 가능성이 있습니다.

반환값:

상속된 채널 (존재하는 경우). 그렇지 않은 경우는 null

예외:

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

SecurityException - 시큐러티 매니저가 인스톨 되고 있어, 채널에의 액세스가 허가되어 있지 않은 경우

도입된 버전 :

1.5

setSecurityManager

public static void setSecurityManager(SecurityManager  s)

system security를 설정합니다.

시큐러티 매니저가 이미 인스톨 되고 있는 경우, 이 메서드는 최초로 RuntimePermission("setSecurityManager") 접근 권한을 사용해 시큐러티 매니저의 checkPermission 메서드를 호출하는 것으로 기존의 시큐러티 매니저를 치환해도 괜찮은지 어떤지를 확인합니다. 이 결과, SecurityException가 발생되는 일이 있습니다.

그렇지 않은 경우는 인수를 현재의 시큐러티 매니저로 설정합니다. 인수가 null 이며, 시큐러티 매니저가 설정되어 있지 않은 경우, 메서드는 아무것도 실시하지 않고 복귀합니다.

파라미터:

s - 시큐러티 매니저

예외:

SecurityException - 시큐러티 매니저가 이미 설정되어 있어 시큐러티 매니저의 checkPermission 메서드가 시큐러티 매니저의 치환을 허가하지 않는 경우

관련 항목:

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

getSecurityManager

public static SecurityManager  getSecurityManager()

system security 인터페이스를 취득합니다.

반환값:

시큐러티 매니저가 이미 현재의 어플리케이션으로 설정되어 있는 경우는 시큐러티 매니저. 그렇지 않은 경우는 null

관련 항목:

setSecurityManager(java.lang.SecurityManager)

currentTimeMillis

public static long currentTimeMillis()

현재의 시간을 밀리 세컨드로 리턴합니다. 반환값의 시간 단위는 밀리 세컨드입니다만, 값의 입도는 기본이 되는 OS에 따라서 달라, 단위가 보다 커지는 경우가 있습니다. 예를 들어 많은 OS에 서는 시간을 10 밀리 세컨드의 단위로 파악 합니다.

「컴퓨터 시간」이라고 협정 세계시 (UTC)와의 사이에 발생하는 미묘한 상위에 대해서는 클래스 Date 설명을 참조하십시오.

반환값:

밀리 세컨드로 측정한, 현재 시각과 협정 세계시의 UTC 1970 년 1 월 1 일 오전 0 시와의 차이

관련 항목:

Date

nanoTime

public static long nanoTime()

이용 가능해도와 도 정확한 시스템 타이머-의 현재의 값을 나노초단위로 리턴합니다.

이 메서드는 경과시간을 측정하기 위해인 만큼 사용할 수 있습니다. 시스템외의 개념이나 벽시계의 시각에 관련하고 있습니다. 리턴된 값은 있는 정해진 임의의 시각 (장래의 시간, 잘못된 값 도 있을 수 있다)부터의 나노초단위의 시간을 나타냅니다. 이 메서드는 나노초단위의 정밀도를 제공합니다만, 반드시 나노초의 정확도가 아닙니다. 어느 정도값이 변화할까는 보증되지 않습니다. 약 292 년 (2⁶³ 나노초 )을 넘는 연속한 호출의 차이에서는 수치의 오버플로우에 의해 경과시간이 올바르게 계산되지 않습니다.

예를 들어 일부의 코드로 실행에 걸리는 시간을 측정하려면, 다음과 같이 됩니다.

   long startTime = System.nanoTime();
   // ... the code being measured ...
   long estimatedTime = System.nanoTime() - startTime;
 

반환값:

시스템 타이머-의 현재의 값 (나노초단위)

도입된 버전 :

1.5

arraycopy

public static void arraycopy(Object  src,
                             int srcPos,
                             Object  dest,
                             int destPos,
                             int length)

지정 위치에서 개시하는 지정 소스 배열로부터, 전송처 배열의 지정 위치에 배열을 카피합니다. 배열 요소의 서브 순서를, src에 의해 참조되는 소스 배열로부터 dest에 의해 참조되는 전송처 배열에 카피합니다. 카피되는 요소의 수는 인수 length와 일치합니다. 소스 배열의 srcPos로 부터 srcPos+length-1 까지의 위치에 있는 요소를, 전송처의 배열의 destPos로 부터 destPos+length-1 까지의 위치에 각각 카피합니다.

인수 src 및 dest이 같은 배열 객체인 경우, 우선 srcPos로 부터 srcPos+length-1 까지의 위치에 있는 요소를 일시 배열 length 요소에 복사해, 다음에 일시 배열의 내용을 전송처 배열의 destPos로 부터 destPos+length-1에 카피합니다.

dest이 null인 경우는 NullPointerException가 발생 됩니다.

src가 null인 경우는 NullPointerException가 Throw 되어 전송처 배열은 변경되지 않습니다.

아래의 어떤 것인가에 들어맞는 경우는 ArrayStoreException을 Throw 해, 전송처를 수정하지 않습니다.

• 인수 src가 배열이 아닌 객체이다
• 인수 dest이 배열이 아닌 객체이다
• 인수 src 및 인수 dest이 요소의 종류가 다른 원시형의 배열이다
• 인수 src가 원시적인 요소형을 가지는 배열이며, 인수 dest이 참조 요소형을 가지는 배열이다
• 인수 src가 참조 요소형을 가지는 배열이며, 인수 dest이 원시적인 요소형을 가지는 배열이다

그렇지 않은 경우, 아래의 어떤 것인가에 들어맞으면, IndexOutOfBoundsException을 Throw 해, 전송처를 수정하지 않습니다.

• 인수 srcPos가 잘못된 값이다
• 인수 destPos가 잘못된 값이다
• 인수 length가 잘못된 값이다
• srcPos+length가 소스 배열의 길이 src.length 보다 크다
• destPos+length가 전송처 배열의 길이 dest.length 보다 크다

그렇지 않은 경우, srcPos로 부터 srcPos+length-1 까지의 위치에 있는 소스 배열의 실제의 요소가 대입 변환에 의해 전송처 배열의 요소형으로 변환할 수 없을 때는 ArrayStoreException을 Throw 합니다. 이 경우 k를 길이보다 작고, 부의 수가 아닌 최소 정수형으로 해, src[srcPos+k]를 전송처 배열의 요소형으로 변환할 수 없게 합니다. 예외를 Throw 하는 경우, srcPos로 부터 srcPos+k-1에 위치하는 소스 배열의 요소는 이미 destPos로 부터 destPos+k-1에 위치하는 전송처 배열에 카피되고 있습니다. 또, 전송처 배열의 그 외의 위치는 수정되지 않습니다. 전술의 제약을 위해, 상기의 기술은 실제로는 양쪽 모두의 배열이 참조형의 요소형을 가지는 상황으로만 유효합니다.

파라미터:

src - 소스 배열

srcPos - 소스 배열의 개시 위치

dest - 전송처 배열

destPos - 전송처 데이터내의 개시 위치

length - 카피되는 배열 요소의 수

예외:

IndexOutOfBoundsException - 카피에 의해 배열의 경계를 넘은 데이터의 액세스가 생겼을 경우

ArrayStoreException - 형의 불일치에의해 배열 src 요소가 배열 dest에 보존할 수 없었던 경우

NullPointerException - src 또는 dest이 null인 경우

identityHashCode

public static int identityHashCode(Object  x)

지정된 객체의 클래스가 hashCode()를 오버라이드(override) 하고 있을지 어떨지에 관계없이, 디폴트의 hashCode() 메서드에 의해 리턴된 것과 같은 지정된 객체의 해시 코드를 리턴합니다. 참조 null 해시 코드는 제로입니다.

파라미터:

x - 해시 코드가 계산되는 객체

반환값:

해시 코드

도입된 버전 :

JDK1. 1

getProperties

public static Properties  getProperties()

현재의 시스템 프로퍼티를 결정합니다.

우선, 시큐러티 매니저가 존재하는 경우는 인수없이 메서드 checkPropertiesAccess를 호출합니다. 이것은 시큐러티 예외가 되는 경우가 있습니다.

getProperty(String) 메서드에의해 현재 사용하고 있는 시스템 프로퍼티세트가 Properties 객체로서 리턴됩니다 . 현재의 시스템 프로퍼티세트가 없는 경우는 시스템 프로퍼티세트를 작성한 후에 초기화합니다. 이 시스템 프로퍼티세트에는 반드시 아래의 키에 대응하는 값이 포함됩니다.

키	대응하는 값의 설명
java.version	Java Runtime Environment 버전
java.vendor	Java Runtime Environment 벤더
java.vendor.url	Java 벤더의 URL
java.home	Java 인스톨처 디렉토리
java.vm.specification.version	Java 가상 머신의 사양 버전
java.vm.specification.vendor	Java 가상 머신의 사양 벤더
java.vm.specification.name	Java 가상 머신의 사양명
java.vm.version	Java 가상 머신의 구현 버전
java.vm.vendor	Java 가상 머신의 구현 벤더
java.vm.name	Java 가상 머신의 구현명
java.specification.version	Java Runtime Environment 사양 버전
java.specification.vendor	Java Runtime Environment 사양의 벤더
java.specification.name	Java Runtime Environment 사양명
java.class.version	Java 클래스의 형식의 버전 번호
java.class.path	Java 클래스 패스
java.library.path	라이브러리의 로드시에 검색하는 패스의 리스트
java.io.tmpdir	디폴트 임시 파일의 패스
java.compiler	사용하는 JIT 컴파일러의 이름
java.ext.dirs	확장 디렉토리의 패스
os.name	OS 명
os.arch	OS 의 아키텍쳐
os.version	OS 의 버전
file.separator	파일 단락 문자 (UNIX 에서는 「/」)
path.separator	패스 단락 문자 (UNIX 에서는 「:」)
line.separator	행 단락 문자 (UNIX 에서는 「\n」)
user.name	사용자 의 어카운트명
user.home	사용자 의 홈 디렉토리
user.dir	사용자 의 현재의 작업 디렉토리

시스템 프로퍼티치내의 복수의 패스는 플랫폼 고유의 패스 단락 문자로 단락지어집니다.

시큐러티 매니저는 getProperties 오퍼레이션을 허가하지 않는 경우에서도, getProperty(String) 오퍼레이션을 허가하는 경우가 있습니다.

반환값:

시스템 프로퍼티

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPropertiesAccess 메서드가 시스템 프로퍼티에의 액세스를 허가하지 않는 경우

관련 항목:

setProperties(java.util.Properties), SecurityException, SecurityManager.checkPropertiesAccess(), Properties

setProperties

public static void setProperties(Properties  props)

시스템 프로퍼티를 인수 Properties로 설정합니다.

우선, 시큐러티 매니저가 존재하는 경우는 인수없이 메서드 checkPropertiesAccess를 호출합니다. 이것은 시큐러티 예외가 되는 경우가 있습니다.

인수는 메서드 getProperty(String) 에의해 사용하는 시스템 프로퍼티의 현재세트가 됩니다. 인수가 null인 경우, 시스템 프로퍼티의 현재세트는 그대로입니다.

파라미터:

props - 새로운 시스템 프로퍼티

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPropertiesAccess 메서드가 시스템 프로퍼티에의 액세스를 허가하지 않는 경우

관련 항목:

getProperties(), Properties, SecurityException, SecurityManager.checkPropertiesAccess()

getProperty

public static String  getProperty(String  key)

지정된 키에 의해 나타나는 시스템 프로퍼티를 취득합니다.

시큐러티 매니저가 존재하는 경우는 키를 인수로서 건네주어 checkPropertyAccess 메서드를 호출합니다. 그 결과, SecurityException가 발생되는 일이 있습니다.

시스템 프로퍼티의 현재세트가 없는 경우, 시스템 프로퍼티세트를 우선 작성해, getProperties 메서드와 같은 방법으로 초기화합니다.

파라미터:

key - 시스템 프로퍼티의 이름

반환값:

시스템 프로퍼티의 캐릭터 라인치. 그 키에 프로퍼티가 없는 경우는 null

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPropertiesAccess 메서드가 지정된 시스템 프로퍼티에의 액세스를 허가하지 않는 경우

NullPointerException - key가 null인 경우

IllegalArgumentException - key가 비어있는 경우

관련 항목:

setProperty(java.lang.String, java.lang.String), SecurityException, SecurityManager.checkPropertyAccess(java.lang.String), getProperties()

getProperty

public static String  getProperty(String  key,
                                 String  def)

지정된 키에 의해 나타나는 시스템 프로퍼티를 취득합니다.

시큐러티 매니저가 존재하는 경우는 key를 인수로서 건네주어 checkPropertyAccess 메서드를 호출합니다.

시스템 프로퍼티의 현재세트가 없는 경우, 시스템 프로퍼티세트를 우선 작성해, getProperties 메서드와 같은 방법으로 초기화합니다.

파라미터:

key - 시스템 프로퍼티의 이름

def - 기본값

반환값:

시스템 프로퍼티의 캐릭터 라인치. 그 키에 프로퍼티가 없는 경우는 기본값

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPropertiesAccess 메서드가 지정된 시스템 프로퍼티에의 액세스를 허가하지 않는 경우

NullPointerException - key가 null인 경우

IllegalArgumentException - key가 비어있는 경우

관련 항목:

setProperty(java.lang.String, java.lang.String), SecurityManager.checkPropertyAccess(java.lang.String), getProperties()

setProperty

public static String  setProperty(String  key,
                                 String  value)

지정된 키에 의해 나타나는 시스템 프로퍼티를 설정합니다.

시큐러티 매니저가 존재하는 경우는 PropertyPermission(key, "write") 접근 권한을 사용해 SecurityManager.checkPermission 메서드가 호출됩니다. 이 결과, SecurityException가 발생되는 일이 있습니다. 예외가 Throw 되지 않았던 경우는 지정된 프로퍼티가 지정된 값으로 설정됩니다.

파라미터:

key - 시스템 프로퍼티의 이름

value - 시스템 프로퍼티의 값

반환값:

시스템 프로퍼티의 이전의 값. 없는 경우는 null

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPermission 메서드가 지정된 프로퍼티의 설정을 허가하지 않는 경우

NullPointerException - key 또는 value가 null인 경우

IllegalArgumentException - key가 비어있는 경우

도입된 버전 :

1.2

관련 항목:

getProperty(java.lang.String), getProperty(java.lang.String), getProperty(java.lang.String, java.lang.String), PropertyPermission, SecurityManager.checkPermission(java.security.Permission)

clearProperty

public static String  clearProperty(String  key)

지정된 키에 의해 나타난 시스템 프로퍼티를 삭제합니다.

시큐러티 매니저가 존재하는 경우는 PropertyPermission(key, "write") 접근 권한을 사용해 SecurityManager.checkPermission 메서드가 호출됩니다. 이 결과, SecurityException가 발생되는 일이 있습니다. 예외가 Throw 되지 않았던 경우는 지정된 프로퍼티는 삭제됩니다.

파라미터:

key - 삭제되는 시스템 프로퍼티의 이름

반환값:

시스템 프로퍼티의 이전의 캐릭터 라인치. 그 키에 프로퍼티가 없었던 경우는 null

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPropertiesAccess 메서드가 지정된 시스템 프로퍼티에의 액세스를 허가하지 않는 경우

NullPointerException - key가 null인 경우

IllegalArgumentException - key가 비어있는 경우

도입된 버전 :

1.5

관련 항목:

getProperty(java.lang.String), setProperty(java.lang.String, java.lang.String), Properties, SecurityException, SecurityManager.checkPropertiesAccess()

getenv

public static String  getenv(String  name)

지정된 환경 변수의 값을 취득합니다. 환경 변수는 시스템 고유의 외부에 있는 이름 첨잘못된 값 입니다.

시큐러티 매니저가 존재하는 경우는 RuntimePermission ("getenv. "+name) 접근 권한을 사용해 checkPermission 메서드가 호출됩니다. 이 결과, SecurityException이 발생되는 일이 있습니다. 예외가 Throw 되지 않는 경우, 변수 name값이 리턴됩니다 .

「시스템 프로퍼티」와「환경 변수」는 이름과 값과의 사이에 개념적으로 맵 되고 있습니다. 양쪽 모두의 메카니즘을 사용해, 사용자 정의 정보를 Java 프로세스에 건네줄 수가 있습니다. 환경 변수는 보다 글로벌인 효과를 미칩니다. 이것은 프로세스에 의해 정의된 모든 자손에게 있어 환경 변수가 직접적인 Java 서브 프로세스 일 뿐만 아니라, 가시이기 때문입니다. 이것들은 다른 OS 상에서 미묘하게 다른 시멘틱스 (대문자와 소문자를 구별하지 않는 등)를 가질 수가 있습니다. 이러한 이유로부터, 환경 변수는 도하지 않는 부작용을 가질 가능성이 높아집니다. 가능한 경우는 시스템 프로퍼티를 사용하는 것이 가장 적절합니다. 환경 변수는 글로벌인 효과가 필요한 때나, 외부 시스템 인터페이스가 환경 변수 (PATH 등)를 필요로 할 때 사용할 필요가 있습니다.

UNIX 시스템에서는 name 알파벳의 대문자와 소문자는 구별됩니다만, Microsoft Windows 시스템에서는 일반적으로 구별되지 않습니다. 예를 들어, System.getenv("FOO"). equals(System.getenv("foo")) 라고 하는 표현은 Microsoft Windows 에서는 true 입니다.

파라미터:

name - 환경 변수의 이름

반환값:

변수의 캐릭터 라인치. 시스템 환경에서 변수를 정의하지 않는 경우는 null

예외:

NullPointerException - name가 null인 경우

SecurityException - 시큐러티 매니저가 존재해, checkPermission 메서드가 환경 변수 name에 의 액세스를 허가하지 않을 때

관련 항목:

getenv(), ProcessBuilder.environment()

getenv

public static Map <String,
String > getenv()

현재의 시스템 환경의 변경할 수 없는 캐릭터 라인 맵의 뷰를 리턴합니다. 환경은 이름에서 값에의 시스템에 존재하는 매핑이며, parent process로부터 child process에게 건네집니다.

시스템이 환경 변수를 지원 하고 있지 않는 경우는 비어있는 맵이 리턴됩니다 .

리턴된 맵은 null 키나 값을 포함하지 않습니다. null 키나 값이 있을지 어떨지 쿼리를 실행하면, NullPointerException을 발생시킵니다. String 형이 아닌 키나 값이 있을지 어떨지 쿼리를 실행하면, ClassCastException을 발생시킵니다.

리턴된 맵과 그 코레크션뷰는 Object.equals(java.lang.Object) 메서드와 Object.hashCode() 메서드의 범용 규약에 따르지 않을 가능성이 있습니다.

리턴된 맵은 일반적으로 모든 플랫폼에서 대문자와 소문자를 구별합니다.

시큐러티 매니저가 존재하는 경우는 RuntimePermission ("getenv. *") 접근 권한을 사용해 checkPermission 메서드가 호출됩니다. 이 결과, SecurityException이 발생되는 일이 있습니다.

Java 서브 프로세스에 정보를 건네주는 경우, 일반적으로 환경 변수보다시스템 프로퍼티가 추천 됩니다.

반환값:

변수명으로부터 값에의 맵으로서의 환경

예외:

SecurityException - 시큐러티 매니저가 존재해, checkPermission 메서드가 프로세스 환경에의 액세스를 허가하지 않을 때

도입된 버전 :

1.5

관련 항목:

getenv(String), ProcessBuilder.environment()

exit

public static void exit(int status)

현재 실행하고 있는 Java 가상 머신을 종료합니다. 인수는 스테이터스 코드로서 작용합니다. 통례, 제로 이외의 스테이터스 코드는 이상종료(ABEND)를 나타냅니다.

이 메서드는 Runtime 클래스의 exit 메서드를 호출합니다. 이 메서드는 정상적으로 복귀할 것은 없습니다.

System.exit(n) 호출의 동작은 실제로는 다음의 호출과 같습니다.

 Runtime.getRuntime(). exit(n) 

파라미터:

status - 종료의 스테이터스

예외:

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

관련 항목:

Runtime.exit(int)

gc

public static void gc()

가비지 컬렉터를 실행합니다.

gc 메서드의 호출은 현재 점유 하고 있는 메모리를 재차 신속히 이용하기 위해서 Java 가상 머신이 사용하지 않는 객체의 리사이클을 실행하는 것을의미합니다. 메서드의 호출로부터 제어가 돌아오는 것은 Java 가상 머신이, 파기된 객체가 점유 하고 있던 스페이스를 최대한까지 회복 끝마쳤을 때입니다.

System.gc() 호출의 동작은 실제로는 다음의 호출과 같습니다.

 Runtime.getRuntime(). gc() 

관련 항목:

Runtime.gc()

runFinalization

public static void runFinalization()

파이나라이즈를 보류하고 있는 객체의 파이나라이즈메서드를 실행합니다.

이 메서드를 호출하면, Java 가상 머신이, 파기되고 있는 것을 알 수 있고 있어 finalize 메서드가 실행되어 있지 않은 객체에 대해서 finalize 메서드의 실행이 시행됩니다. 메서드의 호출로부터 제어가 돌아오는 것은 Java 가상 머신이, 모든 미처리의 파이나라이즈를 최대한까지 완료 끝마쳤을 때입니다.

System.runFinalization() 호출의 동작은 실제로는 다음의 호출과 같습니다.

 Runtime.getRuntime(). runFinalization() 

관련 항목:

Runtime.runFinalization()

runFinalizersOnExit

@Deprecated 
public static void runFinalizersOnExit(boolean value)

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

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

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

파라미터:

value - 파이나라이즈를 유효하게 할까 무효로 하는지를 나타낸다

예외:

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

도입된 버전 :

JDK1. 1

관련 항목:

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

load

public static void load(String  filename)

지정된 파일명을 가지는 코드 파일을 다이나믹 라이브러리로서 로컬 파일 시스템으로부터 로드합니다. filename 인수는 완전한 패스명이 아니면 안됩니다.

System.load(name) 호출의 동작은 실제로는 다음의 호출과 같습니다.

 Runtime.getRuntime(). load(name) 

파라미터:

filename - 로드하는 파일

예외:

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

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

NullPointerException - filename가 null인 경우

관련 항목:

Runtime.load(java.lang.String), SecurityManager.checkLink(java.lang.String)

loadLibrary

public static void loadLibrary(String  libname)

인수 libname에 의해 지정되는 시스템 라이브러리를 로드합니다. 라이브러리명이 실제의 시스템 라이브러리에 매핑 되는 방법은 시스템에 따라서 다릅니다.

System.loadLibrary(name) 호출의 동작은 실제로는 다음의 호출과 같습니다.

 Runtime.getRuntime(). loadLibrary(name) 

파라미터:

libname - 라이브러리의 이름

예외:

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

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

NullPointerException - libname가 null인 경우

관련 항목:

Runtime.loadLibrary(java.lang.String), SecurityManager.checkLink(java.lang.String)

mapLibraryName

public static String  mapLibraryName(String  libname)

라이브러리명을 네이티브 라이브러리를 나타내는 플랫폼 존의 캐릭터 라인에 매핑 합니다.

파라미터:

libname - 라이브러리의 이름

반환값:

플랫폼 존의 네이티브 라이브러리명

예외:

NullPointerException - libname가 null인 경우

도입된 버전 :

1.2

관련 항목:

loadLibrary(java.lang.String), ClassLoader.findLibrary(java.lang.String)