Applicet Framework for Applets and Applications v2.03

Package be.arci.applet

This package contains the Applicet Framework for Applets and Applications; additional helper classes can be found in the be.arci.pub package.

See:
          Description

Interface Summary
Browser Interface describing helper programs for the AppletContext of an Applicet application: Applicet.getAppletContext().showDocument(), if instanceof Applicet.Context, delegates to Browser.showDocument().
Framework Framework contract for applets and applications, common to Applicet and JApplicet.
HFile Defines some common primitive constants for Applicet.
 

Class Summary
Applicet Extends Applet with full support for running as an application, with access to resource URLs and inputstreams, images, sound and all, and with carefully designed internationalization (I18N) conveniences that make internationalization of your applets and applications trivial.
DummyBrowser Dummy implementation of Browser that does not display documents, but shows the URL in the status field.
FallbackAudioClip Fallback for loadig AudioClips for applications in pre-Java 2 environments.
I18NDelegate Groups all internationalization (I18N) support for the Applicet Framework, allowing to leave this out of the distribution package for basic applets.
JApplicet Extends JApplet with full support for running as an application, with access to resource URLs and inputstreams, images, sound and all, and with carefully designed internationalization (I18N) conveniences that make internationalization of your applets and applications trivial.
 

Package be.arci.applet Description

This package contains the Applicet Framework for Applets and Applications; additional helper classes can be found in the be.arci.pub package.

The Applicet Framework for Applets and Applications gives full support for running applets as applications, by replacing either java.applet.Applet as superclass with be.arci.applet.Applicet for AWT applets, or java.swing.JApplet as superclass with be.arci.applet.JApplicet for Swing applets.

It is popular belief that all you have to do to run an applet as application is to add a main() method calling init() and start() on your applet instance. But why then are there so few applets that run as an application as well? The answer is simple: while the simple main() method might be enough for very basic applets, it is not at all the case for most (if not all) usefull applets. About anything an applet needs apart from it's own canvas to draw on, it'll have to ask for from it's AppletStub and it's AppletContext.

The Applicet Framework gives Applicet applications the necessary implementations of the java.applet.AppletStub and java.applet.AppletContext interfaces that are needed to run an applet as application without changing any code, and without having to branch on switches you maintain to distinguish between both execution environments. Additional benefits are uniform support for retrieving resources as Image, AudioClip, URL or Inputstream, even across application environments, Web browsers and packaging options. And last but not least, the Applicet Framework makes internationalization of your applet/application trivial.

Note: In this and other documents we'll say 'Applicet applet' or 'Applicet application' whenever there is a difference between running as an applet and running as an application. We will also only make the distinction AWT Applicet versus Swing JApplicet when there is need for it.

See Also:
Applicet, JApplicet, The Applicet Framework overview, be.arci.pub

Applicet Framework for Applets and Applications v2.03