java.applet
인터페이스 AppletContext

public interface AppletContext

이 인터페이스는 애플릿 환경에 대응합니다. 애플릿의 환경이란 애플릿을 포함한 문서 및 같은 문서내에 있는 것 외의 애플릿입니다.

이 인터페이스의 메서드를 애플릿내에서 사용하면 그 애플릿 환경에 대한 정보를 취득할 수 있습니다.

도입된 버전 :

JDK1. 0

메서드 개요

Applet	getApplet (String name) 이 애플릿 컨텍스트에 의해 표시되는 문서내에서 지정된 이름의 애플릿을 찾아 리턴합니다.
Enumeration <Applet >	getApplets () 이 애플릿 컨텍스트에 의해 표시되는 문서내에 있는 모든 애플릿을 찾습니다.
AudioClip	getAudioClip (URL url) 오디오 클립을 취득합니다.
Image	getImage (URL url) Image 객체를 리턴합니다.
InputStream	getStream (String key) 이 애플릿 컨텍스트내에 관련된 키의 스트림을 리턴합니다.
Iterator <String >	getStreamKeys () 이 애플릿 컨텍스트내의 스트림의 키를 모두 검색합니다.
void	setStream (String key, InputStream stream) 지정된 스트림을 이 애플릿 컨텍스트의 지정된 키에 관련짓습니다.
void	showDocument (URL url) 표시중인 Web 페이지 대신에 지정된 URL페이지를 표시합니다.
void	showDocument (URL url, String target) 브라우저 또는 애플릿 viewer에 인수 url로 지정된 Web 페이지를 표시하도록 요구합니다.
void	showStatus (String status) 인수로 지정된 캐릭터 라인을 「스테이터스 윈도우」에 표시하도록 요구합니다.

메서드의 상세

getAudioClip

AudioClip  getAudioClip(URL  url)

오디오 클립을 취득합니다.

파라미터:

url - 오디오 클립의 위치를 나타내는 절대 URL

반환값:

지정된 URL에 있는 오디오 클립

getImage

Image  getImage(URL  url)

Image 객체를 리턴합니다. 이 객체는 화면에 렌더링 할 수 있습니다 . 인수 url에는 절대 URL를 지정할 필요가 있습니다.

이 메서드는 이미지가 있을지 어떨지에 관계없이, 곧바로 복귀합니다. 애플릿이 화면에 이미지를 렌더링 하려고 했을 때에 데이터가 로드 됩니다. 이미지는 조금씩 화면에 렌더링 되어 갑니다.

파라미터:

url - 이미지의 위치를 나타내는 절대 URL

반환값:

지정된 URL에 있는 이미지

관련 항목:

Image

getApplet

Applet  getApplet(String  name)

이 애플릿 컨텍스트에 의해 표시되는 문서내에서 지정된 이름의 애플릿을 찾아 리턴합니다. 애플릿명은 HTML 태그의 name 속성을 사용해 지정할 수 있습니다.

파라미터:

name - 애플릿의 이름

반환값:

지정된 이름의 애플릿. 애플릿이 발견되지 않는 경우는 null

getApplets

Enumeration <Applet > getApplets()

이 애플릿 컨텍스트에 의해 표시되는 문서내에 있는 모든 애플릿을 찾습니다.

반환값:

이 애플릿 컨텍스트에 의해 표시되는 문서내에 있는 모든 애플릿의 열거

showDocument

void showDocument(URL  url)

표시중의 Web 페이지 대신에 지정된 URL 페이지를 표시합니다. 애플릿 컨텍스트이 브라우저가 아닌 경우는 이 메서드는 무시됩니다.

파라미터:

url - 문서의 위치를 나타내는 절대 URL

showDocument

void showDocument(URL  url,
                  String  target)

브라우저 또는 애플릿 viewer에 인수 url로 지정된 Web 페이지를 표시하도록 요구합니다. 인수 target에는 문서를 표시하는 HTML 프레임을 지정합니다. 인수 target은 다음과 같이 해석됩니다.

인수 target	설명
"_self"	애플릿을 포함한 윈도우 및 프레임에 표시하는
"_parent"	애플릿의 부모 프레임에 표시한다. 부모 프레임이 없는 경우는 "_self"와 같은
"_top"	애플릿의 윈도우의 최상정도 프레임에 표시한다. 애플릿의 프레임이 최상정도 프레임의 경우는 "_self"와 같은
"_blank"	이름이 없는 새로운 최상정도 윈도우에 표시하는
name	name에 이름을 지정한 프레임 또는 윈도우에 표시한다. name 로 지정한 타겟이 아직 없는 경우는 지정한 이름으로 새로운 최상정도 윈도우가 작성되어 거기에 문서가 표시된다

showDocument 메서드는 애플릿 viewer나 브라우저에 따라서는 무시되는 일이 있습니다.

파라미터:

url - 문서의 위치를 나타내는 절대 URL

target - 페이지를 표시하는 장소를 나타내는 String

showStatus

void showStatus(String  status)

인수로 지정된 캐릭터 라인을 「스테이터스 윈도우」에 표시하도록 요구합니다. 많은 브라우저나 애플릿 viewer에는 스테이터스 윈도우가 있어, 어플리케이션은 이 윈도우를 사용해 사용자에 게 현재 상태를 전할 수 있습니다 .

파라미터:

status - 스테이터스 윈도우에 표시되는 캐릭터 라인

setStream

void setStream(String  key,
               InputStream  stream)
               throws IOException 

지정된 스트림을 이 애플릿 컨텍스트의 지정된 키에 관련짓습니다. 애플릿 컨텍스트이 이전에 이 키의 매핑을 보관 유지하고 있었을 경우, 낡은 값을 옮겨놓을 수 있습니다.

보안상의 이유로 스트림 및 키의 매핑은 코드 베이스 마다 실시합니다. 즉, 어떤 코드 베이스의 애플릿도 다른 코드 베이스의 애플릿에 의해 작성된 스트림에 액세스 할 수 없습니다.

파라미터:

key - 지정되는 값을 관련된 키

stream - 지정된 키에 관련된 스트림. 파라미터가 null인 경우는 해당하는 애플릿 컨텍스트으로부터 지정된 키가 삭제된다

예외:

IOException - 스트림의 사이즈가 지정의 사이즈 제한을 넘었을 경우에 Throw 된다. 사이즈 제한은 이 인터페이스의 구현자가 결정한다

IOException

도입된 버전 :

JDK1. 4

getStream

InputStream  getStream(String  key)

이 애플릿 컨텍스트내에 관련된 키의 스트림을 리턴합니다. 대상의 애플릿에 키의 스트림이 포함되지 않은 경우는 null가 리턴됩니다 .

보안상의 이유로 스트림 및 키의 매핑은 코드 베이스 마다 실시합니다. 즉, 어떤 코드 베이스의 애플릿도 다른 코드 베이스의 애플릿에 의해 작성된 스트림에 액세스 할 수 없습니다.

파라미터:

key - 관련된 값이 리턴된 스트림

반환값:

이 애플릿 컨텍스트이 매핑 한 키의 스트림

도입된 버전 :

JDK1. 4

getStreamKeys

Iterator <String > getStreamKeys()

이 애플릿 컨텍스트내의 스트림의 키를 모두 검색합니다.

보안상의 이유로 스트림 및 키의 매핑은 코드 베이스 마다 실시합니다. 즉, 어떤 코드 베이스의 애플릿도 다른 코드 베이스의 애플릿에 의해 작성된 스트림에 액세스 할 수 없습니다.

반환값:

이 애플릿 컨텍스트내의 스트림명 모든 반복자

도입된 버전 :

JDK1. 4