Como girar páginas de arquivos PDF em Java

Como girar páginas PDF em Java usando a API Rest.

Os arquivos PDF são amplamente usados para várias finalidades, incluindo compartilhamento, arquivamento e impressão de documentos. No entanto, há situações em que pode ser necessário girar todas as páginas ou páginas específicas em um arquivo PDF programaticamente. Se você deseja corrigir a orientação das páginas digitalizadas ou ajustar o layout para melhor legibilidade, girar as páginas do PDF é um requisito comum. Neste artigo, exploraremos como girar páginas PDF em Java usando a API REST.

Os seguintes tópicos serão abordados neste artigo:

Java REST API para girar páginas PDF online e instalação do SDK

GroupDocs.Merger Cloud SDK for Java é uma solução poderosa e confiável que permite manipular documentos PDF programaticamente. Ele fornece uma ampla gama de recursos que facilitam a divisão, mesclagem, reordenar, girar, trocar e manipular documentos PDF. O SDK é fácil de usar e pode ser integrado a um aplicativo baseado em Java para automatizar tarefas de manipulação de arquivos.

Você pode baixar o arquivo JAR da API ou instalá-lo usando o Maven adicionando o seguinte repositório e dependência ao arquivo pom.xml do seu projeto:

Repositório Maven:

<repository>
    <id>groupdocs-artifact-repository</id>
    <name>GroupDocs Artifact Repository</name>
    <url>https://repository.groupdocs.cloud/repo</url>
</repository>

Dependência do Maven:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger-cloud</artifactId>
    <version>23.2</version>
    <scope>compile</scope>
</dependency>

Agora, você precisa inscrever-se para uma conta de avaliação gratuita ou comprar um plano de assinatura no site do GroupDocs para obter sua chave de API. Depois de obter o ID do cliente e o segredo do cliente, adicione o trecho de código abaixo a um aplicativo baseado em Java:

# Obtenha seu client_id e client_secret em https://dashboard.groupdocs.cloud após o registro.

String ClientId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
String ClientSecret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
String MyStorage = "test-internal-storage";
Configuration configuration = new Configuration(ClientId, ClientSecret);

Como girar todas as páginas em um arquivo PDF usando Java

Girar páginas de arquivos PDF com GroupDocs.Merger Cloud SDK é um processo simples. Siga estas etapas para girar todas as páginas em um arquivo PDF:

  • Upload o arquivo PDF para a nuvem
  • Girar páginas de arquivo PDF usando Java
  • Baixar o documento PDF

Envie os arquivos

Em primeiro lugar, carregue o arquivo PDF para a nuvem usando o exemplo de código abaixo:

package com.groupdocsdev.classes;

import java.io.File;
import com.groupdocs.cloud.merger.client.*;
import com.groupdocs.cloud.merger.model.*;
import com.groupdocs.cloud.merger.model.requests.*;
import com.groupdocs.cloud.merger.api.*;
import com.groupdocs.cloud.merger.client.ApiException;

// Carregar arquivo para o Cloud Storage usando Java
public class App {

	public static void main(String[] args) {

		FileApi apiInstance = new FileApi(configuration);
		try {
			File fileStream = new File("H:\\groupdocs-cloud-data\\input-sample-file.pdf");
			UploadFileRequest request = new UploadFileRequest("java-testing\\input-sample-file.pdf", fileStream, MyStorage);
			FilesUploadResult response = apiInstance.uploadFile(request);
			System.out.println("Expected response type is FilesUploadResult: " + response.getUploaded().size());
		} catch (ApiException e) {
			System.err.println("Exception while calling FileApi:");
			e.printStackTrace();
		}
	}
}

Como resultado, o arquivo PDF carregado estará disponível na seção de arquivos do seu painel na nuvem.

Girar páginas de arquivos PDF em Java

Seguindo as etapas e um trecho de código de exemplo, você pode facilmente girar as páginas do PDF programaticamente usando GroupDocs.Merger Cloud SDK em seu aplicativo Java:

  • Em primeiro lugar, importe as classes necessárias para o seu arquivo Java.
  • Em segundo lugar, crie uma instância da classe PagesApi.
  • Em terceiro lugar, crie uma instância da classe FileInfo.
  • Agora, forneça o caminho do documento PDF de entrada.
  • Em seguida, crie uma instância da classe RotateOptions.
  • Agora, defina o fileInfo e o caminho do arquivo de saída de exemplo.
  • Em seguida, defina a rotação de página desejada como Rotate90, Rotate180 ou Rotate270.
  • Depois disso, crie a instância da classe RotateRequest e passe o parâmetro RotateOptions.
  • Por fim, chame o método rotate() e passe o parâmetro RotateRequest para girar as páginas do arquivo PDF.

O trecho de código a seguir mostra como girar todas as páginas de um arquivo PDF em Java usando a API REST:

package com.groupdocsdev.classes;

import java.util.Arrays;
import com.groupdocs.cloud.merger.client.*;
import com.groupdocs.cloud.merger.model.*;
import com.groupdocs.cloud.merger.model.requests.*;
import com.groupdocs.cloud.merger.api.*;
import com.groupdocs.cloud.merger.client.ApiException;

// Como girar todas as páginas em um arquivo PDF usando Java.
public class App {

	public static void main(String[] args) {

	  // Crie uma instância da API de páginas
		PagesApi apiInstance = new PagesApi(configuration);

		try {

	                // Prepare as configurações
			FileInfo fileInfo = new FileInfo();
			fileInfo.setFilePath("java-testing/input-sample-file.pdf");
			
			RotateOptions options = new RotateOptions();
			options.setFileInfo(fileInfo);
			options.setOutputPath("java-testing/output-sample-file.pdf");
			options.setMode(RotateOptions.ModeEnum.ROTATE90);
			
			RotateRequest request = new RotateRequest(options);

			DocumentResult response = apiInstance.rotate(request);
			
			// Obter caminho do arquivo de saída
			System.out.println("Output file path: " + response.getPath());
			
		} catch (ApiException e) {
			System.err.println("Exception while calling FileApi:");
			e.printStackTrace();
		}
		
	}
}

Baixe o arquivo

O exemplo de código acima salvará o arquivo PDF girado na nuvem. Você pode baixá-lo usando o seguinte exemplo de código:

package com.groupdocsdev.classes;

import java.io.File;
import com.groupdocs.cloud.merger.client.*;
import com.groupdocs.cloud.merger.model.requests.*;
import com.groupdocs.cloud.merger.api.*;
import com.groupdocs.cloud.merger.client.ApiException;

// Baixe o arquivo do armazenamento em nuvem usando Java
public class App {

	public static void main(String[] args) {

		FileApi apiInstance = new FileApi(configuration);
		try {

			DownloadFileRequest request = new DownloadFileRequest("java-testing\\output-sample-file.pdf", MyStorage, null);
			File response = apiInstance.downloadFile(request);
			System.out.println("Expected response type is downloadFile: " + response.length());
		} catch (ApiException e) {
			System.err.println("Exception while calling FileApi:");
			e.printStackTrace();
		}
	}
}

Como girar páginas específicas de um arquivo PDF em Java

Se você deseja girar apenas páginas específicas de um arquivo PDF, o SDK permite que você defina o intervalo de páginas de acordo. Aqui estão as etapas e um trecho de código de exemplo para definir ângulos de rotação personalizados:

  • Em primeiro lugar, importe as classes necessárias para o seu arquivo Java.
  • Em segundo lugar, crie uma instância da classe PagesApi.
  • Em terceiro lugar, crie uma instância da classe FileInfo.
  • Agora, forneça o caminho do documento PDF de entrada.
  • Em seguida, crie uma instância da classe RotateOptions.
  • Agora, defina o fileInfo e o caminho do arquivo de saída de exemplo.
  • Defina os números de página desejados na matriz de coleção de páginas.
  • Em seguida, defina a rotação de página desejada como Rotate90, Rotate180 ou Rotate270.
  • Depois disso, crie a instância da classe RotateRequest e passe o parâmetro RotateOptions.
  • Por fim, chame o método rotate() e passe o parâmetro RotateRequest para girar as páginas do arquivo PDF.

O trecho de código a seguir detalha como girar páginas específicas ou determinadas em um documento PDF usando Java:

package com.groupdocsdev.classes;

import java.util.Arrays;
import com.groupdocs.cloud.merger.client.*;
import com.groupdocs.cloud.merger.model.*;
import com.groupdocs.cloud.merger.model.requests.*;
import com.groupdocs.cloud.merger.api.*;
import com.groupdocs.cloud.merger.client.ApiException;

// Como girar páginas específicas de um arquivo PDF em Java.
public class App {

	public static void main(String[] args) {

	  // Crie uma instância da API de páginas
		PagesApi apiInstance = new PagesApi(configuration);

		try {

	               // Prepare as configurações
			FileInfo fileInfo = new FileInfo();
			fileInfo.setFilePath("java-testing/input-sample-file.pdf");
			
			RotateOptions options = new RotateOptions();
			options.setFileInfo(fileInfo);
			options.setOutputPath("java-testing/output-sample-file.pdf");
			options.setPages(Arrays.asList(3, 5));
			options.setMode(RotateOptions.ModeEnum.ROTATE90);

			RotateRequest request = new RotateRequest(options);
			
			DocumentResult response = apiInstance.rotate(request);
			
			// Obter caminho do arquivo de saída
			System.out.println("Output file path: " + response.getPath());
			
		} catch (ApiException e) {
			System.err.println("Exception while calling FileApi:");
			e.printStackTrace();
		}
		
	}
}

Girar páginas PDF online gratuitamente

Como girar páginas PDF online gratuitamente? Tente a seguinte ferramenta on-line gratuita para girar as páginas do arquivo PDF. Esta ferramenta é desenvolvida usando as APIs Groupdocs.Merger Cloud mencionadas acima.

Conclusão

Com GroupDocs.Merger Cloud SDK para Java, você pode facilmente girar páginas PDF, melhorar a legibilidade do documento e melhorar a experiência do usuário. O seguinte é o que você aprendeu neste artigo:

  • como girar todas as páginas em um documento PDF usando Java;
  • carregar e baixar programaticamente os arquivos em Java na nuvem;
  • como girar páginas específicas de arquivos PDF usando Java;
  • e gire as páginas do arquivo PDF gratuitamente usando uma ferramenta de rotação de PDF online.

Além disso, também fornecemos uma seção de referência de API que permite que você visualize e se comunique com nossas APIs diretamente pelo navegador. O código-fonte completo do Java SDK está disponível gratuitamente no Github. Verifique o GroupDocs.Merger Cloud SDK para Java Exemplos aqui.

Além disso, sugerimos que você siga nosso Guia de primeiros passos para obter etapas detalhadas e uso da API.

Por fim, continuamos escrevendo novas postagens de blog sobre diferentes operações de documentos usando a API REST. Então, por favor, entre em contato para as atualizações regulares.

Faça uma pergunta

Se você tiver alguma dúvida sobre a API de rotação de páginas em PDF, sinta-se à vontade para nos perguntar no Fórum de suporte gratuito.

perguntas frequentes

Posso girar páginas específicas em um documento PDF usando GroupDocs.Merger Cloud SDK para Java?

Sim, você pode especificar o intervalo de páginas para girar páginas específicas em um documento PDF usando GroupDocs.Merger Cloud SDK for Java.

Como faço para girar páginas PDF online em Java?

Crie uma instância de PagesApi, defina os valores de RotateOptions e invoque o método pagesApi.rotate() com RotateRequest para girar páginas PDF e salvá-las online usando Java.

Como faço para girar as páginas do arquivo PDF no Windows?

Visite este link para baixar a ferramenta de rotação de páginas em PDF. Este software off-line é usado para executar diferentes operações de formato de arquivo, incluindo rotação de documentos no Windows.

Veja também

Aqui estão alguns artigos relacionados que podem ser úteis: