Cara melakukan manipulasi xml java dengan GroupDocs.Editor – panduan lengkap

Dalam aplikasi Java modern, java xml manipulation merupakan kebutuhan yang sering—baik Anda memperbarui file konfigurasi, menyinkronkan katalog produk, atau menghasilkan laporan. Melakukan ini secara manual rawan kesalahan dan memakan waktu. Dalam tutorial ini Anda akan menemukan bagaimana GroupDocs.Editor menyederhanakan seluruh proses: memuat dokumen XML, mengedit node-nya, mengonversi konten ke TXT atau DOCX, dan mengambil metadata yang berguna—semua dengan kode Java yang bersih dan dapat dipelihara.

Jawaban Cepat

  • Perpustakaan apa yang membantu Anda mengedit XML di Java? GroupDocs.Editor for Java.
  • Bisakah saya memuat file XML dari path atau stream? Yes – use Editor with XmlEditOptions.
  • Apakah memungkinkan menyimpan XML yang diedit sebagai DOCX atau TXT? Absolutely, using WordProcessingSaveOptions or TextSaveOptions.
  • Bagaimana cara menyesuaikan penyorotan font untuk tag XML? Configure XmlHighlightOptions on the edit options.
  • Bisakah saya mengambil metadata seperti tipe dokumen dari file XML? Yes, via Editor.getDocumentInfo().

Apa itu manipulasi xml java?

Manipulasi xml java adalah proses programatik membaca file XML, mengubah elemen, atribut, atau node teksnya, dan menulis dokumen yang diperbarui kembali ke penyimpanan. GroupDocs.Editor mengabstraksi parsing tingkat rendah, memungkinkan Anda fokus pada logika bisnis daripada kerumitan DOM atau SAX.

Mengapa menggunakan GroupDocs.Editor untuk manipulasi xml java?

GroupDocs.Editor mendukung 50+ format input dan output, memproses file XML berukuran ratusan halaman tanpa memuat seluruh dokumen ke memori, dan menyediakan penyorotan bawaan yang mempercepat peninjauan manual. Mesin tanpa ketergantungan ini menghilangkan kebutuhan mengelola parser XML terpisah, dan menawarkan konversi satu klik ke Word, teks biasa, atau HTML, mengurangi waktu pengembangan hingga 70 %.

Prasyarat

Sebelum kita mulai, pastikan Anda memiliki:

  • GroupDocs.Editor for Java (versi 25.3 atau lebih baru)
  • JDK 8+ (versi terbaru apa pun dapat digunakan)
  • Sebuah IDE seperti IntelliJ IDEA atau Eclipse
  • Maven (atau Gradle) untuk manajemen dependensi

Pengetahuan yang diperlukan

  • Sintaks Java dasar
  • Familiaritas dengan konsep XML (elemen, atribut, CDATA)

Menyiapkan GroupDocs.Editor untuk Java

Pengaturan Maven

Add the following dependency to your pom.xml file to pull in GroupDocs.Editor:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-editor</artifactId>
    <version>25.3</version>
</dependency>

Unduhan langsung

Atau, unduh versi terbaru dari GroupDocs.Editor for Java releases.

Akuisisi lisensi

Inisialisasi dasar

Editor adalah kelas utama GroupDocs.Editor yang memuat dan mengelola konten dokumen. XmlEditOptions menentukan bagaimana XML ditampilkan untuk diedit.

import com.groupdocs.editor.Editor;

String inputFilePath = "path/to/your/sample.xml";
Editor editor = new Editor(inputFilePath);

Panduan Implementasi

Pada bagian ini kami akan membahas langkah-langkah inti untuk load XML Java, mengedit dokumen, convert XML TXT, dan extract XML metadata.

Memuat dan mengedit file XML

Kelas Editor adalah komponen inti yang memuat dan mengelola dokumen XML.
EditableDocument menyediakan metode untuk memodifikasi markup dari dokumen XML yang dimuat.

Jawaban langsung: Muat XML dengan new Editor("input.xml", new XmlEditOptions()), terapkan XmlHighlightOptions yang diperlukan, modifikasi markup melalui EditableDocument, dan akhirnya panggil editor.save()—semua dalam tiga baris kode yang singkat.

Langkah 1: muat dokumen XML

Editor memuat file dan membuat representasi dalam memori yang siap untuk diedit.

import com.groupdocs.editor.Editor;
import com.groupdocs.editor.editable.EditableDocument;
import com.groupdocs.editor.options.XmlEditOptions;

String inputFilePath = "YOUR_DOCUMENT_DIRECTORY" + "/sample.xml";
Editor editor = new Editor(inputFilePath);

Langkah 2: konfigurasikan opsi edit

XmlEditOptions memungkinkan Anda mengaktifkan penyorotan sintaks, nomor baris, dan font khusus.

XmlEditOptions editOptions = new XmlEditOptions();
editOptions.setAttributeValuesQuoteType(QuoteType.DoubleQuote); // Use double quotes for attribute values
EditableDocument beforeEdit = editor.edit(editOptions);

Langkah 3: modifikasi konten

EditableDocument menyediakan metode replace, insert, dan remove yang bekerja pada string markup mentah.

String originalTextContent = beforeEdit.getContent();
String updatedTextContent = originalTextContent.replace("John", "Samuel");
EditableDocument afterEdit = EditableDocument.fromMarkup(updatedTextContent, beforeEdit.getAllResources());
afterEdit.dispose();
editor.dispose();

Menyimpan konten XML yang diedit ke format berbeda

TextSaveOptions menentukan bagaimana dokumen disimpan sebagai teks biasa, termasuk opsi enkoding dan format.

Jawaban langsung: Gunakan WordProcessingSaveOptions untuk mengekspor ke DOCX atau TextSaveOptions untuk output teks biasa; cukup berikan opsi tersebut ke editor.save("output.docx", saveOptions) atau editor.save("output.txt", saveOptions).

Langkah 1: simpan sebagai DOCX

WordProcessingSaveOptions mempertahankan tata letak saat mengonversi struktur XML menjadi tabel Word dan heading.

import com.groupdocs.editor.options.WordProcessingSaveOptions;
import java.nio.charset.StandardCharsets;

String outputWordPath = "YOUR_OUTPUT_DIRECTORY" + "/output.docx";
WordProcessingSaveOptions wordSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docx);
afterEdit.save(outputWordPath, wordSaveOptions);

Langkah 2: simpan sebagai TXT

TextSaveOptions menulis versi teks bersih dan terindentasi dari XML, menghormati aturan format yang Anda tetapkan.

import com.groupdocs.editor.options.TextSaveOptions;

String outputTxtPath = "YOUR_OUTPUT_DIRECTORY" + "/output.txt";
TextSaveOptions txtSaveOptions = new TextSaveOptions();
txtSaveOptions.setEncoding(StandardCharsets.UTF_8);
afterEdit.save(outputTxtPath, txtSaveOptions);

Opsi penyorotan untuk pengeditan XML

XmlHighlightOptions memungkinkan Anda menyesuaikan warna dan font untuk tag XML, atribut, dan nilai selama pengeditan.

Jawaban langsung: Buat instance XmlHighlightOptions, atur keluarga font, ukuran, dan warna untuk tag, atribut, dan CDATA, lalu tetapkan ke XmlEditOptions sebelum memuat dokumen.

import com.groupdocs.editor.options.XmlHighlightOptions;
import com.groupdocs.editor.htmlcss.css.datatypes.ArgbColors;
import com.groupdocs.editor.htmlcss.css.properties.FontSize;
import com.groupdocs.editor.htmlcss.css.properties.FontStyle;
import com.groupdocs.editor.htmlcss.css.properties.FontWeight;
import com.groupdocs.editor.htmlcss.css.properties.TextDecorationLineType;

XmlEditOptions editOptions = new XmlEditOptions();
XmlHighlightOptions highlightOptions = editOptions.getHighlightOptions();

highlightOptions.getXmlTagsFontSettings().setSize(FontSize.Large);
highlightOptions.getXmlTagsFontSettings().setColor(ArgbColors.Olive);

highlightOptions.getAttributeNamesFontSettings().setName("Arial");
highlightOptions.getAttributeNamesFontSettings().setLine(TextDecorationLineType.Underline);

highlightOptions.getAttributeValuesFontSettings().setStyle(FontStyle.Italic);

highlightOptions.getCDataFontSettings().setLine(TextDecorationLineType.LineThrough);

highlightOptions.getHtmlCommentsFontSettings().setColor(ArgbColors.Lightgreen);

highlightOptions.resetToDefault();
afterEdit.dispose();
editor.dispose();

Opsi format untuk pengeditan XML

XmlFormatOptions mengontrol indentasi, gaya baris baru, dan pelipatan elemen saat menyimpan XML.

Jawaban langsung: XmlFormatOptions mengontrol indentasi (tab vs. spasi), gaya baris baru, dan apakah elemen kosong dilipat, memberi Anda kontrol penuh atas tampilan akhir.

import com.groupdocs.editor.htmlcss.css.datatypes.Length;
import com.groupdocs.editor.htmlcss.css.datatypes.LengthUnit;

XmlEditOptions editOptions = new XmlEditOptions();
XmlFormatOptions formatOptions = editOptions.getFormatOptions();

formatOptions.setEachAttributeFromNewline(true);
formatOptions.setLeftIndent(Length.fromValueWithUnit(20, LengthUnit.Px));
formatOptions.setLeafTextNodesOnNewline(true);
formatOptions.setLeftIndent(Length.UnitlessZero);

afterEdit.dispose();
editor.dispose();

Mengambil informasi metadata XML

TextualDocumentInfo menyimpan informasi yang diekstrak tentang sebuah dokumen, termasuk metadata khusus XML.

Jawaban langsung: Panggil editor.getDocumentInfo(null) untuk mendapatkan objek TextualDocumentInfo; properti xmlInfo-nya berisi documentType, encoding, dan rootElementName tanpa harus mem-parsing seluruh file.

import com.groupdocs.editor.IDocumentInfo;
import com.groupdocs.editor.metadata.TextualDocumentInfo;

Editor editor = new Editor(inputFilePath);
IDocumentInfo info = editor.getDocumentInfo(null);
TextualDocumentInfo xmlInfo = (TextualDocumentInfo)info;

afterEdit.dispose();
editor.dispose();

Cara memuat XML Java – jebakan umum

Memuat XML dengan GroupDocs.Editor cukup sederhana, tetapi Anda harus memastikan path file benar, lisensi yang tepat diterapkan, dan enkoding dokumen cocok dengan sumber. Menggunakan path absolut atau Paths.get(...) menghindari kesalahan resolusi, lisensi yang valid mencegah watermark percobaan, dan mengatur charset yang tepat di XmlEditOptions menjamin penanganan karakter yang benar.

  • Incorrect file path – selalu selesaikan path dengan Paths.get(...) atau gunakan path absolut.
  • Missing license – tanpa lisensi yang valid editor berjalan dalam mode percobaan dan menambahkan watermark pada output.
  • Encoding mismatches – pastikan XML sumber berformat UTF‑8 atau secara eksplisit atur enkoding yang diharapkan di XmlEditOptions.

Cara mengonversi XML ke TXT menggunakan GroupDocs.Editor

Mengonversi dokumen XML yang diedit ke teks biasa dengan GroupDocs.Editor dilakukan melalui kelas TextSaveOptions. Konfigurasikan opsi untuk mempertahankan indentasi, baris baru, dan enkoding karakter, kemudian panggil editor.save("output.txt", saveOptions). Ini menghasilkan file TXT yang bersih dan dapat dibaca manusia yang mencerminkan struktur XML asli sambil menghapus tag markup.

Manipulasi xml java – tips lanjutan

  • Batch replace – manfaatkan String.replaceAll dengan ekspresi reguler untuk transformasi skala besar.
  • Preserve comments – editor mempertahankan komentar XML kecuali Anda menghapusnya secara eksplisit.
  • Reuse resources – EditableDocument.fromMarkup membuat ulang dokumen sambil mempertahankan sumber daya tersemat (gambar, gaya) tetap utuh.

Cara mengekstrak metadata XML

Mengekstrak metadata dari file XML menjadi mudah dengan GroupDocs.Editor. Setelah memuat dokumen, panggil editor.getDocumentInfo(null) untuk mendapatkan objek TextualDocumentInfo, yang berisi bagian xmlInfo. Ini memberikan detail seperti tipe dokumen, enkoding, dan nama elemen root tanpa memerlukan parsing DOM penuh.

  • xmlInfo.getDocumentType() – mengembalikan “XML”.
  • xmlInfo.getEncoding() – enkoding karakter (misalnya, UTF‑8).
  • xmlInfo.getRootElementName() – nama elemen root, memberikan gambaran cepat tentang struktur dokumen.

Aplikasi praktis

Skenario dunia nyata di mana teknik ini bersinar:

  1. Content management systems – secara otomatis memperbarui file konfigurasi berbasis XML di seluruh lingkungan.
  2. E‑commerce platforms – menjaga katalog produk tetap sinkron dengan mengedit feed XML secara langsung.
  3. Data interchange – mengubah laporan XML lama menjadi TXT atau DOCX yang dapat dibaca manusia untuk pemangku kepentingan non‑teknis.

Pertanyaan yang sering diajukan

Q: Apakah saya memerlukan lisensi untuk mengedit XML di produksi?
A: Ya, lisensi GroupDocs.Editor yang valid diperlukan untuk produksi; lisensi percobaan cukup untuk evaluasi.

Q: Bisakah perpustakaan menangani file XML yang sangat besar (ratusan MB)?
A: GroupDocs.Editor melakukan streaming dokumen, memungkinkan Anda bekerja dengan file hingga beberapa ratus megabyte tanpa memuat seluruh file ke memori.

Q: Apakah format asli dipertahankan saat menyimpan sebagai TXT?
A: TextSaveOptions menghormati pengaturan indentasi dan baris baru yang didefinisikan dalam XmlFormatOptions, menghasilkan representasi teks yang bersih.

Q: Bagaimana penanganan namespace XML?
A: Namespace muncul sebagai atribut biasa; Anda dapat mengedit atau menghapusnya menggunakan metode replace yang sama seperti yang ditunjukkan sebelumnya.

Q: Versi Java mana yang didukung?
A: GroupDocs.Editor 25.3 mendukung Java 8 dan yang lebih baru, termasuk Java 11, Java 17, dan rilis LTS selanjutnya.

Terakhir Diperbarui: 2026-08-15
Diuji Dengan: GroupDocs.Editor 25.3 for Java
Penulis: GroupDocs

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/editor/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-editor</artifactId>
      <version>25.3</version>
   </dependency>
</dependencies>

Tutorial Terkait