Korzystanie z opcji ładowania w Aspose.Words dla Java
Wprowadzenie do pracy z opcjami ładowania w Aspose.Words dla Java
tym samouczku omówimy, jak pracować z opcjami ładowania w Aspose.Words dla Java. Opcje ładowania umożliwiają dostosowanie sposobu ładowania i przetwarzania dokumentów. Omówimy różne scenariusze, w tym aktualizację brudnych pól, ładowanie zaszyfrowanych dokumentów, konwertowanie kształtów do Office Math, ustawianie wersji MS Word, określanie folderu tymczasowego, obsługę ostrzeżeń i konwertowanie metaplików do formatu PNG. Zanurzmy się krok po kroku.
Zaktualizuj brudne pola
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");
Ten fragment kodu demonstruje, jak zaktualizować uszkodzone pola w dokumencie. ThesetUpdateDirtyFields(true)
Metoda ta służy do zapewnienia aktualizacji brudnych pól podczas ładowania dokumentu.
Załaduj zaszyfrowany dokument
@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"));
}
Tutaj ładujemy zaszyfrowany dokument za pomocą hasła. TheLoadOptions
konstruktor akceptuje hasło dokumentu, możesz także określić nowe hasło podczas zapisywania dokumentu za pomocąOdtSaveOptions
.
Konwertuj kształt na 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);
Ten kod ilustruje sposób konwertowania kształtów na obiekty pakietu Office Math podczas ładowania dokumentu. ThesetConvertShapeToOfficeMath(true)
Metoda umożliwia tę konwersję.
Ustaw wersję 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");
}
Możesz określić wersję MS Word do ładowania dokumentu. W tym przykładzie ustawiliśmy wersję na Microsoft Word 2010 za pomocąsetMswVersion
.
Użyj folderu tymczasowego
@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);
}
Ustawiając folder tymczasowy za pomocąsetTempFolder
możesz kontrolować miejsce przechowywania plików tymczasowych podczas przetwarzania dokumentu.
Ostrzeżenie o oddzwonieniu
@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) {
// Postępuj z ostrzeżeniami pojawiającymi się podczas ładowania dokumentu.
System.out.println(MessageFormat.format("WARNING: {0}, source: {1}", info.getWarningType(), info.getSource()));
System.out.println(MessageFormat.format("\tDescription: {0}", info.getDescription()));
}
}
Ten kod demonstruje, jak skonfigurować wywołanie zwrotne z ostrzeżeniem w celu obsługi ostrzeżeń podczas ładowania dokumentu. Możesz dostosować zachowanie aplikacji w przypadku wystąpienia ostrzeżeń.
Konwertuj metapliki na 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);
}
Aby przekonwertować metapliki (np. WMF) na obrazy PNG podczas ładowania dokumentu, możesz użyć metodysetConvertMetafilesToPng(true)
metoda.
Kompletny kod źródłowy do pracy z opcjami ładowania w Aspose.Words dla 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 {
// Utwórz nowy obiekt LoadOptions, który domyślnie będzie ładować dokumenty zgodnie ze specyfikacją MS Word 2019
// i zmień wersję ładującą na 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) {
//Drukuje ostrzeżenia i ich szczegóły pojawiające się podczas ładowania dokumentu.
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);
}
Wniosek
W tym samouczku zagłębiliśmy się w różne aspekty pracy z opcjami ładowania w Aspose.Words dla Java. Opcje ładowania odgrywają kluczową rolę w dostosowywaniu sposobu ładowania i przetwarzania dokumentów, umożliwiając dostosowanie przetwarzania dokumentów do konkretnych potrzeb. Podsumujmy najważniejsze punkty omówione w tym przewodniku:
Często zadawane pytania
Jak mogę obsługiwać ostrzeżenia podczas ładowania dokumentu?
Możesz ustawić ostrzegawcze wywołanie zwrotne, jak pokazano wwarningCallback()
metoda powyżej. DostosujDocumentLoadingWarningCallback
klasa do obsługi ostrzeżeń zgodnie z wymaganiami aplikacji.
Czy podczas ładowania dokumentu mogę konwertować kształty na obiekty pakietu Office Math?
Tak, możesz konwertować kształty na obiekty Office Math za pomocąloadOptions.setConvertShapeToOfficeMath(true)
.
Jak określić wersję programu MS Word do ładowania dokumentu?
UżywaćloadOptions.setMswVersion(MsWordVersion.WORD_2010)
aby określić wersję MS Word do ładowania dokumentu.
Jaki jest celsetTempFolder
method in Load Options?
ThesetTempFolder
Metoda pozwala określić folder, w którym będą przechowywane pliki tymczasowe podczas przetwarzania dokumentu.