Interface IExportArtifactBuilder

All Superinterfaces:
AutoCloseable, Closeable
All Known Implementing Classes:
OrdinaryDirectoryBuilder, ZipArchiveBuilder

public interface IExportArtifactBuilder extends Closeable
Builds export artifact. Export artifact is an abstraction for directory-like structures. Actual artifact can be an ordinary directory or an archive file residing on the local file system as well as some in-memory data structure.

Implementations must be thread-safe.

Method close must be invoked after building is completed.

See Also:
  • Method Summary

    Modifier and Type
    Method
    Description
    void
    copy(Path sourcePath, Path targetPath)
    Copies a file or directory residing on the local file system into the artifact.
    Creates an output stream for writing a file inside the artifact.

    Methods inherited from interface java.io.Closeable

    close
  • Method Details

    • newOutputStream

      OutputStream newOutputStream(Path path) throws IOException
      Creates an output stream for writing a file inside the artifact. All nonexistent directories are created automatically. The returned stream does not need wrapping into BufferedOutputStream. If the given path already exists, the behavior of this method is not defined.
      Parameters:
      path - The path to the file inside the artifact. May not be null.
      Returns:
      a new output stream. Never null.
      Throws:
      IOException - if any I/O error occurs.
    • copy

      void copy(Path sourcePath, Path targetPath) throws IOException
      Copies a file or directory residing on the local file system into the artifact. All nonexistent directories are created automatically. If the given target path already exists, the behavior of this method is not defined.
      Parameters:
      sourcePath - The path of the source file or directory residing on the local file system. May not be null.
      targetPath - The path of the target file or directory inside the artifact. May not be null.
      Throws:
      IOException - if any I/O error occurs.