Menggunakan Bidang di Aspose.Words untuk Java
isi
[
bersembunyi
]Dalam tutorial langkah demi langkah ini, kami akan memandu Anda tentang cara menggunakan kolom di Aspose.Words untuk Java untuk memanipulasi dokumen dengan mudah. Aspose.Words untuk Java adalah API canggih yang memungkinkan Anda bekerja dengan dokumen Word secara terprogram, memberi Anda kendali penuh atas konten dan pemformatannya.
1. Perkenalan
Aspose.Words for Java adalah alat penting bagi siapa pun yang berurusan dengan dokumen Word dalam aplikasi Java. Bidang adalah tempat penampung yang dapat menyimpan data dinamis dalam dokumen Anda. Tutorial ini akan menunjukkan cara bekerja dengan bidang secara efektif.
2. Menyiapkan Lingkungan Anda
Sebelum memulai, pastikan Anda telah menginstal Aspose.Words for Java. Anda dapat mengunduhnya dariDi Sini. Selain itu, pastikan Anda memiliki Java dan lingkungan pengembangan terintegrasi (IDE) seperti Eclipse atau IntelliJ IDEA yang terinstal di sistem Anda.
3. Memuat Dokumen Word
Di aplikasi Java Anda, Anda perlu memuat dokumen Word yang ingin Anda gunakan. Berikut cuplikan kode untuk Anda mulai:
string dataDir = "Your Document Directory";
string outPath = "Your Output Directory";
Document doc = new Document(dataDir + "Mail merge destinations - Fax.docx");
Mengganti"Your Document Directory" Dan"Your Output Directory" dengan jalur yang sesuai.
4. Menyesuaikan Penggabungan Surat
Aspose.Words untuk Java memberikan dukungan yang sangat baik untuk operasi penggabungan surat. Anda dapat menyesuaikan proses gabungan surat dengan menyiapkan pengendali peristiwa gabungan surat. Berikut cara melakukannya:
// Siapkan pengendali peristiwa gabungan surat untuk melakukan pekerjaan khusus.
doc.getMailMerge().setFieldMergingCallback(new HandleMergeField());
// Pangkas nilai gabungan surat di akhir dan di depan spasi.
doc.getMailMerge().setTrimWhitespaces(false);
String[] fieldNames = {
"RecipientName", "SenderName", "FaxNumber", "PhoneNumber",
"Subject", "Body", "Urgent", "ForReview", "PleaseComment"
};
Object[] fieldValues = {
"Josh", "Jenny", "123456789", "", "Hello",
"<b>HTML Body Test message 1</b>", true, false, true
};
doc.getMailMerge().execute(fieldNames, fieldValues);
5. Menyimpan Dokumen
Setelah menyesuaikan dokumen Anda, Anda dapat menyimpannya menggunakan kode berikut:
doc.save(outPath + "WorkingWithFields.MailMergeFormFields.docx");
Mengganti"Your Output Directory" dengan jalur keluaran yang diinginkan.
Kode Sumber Lengkap
string dataDir = "Your Document Directory";
string outPath = "Your Output Directory";
Document doc = new Document(dataDir + "Mail merge destinations - Fax.docx");
// Siapkan pengendali peristiwa gabungan surat untuk melakukan pekerjaan khusus.
doc.getMailMerge().setFieldMergingCallback(new HandleMergeField());
// Pangkas nilai gabungan surat di akhir dan di depan spasi.
doc.getMailMerge().setTrimWhitespaces(false);
String[] fieldNames = {
"RecipientName", "SenderName", "FaxNumber", "PhoneNumber",
"Subject", "Body", "Urgent", "ForReview", "PleaseComment"
};
Object[] fieldValues = {
"Josh", "Jenny", "123456789", "", "Hello",
"<b>HTML Body Test message 1</b>", true, false, true
};
doc.getMailMerge().execute(fieldNames, fieldValues);
doc.save(outPath + "WorkingWithFields.MailMergeFormFields.docx");
Kode sumber Kelas HandleMergeField
private static class HandleMergeField implements IFieldMergingCallback
{
/// <ringkasan>
/// Penangan ini dipanggil untuk setiap bidang gabungan surat yang ditemukan dalam dokumen,
/// untuk setiap catatan yang ditemukan di sumber data.
///</ringkasan>
public void /*IFieldMergingCallback.*/fieldMerging(FieldMergingArgs e) throws Exception
{
if (mBuilder == null)
mBuilder = new DocumentBuilder(e.getDocument());
// Kami memutuskan bahwa kami ingin semua nilai boolean dikeluarkan sebagai bidang formulir kotak centang.
if (e.getFieldValue() instanceof /*boolean*/Boolean)
{
// Pindahkan "kursor" ke bidang gabungan saat ini.
mBuilder.moveToMergeField(e.getFieldName());
String checkBoxName = MessageFormat.format("{0}{1}", e.getFieldName(), e.getRecordIndex());
mBuilder.insertCheckBox(checkBoxName, (Boolean) e.getFieldValue(), 0);
return;
}
switch (e.getFieldName())
{
case "Body":
mBuilder.moveToMergeField(e.getFieldName());
mBuilder.insertHtml((String) e.getFieldValue());
break;
case "Subject":
{
mBuilder.moveToMergeField(e.getFieldName());
String textInputName = MessageFormat.format("{0}{1}", e.getFieldName(), e.getRecordIndex());
mBuilder.insertTextInput(textInputName, TextFormFieldType.REGULAR, "", (String) e.getFieldValue(), 0);
break;
}
}
}
public void imageFieldMerging(ImageFieldMergingArgs args)
{
args.setImageFileName("Image.png");
args.getImageWidth().setValue(200.0);
args.setImageHeight(new MergeFieldImageDimension(200.0, MergeFieldImageDimensionUnit.PERCENT));
}
private DocumentBuilder mBuilder;
}
@Test
public void mailMergeImageField() throws Exception
{
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.writeln("{{#foreach example}}");
builder.writeln("{{Image(126pt;126pt):stempel}}");
builder.writeln("{{/foreach example}}");
doc.getMailMerge().setUseNonMergeFields(true);
doc.getMailMerge().setTrimWhitespaces(true);
doc.getMailMerge().setUseWholeParagraphAsRegion(false);
doc.getMailMerge().setCleanupOptions(MailMergeCleanupOptions.REMOVE_EMPTY_TABLE_ROWS
| MailMergeCleanupOptions.REMOVE_CONTAINING_FIELDS
| MailMergeCleanupOptions.REMOVE_UNUSED_REGIONS
| MailMergeCleanupOptions.REMOVE_UNUSED_FIELDS);
doc.getMailMerge().setFieldMergingCallback(new ImageFieldMergingHandler());
doc.getMailMerge().executeWithRegions(new DataSourceRoot());
doc.save("Your Directory Path" + "WorkingWithFields.MailMergeImageField.docx");
}
private static class ImageFieldMergingHandler implements IFieldMergingCallback
{
public void fieldMerging(FieldMergingArgs args)
{
// Implementasi tidak diperlukan.
}
public void imageFieldMerging(ImageFieldMergingArgs args) throws Exception
{
Shape shape = new Shape(args.getDocument(), ShapeType.IMAGE);
{
shape.setWidth(126.0); shape.setHeight(126.0); shape.setWrapType(WrapType.SQUARE);
}
shape.getImageData().setImage("Your Directory Path" + "Mail merge image.png");
args.setShape(shape);
}
}
public static class DataSourceRoot implements IMailMergeDataSourceRoot
{
public IMailMergeDataSource getDataSource(String s)
{
return new DataSource();
}
private static class DataSource implements IMailMergeDataSource
{
private boolean next = true;
private String tableName()
{
return "example";
}
@Override
public String getTableName() {
return tableName();
}
public boolean moveNext()
{
boolean result = next;
next = false;
return result;
}
public IMailMergeDataSource getChildDataSource(String s)
{
return null;
}
public boolean getValue(String fieldName, Ref<Object> fieldValue)
{
fieldValue.set(null);
return false;
}
}
}
@Test
public void mailMergeAndConditionalField() throws Exception
{
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Masukkan MERGEFIELD yang bersarang di dalam bidang IF.
// Karena pernyataan kolom IF salah, hasil dari MERGEFIELD bagian dalam tidak akan ditampilkan,
//dan MERGEFIELD tidak akan menerima data apa pun selama penggabungan surat.
FieldIf fieldIf = (FieldIf)builder.insertField(" IF 1 = 2 ");
builder.moveTo(fieldIf.getSeparator());
builder.insertField(" MERGEFIELD FullName ");
// Kita masih dapat menghitung MERGEFIELD di dalam kolom pernyataan IF yang salah jika kita menyetel tanda ini ke true.
doc.getMailMerge().setUnconditionalMergeFieldsAndRegions(true);
DataTable dataTable = new DataTable();
dataTable.getColumns().add("FullName");
dataTable.getRows().add("James Bond");
doc.getMailMerge().execute(dataTable);
// Hasilnya tidak akan terlihat di dokumen karena kolom IF salah,
// tapi MERGEFIELD bagian dalam memang menerima data.
doc.save("Your Directory Path" + "WorkingWithFields.MailMergeAndConditionalField.docx");
}
@Test
public void mailMergeImageFromBlob() throws Exception
{
Document doc = new Document("Your Directory Path" + "Mail merge destination - Northwind employees.docx");
doc.getMailMerge().setFieldMergingCallback(new HandleMergeImageFieldFromBlob());
Class.forName("net.ucanaccess.jdbc.UcanaccessDriver");
String connString = "jdbc:ucanaccess://" + getDatabaseDir() + "Northwind.mdb";
Connection connection = DriverManager.getConnection(connString, "Admin", "");
Statement statement = connection.createStatement();
ResultSet resultSet = statement.executeQuery("SELECT * FROM Employees");
DataTable dataTable = new DataTable(resultSet, "Employees");
IDataReader dataReader = new DataTableReader(dataTable);
doc.getMailMerge().executeWithRegions(dataReader, "Employees");
connection.close();
doc.save("Your Directory Path" + "WorkingWithFields.MailMergeImageFromBlob.docx");
}
public static class HandleMergeImageFieldFromBlob implements IFieldMergingCallback
{
public void /*IFieldMergingCallback.*/fieldMerging(FieldMergingArgs args)
{
// Tidak melakukan apapun.
}
/// <ringkasan>
/// Ini dipanggil ketika mesin gabungan surat menemukan bidang gabungan Gambar:XXX dalam dokumen.
/// Anda mempunyai kesempatan untuk mengembalikan objek Gambar, nama file, atau aliran yang berisi gambar.
///</ringkasan>
public void /*IFieldMergingCallback.*/imageFieldMerging(ImageFieldMergingArgs e) throws Exception
{
// Nilai bidangnya adalah array byte, cukup transmisikan dan buat aliran di dalamnya.
ByteArrayInputStream imageStream = new ByteArrayInputStream((byte[]) e.getFieldValue());
// Sekarang mesin gabungan surat akan mengambil gambar dari aliran.
e.setImageStream(imageStream);
}
}
@Test
public void handleMailMergeSwitches() throws Exception
{
Document doc = new Document("Your Directory Path" + "Field sample - MERGEFIELD.docx");
doc.getMailMerge().setFieldMergingCallback(new MailMergeSwitches());
final String HTML = "<html>\r\n <h1>Hello world!</h1>\r\n </html>";
doc.getMailMerge().execute(new String[] { "htmlField1" }, new Object[] { HTML });
doc.save("Your Directory Path" + "WorkingWithFields.HandleMailMergeSwitches.docx");
}
public static class MailMergeSwitches implements IFieldMergingCallback
{
public void /*IFieldMergingCallback.*/fieldMerging(FieldMergingArgs e) throws Exception
{
if (e.getFieldName().startsWith("HTML"))
{
if (e.getField().getFieldCode().contains("\\b"))
{
FieldMergeField field = e.getField();
DocumentBuilder builder = new DocumentBuilder(e.getDocument());
builder.moveToMergeField(e.getDocumentFieldName(), true, false);
builder.write(field.getTextBefore());
builder.insertHtml(e.getFieldValue().toString());
e.setText("");
}
}
}
public void /*IFieldMergingCallback.*/imageFieldMerging(ImageFieldMergingArgs args)
{
}
}
@Test
public void alternatingRows() throws Exception
{
Document doc = new Document("Your Directory Path" + "Mail merge destination - Northwind suppliers.docx");
doc.getMailMerge().setFieldMergingCallback(new HandleMergeFieldAlternatingRows());
DataTable dataTable = getSuppliersDataTable();
doc.getMailMerge().executeWithRegions(dataTable);
doc.save("Your Directory Path" + "WorkingWithFields.AlternatingRows.doc");
}
private static class HandleMergeFieldAlternatingRows implements IFieldMergingCallback
{
/// <ringkasan>
/// Dipanggil untuk setiap bidang gabungan yang ditemukan dalam dokumen.
/// Kita dapat mengembalikan beberapa data ke mesin gabungan surat atau melakukan hal lain dengan dokumen tersebut.
/// Dalam hal ini kami mengubah format sel.
///</ringkasan>
public void /*IFieldMergingCallback.*/fieldMerging(FieldMergingArgs e)
{
if (mBuilder == null)
mBuilder = new DocumentBuilder(e.getDocument());
if ("CompanyName".equals(e.getFieldName()))
{
// Pilih warna tergantung pada apakah nomor barisnya genap atau ganjil.
Color rowColor = isOdd(mRowIdx)
? new Color((213), (227), (235))
: new Color((242), (242), (242));
//Tidak ada cara untuk mengatur properti sel untuk seluruh baris saat ini, jadi kita harus mengulangi semua sel dalam baris.
for (int colIdx = 0; colIdx < 4; colIdx++)
{
mBuilder.moveToCell(0, mRowIdx, colIdx, 0);
mBuilder.getCellFormat().getShading().setBackgroundPatternColor(rowColor);
}
mRowIdx++;
}
}
public void /*IFieldMergingCallback.*/imageFieldMerging(ImageFieldMergingArgs args)
{
// Tidak melakukan apapun.
}
private DocumentBuilder mBuilder;
private int mRowIdx;
}
/// <ringkasan>
/// Mengembalikan nilai benar jika nilainya ganjil; salah jika nilainya genap.
///</ringkasan>
private static boolean isOdd(int value)
{
return (value / 2 * 2) == value;
}
/// <ringkasan>
/// Buat DataTable dan isi dengan data.
/// Dalam kehidupan nyata, DataTable ini harus diisi dari database.
///</ringkasan>
private DataTable getSuppliersDataTable()
{
DataTable dataTable = new DataTable("Suppliers");
dataTable.getColumns().add("CompanyName");
dataTable.getColumns().add("ContactName");
for (int i = 0; i < 10; i++)
{
DataRow datarow = dataTable.newRow();
dataTable.getRows().add(datarow);
datarow.set(0, "Company " + i);
datarow.set(1, "Contact " + i);
}
return dataTable;
}
}
6. Kesimpulan
Selamat! Anda telah mempelajari cara menggunakan bidang di Aspose.Words untuk Java untuk memanipulasi dokumen Word secara dinamis. API canggih ini memberi Anda kendali penuh atas dokumen Anda, menjadikannya aset berharga bagi pengembang Java.
7. Pertanyaan Umum
Q1: Di mana saya dapat mengunduh Aspose.Words untuk Java?
Anda dapat mengunduh Aspose.Words untuk Java dariDi Sini.
Q2: Bagaimana cara mendapatkan lisensi sementara untuk Aspose.Words untuk Java?
Anda dapat memperoleh lisensi sementara dariDi Sini.
Q3: Di mana saya bisa mendapatkan dukungan untuk Aspose.Words untuk Java?
Untuk dukungan, Anda dapat mengunjungi forum Aspose.WordsDi Sini.
Q4: Apakah Aspose.Words untuk Java cocok untuk menangani konten HTML di dokumen Word?
Ya, Aspose.Words untuk Java memberikan dukungan luar biasa untuk menangani konten HTML di dokumen Word.
Q5: Dapatkah saya menggunakan Aspose.Words untuk Java secara gratis?
Aspose.Words untuk Java adalah produk komersial, tetapi Anda dapat menjelajahi fitur-fiturnya dengan uji coba gratis yang tersediaDi Sini.
Mulailah dengan Aspose.Words untuk Java hari ini dan kendalikan dokumen Word Anda dengan cara yang belum pernah ada sebelumnya!
