Утилита Make Directory Difference (MakeDirDiff)

English: MakeDirDiff Project Home

Введение

MakeDirDiff это консольная утилита для нахождения отличий между содержимым двух директорий и для сохранения всех новых/обновленных файлов в новой директории.

MakeDirDiff? сравнивает две директории и создает третью директорию со структурой первой директории, но лишь с новыми или обновленными файлами. Приложение может обновлять содержание второй директории, добавляя актуальные файлы из первой директории. При следующей загрузке MakeDirDiff? найдет и сохранит новые/обновленные файлы, которые появились в первой директории, в третью директорию.

Посмотрите на рисунок MakeDirDiff?.gif, и вы получите визуальное представление о потоке данных в MakeDirDiff?.

Это Apache Ant таск.

Я считаю, что программа очень полезна для создания инкрементного резервного копирования и для обновления больших веб-сайтов.

Как можно запустить утилиту Makedirdiff

Это простое java-приложение спроектированное как Апач ант-таск.

Утилита MakeDirDiff может быть

запущена из командной строки;
запущена как отдельный ант-таск;
использована как часть других ант-тасков; или
интегрирована в другие приложения в качестве java-библиотеки.

Системные требования

Устранение неполадок

Выполнение примера ант-таска

Мы запустим и проанализируем ант-таск пример располеженный в файле build.xml в каждом makeDirDiff-bin-1.x.zip дистрибутиве.

Загрузите архив makeDirDiff-bin-1.x.zip cо страницы Project Download.
Распакуйте содержимое архива в некую директорию.
Если вы не знакомы с запуском ант-тасков, просмотрите файл 'build.xml', он небольшой и прост для понимания, в противном случае, пропустите этот шаг.
Зайдите в директорию и запустите ант-скрипт в системной консоли. Таск "example" установлен таском по умолчанию и простое выполнение команды "ant", приведет к его запуску.
В результате вы увидите выходные данные и сообщение "BUILD SUCCESSFUL" (успешно собран). В таком случае наш пример MakeDirDiff работает хорошо. Этот таск-пример создает результирующую директорию и копирует туда все файлы из исходной директории. Также он сохраняет содержимое исходной директории в директорию-хранилище "previous".
Если вы не увидели сообщения "BUILD SUCCESSFUL" (успешно собран), значит что-то пошло не так. Посмотрите главу "Исправление неполадок", чтобы определить тип проблемы.
Вот и все! MakeDirDiff создал копии новых/обновленных файлов из исходной директории. Как вы понимаете при первом запуске директория-хранилище "previous" пуста и все файлы считаются новыми.
Попробуем теперь взяться за более сложную задачу. Удалите результирующую директорию и запустите ант-команду снова. Вы увидете, что результирующая директория создана снова, но на этот раз она пуста. Это объясняется тем, что в нее попадают только новые или обновленные файлы из исходной директории (а мы ничего не меняли там).
В заключение проведем эксперимент, показывающей основную функциональность MakeDirDiff. Добавим несколько файлов из директорий в исходную директорию и снова запустим ант-команду. Результирующая директория будет содержать все новые файлы и директории. Работает!

Запуск в качестве java-приложения

Параметры командной строки

MakeDirDiff требует три обязательных параметра:

<исходная директория данных>
<результирующая директория>
< директория-хранилище "previous" >

и необзятельные флаги. Местополжение флагов в строке выхова значения не имеет.

-cleanDestDir. Этот флаг заставляет программу очистить результурующую директорию перед началом работы.

Обратите внимание, что MakeDirDiff без параметров или с неправильным числом параметров будет выдавать текст подсказки.

Примеры вызова для MS Windows

java -cp *; org.grenader.makedirdiff.MakeDirDiff ./original ./result ./previous

Флаг -cleanDestDir может быть добавлен в вызов. Флаг -cleanDestDir заставляет программу очистить результурующую директорию перед началом работы.

Вы можете найти эту команду в файле makeDirDiff-Example.bat в архиве makeDirDiff-bin-1.x.zip

Примеры вызова для Unix

java -cp *: org.grenader.makedirdiff.MakeDirDiff ./original ./result ./previous

Вы сможете найти эту команду в файле makeDirDiff-Example.sh в архиве makeDirDiff-bin-1.x.zip

Текст ант-таска примера

Нижеприведенный ант-таск пример расположен в файле build.xml в каждом makeDirDiff-bin-1.x.zip дистрибутиве

 <!--   Основной пример использования ант-таска makeDirDiff   -->
    <target name="example">
        <!--  Определяет требуемые jar'ы  -->
        <path id="taskDependencies">
            <pathelement location="./ant.jar"/>
            <pathelement location="./jsCssMin-1.0.jar"/>
            <pathelement location="./makeDirDiff-1.4.jar"/>
        </path>

        <!--  Описывает ант-таск  -->
        <taskdef name="makeDirDiff" classname="org.grenader.makedirdiff.MakeDirDiff">
            <classpath refid="taskDependencies"/>
        </taskdef>

        <!--
        Выполните таск makeDirDiff
          "./original" - исходная директория данных. Задана как вложенный элемент fileset (набор файлов)
          "./result" - результирующая директория. Задана как destDir атрибут
          "./previous" - директория-хранилище "previuos". Задана как prevDir атрибут
          "cleanDestDir - true/false, необязательный атрибут. Если атрибут установлен в                     
                          true, то результирующая директория будет очищена перед там как   
                          makeDirDiff начнет копировать туда новые или измененые файлы.
        -->
        <makeDirDiff
                destDir="./result"
                prevDir="./previous">
            <fileset dir="./original"/>
        </makeDirDiff>
    </target>

Посмотрите на другие примеры вызова другие примеры вызова MakeDirDiff как ант-таска

Основные функции

Лицензия

MakeDirDiff выпущена под лицензией Apache Software License. Чтобы получить больше информации, см. LICENSE.txt.

Как внести свой вклад в развитие программы

Благодарности

Прежде всего хочу поблагодарить Дмитрия Соломадина за его смелость и сообразительность при придумывании имени для утилиты MakeDirDiff.

Ссылки

► Sign in to add a comment