java.applet
클래스 Applet

java.lang.Object 
  java.awt.Component 
      java.awt.Container 
          java.awt.Panel 
              java.applet.Applet

모든 구현된 인터페이스:

ImageObserver, MenuContainer, Serializable, Accessible

알려진 직계 서브 클래스:

JApplet

public class Applet
extends Panel 

애플릿이란 단독으로 동작할 수 없고, 다른 어플리케이션안에 삽입된 형태로 실행되는 작은 프로그램입니다.

Applet 클래스는 Web 페이지에 파묻히는 애플릿, 또는 Java 애플릿 viewer로 표시되는 애플릿의 슈퍼 클래스입니다. Applet 클래스는 애플릿과 그 환경과의 사이의 표준 인터페이스의 역할을 완수합니다.

도입된 버전 :

JDK1. 0

관련 항목:

직렬화 된 형식

중첩(Nested) 클래스 개요

protected class

Applet.AccessibleApplet 이 클래스는 Applet 클래스용의 사용자 보조 기능의 지원를 구현하고 있습니다.

클래스 java.awt. Panel 로부터 상속된 중첩(Nested) 클래스/인터페이스

Panel.AccessibleAWTPanel

클래스 java.awt. Container 로부터 상속된 중첩(Nested) 클래스/인터페이스

Container.AccessibleAWTContainer

클래스 java.awt. Component 로부터 상속된 중첩(Nested) 클래스/인터페이스

Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

필드 개요

클래스 java.awt. Component 로부터 상속된 필드

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

인터페이스 java.awt.image. ImageObserver 로부터 상속된 필드

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

생성자 개요

Applet ()
새로운 Applet 객체를 작성합니다.

메서드 개요

void	destroy () 브라우저 또는 애플릿 viewer에 의해 불려가 이 애플릿의 재생중에 할당할 수 있던 모든 자원을 파기할 필요가 있는 것을 통지합니다.
AccessibleContext	getAccessibleContext () 이 애플릿에 관련한 AccessibleContext를 리턴합니다.
AppletContext	getAppletContext () 애플릿의 컨텍스트를 취득합니다.
String	getAppletInfo () 애플릿에 대한 정보를 리턴합니다.
AudioClip	getAudioClip (URL url) 인수 url로 지정된 AudioClip 객체를 리턴합니다.
AudioClip	getAudioClip (URL url, String name) 인수 url와 name로 지정된 AudioClip 객체를 리턴합니다.
URL	getCodeBase () 이 애플릿을 포함한 디렉토리의 URL 인, 기저 URL를 취득합니다.
URL	getDocumentBase () 이 애플릿이 삽입되어 있는 문서의 URL를 취득합니다.
Image	getImage (URL url) 화면에 표시할 수 있는 Image 객체를 리턴합니다.
Image	getImage (URL url, String name) 화면에 표시할 수 있는 Image 객체를 리턴합니다.
Locale	getLocale () 애플릿의 로케일이 설정되어 있는 경우는 그 로케일을 취득합니다.
String	getParameter (String name) HTML 태그내에 있는 지정된 파라미터의 값을 리턴합니다.
String [][]	getParameterInfo () 이 애플릿이 해석하는 파라미터에 대한 정보를 리턴합니다.
void	init () 브라우저 또는 애플릿 viewer에 의해 불려가 이 애플릿이 시스템에 로드 된 것을 통지합니다.
boolean	isActive () 애플릿이 활성화되었는가 어떤가를 판정합니다.
static AudioClip	newAudioClip (URL url) 지정된 URL 로부터 오디오 클립을 취득합니다.
void	play (URL url) 지정된 절대 URL에 있는 오디오 클립을 재생합니다.
void	play (URL url, String name) URL와 그 URL와 의 상대 위치에서 지정된 오디오 클립을 재생합니다.
void	resize (Dimension d) 애플릿의 사이즈 변경을 요구합니다.
void	resize (int width, int height) 애플릿의 사이즈 변경을 요구합니다.
void	setStub (AppletStub stub) 애플릿의 스텁을 설정합니다.
void	showStatus (String msg) 인수로 지정된 캐릭터 라인을 「스테이터스 윈도우」에 표시하도록 요구합니다.
void	start () 브라우저 또는 애플릿 viewer에 의해 불려가 이 애플릿의 실행을 개시할 필요가 있는 것을 통지합니다.
void	stop () 브라우저 또는 애플릿 viewer에 의해 불려가 이 애플릿의 실행을 정지할 필요가 있는 것을 통지합니다.

클래스 java.awt. Panel 로부터 상속된 메서드

addNotify

클래스 java.awt. Container 로부터 상속된 메서드

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getListeners, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusBackward, transferFocusDownCycle, update, validate, validateTree

클래스 java.awt. Component 로부터 상속된 메서드

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusUpCycle

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

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

생성자 상세

Applet

public Applet()
       throws HeadlessException 

새로운 Applet 객체를 작성합니다.

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true를 돌려주는 경우

도입된 버전 :

1.4

관련 항목:

GraphicsEnvironment.isHeadless()

메서드의 상세

setStub

public final void setStub(AppletStub  stub)

애플릿의 스텁을 설정합니다. 이 처리는 시스템에 의해 자동적으로 행해집니다.

시큐러티 매니저가 존재하는 경우는 스텁이 이미 설정되어 있으면, AWTPermission("setAppletStub") 접근 권한에 의해 checkPermission 메서드를 호출합니다.

파라미터:

stub - 새로운 스텁

예외:

SecurityException - 호출측이 스텁을 설정할 수 없는 경우

isActive

public boolean isActive()

애플릿이 활성화되었는가 어떤가를 판정합니다. 애플릿은, start 메서드가 불려가기 직전에 활성화 되어, stop 메서드가 불려가기 직전에 활성화되지 않게 됩니다.

반환값:

애플릿이 활성화된 경우는 true, 그렇지 않은 경우는 false

관련 항목:

start(), stop()

getDocumentBase

public URL  getDocumentBase()

이 애플릿이 삽입되어 있는 문서의 URL를 취득합니다. 예를 들어 다음의 문서내에 애플릿이 포함되어 있다고 합니다.

 http://java.sun.com/products/jdk/1. 2/index.html

문서의 베이스는 다음과 같습니다.

 http://java.sun.com/products/jdk/1. 2/index.html 

반환값:

이 애플릿을 포함한 문서 URL

관련 항목:

getCodeBase()

getCodeBase

public URL  getCodeBase()

이 애플릿을 포함한 디렉토리의 URL 인, 기저 URL를 취득합니다.

반환값:

이 애플릿을 포함한 디렉토리의 기저 URL

관련 항목:

getDocumentBase()

getParameter

public String  getParameter(String  name)

HTML 태그내에 있는 지정된 파라미터의 값을 리턴합니다. 예를 들어 애플릿이 다음과 같이 지정되고 있다고 합니다.

 <applet code="Clock" width=50 height=50>
 <param name=Color value="blue">
 </applet>
 

이 경우 getParameter("Color") 호출은 "blue" 라고 하는 값을 리턴합니다.

인수 name에 서는 대문자와 소문자를 구별하지 않습니다.

파라미터:

name - 파라미터명

반환값:

이름 첨부 파라미터의 값. 설정되어 있지 않은 경우는 null

getAppletContext

public AppletContext  getAppletContext()

애플릿의 컨텍스트를 취득합니다. 애플릿은 컨텍스트를 사용해 애플릿의 실행 환경에 관한 정보를 얻거나 실행 환경을 제어하거나 할 수 있습니다 .

애플릿의 환경이란 애플릿을 포함하고 있는 문서를 나타냅니다.

반환값:

애플릿의 컨텍스트

resize

public void resize(int width,
                   int height)

애플릿의 사이즈 변경을 요구합니다.

오버라이드(override):

클래스 Component 내의 resize

파라미터:

width - 애플릿에 새롭게 요구된 폭

height - 애플릿에 새롭게 요구된 높이

resize

public void resize(Dimension  d)

애플릿의 사이즈 변경을 요구합니다.

오버라이드(override):

클래스 Component 내의 resize

파라미터:

d - 새로운 폭과 높이를 나타내는 객체

showStatus

public void showStatus(String  msg)

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

파라미터:

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

getImage

public Image  getImage(URL  url)

화면에 표시할 수 있는 Image 객체를 리턴합니다. 인수 url에는 절대 URL를 지정합니다.

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

파라미터:

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

반환값:

지정된 URL에 있는 이미지

관련 항목:

Image

getImage

public Image  getImage(URL  url,
                      String  name)

화면에 표시할 수 있는 Image 객체를 리턴합니다. 인수 url에는 절대 URL를 지정합니다. 인수 name에는 인수 url와 의 상대 위치를 지정합니다.

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

파라미터:

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

name - 이미지의 위치. 인수 url인수와의 상대 위치에서 지정한다

반환값:

지정된 URL에 있는 이미지

관련 항목:

Image

newAudioClip

public static final AudioClip  newAudioClip(URL  url)

지정된 URL 로부터 오디오 클립을 취득합니다.

파라미터:

url - 오디오 클립의 위치

반환값:

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

도입된 버전 :

1.2

getAudioClip

public AudioClip  getAudioClip(URL  url)

인수 url로 지정된 AudioClip 객체를 리턴합니다.

이 메서드는 오디오 클립이 있을지 어떨지에 관계없이, 곧바로 복귀합니다. 애플릿이 오디오 클립을 재생하려고 했을 때에 데이터가 로드 됩니다.

파라미터:

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

반환값:

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

관련 항목:

AudioClip

getAudioClip

public AudioClip  getAudioClip(URL  url,
                              String  name)

인수 url와 name로 지정된 AudioClip 객체를 리턴합니다.

이 메서드는 오디오 클립이 있을지 어떨지에 관계없이, 곧바로 복귀합니다. 애플릿이 오디오 클립을 재생하려고 했을 때에 데이터가 로드 됩니다.

파라미터:

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

name - 오디오 클립의 위치. 인수 url와 의 상대 위치에서 지정한다

반환값:

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

관련 항목:

AudioClip

getAppletInfo

public String  getAppletInfo()

애플릿에 대한 정보를 리턴합니다. 애플릿은 이 메서드를 오버라이드(override) 해, 애플릿의 작성자, 버전 및 저작권에 대한 정보를 포함한 String 객체를 리턴합니다.

Applet 클래스의 이 메서드의 구현은, null을 리턴합니다.

반환값:

애플릿의 작성자, 버전 및 저작권에 대한 정보를 포함한 캐릭터 라인

getLocale

public Locale  getLocale()

애플릿의 로케일이 설정되어 있는 경우는 그 로케일을 취득합니다. 로케일이 설정되어 있지 않은 경우는 디폴트의 로케일을 리턴합니다.

오버라이드(override):

클래스 Component 내의 getLocale

반환값:

애플릿의 로케일

도입된 버전 :

JDK1. 1

관련 항목:

Component.setLocale(java.util.Locale)

getParameterInfo

public String [][] getParameterInfo()

이 애플릿이 해석하는 파라미터에 대한 정보를 리턴합니다. 애플릿은 이 메서드를 오버라이드(override) 해, 이러한 파라미터에 대한 정보를 포함한 String 배열을 리턴합니다.

배열의 각 요소는 3개의 String 세트로 이름, 형태 및 설명을 포함합니다. 다음에 예를 나타냅니다.

String pinfo[][] = {     {"fps",    "1-10",    "매초 쯤의 프레임수"},   {"repeat", "boolean", "이미지 루프의 반복해"},  {"imgs",   "url",     "이미지의 존재하는 디렉토리"} }; 

Applet 클래스의 이 메서드의 구현은, null을 리턴합니다.

반환값:

이 애플릿이 받는 파라미터에 대한 정보를 포함한 배열

play

public void play(URL  url)

지정된 절대 URL에 있는 오디오 클립을 재생합니다. 오디오 클립이 발견되지 않는 경우는 아무것도 실시하지 않습니다.

파라미터:

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

play

public void play(URL  url,
                 String  name)

URL와 그 URL와 의 상대 위치에서 지정된 오디오 클립을 재생합니다. 오디오 클립이 발견되지 않는 경우는 아무것도 실시하지 않습니다.

파라미터:

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

name - 오디오 클립의 위치. 인수 url와 의 상대 위치에서 지정한다

init

public void init()

브라우저 또는 애플릿 viewer에 의해 불려가 이 애플릿이 시스템에 로드 된 것을 통지합니다. 이 메서드는 start 메서드가 최초로 불려가기 전에 항상 호출합니다.

Applet 서브 클래스에서 초기화 처리를 실시하는 경우는 이 메서드를 오버라이드(override) 할 필요가 있습니다. 예를 들어 thread를 사용하는 애플릿의 경우는 init 메서드로 thread를 작성해, destroy 메서드로 thread를 파기합니다.

Applet 클래스의 이 메서드에서는 아무것도 실시하지 않습니다.

관련 항목:

destroy(), start(), stop()

start

public void start()

브라우저 또는 애플릿 viewer에 의해 불려가 이 애플릿의 실행을 개시할 필요가 있는 것을 통지합니다. 이 메서드는 init 메서드의 후에 불려가 Web 페이지상에서 애플릿이 활성화 될 때마다 호출합니다.

애플릿을 포함한 Web 페이지가 표시될 때마다 하등의 처리를 실시하는 경우는 Applet 서브 클래스에서는 이 메서드를 오버라이드(override) 할 필요가 있습니다. 예를 들어 애니메이션을 포함한 애플릿의 경우는 start 메서드로 애니메이션을 재생해, stop 메서드로 애니메이션을 정지합니다.

주: getLocationOnScreen 등의 메서드의 몇개인가는 애플릿이 표시되고 있는 경우는 의미가 있는 결과 밖에 제공할 수 없습니다. 애플릿의 start이 먼저 불려 갔을 경우, isShowing는 false를 돌려주므로true를 돌려주기 위해서 필요한 isShowing는 ComponentListener로 부터 불려 갈 필요가 있습니다.

Applet 클래스의 이 메서드에서는 아무것도 실시하지 않습니다.

관련 항목:

destroy(), init(), stop(), Component.isShowing(), ComponentListener.componentShown(java.awt.event.ComponentEvent)

stop

public void stop()

브라우저 또는 애플릿 viewer에 의해 불려가 이 애플릿의 실행을 정지할 필요가 있는 것을 통지합니다. 이 메서드는 애플릿을 포함한 Web 페이지 대신에 다른 Web 페이지가 표시되었을 때 및 애플릿이 파기되기 직전에 호출합니다.

애플릿을 포함한 Web 페이지가 비표시가 될 때마다 하등의 처리를 실시하는 경우는 Applet 서브 클래스에서는 이 메서드를 오버라이드(override) 할 필요가 있습니다. 예를 들어 애니메이션을 포함한 애플릿의 경우는 start 메서드로 애니메이션을 재생해, stop 메서드로 애니메이션을 정지합니다.

Applet 클래스의 이 메서드에서는 아무것도 실시하지 않습니다.

관련 항목:

destroy(), init()

destroy

public void destroy()

브라우저 또는 애플릿 viewer에 의해 불려가 이 애플릿의 재생중에 할당할 수 있던 모든 자원을 파기할 필요가 있는 것을 통지합니다. destoroy 메서드의 전에 stop 메서드가 반드시 호출합니다.

파기하기 전에 하등의 처리를 실시하는 경우는 Applet 서브 클래스에서는 이 메서드를 오버라이드(override) 할 필요가 있습니다. 예를 들어 thread를 사용하는 애플릿의 경우는 init 메서드로 thread를 작성해, destroy 메서드로 thread를 파기합니다.

Applet 클래스의 이 메서드에서는 아무것도 실시하지 않습니다.

관련 항목:

init(), start(), stop()

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 애플릿에 관련한 AccessibleContext를 리턴합니다. 애플릿의 경우, AccessibleContext는 AccessibleApplet 형식을 취합니다. 필요에 따라서 새로운의 AccessibleApplet 인스턴스가 작성됩니다.

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 Panel 내의 getAccessibleContext

반환값:

이 애플릿의 AccessibleContext 로서 기능하는 AccessibleApplet