Эквивалент Guava для IOUtils.toString (InputStream)

Apache Commons IO имеет удобный удобный метод IOUtils.toString () для чтения InputStreamстроки в строку.

Поскольку я пытаюсь перейти от Apache Commons к Guava : есть ли эквивалент в Guava? Я просмотрел все классы в com.google.common.ioпакете и не нашел ничего более простого.

Изменить: я понимаю и ценю проблемы с кодировками. Так уж случилось, что я знаю, что все мои источники находятся в ASCII (да, ASCII, а не ANSI и т. Д.), Поэтому в этом случае кодировка для меня не проблема.

В своем комментарии к ответу Калума вы заявили, что собираетесь использовать

CharStreams.toString(new InputStreamReader(supplier.get(), Charsets.UTF_8))

Этот код проблематичен, поскольку в перегрузке CharStreams.toString(Readable)указано:

Не закрывает Readable.

Это означает, что ваш InputStreamReaderи, соответственно, InputStreamвозвращаемый supplier.get(), не будут закрыты после завершения этого кода.

Если, с другой стороны, вы воспользуетесь тем фактом, что у вас уже есть InputSupplier<InputStream>и используется перегрузка CharStreams.toString(InputSupplier<R extends Readable & Closeable>), toStringметод будет обрабатывать как создание, так и закрытие Readerдля вас.

Это именно то, что предложил Джон Скит, за исключением того, что на самом деле нет никакой перегрузки, CharStreams.newReaderSupplierкоторая принимает в InputStreamкачестве входных данных ... вы должны дать ему InputSupplier:

InputSupplier<? extends InputStream> supplier = ...
InputSupplier<InputStreamReader> readerSupplier = 
    CharStreams.newReaderSupplier(supplier, Charsets.UTF_8);

// InputStream and Reader are both created and closed in this single call
String text = CharStreams.toString(readerSupplier);

Смысл в InputSupplierтом, чтобы упростить вашу жизнь, позволив Guava обрабатывать части, требующие уродливого try-finallyблока, чтобы гарантировать правильное закрытие ресурсов.

Изменить: Лично я нахожу следующее (именно так я бы написал это, просто нарушил шаги в приведенном выше коде)

String text = CharStreams.toString(
    CharStreams.newReaderSupplier(supplier, Charsets.UTF_8));

быть гораздо менее подробным, чем это:

String text;
InputStreamReader reader = new InputStreamReader(supplier.get(), 
    Charsets.UTF_8);
boolean threw = true;
try {
  text = CharStreams.toString(reader);
  threw = false;
}
finally {
  Closeables.close(reader, threw);
}

Это более или менее то, что вам нужно было бы написать, чтобы справиться с этим самостоятельно.

Изменить: февраль 2014 г.

InputSupplierи OutputSupplierметоды, которые их используют, устарели в Guava 16.0. Их замены являются ByteSource, CharSource, ByteSinkи CharSink. Учитывая a ByteSource, теперь вы можете получить его содержимое Stringследующим образом:

ByteSource source = ...
String text = source.asCharSource(Charsets.UTF_8).read();

Если у вас есть, Readableвы можете использовать CharStreams.toString(Readable). Итак, вы, вероятно, можете сделать следующее:

String string = CharStreams.toString( new InputStreamReader( inputStream, "UTF-8" ) );

Заставляет вас указать набор символов, что, я думаю, вам все равно следует делать.

ОБНОВЛЕНИЕ : оглядываясь назад, мне не нравится мое старое решение. Кроме того, сейчас 2013 год, и теперь для Java7 доступны лучшие альтернативы. Итак, вот что я использую сейчас:

InputStream fis = ...;
String text;
try (  InputStreamReader reader = new InputStreamReader(fis, Charsets.UTF_8)){
        text = CharStreams.toString(reader);
}

или если с InputSupplier

InputSupplier<InputStreamReader> spl = ...
try (  InputStreamReader reader = spl.getInput()){
        text = CharStreams.toString(reader);
    }

Почти. Вы можете использовать что-то вроде этого:

InputSupplier<InputStreamReader> readerSupplier = CharStreams.newReaderSupplier
    (streamSupplier, Charsets.UTF_8);
String text = CharStreams.toString(readerSupplier);

Лично я не думаю, что IOUtils.toString(InputStream)это "хорошо" - потому что он всегда использует кодировку платформы по умолчанию, что почти никогда не бывает тем, что вам нужно. Есть перегрузка, которая принимает имя кодировки, но использование имен - не лучшая идея, ИМО. Вот почему мне нравится Charsets.*.

РЕДАКТИРОВАТЬ: Не то, чтобы вышеупомянутое нуждается InputSupplier<InputStream>в streamSupplier. Если у вас уже есть поток, вы можете легко реализовать его:

InputSupplier<InputStream> supplier = new InputSupplier<InputStream>() {
    @Override public InputStream getInput() {
        return stream;
    }
};

Другой вариант - прочитать байты из Stream и создать из них String:

new String(ByteStreams.toByteArray(inputStream))
new String(ByteStreams.toByteArray(inputStream), Charsets.UTF_8)

Это не «чистая» гуава, но она немного короче.

Основываясь на принятом ответе, вот служебный метод, который имитирует поведение IOUtils.toString()(а также перегруженную версию с кодировкой). Эта версия должна быть безопасной, правда?

public static String toString(final InputStream is) throws IOException{
    return toString(is, Charsets.UTF_8);
}


public static String toString(final InputStream is, final Charset cs)
throws IOException{
    Closeable closeMe = is;
    try{
        final InputStreamReader isr = new InputStreamReader(is, cs);
        closeMe = isr;
        return CharStreams.toString(isr);
    } finally{
        Closeables.closeQuietly(closeMe);
    }
}

Существует гораздо более короткое решение для автоматического закрытия в случае, когда входной поток поступает из ресурса пути к классам:

URL resource = classLoader.getResource(path);
byte[] bytes = Resources.toByteArray(resource);
String text = Resources.toString(resource, StandardCharsets.UTF_8);

Использует ресурсы Guava , вдохновленные IOExplained .

РЕДАКТИРОВАТЬ (2015): Okio - лучшая абстракция и инструменты для ввода-вывода на Java / Android, о которых я знаю. Я использую это все время.

FWIW вот что я использую.

Если у меня уже есть поток на руках, то:

final InputStream stream; // this is received from somewhere
String s = CharStreams.toString(CharStreams.newReaderSupplier(new InputSupplier<InputStream>() {
    public InputStream getInput() throws IOException {
        return stream;
    }
}, Charsets.UTF_8));

Если я создаю поток:

String s = CharStreams.toString(CharStreams.newReaderSupplier(new InputSupplier<InputStream>() {
    public InputStream getInput() throws IOException {
        return <expression creating the stream>;
    }
}, Charsets.UTF_8));

В качестве конкретного примера я могу прочитать ресурс текстового файла Android следующим образом:

final Context context = ...;
String s = CharStreams.toString(CharStreams.newReaderSupplier(new InputSupplier<InputStream>() {
    public InputStream getInput() throws IOException {
        return context.getAssets().open("my_asset.txt");
    }
}, Charsets.UTF_8));

В качестве конкретного примера, вот как я могу прочитать ресурс текстового файла Android:

public static String getAssetContent(Context context, String file) {
    InputStreamReader reader = null;
    InputStream stream = null;
    String output = "";

    try {
        stream = context.getAssets().open(file);
        reader = new InputStreamReader(stream, Charsets.UTF_8);
        output = CharStreams.toString(reader);
    } catch (IOException e) {
        e.printStackTrace();
    } finally {
        if (stream != null) {
            try {
                stream.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }

        if (reader != null) {
            try {
                reader.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }

    return output;
}