Property Detail

• static final java.nio.charset.Charset DEFAULT_CHARSET

  The default character set, UTF-8.

• static final java.lang.String DEFAULT_DIFF_EXTENSION

  The patching logic looks for files with the .diff extension by default.

• org.slf4j.Logger log

Constructor Detail

• Patcher(org.slf4j.Logger log)

Method Detail

• void apply(java.io.File patch, java.io.File content, java.io.File destination)

  Applies the parameter patch(es) to the parameter file(s).

  Parameters:

  patch - The patch file to apply

  content - The content to apply the patch to

  destination - The destination to write to

• java.util.List<java.lang.String> apply(java.io.File patchOrPatches, java.io.File fileOrFiles, java.lang.String diffExtension, java.nio.charset.Charset charset, java.io.File destinationDir)

  Applies one or more patches to one or more files.

  If no patch or patch directory is provided, nothing is done.

  If an empty patch directory is provided, everything under the content directory will be copied to the destination directory without modification.

  If a patch directory with a set of patches that match some of the files in the content directory is provided, then the patches will be applied, and the remaining files will be copied without modification.

  Parameters:

  patchOrPatches - A patch file or directory containing patch files

  fileOrFiles - A content file or directory containing content files

  diffExtension - The file extension that identifies the patch files

  charset - The character set in use, defaults to UTF-8

  destinatinDir - The directory to write to

  Returns:

  A list of errors, or an empty list if patching succeeded

• java.util.List<java.lang.String> applyDirectory(java.io.File patchDir, java.io.File contentDir, java.lang.String diffExtension, java.nio.charset.Charset charset, java.io.File destinationDir)

  Applies a directory of patches to a directory of content.

  Parameters:

  patchDir - A directory containing patch files

  contentDir - A content directory

  diffExtension - The file extension that identifies the patch files

  charset - The character set in use, defaults to UTF-8

  destinationDir - The directory to write to

  Returns:

  A list of errors, empty if patching succeeded

• java.util.List<java.lang.String> applyFile(java.io.File patchFile, java.io.File contentFile, java.nio.charset.Charset charset, java.io.File destinationFile, java.util.List<java.lang.String> errors)

  Applies a patch file to a content file.

  Parameters:

  patchFile - A patch file

  contentFile - A content file

  charset - The character set in use, defaults to UTF-8

  destinationFile - The file to write to

  errors - An error list to add to if patching fails

  Returns:

  The parameter list of errors, unmodified if patching succeeded

• java.io.File applyOrThrow(java.io.File patchFile, java.io.File contentFile, java.io.File destinationFile)

  Applies a patch file to a content file.

  Parameters:

  patchFile - A patch file

  contentFile - A content file

  destinationFile - The file to write to

  Returns:

  The destination file

• java.io.File applyOrThrow(java.io.File patchFile, java.io.File contentFile, java.nio.charset.Charset charset, java.io.File destinationFile)

  Applies a patch file to a content file and produces a destination file.

  Parameters:

  patchFile - A patch file

  contentFile - A content file

  charset - The character set in use, defaults to UTF-8

  destinationFile - The output file to write to

  Returns:

  The destination file

• java.util.List<java.lang.String> applyOrThrow(java.util.List<java.lang.String> patchLines, java.util.List<java.lang.String> contentLines)