Java Advanced

Java Advanced

Apache Ant

Содержание

Введение Задания Цели Проекты Свойства Заключение

Java Advanced / Описание и проверка структуры XML

Введение

Часть 1

Apache Ant

Язык описания build-файлов Основан на XML Межплатформенный

Java Advanced / Описание и проверка структуры XML

Основные понятия

Строительные блоки Задание Цель Проект Концепции Свойства Пути Множества файлов

Java Advanced / Описание и проверка структуры XML

Задания

Часть 2

Задание (task)

Элементарная операция build-файла Тип задания Аргументы задания Задание завершается успешно либо неуспешно Примеры Откомпилировать все .java файлы в каталоге sources и поместить результат в каталог classes Упаковать классы из каталога classes в .jar файл

Java Advanced / Описание и проверка структуры XML

Описание заданий

Задание задается XML-элементом Тип задания – имя элемента Аргументы задания – атрибуты элемента и вложенные элементы Пример задания <javac srcdir="source" destdir="classes"/> <exec dir="src" executable="cmd.exe" output="dir.txt"><arg line="/c dir"/></exec>

Java Advanced / Описание и проверка структуры XML

Компиляция

Задание javac – компилирует исходный код на Java Атрибуты srcdir – каталог с исходными кодами destdir – каталог для .class файлов includes? – какие файлы компилировать excludes? – какие файлы не компилировать classpath – classpath для компилятора Пример <javac srcdir="source" destdir="classes"/>

Java Advanced / Описание и проверка структуры XML

Применение includes и excludes

Атрибут includes Список масок файлов, которые включаются в множество По умолчанию – все файлы Атрибут excludes Список масок файлов, которые НЕ включаются в множество По умолчанию – пустое множество Excludes имеет приоритет

Java Advanced / Описание и проверка структуры XML

Маски файлов

Специальные символы ? – любой символ имени * – любая последовательность символов имени ** – любой каталог Примеры Все .java файлы в текущем каталоге *.java Все .java файлы в текущем каталоге и подкаталогах **/*.java

Java Advanced / Описание и проверка структуры XML

Создание архивов

Задания jar/zip – создают .jar/.zip файлы Атрибуты destfile – имя файла архива basedir – корневой каталог архива update? – обновлять/перезаписывать includes/excludes Примеры <jar destfile="compress.jar" basedir="classes" includes="**/*.class"/> <zip destfile=“pics.zip" basedir=“images" includes="**/*.jpg"/>

Java Advanced / Описание и проверка структуры XML

Генерация JavaDoc

Задание javadoc – компилирует JavaDoc документацию Атрибуты sourcepath – где брать исходники destdir – куда сохранять документацию packagenames – имена пакетов Пример <javadoc destdir="docs/api“ sourcepath="src/;moduleA/src" packagenames= "api.* "/>

Java Advanced / Описание и проверка структуры XML

Запуск java-программ

Задание java Атрибуты classname – имя основного класса classpath – classpath input? – имя файла для stdin output? – имя файла для stdout Вложенные элементы: arg Пример <java classname="test.Main" classpath="classes.jar“>

Java Advanced / Описание и проверка структуры XML

Аргументы командной строки

Элемент arg Атрибуты value? – значение аргумента file? – имя файла path? – путь line? – аргумента разделенные пробелами Примеры <arg value="-h"/> <arg file="files.lst"/> <arg path="classes:lib/ant.jar"/>

Java Advanced / Описание и проверка структуры XML

Запуск программ

Задача exec – запускает произвольную программу Атрибуты executable – имя исполняемого файла dir? – имя рабочего каталога input? – имя файла для stdin output? – имя файла для stdout Вложенные элементы: arg Пример <exec dir="src" executable="cmd.exe" output="dir.txt"> <arg line="/c dir"/> </exec>

Java Advanced / Описание и проверка структуры XML

Цели

Часть 3

Цель (target)

Набор заданий, исполняемых последовательно Зависимости между целями Компиляция одного модуля зависит от другого Упаковка производится после компиляции и т.п. Условное выполнение Выполнение не всех действий Успешное / неуспешное завершение

Java Advanced / Описание и проверка структуры XML

Описание целей

Описываются XML-элементом target Атрибуты name – имя цели description? – описание цели Пример <target name="build" description="Строит приложение"> <javac ... /> <jar ... /> </target>

Java Advanced / Описание и проверка структуры XML

Зависимости между целями

Атрибут depends – список целей, от которых зависит данная, разделенных запятыми Примеры <target name="build" depends="init, compile, pack"> <echo message="Build competed"/> </target> <target name="build-module-C" depends="build-module-A, build-module-B"> ... </target>

Java Advanced / Описание и проверка структуры XML

Условное выполнение

Атрибут if – цель выполняется если указанное свойство установлено Атрибут unless – цель выполняется если указанное свойство НЕ установлено Пример <target name="build-module-C" depends="build-module-A, build-module-B"> <target name="build-module-C-from-A" if="module-A-present"> <target name="build-module-C-from-scratch« unless="module-A-present"> <target name="build-module-C" depends="build-module-C-from-A, build-module-C-from-scratch">

Java Advanced / Описание и проверка структуры XML

Проекты

Часть 4

Проект

Набор целей и задач При запуске выполняются все задачи выполняется одна или несколько целей Успешное / неуспешное завершение

Java Advanced / Описание и проверка структуры XML

Описание проекта

Описываются XML-элементом project Атрибуты name? – имя проекта default? – имя цели по умолчанию basedir? – базовая директория Пример <project name="MyFirstProject" default="all" basedir="."> ... </project>

Java Advanced / Описание и проверка структуры XML

Запуск Ant

Из командной строки ant <опции> <цели> Из Java java org.apache.tools.ant.Main [опции] [цели] java org.apache.tools.ant.launch.Launcher [опции] [цели]

Java Advanced / Описание и проверка структуры XML

Опции Ant

Основные опции

Основные опции

-lib

Где искать библиотеки

-buildfile

Имя build-файла

-noclasspath

Игнорировать classpath

Информация об Ant

Информация об Ant

-help

Помощь по опциям

-version

Версия Ant

Выводимая информация

Выводимая информация

-quiet

Мало информации

-verbose

Много информации

-debug

Отладочная информация

Java Advanced / Описание и проверка структуры XML

Организация build-файла

Основной файл – обычно build.xml Вспомогательные файлы подключаются элементом import Атрибут file – имя файла Атрибут optional – обязателен ли

Java Advanced / Описание и проверка структуры XML

Свойства

Часть 5

Свойства

Набор пар имя-значение Свойства могут использоваться в атрибутах-аргументах задач Пример использования свойств <javac srcdir="${project.dir}/sources" destdir=" ${project.dir}/classes" />

Java Advanced / Описание и проверка структуры XML

Встроенные свойства

Свойства задаваемые Ant

Свойства задаваемые Ant

basedir

Полный путь к базовой директории проекта

ant.file

Полный путь к build-файлу

ant.version

Полный

project.name

Имя проекта

ant.java.version

Версия Java

Свойства задаваемые Java

Свойства задаваемые Java

java.home

Путь к директории Java

java.class.path

Classpath

os.name

Название операционной системы

os.version

Версия операционной системы

user.home

Домашний каталог пользователя

user.dir

Текущий каталог

Java Advanced / Описание и проверка структуры XML

Установка свойств

Задание property устанавливает значение свойства Атрибуты name – имя свойства value? – значение свойства location? – путь к файлу или каталогу Примеры <property name="module-A-present" value=""/> <property name="project.dir" location="project"/> <property name="source.dir" location="${project.dir}/source"/>

Java Advanced / Описание и проверка структуры XML

Загрузка свойств

Задание property загружает свойства из .property файла Атрибуты file? – путь к файлу url? – URL файла resource? – путь к ресурсу Примеры <property file="build.properties"/> <property url="file:///./project.properties"/> <property resource="resources/project.properties"/>

Java Advanced / Описание и проверка структуры XML

Пример

property-файла

build.compiler=jikes deploy.server=lucky deploy.port=8080 deploy.url=http://${deploy.server}:${deploy.port}/

Java Advanced / Описание и проверка структуры XML

Проверка наличия файла

Задание available устанавливает свойство если файл/ресурс доступен Атрибуты property – имя свойства file? – имя файла resource? – имя ресурса type? – тип (file или dir) value? – устанавливаемое значение Пример <avalilable property="module-A-present" file="lib/module-a.jar"/>

Java Advanced / Описание и проверка структуры XML

Задание tstamp

Задание tstamp Устанавливает свойства переменные DSTAMP и TSTAMP и время запуска для других программ Установленные значения применяются другими заданиями Пример tstamp

Java Advanced / Описание и проверка структуры XML

Проверка изменения файлов

Задание uptodate устанавливает свойство если файл/ресурс доступен Атрибуты property – имя свойства srcfile – имя проверяемого файла targetfile – имя файла с которым сравнивают value? – устанавливаемое значение Пример <uptodate property="module-A-ok" srcfile="ModuleA.java" targetfile="module-a.jar"/>

Java Advanced / Описание и проверка структуры XML

Заключение

Часть 6

Ссылки

Ant Homepage // http://ant.apache.org Ant Manual // http://ant.apache.org/manual/index.html Overview of Ant tasks // http://ant.apache.org/manual/tasksoverview.html

Java Advanced / Описание и проверка структуры XML

Вопросы

Java Advanced / Описание и проверка структуры XML