3.2 Апплет, принимающий параметры

Создадим шаблон апплета AppletWithParam (пример 4), который имеет возможность обрабатывать параметры.

Для того, чтобы апплет принимал параметры, при создании апплета с помощью системы Java Applet Wizard в четвертой диалоговой панели необходимо определить параметры, передаваемые апплету.

Первоначально список параметров пуст, для того чтобы добавить новый параметр, нужно в столбце “Name” ввести имя параметра. Для апплета AppletWithParam следует добавить параметры с именами String_1 и String_2.

В столбце “Member” при заполнении списка параметров отображаются имена полей класса AppletWithParam, в которые можно будет записать значения параметров (при помощи метода getParameter()). Значения столбца “Def-Value” используются для инициализации соответствующих полей класса. Следует задать в этих полях строки “First string” и “Second string” соответственно.

Для описания параметров служит столбец “Description”. Апплет может извлечь эту информацию методом getParameterInfo() и проанализировать.

Рассмотрим тексты созданных файлов. Тексты подобных шаблонных файлов содержатся в Приложении 2 и их можно в дальнейшем использовать в качестве шаблонов апплета, принимающего значения.

Пример 4. Файлы, созданные Java Applet Wizard

Листинг Java-файла:

//***************************************************************

// AppletWithParam.java: Applet

//

//***************************************************************

import java.applet.*;

import java.awt.*;

public class AppletWithParam extends Applet

{

// ПОДДЕРЖКА ПАРАМЕТРОВ АППЛЕТА

//--------------------------------------------------------------------------

// Поля класса для хранения значений параметров

// Создаются автоматически для параметров апплета

// Поля инициализируются значениями по умолчанию из таблицы

// <type> <MemberVar> = <Default Value>

//--------------------------------------------------------------------------

private String m_String_1 = "First string";

private String m_String_2 = "Second string";

// Имена параметров, нужны для функции getParameter

// Создаются автоматически для параметров апплета

//--------------------------------------------------------------------------

private final String PARAM_String_1 = "String_1";

private final String PARAM_String_2= " String_2";

//--------------------------------------------------------------------------

public AppletWithParam()

{

// Сделать: Добавьте сюда код конструктора

}

//--------------------------------------------------------------------------

public String getAppletInfo()

{

return "Name: AppletWithParam\r\n" +

"";

}

// ПОДДЕРЖКА ПАРАМЕТРОВ

// Метод getParameterInfo() возвращает ссылку на

// массив с описаниями параметров в виде

//{ "Name", "Type", "Description" },

//--------------------------------------------------------------------------

public String[][] getParameterInfo()

{

String[][] info =

{

{ PARAM_String_1, "String", "Parameter description" },

{ PARAM_String_2, "String", "Parameter description" },

};

return info;

}

//--------------------------------------------------------------------------

public void init()

{

// ПОДДЕРЖКА ПАРАМЕТРОВ

// Чтение всех параметров и запись их значений в

// соответствующие поля класса

//----------------------------------------------------------------------

String param;

// Параметр с именем String_1

//----------------------------------------------------------------------

param = getParameter(PARAM_String_1);

if (param != null) m_String_1 = param;

// Параметр с именем String_2

//----------------------------------------------------------------------

param = getParameter(PARAM_String_2);

if (param != null) m_String_2 = param;

//----------------------------------------------------------------------

resize(320, 240);

// Сделать: Добавьте сюда код инициализации

}

//-------------------------------------------------------------------------

public void destroy()

{

// Сделать: Добавьте сюда код завершения работы апплета

}

//--------------------------------------------------------------------------

public void paint(Graphics g)

{

g.drawString("Created with Microsoft Visual J++ Version 1.1", 10, 20);

}

//--------------------------------------------------------------------------

public void start()

{

// Сделать: Добавьте сюда код, который должен

// работать при запуске апплета

}

//--------------------------------------------------------------------------

public void stop()

{

// Сделать: Добавьте сюда код, который должен

// работать при остановке апплета

}

// Сделать: Добавьте сюда код, необходимый для работы

// создаваемого специализированного апплета

}

Листинг HTML-файла:

<html>

<head>

<title>AppletWithParam</title>

</head>

<body>

<hr>

<applet

code=AppletWithParam.class

name= AppletWithParam

width=320

height=240 >

<param name=String_1 value="First string">

<param name=String_2 value="Second string">

</applet>

<hr>

<a href=" AppletWithParam.java">The source.</a>

</body>

</html>

Дополним созданный шаблон апплета. Сначала в HTML-файле изменим значения параметров апплета:

<param name=String_1 value="New first string">

<param name=String_2 value="New second string">

А затем выведем в методе paint() строки, получаемые апплетом в виде параметров:

public void paint(Graphics g)

{

g.drawString(m_String_1, 10, 20);

g.drawString(m_String_2, 10, 50);

}

3.3 URL-адреса, загрузка и вывод графических изображений

Создадим апплет ParamUrlImage (пример 5), в котором через параметр аплета передается имя gif-файла, содержимое которого затем выводится в окне апплета. При создании шаблона апплета (тексты шаблонов содержатся в Приложении 2) следует задать имя параметра FileName, а значение по умолчанию - “sample.gif”. В каталог, где содержится файл исходного текста, следует поместить файл с изображением sample.gif

Загрузить изображение можно при помощи URL-адреса на файл с изображением. URL, или Uniform Resource Locators (“унифицированная ссылка на ресурс”), - полный адрес объекта в сети WWW.

В Java есть отдельный класс для обработки URL-адресов - java.net.URL. Самый простой способ создания объекта URL состоит в использовании конструктора URL(String add), передавая ему обычный WWW-адрес, например

URL addUrl=new URL("http://www.vvsu.ru/");

Нужно отметить, что фрагмент кода, где происходит реализация класса URL, может сгенерировать исключение MalformedURLException, если вдруг объект не может по какой-либо причине быть создан (например, если передаваемая конструктору строка не является URL-адресом). Компилятор требует обработать возможность возникновения исключительной ситуации при помощи блоков try-catch, например:

try

{ URL addUrl=new URL("http://www.vvsu.ru/");

}

catch(MalformedURLException e)

{ // код здесь выполняется, если строка URL неправильна

}

Так как нам нужно загрузить файл с графическим изображением, то необходимо предварительно создать объект URL, передавая конструктору адрес файла. Нужно заметить, что загружать файлы, открывая сетевые соединения с удаленными главными серверами, апплетам запрещено в целях безопасности. Загружать файлы можно только с того сервера, с которого был загружен сам апплет.

Класс URL содержит конструктор, которому передается абсолютный базовый URL и строка, содержащая путь к объекту относительно этого базового указателя. Создать URL на файлы своего сервера (или своего локального компьютера) можно при помощи именно этого конструктора. Для получения URL на каталог, содержащий класс работающего апплета, используется метод getCodeBase() класса Applet. Так имя загружаемого графического файла содержится в переменной m_FileName класса, то для загрузки графического изображения можно использовать следующий фрагмент, помещаемый в метод init() класса ParamUrlImage:

try

{ Im=getImage(new URL(getCodeBase(),m_FileName));

}

catch(MalformedURLException e)

{ // код здесь выполняется, если строка URL неправильна

Im=createImage(0,0); // создание пустого изображения

}

Предварительно необходимо в классе апплета ParamUrlImage определить переменную Im:

Image Im;

и импортировать в файл класса ParamUrlImage пакет java.net:

import java.net.*;

Класс Image определяет простое двумерное графическое изображение. Для загрузки изображения из файла используется метод getImage(), принимающий URL это файла. Этот метод может импортировать изображения любого графического формата, поддерживаемого WWW-броузером (чаще всего используются форматы GIF и JPEG).

Для вывода изображения в окно необходимо в методе paint() апплета ParamUrlImage вызвать метод drawImage() класса Graphics, передавая ему изображение, координаты расположения изображения и ссылку текущий объект класса ParamUrlImage:

public void paint(Graphics g)

{ g.drawImage(Im,0,0,this);

}