Does Using PDDocument with try-with-resources guarantee that a file is fully written?

Question

If I have the following code:

try(PDDocument myDoc = new PDDocument()) {
  // add to myDoc in a giant loop so that the resulting file
  // would be quite large
  .
  .
  .
  myDoc.save("/some/file/path");
}

Once I'm outside of the try-with-resources block, am I guaranteed that the file located at some/file/path is fully written? I looked into the PDFBox source code but I couldn't get a confirmation.

Answer 1

If a pdf API contains an explicit save method, you can usually assume that it creates a complete pdf file representing the document state at the time you call that method.

If a pdf API early on accepts some OutputStream to continously write to, though, it requires some signal when to finalize the output; this signal usually is an explicit close call or an implicit closing by try-with-resources .

The pdfbox API is of the former type, so the save call already suffices. Nonetheless, it's a good idea to explicitly or implicitly close the document here, too, for proper resource handling.