The Java TM Tutorial

| Start of Tutorial > Start of Trail > Start of Lesson | Search

Trail: Writing Applets
Lesson: Taking Advantage of the Applet API

## Finding and Loading Data Files

> Whenever an applet needs to load some data from a file that's specified with a relative URL (a URL that doesn't completely specify the file's location), the applet usually uses either the code base or the document base to form the complete URL. The code base, returned by the `Applet` `getCodeBase` method, is a URL that specifies the directory from which the applet's classes were loaded. The document base, returned by the `Applet` `getDocumentBase` method, specifies the directory of the HTML page that contains the applet.

> Unless the `<APPLET>` tag specifies a code base, both the code base and document base refer to the same directory on the same server. For example, in the figure in Test Driving an Applet, the code and document bases would both specify the someDirectory directory.

> Data that the applet always needs, or needs to rely on as a backup, is usually specified relative to the code base. Data that the applet user specifies, often by using parameters, is usually specified relative to the document base.

> > Note: For security reasons, browsers limit the URLs from which untrusted applets can read. For example, most browsers don't allow untrusted applets to use ".." to get to directories above the code base or document base. Also, since untrusted applets can't read files except those on the applet's originating host, the document base isn't generally useful if the document and the untrusted applet are on different servers.

> The `Applet` class defines convenient forms of image-loading and sound-loading methods that let you specify images and sounds relative to a base URL. For example, assume an applet is set up with one of the directory structures shown in the following figure.

> To create an `Image` object using the `a.gif` image file under `imgDir`, the applet can use the following code:

> >     Image image = getImage(getCodeBase(), "imgDir/a.gif");

| Start of Tutorial > Start of Trail > Start of Lesson | Search