Files.write: примеры (JAVA)

Короткие примеры с результатами

Примеры демонстрируют основные варианты: запись байтов, запись строк, добавление, использование CREATE_NEW и writeString.

1) Простая запись байтов (перезапись файла)

import java.nio.file.*;
import java.io.IOException;

Path p = Paths.get("out.bin");
try {
    Files.write(p, new byte[]{1,2,3,4});
    System.out.println("OK");
} catch (IOException e) {
    e.printStackTrace();
}

Результат: файл out.bin создан/перезаписан, содержимое в шестнадцатеричной форме: 01 02 03 04
Вывод: OK

2) Запись списка строк с указанием кодировки

import java.nio.file.*;
import java.nio.charset.StandardCharsets;
import java.util.List;

Path p = Paths.get("text.txt");
List<String> lines = List.of("Первая строка","Вторая строка");
Files.write(p, lines, StandardCharsets.UTF_8);

Результат: text.txt содержит две строки в кодировке UTF-8

3) Добавление в файл (append)

Path p = Paths.get("text.txt");
Files.writeString(p, "\nДобавлено\n", java.nio.file.StandardOpenOption.APPEND);

Результат: к text.txt добавлена новая строка

4) Попытка создать файл только если его нет (CREATE_NEW) - пример ошибки

Path p = Paths.get("text.txt");
try {
    Files.writeString(p, "data", StandardOpenOption.CREATE_NEW);
} catch (IOException e) {
    e.printStackTrace();
}

Если файл text.txt уже существует, то выбрасывается java.nio.file.FileAlreadyExistsException с трассировкой

Похожие варианты в Java

• Files.writeString (Java 11+) - более удобная перегрузка для записи текста напрямую; автоматически использует кодировку при указании Charset; предпочтительна для простого текста.
• Files.newBufferedWriter - возвращает BufferedWriter; предпочтительна при поэтапной записи больших текстовых данных для уменьшения использования памяти.
• Files.newOutputStream / FileOutputStream - потоковый API; удобнее при побайтовой или потоковой записи больших объёмов, когда не нужно сначала собирать весь byte[].
• FileChannel / FileChannel#write - полезен при позиционной записи, работе с mmap или при необходимости блокировок/ручного управления позициями.
• Files.copy - копирование данных в файл из другого потока или файла; в задачах, где источник уже представлен как InputStream или Path, может быть эффективнее.

Выбор зависит от объема данных и требований: для простых записей и небольших буферов Files.write удобна, для больших потоковых данных - newOutputStream или buffered writer/stream, для позиционной записи и блокировок - FileChannel.

Аналоги в других языках

• PHP: file_put_contents - простой способ записать данные, флаги FILE_APPEND, LOCK_EX. Пример:

  file_put_contents('a.txt', "hello\n", FILE_APPEND | LOCK_EX);

  Результат: a.txt содержит добавленную строку

• JavaScript (Node.js): модуль fs, функции fs.writeFileSync и fs.appendFileSync. Пример:

  const fs = require('fs');
  fs.writeFileSync('a.txt', 'hello\n', { encoding: 'utf8' });

  Результат: a.txt перезаписан текстом 'hello'

• Python: встроенная функция open + write; также pathlib.Path.write_text / write_bytes.

  from pathlib import Path
  Path('a.txt').write_text('hello\n', encoding='utf-8')

  Результат: a.txt содержит 'hello'

• SQL: прямой аналог записи файла отсутствует, но в СУБД используются BLOB/LOB API или команды COPY для импорта/экспорта файлов; операции зависят от СУБД.
• C#: System.IO.File.WriteAllText / WriteAllBytes / AppendAllText. Пример:

  System.IO.File.WriteAllText("a.txt", "hello\n", System.Text.Encoding.UTF8);

  Результат: файл 'a.txt' создан/перезаписан

• Lua: io.open + :write + :close. Пример:

  local f = io.open('a.txt','w')
  f:write('hello\n')
  f:close()

  Результат: a.txt содержит 'hello'

• Golang: os.WriteFile или io.Writer через os.OpenFile. Пример:

  import "os"
  
  os.WriteFile("a.txt", []byte("hello\n"), 0644)

  Результат: a.txt создан с правами 0644

• Kotlin: использует те же API JVM; имеется удобный extension Path.writeText / writeBytes. Пример:

  import java.nio.file.Path
  
  Path.of("a.txt").writeText("hello\n")

  Результат: a.txt создан/перезаписан

Отличия от Java: в большинстве языков запись выполняется синхронно и тоже может бросать ошибки; у Java есть богатый набор опций OpenOption и тесная интеграция с файловой системой через NIO, что даёт более тонкий контроль над поведением и атрибутами файлов.

Типичные ошибки и их проявления

• FileAlreadyExistsException - возникает при использовании StandardOpenOption.CREATE_NEW если файл уже существует.

  Path p = Paths.get("exists.txt");
  Files.writeString(p, "x", StandardOpenOption.CREATE_NEW);

  java.nio.file.FileAlreadyExistsException: exists.txt
      at ...

• NoSuchFileException - когда родительские каталоги отсутствуют и опция создания директории не использована. Пример:

  Path p = Paths.get("nonexistent_dir/out.txt");
  Files.writeString(p, "x");

  java.nio.file.NoSuchFileException: nonexistent_dir/out.txt
      at ...

• AccessDeniedException / SecurityException - недостаточно прав на запись. Проявляется в стеке как IOException (AccessDeniedException).
• OutOfMemoryError или проблемы с памятью - при передаче очень большого byte[] или большой коллекции строк, т.к. Files.write часто требует полностью сформировать данные в памяти; для больших объёмов следует использовать потоковый API.
• UnsupportedOperationException - некоторые опции могут быть не поддержаны конкретной файловой системой (например SPARSE не поддерживается everywhere).
• Проблемы кодировки - при записи текста без указания Charset может использоваться платформа-зависимая кодировка, что приводит к несовпадению ожидаемых символов.

Изменения и история API

• Java 7: появление NIO.2 и методов в классе Files, включая первые перегрузки Files.write для byte[] и Iterable<CharSequence>.
• Java 11: добавлен удобный метод Files.writeString для прямой записи CharSequence с перегрузками, принимающими Charset и OpenOption; упрощается запись текста без явного преобразования в байты.
• Дальнейшие релизы Java не вносили крупных изменений в поведение Files.write; улучшения в работе с файловыми системами происходят на уровне платформы и реализации JVM.

Расширенные и редкие варианты применения

1) Атомарическая запись: запись во временный файл с последующим перемещением atomically

import java.nio.file.*;
import java.nio.file.attribute.FileAttribute;
import java.io.IOException;

Path target = Paths.get("atomic.txt");
Path temp = Files.createTempFile(target.getParent(), "tmp", ".tmp");
try {
    Files.writeString(temp, "новые данные\n");
    Files.move(temp, target, StandardCopyOption.ATOMIC_MOVE, StandardCopyOption.REPLACE_EXISTING);
} catch (IOException e) {
    e.printStackTrace();
} finally {
    // temp будет удалён, если остался
    Files.deleteIfExists(temp);
}

Результат: содержимое atomic.txt заменено атомарно; при сбое до move целевой файл остаётся неизменным

2) Запись с установкой POSIX прав (Unix-like)

import java.nio.file.*;
import java.nio.file.attribute.PosixFilePermissions;
import java.util.Set;

Path p = Paths.get("secure.txt");
Files.writeString(p, "секрет\n");
Set<java.nio.file.attribute.PosixFilePermission> perms = PosixFilePermissions.fromString("rw-r-----");
Files.setPosixFilePermissions(p, perms);

Результат: файл secure.txt создан и получает права rw-r----- (на POSIX-системе)

3) Запись большого потока данных без накопления в памяти

import java.nio.file.*;
import java.io.OutputStream;
import java.io.IOException;

Path p = Paths.get("big.bin");
try (OutputStream os = Files.newOutputStream(p, StandardOpenOption.CREATE, StandardOpenOption.WRITE)) {
    byte[] buf = new byte[8192];
    for (int i = 0; i < 100000; i++) {
        // генерировать/получать кусок данных
        os.write(buf);
    }
}

Результат: big.bin записан по частям без выделения всего объёма в памяти

4) Параллельное добавление в файл с блокировками

import java.nio.channels.FileChannel;
import java.nio.file.*;
import java.nio.ByteBuffer;

Path p = Paths.get("append.log");
try (FileChannel ch = FileChannel.open(p, StandardOpenOption.CREATE, StandardOpenOption.WRITE, StandardOpenOption.APPEND)) {
    ch.lock(); // блокировка на уровне канала
    ByteBuffer b = ByteBuffer.wrap("entry\n".getBytes());
    ch.write(b);
}

Результат: в append.log добавлена строка; блокировка предотвращает одновременную порчу данных при конкурентных записях

5) Запись с требованием синхронизации на диск

Path p = Paths.get("sync.txt");
Files.writeString(p, "важно\n", StandardOpenOption.CREATE, StandardOpenOption.SYNC);

Результат: запись выполнена с опцией SYNC; физическая запись на диск ожидается до возврата метода (платформозависимо)

6) Запись с компрессией (gzip) без промежуточных файлов

import java.nio.file.*;
import java.util.zip.GZIPOutputStream;
import java.io.OutputStream;

Path p = Paths.get("data.gz");
try (OutputStream os = new GZIPOutputStream(Files.newOutputStream(p, StandardOpenOption.CREATE, StandardOpenOption.TRUNCATE_EXISTING))) {
    os.write("сжатые данные\n".getBytes(java.nio.charset.StandardCharsets.UTF_8));
}

Результат: файл data.gz содержит GZIP-поток с заданными данными

Комментарий: многие из продвинутых вариантов требуют управления потоками и опциями explicitly, чтобы избежать полной помехи в памяти, обеспечить атомарность или выставить права и синхронизацию. Для кросс-платформенных сценариев следует учитывать поддерживаемые OpenOption на целевой файловой системе.