Usando opções de carregamento em Aspose.Words para Java

Introdução ao trabalho com opções de carregamento em Aspose.Words para Java

Neste tutorial, exploraremos como trabalhar com opções de carregamento em Aspose.Words for Java. As opções de carregamento permitem personalizar como os documentos são carregados e processados. Cobriremos vários cenários, incluindo atualização de campos sujos, carregamento de documentos criptografados, conversão de formas para Office Math, configuração da versão do MS Word, especificação de uma pasta temporária, tratamento de avisos e conversão de metarquivos para PNG. Vamos mergulhar passo a passo.

Atualizar campos sujos

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 trecho de código demonstra como atualizar campos sujos em um documento. OsetUpdateDirtyFields(true) O método é usado para garantir que os campos sujos sejam atualizados durante o carregamento do documento.

Carregar documento criptografado

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

Aqui, carregamos um documento criptografado usando uma senha. OLoadOptions O construtor aceita a senha do documento e você também pode especificar uma nova senha ao salvar o documento usandoOdtSaveOptions.

Converter forma em 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 demonstra como converter formas em objetos do Office Math durante o carregamento do documento. OsetConvertShapeToOfficeMath(true)método permite essa conversão.

Definir versão do 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");
}

Você pode especificar a versão do MS Word para carregamento do documento. Neste exemplo, definimos a versão para Microsoft Word 2010 usandosetMswVersion.

Usar pasta temporária

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

Ao definir a pasta temporária usandosetTempFolder, você pode controlar onde os arquivos temporários são armazenados durante o processamento do documento.

Retorno de chamada de aviso

@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) {
        // Lide com avisos à medida que surgirem durante o carregamento 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 demonstra como configurar um retorno de chamada de aviso para lidar com avisos durante o carregamento do documento. Você pode personalizar o comportamento do seu aplicativo quando ocorrerem avisos.

Converter metarquivos em 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 converter metarquivos (por exemplo, WMF) em imagens PNG durante o carregamento do documento, você pode usar osetConvertMetafilesToPng(true) método.

Código-fonte completo para trabalhar com opções de carregamento em Aspose.Words for 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 {
	// Crie um novo objeto LoadOptions, que carregará documentos de acordo com a especificação do MS Word 2019 por padrão
	// e altere a versão de carregamento para 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 avisos e seus detalhes à medida que surgem durante o carregamento do documento.
		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);
}

Conclusão

Neste tutorial, nos aprofundamos em vários aspectos do trabalho com opções de carregamento em Aspose.Words for Java. As opções de carregamento desempenham um papel crucial na personalização de como os documentos são carregados e processados, permitindo adaptar o processamento de documentos às suas necessidades específicas. Vamos recapitular os principais pontos abordados neste guia:

Perguntas frequentes

Como posso lidar com avisos durante o carregamento de documentos?

Você pode configurar um retorno de chamada de aviso conforme mostrado nawarningCallback() método acima. Personalize oDocumentLoadingWarningCallback class para lidar com avisos de acordo com os requisitos do seu aplicativo.

Posso converter formas em objetos do Office Math ao carregar um documento?

Sim, você pode converter formas em objetos do Office Math usandoloadOptions.setConvertShapeToOfficeMath(true).

Como especifico a versão do MS Word para carregamento de documentos?

UsarloadOptions.setMswVersion(MsWordVersion.WORD_2010) para especificar a versão do MS Word para carregamento do documento.

Qual é o propósito dosetTempFolder method in Load Options?

OsetTempFolder método permite que você especifique a pasta onde os arquivos temporários são armazenados durante o processamento do documento.