X-Git-Url: http://www2.svjatoslav.eu/gitweb/?a=blobdiff_plain;f=src%2Fmain%2Fjava%2Feu%2Fsvjatoslav%2Fcommons%2Ffile%2FIOHelper.java;h=e7ee659e8b729acb282fe14821e79691487c7176;hb=846af2def5b489670668b978e4ea703c8dfb22b6;hp=5b4e634656fcb649dbc40952292c7a1c90762a76;hpb=30d5a74b04947e845e4b8f4ae3220452d5b1de2c;p=svjatoslav_commons.git diff --git a/src/main/java/eu/svjatoslav/commons/file/IOHelper.java b/src/main/java/eu/svjatoslav/commons/file/IOHelper.java old mode 100644 new mode 100755 index 5b4e634..e7ee659 --- a/src/main/java/eu/svjatoslav/commons/file/IOHelper.java +++ b/src/main/java/eu/svjatoslav/commons/file/IOHelper.java @@ -1,10 +1,10 @@ /* * Svjatoslav Commons - shared library of common functionality. - * Copyright ©2012-2013, Svjatoslav Agejenko, svjatoslav@svjatoslav.eu - * + * Copyright ©2012-2014, Svjatoslav Agejenko, svjatoslav@svjatoslav.eu + * * This program is free software; you can redistribute it and/or - * modify it under the terms of version 2 of the GNU General Public License - * as published by the Free Software Foundation. + * modify it under the terms of version 3 of the GNU Lesser General Public License + * or later as published by the Free Software Foundation. */ package eu.svjatoslav.commons.file; @@ -14,11 +14,18 @@ import java.io.FileInputStream; import java.io.FileNotFoundException; import java.io.FileOutputStream; import java.io.IOException; +import java.io.UnsupportedEncodingException; public class IOHelper { /** * Deletes files and directories recursively. WARNING!!! Follows symlinks!!! + * + * @param file + * directory to delete with entire contents. + * + * @throws IOException + * if filesystem error happens */ public static void deleteRecursively(final File file) throws IOException { if (file.isDirectory()) { @@ -49,12 +56,30 @@ public class IOHelper { return result; } + public static String getFileContentsAsString(final File file) + throws FileNotFoundException, IOException { + try { + return new String(getFileContents(file), "UTF-8"); + } catch (final UnsupportedEncodingException exception) { + throw new RuntimeException(exception); + } + } + /** * Compares new file content with old file content. If content in equal, * then leaves file as-is. If content differs, then overrides file with the * new content. - * + * + * @param file + * file to potentially overwrite + * @param newContent + * new content * @return true if file was overwritten. + * + * @throws FileNotFoundException + * if file is not found. + * @throws IOException + * if error happens during file IO. */ public static boolean overwriteFileIfContentDiffers(final File file, final byte[] newContent) throws FileNotFoundException, IOException {