Java İle Dosya Okuma Ve Yazma İşlemi Nasıl Yapılır?

Ön Hazırlık ve Gereksinimler

Java ile dosya işlemleri yapabilmek için bilgisayarınızda en az JDK 11 veya 21 gibi güncel bir Java Geliştirme Kiti (JDK) kurulu olmalıdır. Ayrıca, kodlarınızı derlemek ve çalıştırmak için IntelliJ IDEA, Eclipse veya VS Code gibi bir IDE (Tümleşik Geliştirme Ortamı) kullanmanız önerilir.

• JDK Sürümü: JDK 17 veya 21 (Uzun süreli destek sürümleri).
• Kütüphane: Java'nın standart kütüphanesi olan java.nio.file paketi.
• İşletim Sistemi: Windows, Linux veya macOS üzerinde aynı kod yapısı çalışacaktır.

Modern Java Dosya Yazma Yöntemi: Files.writeString

Java 11 ile gelen Files.writeString metodu, metin tabanlı dosyaları tek satırda yazmak için kullanılan en pratik yöntemdir. Bu yöntem, dosya mevcut değilse oluşturur, mevcutsa içeriğini varsayılan olarak üzerine yazar.

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.io.IOException;

public class DosyaYazmaOrnegi {
    public static void main(String[] args) {
        Path yol = Paths.get("ornek.txt");
        String icerik = "Java ile dosya yazma işlemi oldukça kolaydır.";
        try {
            Files.writeString(yol, icerik);
            System.out.println("Dosya başarıyla yazıldı.");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

Yukarıdaki kod, projenizin bulunduğu dizinde "ornek.txt" adında bir dosya oluşturur ve içine belirtilen metni yazar. IOException kullanımı, dosya sistemindeki olası kilitlenmeleri veya izin hatalarını yakalamak için zorunludur.

Java İle Dosya Okuma: Files.readString Adımları

Dosyayı okumak, yazmaktan daha hassas bir işlemdir çünkü dosyanın varlığını kontrol etmeniz gerekir. Files.readString metodu, dosya içeriğini tek bir String nesnesi olarak belleğe yükler. Küçük ve orta ölçekli dosyalar için idealdir.

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.io.IOException;

public class DosyaOkumaOrnegi {
    public static void main(String[] args) {
        Path yol = Paths.get("ornek.txt");
        try {
            String icerik = Files.readString(yol);
            System.out.println("Dosya içeriği: " + icerik);
        } catch (IOException e) {
            System.err.println("Dosya okunamadı: " + e.getMessage());
        }
    }
}

Bu yöntem, dosya içeriğini okur ve konsola yazdırır. Eğer dosya bulunamazsa NoSuchFileException fırlatılır; bu nedenle hata yönetimi (try-catch) burada kritik bir rol oynar.

Büyük Dosyalar İçin Satır Satır Okuma

Eğer çok büyük bir dosya (örneğin birkaç gigabaytlık bir log dosyası) okumanız gerekiyorsa, tüm içeriği belleğe yüklemek (readString) sistemin çökmesine (OutOfMemoryError) neden olabilir. Bu durumda Files.lines yöntemini kullanarak dosyayı akış (Stream) şeklinde satır satır okumalıyız.

import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.stream.Stream;

public class BuyukDosyaOkuma {
    public static void main(String[] args) {
        try (Stream satirlar = Files.lines(Paths.get("buyuk_dosya.txt"))) {
            satirlar.forEach(System.out::println);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

Burada kullanılan try-with-resources yapısı, dosya okuma işlemi bittiğinde kaynağın (dosya akışının) otomatik olarak kapatılmasını sağlar. Bu, bellek sızıntılarını önlemek için profesyonel bir yaklaşımdır.

Dosya İşlemlerinde Karşılaştırma Tablosu

Dosya İşlemlerinde Güvenlik ve Hata Yönetimi

Dikkat: Kullanıcıdan alınan dosya yollarını doğrudan kullanmak "Path Traversal" (Dizin Gezinme) saldırılarına kapı aralar. Dosya yollarını her zaman valide edin ve uygulamanın dışındaki kritik sistem dosyalarına erişimi engelleyin.

Dosya yazarken veya okurken oluşabilecek en yaygın hata, dosyanın başka bir program tarafından kilitlenmiş olmasıdır. Ayrıca, dosya izinleri (Read/Write permissions) işletim sistemi seviyesinde kontrol edilmelidir.

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.StandardOpenOption;

public class DosyayaEklemeYapma {
    public static void main(String[] args) {
        Path yol = Path.of("log.txt");
        String yeniSatir = "Yeni log kaydı eklendi.\n";
        try {
            Files.writeString(yol, yeniSatir, StandardOpenOption.CREATE, StandardOpenOption.APPEND);
        } catch (IOException e) {
            System.err.println("Dosyaya yazılamadı: " + e.getMessage());
        }
    }
}

StandardOpenOption.APPEND parametresi, dosyanın üzerine yazmak yerine içeriğin sonuna ekleme yapmanızı sağlar. Bu, loglama sistemleri için en doğru yöntemdir.

Sıkça Sorulan Sorular

Java'da dosya var mı nasıl kontrol edilir?

Files.exists(Path) metodunu kullanarak bir dosyanın veya dizinin var olup olmadığını kolayca kontrol edebilirsiniz.

Dosya okurken karakter kodlaması (Encoding) nasıl ayarlanır?

Java'nın modern Files metotları varsayılan olarak UTF-8 kullanır. Ancak StandardCharsets.ISO_8859_1 gibi farklı bir kodlama belirtmek isterseniz, metodun parametrelerine bunu ekleyebilirsiniz.

Dosya silme işlemi nasıl yapılır?

Files.delete(Path) metodu ile bir dosyayı silebilirsiniz. Eğer dosya yoksa NoSuchFileException fırlatılır, bu yüzden silmeden önce exists kontrolü yapmak iyi bir pratiktir.

Dosya izinleri nasıl değiştirilir?

Files.setPosixFilePermissions(Path, Set) kullanarak Linux/Unix sistemlerinde dosya okuma, yazma ve çalıştırma izinlerini programatik olarak değiştirebilirsiniz.

Neden java.io yerine java.nio kullanmalıyım?

java.nio daha modern hata yönetimi sunar, dosya sistemi özelliklerine (sembolik linkler vb.) daha iyi erişim sağlar ve daha yüksek performanslıdır.

Dosya İşlemlerinde Performans Optimizasyonu ve Buffer Yönetimi

Küçük boyutlu dosyalar için Files.readString kullanımı pratik olsa da, gigabaytlarca veri içeren log dosyaları veya büyük veri setleri ile çalışırken bellek (RAM) yönetimi kritik bir hal alır. Java'da büyük dosyaları işlerken belleği tüketmemek için Buffered I/O mekanizmalarını kullanmak en iyi uygulamadır.

Aşağıdaki örnekte, BufferedReader kullanarak büyük bir dosyayı satır satır nasıl verimli bir şekilde işleyebileceğinizi görebilirsiniz:

import java.io.BufferedReader;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;

public class LargeFileProcessor {
    public static void processLargeFile(String filePath) {
        Path path = Paths.get(filePath);
        // try-with-resources kullanarak akışı otomatik kapatıyoruz
        try (BufferedReader reader = Files.newBufferedReader(path)) {
            String line;
            while ((line = reader.readLine()) != null) {
                // Her satırı burada işleyin
                if (line.contains("ERROR")) {
                    System.out.println("Hata tespit edildi: " + line);
                }
            }
        } catch (IOException e) {
            System.err.println("Dosya okuma hatası: " + e.getMessage());
        }
    }
}

Bu yaklaşımın avantajları şunlardır:

• Düşük Bellek Kullanımı: Dosyanın tamamı belleğe yüklenmez, sadece o an işlenen satır bellekte tutulur.
• Hız: BufferedReader, diskten okuma yaparken verileri gruplandırarak (buffer) sistem çağrısı sayısını azaltır.
• Güvenlik: try-with-resources yapısı, dosya işlemleri sırasında bir hata oluşsa bile dosya tanımlayıcısının (file descriptor) serbest bırakılmasını garanti eder.

Dosya İşlemlerinde Hata Ayıklama ve İleri Düzey İpuçları

Dosya sistemi işlemleri, dış dünyayla etkileşim kurduğu için her zaman "beklenmedik" durumlarla karşılaşmaya müsaittir. Uygulamanızın üretim ortamında kararlı çalışması için şu stratejileri uygulayın:

1. Atomik Dosya Yazma

Bir dosyayı güncellerken sistemin çökmesi durumunda dosyanın bozulmasını (corruption) önlemek için StandardCopyOption.ATOMIC_MOVE kullanabilirsiniz. Önce veriyi geçici bir dosyaya yazıp, ardından bu dosyayı hedef konuma atomik olarak taşımak en güvenli yöntemdir.

import java.nio.file.*;

public void safeWrite(Path target, byte[] data) throws IOException {
    Path tempFile = Files.createTempFile(target.getParent(), "tmp", ".tmp");
    Files.write(tempFile, data);
    Files.move(tempFile, target, StandardCopyOption.REPLACE_EXISTING, StandardCopyOption.ATOMIC_MOVE);
}

2. Dosya Sistemi Olaylarını İzleme (WatchService)

Eğer bir klasördeki değişiklikleri (yeni dosya eklenmesi, dosya silinmesi) anlık olarak takip etmeniz gerekiyorsa, java.nio.file.WatchService API'sini kullanmalısınız. Bu servis, işletim sistemi seviyesindeki olayları dinleyerek uygulamanızın dosya sistemiyle senkronize kalmasını sağlar.

Profesyonel İpucu: Dosya yollarını kod içerisinde sabit (hardcoded) olarak tanımlamak yerine, System.getProperty("user.home") veya uygulama yapılandırma dosyalarından (properties/yaml) dinamik olarak almayı tercih edin. Bu, uygulamanızın farklı işletim sistemlerinde (Windows, Linux, macOS) sorunsuz çalışmasını sağlar.

Sonuç

Java ile dosya okuma ve yazma işlemleri, modern NIO kütüphanesi ile oldukça güvenli ve yönetilebilir hale gelmiştir. Bu rehberde öğrendiğiniz Files.writeString, Files.readString ve Files.lines metotları, günlük yazılım geliştirme süreçlerinizin %90'ında ihtiyacınızı karşılayacaktır. Bir sonraki adım olarak, dosyaları JSON veya XML formatında nasıl yapılandırılmış bir şekilde saklayabileceğinizi (Serialization) araştırmanızı öneririm.

Yasal Uyarı: Bu rehberdeki kod örnekleri eğitim amaçlıdır. Üretim ortamında dosya işlemleri yaparken mutlaka giriş doğrulaması (input validation) yapmalı ve dosya sistemi izinlerini "en az yetki" prensibine göre ayarlamalısınız.