Package com._1c.g5.v8.dt.export

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:

OrdinaryDirectoryBuilder, ZipArchiveBuilder

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.
OutputStream	newOutputStream(Path path)	Creates an output stream for writing a file inside the artifact.

Methods inherited from interface java.io.Closeable

close

Method Detail

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.