Philip Crow

NAME

Java::Build - a family of modules which you can use instead of Ant

SYNOPSIS

    use Java::Build::JVM;  # access to the javac compiler in one jvm
    use Java::Build::Tasks;  # some helpful methods similar to Ant tasks

    my $source_files = build_file_list(
        BASE_DIR         => $some_path,
        INCLUDE_PATTERNS => [ qr/\.java$/ ],
    );
    my $dirty_sources = what_needs_compiling(
        SOURCE_FILE_LIST => $source_files,
    );
    if (@$dirty_sources) {
        my $compiler = Java::Ant::JVM->getCompiler();
        $compiler->destination($base_dir);
        $compiler->classpath($base_dir);
        $compiler->compile($dirty_sources);

        my $class_files = build_file_list(
                BASE_DIR         => $some_path,
                INCLUDE_PATTERNS => [ qr/\.class$/ ],
                EXCLUDE_PATTERNS => [ qr/Test/ ],
                EXCLUDE_DEFAULTS => 1,
                STRIP_BASE_DIR   => 1,
        );
        jar(
            JAR_FILE  => $jar_file_name,
            FILE_LIST => $class_files,
            BASE_DIR  => $some_path,
       );
    }

ABSTRACT

  This family of modules helped me move away from Ant to a proper scripting
  language, namely Perl.  With it you can use a single JVM for compiling
  your java programs.  It provides many useful methods to help you build
  lists of files, package them with jar etc.  Currently the modules are
  unix centric.  If you make them work elsewhere, please send in patches.

DESCRIPTION

With the modules in this distribution, you can aviod Ant. This gives you the following benefits:

  • Variables instead of properties.

  • Flow of control structures.

  • The ability to write functions.

  • Cleaner build files (you don't have to code in XML)

  • All the other benefits of Perl (CPAN, regexes, etc.)

EXPORT

build_file_list what_needs_compiling jar signjar

SEE ALSO

You will need to install recent versions of Inline and Inline::Java. See Java::Build::JVM and Java::Build::Tasks for more details about their methods.

REQUIRES

  Inline
  Inline::Java
  Carp;
  File::Find;
  Cwd;
  File::Temp;
  Exporter;

AUTHOR

Phil Crow, <philcrow2000@yahoo.com<gt>

COPYRIGHT AND LICENSE

Copyright 2003 by Phil Crow

This library is free software; you can redistribute it and/or modify it under the same terms as Perl 5.8.0 itself.