java.applet
인터페이스 AppletContext

public interface AppletContext

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

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

도입된 버젼:

JDK1. 0

메소드의 개요

Applet	getApplet (String name) 이 애플릿 문맥에 의해 표시되는 문서내에서, 지정된 이름의 애플릿을 찾아 돌려줍니다.
Enumeration	getApplets () 이 애플릿 문맥에 의해 표시되는 문서내에 있는 모든 애플릿을 찾습니다.
AudioClip	getAudioClip (URL url) 오디오 클립을 취득합니다.
Image	getImage (URL url) Image 오브젝트를 돌려줍니다.
InputStream	getStream (String key) 이 애플릿 문맥내에 관련지을 수 있고 있는 키에의 스트림을 돌려줍니다.
Iterator	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

public AudioClip  getAudioClip(URL  url)

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

파라미터:

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

반환값:

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

getImage

public Image  getImage(URL  url)

Image 오브젝트를 돌려줍니다. 이 오브젝트는 화면에 표현 할 수가 있습니다. 인수 url 에는 절대 URL 를 지정할 필요가 있습니다.

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

파라미터:

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

반환값:

지정된 URL 에 있는 이미지

관련 항목:

Image

getApplet

public Applet  getApplet(String  name)

이 애플릿 문맥에 의해 표시되는 문서내에서, 지정된 이름의 애플릿을 찾아 돌려줍니다. 애플릿명은 HTML 태그의 name 속성을 사용해 지정할 수 있습니다.

파라미터:

name - 애플릿의 이름

반환값:

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

getApplets

public Enumeration  getApplets()

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

반환값:

이 애플릿 문맥에 의해 표시되는 문서내에 있는 모든 애플릿의 열거

showDocument

public void showDocument(URL  url)

표시중의 Web 페이지 대신에, 지정된 URL 의 페이지를 표시합니다. 애플릿 문맥이 브라우저가 아닌 경우는 이 메소드는 무시됩니다.

파라미터:

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

showDocument

public void showDocument(URL  url,
                         String  target)

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

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

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

파라미터:

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

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

showStatus

public void showStatus(String  status)

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

파라미터:

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

setStream

public void setStream(String  key,
                      InputStream  stream)
               throws IOException 

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

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

파라미터:

key - 지정되는 값을 관련지을 수 있는 키

stream - 지정된 키에 관련지을 수 있었던 스트림. 파라미터가 null 의 경우는 해당하는 애플릿 문맥으로부터 지정된 키가 삭제된다

예외:

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

IOException

도입된 버젼:

JDK1. 4

getStream

public InputStream  getStream(String  key)

이 애플릿 문맥내에 관련지을 수 있고 있는 키에의 스트림을 돌려줍니다. 대상의 애플릿에 키의 스트림이 포함되지 않은 경우는 null 가 돌려주어집니다.

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

파라미터:

key - 관련지을 수 있었던 값이 돌려주어지는 스트림

반환값:

이 애플릿 문맥이 매핑 한 키에의 스트림

도입된 버젼:

JDK1. 4

getStreamKeys

public Iterator  getStreamKeys()

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

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

반환값:

이 애플릿 문맥내의 스트림명 모든 반복자

도입된 버젼:

JDK1. 4