Bagian 4: Packaging dan Pengujian

import java.awt.GraphicsEnvironment;
import java.nio.file.Path;
import javax.swing.SwingUtilities;

/**
 * Titik masuk aplikasi Buku Kontak: memilih penyimpanan berkas,
 * memuat data, lalu membuka jendela utama pada Event Dispatch Thread.
 */
public class AplikasiKontak {

    public static void main(String[] args) {
        if (GraphicsEnvironment.isHeadless()) {
            System.out.println("Lingkungan tanpa layar terdeteksi; jendela tidak dapat dibuka.");
            System.out.println("Jalankan aplikasi ini pada komputer dengan tampilan grafis.");
            return;
        }
        SwingUtilities.invokeLater(AplikasiKontak::bukaJendela);
    }

    private static void bukaJendela() {
        DaftarKontak daftar;
        try {
            daftar = new DaftarKontak(new KontakDaoBerkas(Path.of("kontak.txt")));
        } catch (PersistensiGagalException e) {
            System.err.println("Gagal memuat penyimpanan: " + e.getMessage());
            daftar = new DaftarKontak();
        }
        new JendelaUtama(daftar).setVisible(true);
    }
}

import java.util.ArrayList;
import java.util.List;
import java.util.Locale;
import java.util.Optional;

/**
 * Logika inti aplikasi Buku Kontak: daftar kontak dengan validasi,
 * operasi CRUD, dan pencarian. Kelas ini tidak mengenal satu pun
 * kelas Swing sehingga bisa diuji tanpa layar.
 */
public class DaftarKontak {

    private final KontakDao dao;
    private final List<Kontak> kontak = new ArrayList<>();
    private int idBerikutnya = 1;

    /** Daftar kontak tanpa penyimpanan permanen (penyimpanan memori). */
    public DaftarKontak() {
        this.dao = new KontakDaoMemori();
    }

    /**
     * Daftar kontak yang dimuat dari penyimpanan dan menulis
     * kembali ke penyimpanan yang sama pada setiap perubahan.
     */
    public DaftarKontak(KontakDao dao) throws PersistensiGagalException {
        this.dao = dao;
        kontak.addAll(dao.muatSemua());
        for (Kontak k : kontak) {
            idBerikutnya = Math.max(idBerikutnya, k.id() + 1);
        }
    }

    /** Menambah kontak baru setelah seluruh field tervalidasi. */
    public Kontak tambah(String nama, String email, String telepon)
            throws KontakInvalidException, PersistensiGagalException {
        periksa(nama, email, telepon);
        periksaEmailBelumTerpakai(email, 0);

        Kontak baru = new Kontak(idBerikutnya,
                nama.strip(), email.strip(), telepon.strip());
        dao.tambah(baru);
        kontak.add(baru);
        idBerikutnya++;
        return baru;
    }

    /** Menimpa kontak berdasarkan id dengan nilai field yang baru. */
    public Kontak ubah(int id, String nama, String email, String telepon)
            throws KontakInvalidException, KontakTidakDitemukanException,
            PersistensiGagalException {
        periksa(nama, email, telepon);
        periksaEmailBelumTerpakai(email, id);

        int posisi = indeksDariId(id);
        if (posisi < 0) {
            throw new KontakTidakDitemukanException(id);
        }
        Kontak baru = new Kontak(id,
                nama.strip(), email.strip(), telepon.strip());
        dao.perbarui(baru);
        kontak.set(posisi, baru);
        return baru;
    }

    /** Menghapus kontak berdasarkan id dan mengembalikan kontaknya. */
    public Kontak hapus(int id)
            throws KontakTidakDitemukanException, PersistensiGagalException {
        int posisi = indeksDariId(id);
        if (posisi < 0) {
            throw new KontakTidakDitemukanException(id);
        }
        Kontak terhapus = kontak.remove(posisi);
        dao.hapus(id);
        return terhapus;
    }

    /** Salinan seluruh kontak, terurut sesuai urutan penambahan. */
    public List<Kontak> semua() {
        return List.copyOf(kontak);
    }

    /** Kontak berdasarkan id, atau kosong bila tidak ada. */
    public Optional<Kontak> cari(int id) {
        for (Kontak k : kontak) {
            if (k.id() == id) {
                return Optional.of(k);
            }
        }
        return Optional.empty();
    }

    /** Kontak yang nama, email, atau teleponnya memuat kata kunci. */
    public List<Kontak> cari(String kataKunci) {
        String kunci = kataKunci.strip().toLowerCase(Locale.ROOT);
        List<Kontak> hasil = new ArrayList<>();
        for (Kontak k : kontak) {
            if (k.nama().toLowerCase(Locale.ROOT).contains(kunci)
                    || k.email().toLowerCase(Locale.ROOT).contains(kunci)
                    || k.telepon().toLowerCase(Locale.ROOT).contains(kunci)) {
                hasil.add(k);
            }
        }
        return hasil;
    }

    public int jumlah() {
        return kontak.size();
    }

    private int indeksDariId(int id) {
        for (int i = 0; i < kontak.size(); i++) {
            if (kontak.get(i).id() == id) {
                return i;
            }
        }
        return -1;
    }

    /** Validasi seluruh field sebelum kontak disimpan. */
    private static void periksa(String nama, String email, String telepon)
            throws KontakInvalidException {
        if (nama == null || nama.isBlank()) {
            throw new KontakInvalidException("nama tidak boleh kosong");
        }
        if (email == null || email.isBlank()) {
            throw new KontakInvalidException("email tidak boleh kosong");
        }
        if (telepon == null || telepon.isBlank()) {
            throw new KontakInvalidException("telepon tidak boleh kosong");
        }
        periksaFormatEmail(email.strip());
        periksaTanpaPemisah(nama.strip(), email.strip(), telepon.strip());
    }

    /** Email harus berformat [email protected]. */
    private static void periksaFormatEmail(String email)
            throws KontakInvalidException {
        int posisiAt = email.indexOf('@');
        if (posisiAt <= 0 || posisiAt != email.lastIndexOf('@')
                || email.indexOf('.', posisiAt) < 0) {
            throw new KontakInvalidException(
                    "email harus berformat [email protected]: " + email);
        }
    }

    /** Karakter | dipakai sebagai pemisah kolom pada berkas penyimpanan. */
    private static void periksaTanpaPemisah(String nama, String email, String telepon)
            throws KontakInvalidException {
        if (nama.indexOf('|') >= 0 || email.indexOf('|') >= 0
                || telepon.indexOf('|') >= 0) {
            throw new KontakInvalidException(
                    "field tidak boleh memuat karakter |");
        }
    }

    /** Email hanya boleh dipakai satu kontak. */
    private void periksaEmailBelumTerpakai(String email, int idKecuali)
            throws KontakInvalidException {
        for (Kontak k : kontak) {
            if (k.id() != idKecuali
                    && k.email().equalsIgnoreCase(email.strip())) {
                throw new KontakInvalidException(
                        "email sudah dipakai kontak lain: " + email.strip());
            }
        }
    }
}

import java.awt.BorderLayout;
import java.awt.FlowLayout;
import javax.swing.JButton;
import javax.swing.JFrame;
import javax.swing.JLabel;
import javax.swing.JPanel;
import javax.swing.JTextField;

/**
 * Jendela utama aplikasi Buku Kontak.
 * JFrame tidak bisa dibuat pada lingkungan tanpa layar, sehingga
 * perakitan isi jendela dipisahkan ke method static bangunPanelTombol
 * yang bisa diuji tanpa membuka jendela nyata.
 */
public class JendelaUtama extends JFrame {

    public JendelaUtama(DaftarKontak daftar) {
        super("Buku Kontak");
        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

        KontakTableModel model = new KontakTableModel(daftar);
        PanelFormKontak form = new PanelFormKontak();
        PanelTabelKontak tabel = new PanelTabelKontak(model);
        JLabel status = new JLabel("Siap.");
        JPanel tombol = bangunPanelTombol(form, model, tabel, status);

        JPanel selatan = new JPanel(new BorderLayout(4, 4));
        selatan.add(tombol, BorderLayout.NORTH);
        selatan.add(status, BorderLayout.SOUTH);

        JPanel isi = new JPanel(new BorderLayout(8, 8));
        isi.add(form, BorderLayout.NORTH);
        isi.add(tabel, BorderLayout.CENTER);
        isi.add(selatan, BorderLayout.SOUTH);
        setContentPane(isi);

        pack();
        setLocationRelativeTo(null);
    }

    /**
     * Membangun panel tombol beserta seluruh aksinya.
     * Setiap tombol hanya membaca formulir, memanggil satu operasi
     * KontakTableModel, lalu melaporkan hasil pada label status.
     */
    static JPanel bangunPanelTombol(PanelFormKontak form, KontakTableModel model,
            PanelTabelKontak tabel, JLabel status) {
        JPanel tombol = new JPanel(new FlowLayout(FlowLayout.LEADING));

        JButton tambah = new JButton("Tambah");
        tambah.addActionListener(e -> {
            try {
                Kontak baru = model.tambah(form.nama(), form.email(), form.telepon());
                form.kosongkan();
                tabel.pilihBaris(model.jumlahBaris() - 1);
                status.setText("Kontak " + baru.nama() + " (id " + baru.id() + ") ditambahkan.");
            } catch (KontakInvalidException | PersistensiGagalException ex) {
                status.setText("Gagal menambah: " + ex.getMessage());
            }
        });

        JButton ubah = new JButton("Ubah");
        ubah.addActionListener(e -> {
            int id = tabel.idTerpilih();
            if (id < 0) {
                status.setText("Pilih kontak pada tabel terlebih dahulu.");
                return;
            }
            try {
                Kontak baru = model.ubah(id, form.nama(), form.email(), form.telepon());
                status.setText("Kontak id " + baru.id() + " diubah menjadi " + baru.nama() + ".");
            } catch (KontakInvalidException | KontakTidakDitemukanException
                    | PersistensiGagalException ex) {
                status.setText("Gagal mengubah: " + ex.getMessage());
            }
        });

        JButton hapus = new JButton("Hapus");
        hapus.addActionListener(e -> {
            int id = tabel.idTerpilih();
            if (id < 0) {
                status.setText("Pilih kontak pada tabel terlebih dahulu.");
                return;
            }
            try {
                Kontak terhapus = model.hapus(id);
                status.setText("Kontak " + terhapus.nama() + " (id " + id + ") dihapus.");
            } catch (KontakTidakDitemukanException | PersistensiGagalException ex) {
                status.setText("Gagal menghapus: " + ex.getMessage());
            }
        });

        JTextField isianCari = new JTextField(10);
        JButton cari = new JButton("Cari");
        cari.addActionListener(e -> {
            tabel.saring(isianCari.getText());
            status.setText(tabel.tabel().getRowCount() + " kontak cocok untuk \""
                    + isianCari.getText().strip() + "\".");
        });

        tombol.add(tambah);
        tombol.add(ubah);
        tombol.add(hapus);
        tombol.add(isianCari);
        tombol.add(cari);
        return tombol;
    }
}

/**
 * Satu baris data kontak pada aplikasi Buku Kontak.
 * Record hanya menyimpan nilai; aturan bisnis hidup di DaftarKontak.
 */
public record Kontak(int id, String nama, String email, String telepon) {
}

import java.util.List;

/**
 * Kontrak penyimpanan kontak — pola DAO (Data Access Object).
 * DaftarKontak hanya mengenal antarmuka ini, sehingga jenis penyimpanan
 * bisa ditukar (memori, berkas, database) tanpa menyentuh kode lain.
 */
public interface KontakDao {

    /** Memuat seluruh kontak yang tersimpan. */
    List<Kontak> muatSemua() throws PersistensiGagalException;

    /** Menyimpan kontak baru ke penyimpanan. */
    void tambah(Kontak kontak) throws PersistensiGagalException;

    /** Menimpa kontak lama berdasarkan id dengan data baru. */
    void perbarui(Kontak kontak) throws PersistensiGagalException;

    /** Menghapus kontak berdasarkan id dari penyimpanan. */
    void hapus(int id) throws PersistensiGagalException;
}

import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.ArrayList;
import java.util.List;

/**
 * Penyimpanan berkas teks: satu kontak per baris dengan format
 * id|nama|email|telepon. Setiap perubahan ditulis ulang seluruhnya
 * dengan charset UTF-8.
 */
public class KontakDaoBerkas implements KontakDao {

    private final Path berkas;

    public KontakDaoBerkas(Path berkas) {
        this.berkas = berkas;
    }

    @Override
    public List<Kontak> muatSemua() throws PersistensiGagalException {
        if (!Files.exists(berkas)) {
            return List.of();
        }
        List<Kontak> hasil = new ArrayList<>();
        try {
            List<String> barisSemua = Files.readAllLines(berkas, StandardCharsets.UTF_8);
            for (int i = 0; i < barisSemua.size(); i++) {
                String baris = barisSemua.get(i);
                if (baris.isBlank()) {
                    continue;
                }
                hasil.add(uraikan(baris, i + 1));
            }
            return hasil;
        } catch (IOException e) {
            throw new PersistensiGagalException(
                    "gagal membaca " + berkas, e);
        }
    }

    @Override
    public void tambah(Kontak kontak) throws PersistensiGagalException {
        List<Kontak> data = new ArrayList<>(muatSemua());
        data.add(kontak);
        tulisSemua(data);
    }

    @Override
    public void perbarui(Kontak kontak) throws PersistensiGagalException {
        List<Kontak> data = new ArrayList<>(muatSemua());
        for (int i = 0; i < data.size(); i++) {
            if (data.get(i).id() == kontak.id()) {
                data.set(i, kontak);
                tulisSemua(data);
                return;
            }
        }
        throw new PersistensiGagalException(
                "id " + kontak.id() + " tidak ada di " + berkas);
    }

    @Override
    public void hapus(int id) throws PersistensiGagalException {
        List<Kontak> data = new ArrayList<>(muatSemua());
        for (Kontak k : data) {
            if (k.id() == id) {
                data.remove(k);
                tulisSemua(data);
                return;
            }
        }
        throw new PersistensiGagalException(
                "id " + id + " tidak ada di " + berkas);
    }

    /** Mengubah satu baris berkas menjadi objek Kontak. */
    private static Kontak uraikan(String baris, int nomor)
            throws PersistensiGagalException {
        String[] bagian = baris.split("\\|", 4);
        if (bagian.length != 4) {
            throw new PersistensiGagalException(
                    "baris rusak pada nomor " + nomor + ": \"" + baris + "\"");
        }
        try {
            int id = Integer.parseInt(bagian[0].strip());
            return new Kontak(id, bagian[1], bagian[2], bagian[3]);
        } catch (NumberFormatException e) {
            throw new PersistensiGagalException(
                    "id bukan angka pada baris " + nomor + ": " + bagian[0]);
        }
    }

    /** Menulis ulang seluruh isi berkas dari daftar kontak. */
    private void tulisSemua(List<Kontak> data) throws PersistensiGagalException {
        StringBuilder teks = new StringBuilder();
        for (Kontak k : data) {
            teks.append(k.id()).append('|')
                    .append(k.nama()).append('|')
                    .append(k.email()).append('|')
                    .append(k.telepon()).append('\n');
        }
        try {
            Files.writeString(berkas, teks.toString(), StandardCharsets.UTF_8);
        } catch (IOException e) {
            throw new PersistensiGagalException(
                    "gagal menulis " + berkas, e);
        }
    }
}

import java.util.ArrayList;
import java.util.List;

/** Penyimpanan di memori: cepat, tanpa berkas, cocok untuk pengujian. */
public class KontakDaoMemori implements KontakDao {

    private final List<Kontak> simpanan = new ArrayList<>();

    @Override
    public List<Kontak> muatSemua() {
        return List.copyOf(simpanan);
    }

    @Override
    public void tambah(Kontak kontak) {
        simpanan.add(kontak);
    }

    @Override
    public void perbarui(Kontak kontak) throws PersistensiGagalException {
        int posisi = indeksDariId(kontak.id());
        if (posisi < 0) {
            throw new PersistensiGagalException(
                    "id " + kontak.id() + " tidak ada di penyimpanan memori");
        }
        simpanan.set(posisi, kontak);
    }

    @Override
    public void hapus(int id) throws PersistensiGagalException {
        int posisi = indeksDariId(id);
        if (posisi < 0) {
            throw new PersistensiGagalException(
                    "id " + id + " tidak ada di penyimpanan memori");
        }
        simpanan.remove(posisi);
    }

    private int indeksDariId(int id) {
        for (int i = 0; i < simpanan.size(); i++) {
            if (simpanan.get(i).id() == id) {
                return i;
            }
        }
        return -1;
    }
}

/**
 * Masukan kontak yang melanggar aturan validasi:
 * field kosong, format email salah, email dipakai kontak lain,
 * atau field memuat karakter pemisah penyimpanan.
 */
public class KontakInvalidException extends Exception {

    public KontakInvalidException(String pesan) {
        super(pesan);
    }
}

import javax.swing.table.AbstractTableModel;

/**
 * TableModel kustom yang membaca DaftarKontak sebagai sumber data.
 * Operasi CRUD diteruskan ke DaftarKontak, lalu notifikasi perubahan
 * dikirim ke view lewat keluarga method fire... .
 */
public class KontakTableModel extends AbstractTableModel {

    private static final String[] KOLUM = { "Id", "Nama", "Email", "Telepon" };

    private final DaftarKontak daftar;

    public KontakTableModel(DaftarKontak daftar) {
        this.daftar = daftar;
    }

    @Override
    public int getRowCount() {
        return daftar.jumlah();
    }

    @Override
    public int getColumnCount() {
        return KOLUM.length;
    }

    @Override
    public String getColumnName(int kolom) {
        return KOLUM[kolom];
    }

    @Override
    public Object getValueAt(int baris, int kolom) {
        Kontak k = daftar.semua().get(baris);
        return switch (kolom) {
            case 0 -> k.id();
            case 1 -> k.nama();
            case 2 -> k.email();
            default -> k.telepon();
        };
    }

    /** Menambah kontak lewat DaftarKontak lalu memberi tahu view. */
    public Kontak tambah(String nama, String email, String telepon)
            throws KontakInvalidException, PersistensiGagalException {
        Kontak baru = daftar.tambah(nama, email, telepon);
        int baris = daftar.jumlah() - 1;
        fireTableRowsInserted(baris, baris);
        return baru;
    }

    /** Mengubah kontak lewat DaftarKontak lalu memberi tahu view. */
    public Kontak ubah(int id, String nama, String email, String telepon)
            throws KontakInvalidException, KontakTidakDitemukanException,
            PersistensiGagalException {
        int baris = barisDariId(id);
        Kontak baru = daftar.ubah(id, nama, email, telepon);
        fireTableRowsUpdated(baris, baris);
        return baru;
    }

    /** Menghapus kontak lewat DaftarKontak lalu memberi tahu view. */
    public Kontak hapus(int id)
            throws KontakTidakDitemukanException, PersistensiGagalException {
        int baris = barisDariId(id);
        Kontak terhapus = daftar.hapus(id);
        fireTableRowsDeleted(baris, baris);
        return terhapus;
    }

    /** Kontak pada baris model — dipakai aksi terhadap baris terpilih. */
    public Kontak kontakDiBaris(int baris) {
        return daftar.semua().get(baris);
    }

    /** Jumlah baris saat ini pada model. */
    public int jumlahBaris() {
        return daftar.jumlah();
    }

    private int barisDariId(int id) {
        for (int i = 0; i < daftar.jumlah(); i++) {
            if (daftar.semua().get(i).id() == id) {
                return i;
            }
        }
        return -1;
    }
}