Uso de opciones de carga en Aspose.Words para Java

Introducción a trabajar con opciones de carga en Aspose.Words para Java

En este tutorial, exploraremos cómo trabajar con las opciones de carga en Aspose.Words para Java. Las opciones de carga le permiten personalizar cómo se cargan y procesan los documentos. Cubriremos varios escenarios, incluida la actualización de campos sucios, la carga de documentos cifrados, la conversión de formas a Office Math, la configuración de la versión de MS Word, la especificación de una carpeta temporal, el manejo de advertencias y la conversión de metarchivos a PNG. Profundicemos paso a paso.

Actualizar campos sucios

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");

Este fragmento de código demuestra cómo actualizar campos sucios en un documento. ElsetUpdateDirtyFields(true) El método se utiliza para garantizar que los campos sucios se actualicen durante la carga del documento.

Cargar documento cifrado

@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"));
}

Aquí, cargamos un documento cifrado usando una contraseña. ElLoadOptions El constructor acepta la contraseña del documento y también puede especificar una nueva contraseña al guardar el documento usandoOdtSaveOptions.

Convertir formas a 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);

Este código demuestra cómo convertir formas en objetos de Office Math durante la carga del documento. ElsetConvertShapeToOfficeMath(true)El método permite esta conversión.

Establecer la versión de 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");
}

Puede especificar la versión de MS Word para cargar el documento. En este ejemplo, configuramos la versión en Microsoft Word 2010 usandosetMswVersion.

Usar carpeta temporal

@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);
}

Al configurar la carpeta temporal usandosetTempFolder, puede controlar dónde se almacenan los archivos temporales durante el procesamiento de documentos.

Devolución de llamada de advertencia

@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) {
        // Maneje las advertencias que surjan durante la carga de documentos.
        System.out.println(MessageFormat.format("WARNING: {0}, source: {1}", info.getWarningType(), info.getSource()));
        System.out.println(MessageFormat.format("\tDescription: {0}", info.getDescription()));
    }
}

Este código demuestra cómo configurar una devolución de llamada de advertencia para manejar las advertencias durante la carga del documento. Puede personalizar el comportamiento de su aplicación cuando ocurren advertencias.

Convertir metarchivos a 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);
}

Para convertir metarchivos (por ejemplo, WMF) a imágenes PNG durante la carga del documento, puede utilizar elsetConvertMetafilesToPng(true) método.

Código fuente completo para trabajar con opciones de carga en Aspose.Words para 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 {
	// Cree un nuevo objeto LoadOptions, que cargará documentos de acuerdo con la especificación de MS Word 2019 de forma predeterminada.
	// y cambie la versión de carga a 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) {
		//Imprime advertencias y sus detalles a medida que surgen durante la carga de documentos.
		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);
}

Conclusión

En este tutorial, hemos profundizado en varios aspectos del trabajo con opciones de carga en Aspose.Words para Java. Las opciones de carga juegan un papel crucial en la personalización de cómo se cargan y procesan los documentos, lo que le permite adaptar el procesamiento de documentos a sus necesidades específicas. Recapitulemos los puntos clave cubiertos en esta guía:

Preguntas frecuentes

¿Cómo puedo manejar las advertencias durante la carga de documentos?

Puede configurar una devolución de llamada de advertencia como se muestra en lawarningCallback() método anterior. Personaliza elDocumentLoadingWarningCallback clase para manejar advertencias de acuerdo con los requisitos de su aplicación.

¿Puedo convertir formas en objetos de Office Math al cargar un documento?

Sí, puedes convertir formas en objetos de Office Math usandoloadOptions.setConvertShapeToOfficeMath(true).

¿Cómo especifico la versión de MS Word para cargar documentos?

UsarloadOptions.setMswVersion(MsWordVersion.WORD_2010) para especificar la versión de MS Word para cargar el documento.

¿Cuál es el propósito de lasetTempFolder method in Load Options?

ElsetTempFolderEl método le permite especificar la carpeta donde se almacenan los archivos temporales durante el procesamiento de documentos.