كيفية تدوير صفحات ملفات PDF بجافا

كيفية تدوير صفحات PDF في Java باستخدام Rest API.

تستخدم ملفات PDF على نطاق واسع لأغراض مختلفة ، بما في ذلك مشاركة المستندات والأرشفة والطباعة. ومع ذلك ، هناك مواقف قد تحتاج فيها إلى تدوير كل أو صفحات معينة في ملف PDF برمجيًا. سواء كنت تريد تصحيح اتجاه الصفحات الممسوحة ضوئيًا أو ضبط التخطيط لقراءة أفضل ، فإن تدوير صفحات PDF يعد مطلبًا شائعًا. في هذه المقالة ، سوف نستكشف كيفية تدوير صفحات PDF في Java باستخدام REST API.

سيتم تناول الموضوعات التالية في هذه المقالة:

Java REST API لتدوير صفحات PDF عبر الإنترنت وتثبيت SDK

GroupDocs.Merger Cloud SDK لجافا هو حل قوي وموثوق يسمح لك بمعالجة مستندات PDF برمجيًا. يوفر مجموعة واسعة من الميزات التي تسهل تقسيم مستندات PDF ودمجها وإعادة ترتيبها وتدويرها وتبديلها ومعالجتها. SDK سهل الاستخدام ويمكن دمجه في تطبيق قائم على Java لأتمتة مهام معالجة الملفات.

يمكنك إما تنزيل ملف JAR الخاص بواجهة برمجة التطبيقات أو تثبيته باستخدام Maven عن طريق إضافة المستودع التالي والتبعية إلى ملف pom.xml الخاص بمشروعك:

مستودع مافن:

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

تبعية المخضرم:

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

الآن ، تحتاج إلى التسجيل للحصول على حساب تجريبي مجاني أو شراء خطة اشتراك على موقع GroupDocs على الويب للحصول على مفتاح API الخاص بك. بمجرد حصولك على معرف العميل وسر العميل ، أضف مقتطف الشفرة أدناه إلى تطبيق يستند إلى Java:

# احصل على client_id و client_secret من https://dashboard.groupdocs.cloud بعد التسجيل.

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

كيفية تدوير جميع الصفحات في ملف PDF باستخدام Java

تدوير صفحات ملفات PDF باستخدام GroupDocs.Merger Cloud SDK هي عملية مباشرة. اتبع هذه الخطوات لتدوير كل الصفحات داخل ملف PDF:

تحميل الملفات

أولاً ، قم بتحميل ملف PDF إلى السحابة باستخدام مثال الرمز الموضح أدناه:

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;

// قم بتحميل الملف إلى Cloud Storage باستخدام 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();
		}
	}
}

نتيجة لذلك ، سيكون ملف PDF الذي تم تحميله متاحًا في قسم الملفات من لوحة التحكم على السحابة.

تدوير صفحات ملف PDF في Java

باتباع الخطوات ومثال مقتطف الشفرة ، يمكنك بسهولة تدوير صفحات PDF برمجيًا باستخدام GroupDocs.Merger Cloud SDK في تطبيق Java الخاص بك:

  • أولاً ، قم باستيراد الفئات المطلوبة إلى ملف Java الخاص بك.
  • ثانيًا ، قم بإنشاء مثيل لفئة PagesApi.
  • ثالثًا ، قم بإنشاء مثيل للفئة FileInfo.
  • الآن ، قم بتوفير مسار مستند PDF للإدخال.
  • ثم قم بإنشاء مثيل لفئة RotateOptions.
  • الآن ، قم بتعيين fileInfo وعينة مسار ملف الإخراج.
  • بعد ذلك ، قم بتعيين تدوير الصفحة المطلوب مثل Rotate90 أو Rotate180 أو Rotate270.
  • بعد ذلك ، قم بإنشاء مثيل فئة RotateRequest وتمرير معلمة RotateOptions.
  • أخيرًا ، قم باستدعاء طريقة rotate() وقم بتمرير معلمة RotateRequest لتدوير صفحات ملف PDF.

يوضح مقتطف الشفرة التالي كيفية تدوير جميع صفحات ملف PDF في Java باستخدام REST API:

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;

// كيفية تدوير جميع الصفحات في ملف PDF باستخدام Java.
public class App {

	public static void main(String[] args) {

	  // أنشئ مثيلاً لواجهة برمجة تطبيقات الصفحات
		PagesApi apiInstance = new PagesApi(configuration);

		try {

	                // تحضير الإعدادات
			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);
			
			// الحصول على مسار ملف الإخراج
			System.out.println("Output file path: " + response.getPath());
			
		} catch (ApiException e) {
			System.err.println("Exception while calling FileApi:");
			e.printStackTrace();
		}
		
	}
}

تنزيل الملف

نموذج الكود أعلاه سيحفظ ملف PDF الذي تم تدويره على السحابة. يمكنك تنزيله باستخدام نموذج التعليمات البرمجية التالي:

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;

// قم بتنزيل الملف من Cloud Storage باستخدام 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();
		}
	}
}

كيفية تدوير صفحات معينة من ملف PDF في جافا

إذا كنت تريد تدوير صفحات معينة فقط من ملف PDF ، فإن SDK يسمح لك بتحديد نطاق الصفحات وفقًا لذلك. فيما يلي الخطوات ومثال مقتطف الشفرة لتعيين زوايا دوران مخصصة:

  • أولاً ، قم باستيراد الفئات المطلوبة إلى ملف Java الخاص بك.
  • ثانيًا ، قم بإنشاء مثيل لفئة PagesApi.
  • ثالثًا ، قم بإنشاء مثيل للفئة FileInfo.
  • الآن ، قم بتوفير مسار مستند PDF للإدخال.
  • ثم قم بإنشاء مثيل لفئة RotateOptions.
  • الآن ، قم بتعيين fileInfo وعينة مسار ملف الإخراج.
  • قم بتعيين أرقام الصفحات المطلوبة في مصفوفة مجموعة الصفحات.
  • بعد ذلك ، قم بتعيين تدوير الصفحة المطلوب مثل Rotate90 أو Rotate180 أو Rotate270.
  • بعد ذلك ، قم بإنشاء مثيل فئة RotateRequest وتمرير معلمة RotateOptions.
  • أخيرًا ، قم باستدعاء طريقة rotate() وقم بتمرير معلمة RotateRequest لتدوير صفحات ملف PDF.

يوضح مقتطف الشفرة التالي كيفية تدوير صفحات معينة أو معينة في مستند PDF باستخدام 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;

// كيفية تدوير صفحات معينة من ملف PDF في جافا.
public class App {

	public static void main(String[] args) {

	  // أنشئ مثيلاً لواجهة برمجة تطبيقات الصفحات
		PagesApi apiInstance = new PagesApi(configuration);

		try {

	               // تحضير الإعدادات
			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);
			
			// الحصول على مسار ملف الإخراج
			System.out.println("Output file path: " + response.getPath());
			
		} catch (ApiException e) {
			System.err.println("Exception while calling FileApi:");
			e.printStackTrace();
		}
		
	}
}

قم بتدوير صفحات PDF مجانًا عبر الإنترنت

كيفية تدوير صفحات PDF عبر الإنترنت مجانًا؟ يرجى تجربة [أداة الإنترنت المجانية] التالية 21 لتدوير صفحات ملف PDF. تم تطوير هذه الأداة باستخدام Groupdocs.Merger Cloud APIs المذكورة أعلاه.

الخلاصة

باستخدام GroupDocs.Merger Cloud SDK لـ Java ، يمكنك بسهولة تدوير صفحات PDF ، وتحسين إمكانية قراءة المستندات ، وتحسين تجربة المستخدم. فيما يلي ما تعلمته في هذا المقال:

  • كيفية تدوير جميع الصفحات في مستند PDF باستخدام Java ؛
  • تحميل وتنزيل الملفات برمجيًا في Java على السحابة ؛
  • كيفية تدوير صفحات معينة من ملفات PDF باستخدام Java ؛
  • وقم بتدوير صفحات ملفات PDF مجانًا باستخدام أداة تدوير PDF عبر الإنترنت.

بالإضافة إلى ذلك ، نقدم أيضًا قسم مرجع API يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتواصل معها مباشرةً من خلال المتصفح. شفرة المصدر الكاملة لـ Java SDK متاحة مجانًا على Github. يرجى التحقق من GroupDocs.Merger Cloud SDK لـ Java أمثلة هنا.

علاوة على ذلك ، نقترح عليك اتباع دليل البدء لمعرفة الخطوات التفصيلية واستخدام واجهة برمجة التطبيقات.

أخيرًا ، نواصل كتابة منشورات مدونة جديدة حول عمليات المستندات المختلفة باستخدام REST API. لذا ، يرجى الاتصال للحصول على التحديثات المنتظمة.

طرح سؤال

إذا كانت لديك أي أسئلة حول واجهة برمجة تطبيقات تدوير صفحات PDF ، فلا تتردد في طرحها على منتدى الدعم المجاني.

أسئلة وأجوبة

هل يمكنني تدوير صفحات معينة داخل مستند PDF باستخدام GroupDocs.Merger Cloud SDK لـ Java؟

نعم ، يمكنك تحديد نطاق الصفحات لتدوير صفحات معينة داخل مستند PDF باستخدام GroupDocs.Merger Cloud SDK لجافا.

كيف أقوم بتدوير صفحات PDF عبر الإنترنت في Java؟

قم بإنشاء مثيل لـ PagesApi ، وقم بتعيين قيم خيارات التدوير ، واستدعاء طريقة pagesApi.rotate() باستخدام RotateRequest لتدوير صفحات PDF وحفظها عبر الإنترنت باستخدام Java.

كيف أقوم بتدوير صفحات ملف PDF على نظام Windows؟

يرجى زيارة هذا الرابط لتنزيل أداة تدوير صفحات PDF. يُستخدم هذا البرنامج غير المتصل لإجراء عمليات تنسيق ملفات مختلفة ، بما في ذلك تدوير المستندات في Windows.

أنظر أيضا

فيما يلي بعض المقالات ذات الصلة التي قد تجدها مفيدة: