Sebelum Anda Memulai: Prasyarat dan Instalasi

Untuk mengikuti tutorial ini, Anda memerlukan:

• Java 17 atau yang lebih baru terpasang di mesin pengembangan Anda.
• Maven 3.6+ untuk manajemen dependensi.
• Sebuah IDE seperti IntelliJ IDEA atau Eclipse.

Tambahkan repositori Maven Conholdate dan dependensi SDK ke pom.xml Anda:

<repositories>
    <repository>
        <id>conholdate-repo</id>
        <name>Conholdate Maven Repository</name>
        <url>https://repository.conholdate.com/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.conholdate</groupId>
    <artifactId>conholdate-total</artifactId>
    <version>24.9</version>
    <type>pom</type>
</dependency>

Unduh binary SDK terbaru dari halaman unduhan jika Anda lebih suka pengaturan manual. Setelah dependensi teratasi, Anda siap mulai menulis kode. Bagian berikutnya menjelaskan setiap langkah menambahkan teks coret dalam Java.

Panduan Langkah-demi-Langkah untuk Teks Coret di Java

Langkah 1: Muat Dokumen Sumber

Pertama, buat sebuah instance Document. Jika file input ada, SDK memuatnya; jika tidak, sebuah dokumen kosong baru dibuat.

String inputPath = "input.docx";
Document doc;
File inputFile = new File(inputPath);
if (inputFile.exists()) {
    doc = new Document(inputPath); // loads existing DOCX
} else {
    doc = new Document();          // creates a new blank document
    doc.removeAllChildren();       // ensure it's empty
}

Kelas Document didokumentasikan di referensi API.

Langkah 2: Tulis Paragraf Normal

Gunakan DocumentBuilder untuk menambahkan paragraf biasa. Ini menunjukkan bahwa teks normal tidak terpengaruh oleh pengaturan coret.

DocumentBuilder builder = new DocumentBuilder(doc);
builder.moveToDocumentEnd();
builder.writeln("This is a normal paragraph.");

Langkah 3: Terapkan Pemformatan Coret

Aktifkan flag strike‑through pada font builder sebelum menulis teks bergaya.

builder.getFont().setStrikeThrough(true);
builder.writeln("This text is rendered with strikethrough.");
builder.getFont().setStrikeThrough(false); // reset for subsequent text

Langkah 4: Cari dan Terapkan Coret Teks Kondisional

Iterasi melalui semua objek Run, temukan kata “strike”, dan terapkan pemformatan secara programatik.

for (Paragraph para : (Iterable<Paragraph>) doc.getChildNodes(NodeType.PARAGRAPH, true)) {
    for (Run run : (Iterable<Run>) para.getChildNodes(NodeType.RUN, true)) {
        String text = run.getText();
        if (text != null && text.toLowerCase().contains("strike")) {
            run.getFont().setStrikeThrough(true);
        }
    }
}

Langkah 5: Simpan Dokumen

Akhirnya, tulis dokumen yang telah dimodifikasi ke disk dalam format DOCX.

String outputPath = "output.docx";
doc.save(outputPath, SaveFormat.DOCX);

Setelah dokumen disimpan, Anda dapat membuka output.docx untuk memverifikasi bahwa gaya coret muncul seperti yang diharapkan.

Contoh Lengkap yang Berfungsi untuk Teks Coret Java

Kode berikut menunjukkan alur kerja lengkap untuk menambahkan teks coret dalam Java menggunakan Conholdate.Total.

import com.aspose.words.*;

import java.io.File;

public class StrikethroughExample {
    public static void main(String[] args) {
        String inputPath = "input.docx";
        String outputPath = "output.docx";

Document doc = null;
        try {
            File inputFile = new File(inputPath);
            if (inputFile.exists()) {
                doc = new Document(inputPath);
            } else {
                doc = new Document();
                doc.removeAllChildren();
            }

DocumentBuilder builder = new DocumentBuilder(doc);
            builder.moveToDocumentEnd();

builder.writeln("This is a normal paragraph.");

builder.getFont().setStrikeThrough(true);
            builder.writeln("This text is rendered with strikethrough.");
            builder.getFont().setStrikeThrough(false);

for (Paragraph para : (Iterable<Paragraph>) doc.getChildNodes(NodeType.PARAGRAPH, true)) {
                for (Run run : (Iterable<Run>) para.getChildNodes(NodeType.RUN, true)) {
                    String text = run.getText();
                    if (text != null && text.toLowerCase().contains("strike")) {
                        run.getFont().setStrikeThrough(true);
                    }
                }
            }

doc.save(outputPath, SaveFormat.DOCX);
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            if (doc != null) {
                doc = null;
            }
        }
    }
}

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui semua jalur file dan nilai konfigurasi agar sesuai dengan lingkungan Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan lakukan pengujian secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Penyesuaian Opsi Gaya Coret

SDK memungkinkan Anda mengontrol atribut font tambahan seperti warna, ukuran, dan underline sambil menjaga flag strike‑through tetap aktif. Misalnya, Anda dapat mengubah warna teks strike‑through:

builder.getFont().setColor(java.awt.Color.RED);
builder.getFont().setStrikeThrough(true);
builder.writeln("Important deletion highlighted in red.");

Jika Anda perlu menerapkan gaya yang sama pada banyak run, pertimbangkan untuk membuat instance Font yang dapat digunakan kembali dan menetapkannya ke setiap Run untuk menghindari pengaturan properti yang berulang.

Pertimbangan Kinerja untuk Rendering Coret

1. Gunakan kembali objek Document - memuat dokumen sekali dan melakukan semua modifikasi dalam satu sesi mengurangi beban I/O.
2. Ubah gaya secara batch - terapkan flag coret pada koleksi Paragraph atau Run alih-alih mengubahnya untuk setiap karakter.
3. Hindari penelusuran yang tidak perlu - loop kondisional yang mencari kata “strike” harus dijalankan hanya ketika Anda benar-benar membutuhkan gaya dinamis.
4. Alirkan output bila memungkinkan - untuk dokumen besar, gunakan doc.save(OutputStream, SaveFormat.DOCX) untuk menulis langsung ke aliran dan menghemat memori.

Tips ini membantu menjaga penggunaan memori tetap rendah dan waktu eksekusi tetap cepat, terutama saat memproses ratusan dokumen dalam pekerjaan batch.

Kesimpulan

Menambahkan teks coret (strikethrough) dalam Java sangat mudah dengan Conholdate.Total for Java. API fluent SDK memungkinkan Anda mencampur paragraf normal dan bergaya, menerapkan pemformatan bersyarat, dan menyimpan hasil dalam format standar industri. Ingatlah untuk mengonfigurasi dependensi Maven Anda, menggunakan kembali objek dokumen, dan menerapkan gaya secara efisien untuk mencapai kinerja optimal. Untuk penyebaran produksi Anda memerlukan lisensi yang valid; detail harga tersedia di halaman harga dan lisensi sementara dapat diperoleh dari halaman lisensi sementara. Selamat coding!

Pertanyaan yang Mungkin Anda Miliki

• Bagaimana cara menerapkan teks coret di Java tanpa harus mengatur flag secara manual untuk setiap run?
  Gunakan DocumentBuilder.getFont().setStrikeThrough(true) sebelum menulis paragraf. Flag tetap aktif sampai Anda meresetnya, memungkinkan Anda menulis beberapa baris dengan gaya yang sama.

• Bisakah saya secara otomatis memberi garis coret pada setiap kemunculan kata kunci?
  Ya. Iterasikan setiap Run seperti yang ditunjukkan dalam panduan, periksa run.getText() untuk kata kunci, dan panggil run.getFont().setStrikeThrough(true) ketika cocok ditemukan.

• Format dokumen apa yang mempertahankan garis coret saat disimpan?
  DOCX, DOC, RTF, dan format teks kaya lainnya mempertahankan atribut garis coret. Lihat dokumentasi resmi untuk daftar lengkap format yang didukung.

• Apakah menerapkan banyak gaya coret akan memperlambat pemrosesan file besar?
  Dampaknya minimal jika Anda mengikuti tips kinerja: gunakan kembali instance Document, lakukan perubahan gaya secara batch, dan hindari penelusuran berulang. Ini menjaga penggunaan memori tetap rendah dan mempercepat pemrosesan.

Artikel Terkait

• Putar Gambar di Java
• Tambahkan Teks ke PDF di Java
• Konversi PDF ke PNG di Java