Создание собственной задачи

Создаётся Java-класс, наследуемый от org.apache.tools.ant.Task или другого сходного с ним класса.

Для каждого атрибута пишется установочный метод. Он должен быть public void и принимать один-единственный параметр. Имя метода должно начинаться с set, предшествующего имени атрибута, с первым символом имени, написанным в верхнем регистре, a остальное в нижнем. Так, чтобы подключить атрибут с именем file, следует создать метод setFile().

Если задача будет содержать другие задачи в качестве внутренних, класс должен наследоваться от org.apache.tools.ant.TaskContainer.

Для каждого внутреннего элемента указывается create(), add() или addConfigured() метод. Метод сreate() должен быть public методом, который не принимает аргументов и возвращает Object тип. Метод аdd() (или addConfigured()) метод должен быть public void методом, который принимает единственный аргумент Object типа с конструктором без аргументов.

public void execute() – метод без аргументов, является главным методом в задаче, который генерирует BuildException.

В качестве примера можно создать собственную задачу, в результате выполнения которой будет выводиться сообщение в поток System.out. У задачи будет один атрибут с именем message.

package com.mydomain;

import org.apache.tools.ant.BuildException;

import org.apache.tools.ant.Task;

public class MyVeryOwnTask extends Task {

private String msg;

// метод, выполняющий задачу

public void execute() throws BuildException {

System.out.println(msg);

}

// метод установки атрибута

public void setMessage(String msg) {

this. msg = msg;

}

}

Чтобы добавить задачу в проект, следует удостовериться, что класс, который подключается, находится в classpath.

После добавления <taskdef> -элемента в проект элемент добавится в систему, используя предыдущую задачу в оставшемся build -файле.

Чтобы использовать задачу повсеместно в проекте, нужно поместить <taskdef> внутри проекта, а не задачи. Следует использовать classpath атрибут <taskdef>, чтобы указать, откуда брать код задачи.

В этой книге были рассмотрены основные возможности языка Java применительно к созданию приложений и распределенных систем. Ряд дополнительных возможностей остался вне поля зрения, поэтому читайте спецификации, которые можно загрузить по адресу:

java.sun.com/products/servlet/index.jsp

java.sun.com/products/jsp/index.jsp

java.sun.com/products/jdbc/index.jsp

java.sun.com/j2ee/1.4/index.jsp