Sử dụng tùy chọn tải trong Aspose.Words cho Java

Giới thiệu về Làm việc với Tùy chọn Tải trong Aspose.Words cho Java

Trong hướng dẫn này, chúng ta sẽ khám phá cách làm việc với Load Options trong Aspose.Words for Java. Load Options cho phép bạn tùy chỉnh cách tải và xử lý tài liệu. Chúng ta sẽ đề cập đến nhiều tình huống khác nhau, bao gồm cập nhật các trường dirty, tải tài liệu được mã hóa, chuyển đổi hình dạng sang Office Math, thiết lập phiên bản MS Word, chỉ định thư mục tạm thời, xử lý cảnh báo và chuyển đổi siêu tệp sang PNG. Hãy cùng tìm hiểu từng bước.

Cập nhật Dirty Fields

LoadOptions loadOptions = new LoadOptions();
loadOptions.setUpdateDirtyFields(true);

Document doc = new Document("Your Directory Path" + "Dirty field.docx", loadOptions);
doc.save("Your Directory Path" + "WorkingWithLoadOptions.UpdateDirtyFields.docx");

Đoạn mã này trình bày cách cập nhật các trường bẩn trong tài liệu.setUpdateDirtyFields(true) phương pháp này được sử dụng để đảm bảo các trường bẩn được cập nhật trong quá trình tải tài liệu.

Tải tài liệu được mã hóa

@Test
public void loadEncryptedDocument() throws Exception {
    Document doc = new Document("Your Directory Path" + "Encrypted.docx", new LoadOptions("docPassword"));
    doc.save("Your Directory Path" + "WorkingWithLoadOptions.LoadAndSaveEncryptedOdt.odt", new OdtSaveOptions("newPassword"));
}

Ở đây, chúng tôi tải một tài liệu được mã hóa bằng mật khẩu.LoadOptions constructor chấp nhận mật khẩu tài liệu và bạn cũng có thể chỉ định mật khẩu mới khi lưu tài liệu bằng cách sử dụngOdtSaveOptions.

Chuyển đổi Shape sang Office Math

LoadOptions loadOptions = new LoadOptions();
loadOptions.setConvertShapeToOfficeMath(true);

Document doc = new Document("Your Directory Path" + "Office math.docx", loadOptions);
doc.save("Your Directory Path" + "WorkingWithLoadOptions.ConvertShapeToOfficeMath.docx", SaveFormat.DOCX);

Mã này trình bày cách chuyển đổi hình dạng thành các đối tượng Office Math trong quá trình tải tài liệu.setConvertShapeToOfficeMath(true)phương pháp cho phép chuyển đổi này.

Đặt phiên bản MS Word

@Test
public void setMsWordVersion() throws Exception {
    LoadOptions loadOptions = new LoadOptions();
    loadOptions.setMswVersion(MsWordVersion.WORD_2010);

    Document doc = new Document("Your Directory Path" + "Document.docx", loadOptions);
    doc.save("Your Directory Path" + "WorkingWithLoadOptions.SetMsWordVersion.docx");
}

Bạn có thể chỉ định phiên bản MS Word để tải tài liệu. Trong ví dụ này, chúng tôi đặt phiên bản thành Microsoft Word 2010 bằng cách sử dụngsetMswVersion.

Sử dụng thư mục tạm thời

@Test
public void useTempFolder() throws Exception {
    LoadOptions loadOptions = new LoadOptions();
    loadOptions.setTempFolder("Your Directory Path");

    Document doc = new Document("Your Directory Path" + "Document.docx", loadOptions);
}

Bằng cách thiết lập thư mục tạm thời bằng cách sử dụngsetTempFolder, bạn có thể kiểm soát nơi lưu trữ các tệp tạm thời trong quá trình xử lý tài liệu.

Cảnh báo gọi lại

@Test
public void warningCallback() throws Exception {
    LoadOptions loadOptions = new LoadOptions();
    loadOptions.setWarningCallback(new DocumentLoadingWarningCallback());

    Document doc = new Document("Your Directory Path" + "Document.docx", loadOptions);
}

public static class DocumentLoadingWarningCallback implements IWarningCallback {
    public void warning(WarningInfo info) {
        // Xử lý các cảnh báo khi chúng phát sinh trong quá trình tải tài liệu.
        System.out.println(MessageFormat.format("WARNING: {0}, source: {1}", info.getWarningType(), info.getSource()));
        System.out.println(MessageFormat.format("\tDescription: {0}", info.getDescription()));
    }
}

Mã này trình bày cách thiết lập lệnh gọi lại cảnh báo để xử lý cảnh báo trong quá trình tải tài liệu. Bạn có thể tùy chỉnh hành vi của ứng dụng khi cảnh báo xảy ra.

Chuyển đổi Metafiles sang PNG

@Test
public void convertMetafilesToPng() throws Exception {
    LoadOptions loadOptions = new LoadOptions();
    loadOptions.setConvertMetafilesToPng(true);

    Document doc = new Document("Your Directory Path" + "WMF with image.docx", loadOptions);
}

Để chuyển đổi các tệp siêu dữ liệu (ví dụ: WMF) sang hình ảnh PNG trong khi tải tài liệu, bạn có thể sử dụngsetConvertMetafilesToPng(true) phương pháp.

Mã nguồn đầy đủ để làm việc với tùy chọn tải trong Aspose.Words cho Java

public void updateDirtyFields() throws Exception {
	LoadOptions loadOptions = new LoadOptions();
	{
		loadOptions.setUpdateDirtyFields(true);
	}
	Document doc = new Document("Your Directory Path" + "Dirty field.docx", loadOptions);
	doc.save("Your Directory Path" + "WorkingWithLoadOptions.UpdateDirtyFields.docx");
}
@Test
public void loadEncryptedDocument() throws Exception {
	Document doc = new Document("Your Directory Path" + "Encrypted.docx", new LoadOptions("docPassword"));
	doc.save("Your Directory Path" + "WorkingWithLoadOptions.LoadAndSaveEncryptedOdt.odt", new OdtSaveOptions("newPassword"));
}
@Test
public void convertShapeToOfficeMath() throws Exception {
	LoadOptions loadOptions = new LoadOptions();
	{
		loadOptions.setConvertShapeToOfficeMath(true);
	}
	Document doc = new Document("Your Directory Path" + "Office math.docx", loadOptions);
	doc.save("Your Directory Path" + "WorkingWithLoadOptions.ConvertShapeToOfficeMath.docx", SaveFormat.DOCX);
}
@Test
public void setMsWordVersion() throws Exception {
	// Tạo một đối tượng LoadOptions mới, đối tượng này sẽ tải các tài liệu theo thông số kỹ thuật của MS Word 2019 theo mặc định
	// và thay đổi phiên bản tải xuống thành Microsoft Word 2010.
	LoadOptions loadOptions = new LoadOptions();
	{
		loadOptions.setMswVersion(MsWordVersion.WORD_2010);
	}
	Document doc = new Document("Your Directory Path" + "Document.docx", loadOptions);
	doc.save("Your Directory Path" + "WorkingWithLoadOptions.SetMsWordVersion.docx");
}
@Test
public void useTempFolder() throws Exception {
	LoadOptions loadOptions = new LoadOptions();
	{
		loadOptions.setTempFolder("Your Directory Path");
	}
	Document doc = new Document("Your Directory Path" + "Document.docx", loadOptions);
}
@Test
public void warningCallback() throws Exception {
	LoadOptions loadOptions = new LoadOptions();
	{
		loadOptions.setWarningCallback(new DocumentLoadingWarningCallback());
	}
	Document doc = new Document("Your Directory Path" + "Document.docx", loadOptions);
}
public static class DocumentLoadingWarningCallback implements IWarningCallback {
	public void warning(WarningInfo info) {
		//In các cảnh báo và thông tin chi tiết khi chúng phát sinh trong quá trình tải tài liệu.
		System.out.println(MessageFormat.format("WARNING: {0}, source: {1}", info.getWarningType(), info.getSource()));
		System.out.println(MessageFormat.format("\tDescription: {0}", info.getDescription()));
	}
}
@Test
public void convertMetafilesToPng() throws Exception {
	LoadOptions loadOptions = new LoadOptions();
	{
		loadOptions.setConvertMetafilesToPng(true);
	}
	Document doc = new Document("Your Directory Path" + "WMF with image.docx", loadOptions);
}
@Test
public void loadChm() throws Exception {
	LoadOptions loadOptions = new LoadOptions();
	{
		loadOptions.setEncoding(Charset.forName("windows-1251"));
	}
	Document doc = new Document("Your Directory Path" + "HTML help.chm", loadOptions);
}

Phần kết luận

Trong hướng dẫn này, chúng tôi đã đi sâu vào nhiều khía cạnh khác nhau của việc làm việc với Load Options trong Aspose.Words for Java. Load Options đóng vai trò quan trọng trong việc tùy chỉnh cách tải và xử lý tài liệu, cho phép bạn tùy chỉnh cách xử lý tài liệu theo nhu cầu cụ thể của mình. Hãy cùng tóm tắt lại các điểm chính được đề cập trong hướng dẫn này:

Câu hỏi thường gặp

Tôi có thể xử lý cảnh báo trong quá trình tải tài liệu như thế nào?

Bạn có thể thiết lập cảnh báo gọi lại như được hiển thị trongwarningCallback() phương pháp trên. Tùy chỉnhDocumentLoadingWarningCallback lớp xử lý cảnh báo theo yêu cầu của ứng dụng của bạn.

Tôi có thể chuyển đổi hình dạng thành đối tượng Office Math khi tải tài liệu không?

Có, bạn có thể chuyển đổi hình dạng thành các đối tượng Office Math bằng cách sử dụngloadOptions.setConvertShapeToOfficeMath(true).

Làm thế nào để chỉ định phiên bản MS Word để tải tài liệu?

Sử dụngloadOptions.setMswVersion(MsWordVersion.WORD_2010) để chỉ định phiên bản MS Word để tải tài liệu.

Mục đích của việc này là gì?setTempFolder method in Load Options?

CácsetTempFolderPhương pháp này cho phép bạn chỉ định thư mục lưu trữ các tập tin tạm thời trong quá trình xử lý tài liệu.