Pemformatan coret biasanya diperlukan untuk menunjukkan penghapusan, revisi, atau tugas yang selesai dalam dokumen yang dihasilkan. Conholdate.Total for Java menyediakan SDK yang kuat yang memungkinkan Anda memanipulasi dokumen Word secara programatis. Dalam panduan ini Anda akan mempelajari cara menambahkan teks coret di Java, menjelajahi opsi konfigurasi, melihat praktik terbaik kinerja, dan menjalankan contoh lengkap yang dapat Anda sesuaikan dengan proyek Anda sendiri.
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
- Gunakan kembali objek
Document- memuat dokumen sekali dan melakukan semua modifikasi dalam satu sesi mengurangi beban I/O. - Ubah gaya secara batch - terapkan flag coret pada koleksi
ParagraphatauRunalih-alih mengubahnya untuk setiap karakter. - Hindari penelusuran yang tidak perlu - loop kondisional yang mencari kata “strike” harus dijalankan hanya ketika Anda benar-benar membutuhkan gaya dinamis.
- 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?
GunakanDocumentBuilder.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 setiapRunseperti yang ditunjukkan dalam panduan, periksarun.getText()untuk kata kunci, dan panggilrun.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 instanceDocument, lakukan perubahan gaya secara batch, dan hindari penelusuran berulang. Ini menjaga penggunaan memori tetap rendah dan mempercepat pemrosesan.