PDF-ის რედაქტირება ონლაინ Java REST API-ის გამოყენებით

ჩვენ გვაქვს მოთხოვნა, ამოიღოთ სენსიტიური დეტალები PDF ფაილებიდან მონაცემთა საიდუმლოების გამო, ასე რომ, ჩვენ ჩვეულებრივ ვასწორებთ (წაშლა ტექსტი, სურათი და ა.შ.) PDF დოკუმენტის გარკვეული გვერდის რეგიონიდან. თუმცა, როდესაც საქმე გვაქვს დოკუმენტების დიდ ნაკრებთან, ჩვენ უნდა გამოვიყენოთ API ამ მოთხოვნის შესასრულებლად.

ამ სტატიაში ჩვენ განვიხილავთ ნაბიჯებს, თუ როგორ უნდა მოხდეს PDF რედაქტირება ონლაინში RedactionAnnotation კლასის Aspose.PDF Cloud SDK for Java გამოყენებით.

SDK-ის ინსტალაცია
დაამატეთ რედაქციის ანოტაცია ჯავის გამოყენებით
წაიკითხეთ გვერდის რედაქციის ანოტაციები
განაახლეთ არსებული რედაქციის ანოტაცია

SDK-ის ინსტალაცია

Aspose.PDF Cloud SDK for Java არის პროგრამირების API სპეციფიკური Java დეველოპერებისთვის და ის აგებულია Aspose.PDF Cloud API-ზე. ჩვენი Cloud API-ების გამოყენება შესაძლებელია ნებისმიერი პლატფორმიდან რაიმე კონკრეტული პროგრამული უზრუნველყოფის ინსტალაციის გარეშე. თუმცა, იმისათვის, რომ გამოიყენოთ SDK, ჯერ უნდა დააინსტალიროთ იგი სისტემაზე.

Cloud SDK ხელმისაწვდომია ჩამოსატვირთად Maven და GitHub-დან. ახლა დაამატეთ შემდეგი დეტალები თქვენს pom.xml ფაილში, რომ ჩამოტვირთოთ და გამოიყენოთ Aspose.Pdf.jar თქვენს Maven build პროექტში.

<repositories>
 <repository>
        <id>aspose-cloud</id>
        <name>artifact.aspose-cloud-releases</name>
        <url>https://artifact.aspose.cloud/repo</url>
    </repository>   
</repositories>
<dependencies>
 <dependency>
        <groupId>com.aspose</groupId>
        <artifactId>aspose-pdf-cloud</artifactId>
        <version>21.1.0</version>
        <scope>compile</scope>
    </dependency>
 </dependencies>

SDK-ის დაინსტალირების შემდეგ, შემდეგი ნაბიჯი არის თქვენი პერსონალური კლიენტის ID და კლიენტის საიდუმლოების მიღება. გთხოვთ, ეწვიოთ Aspose.Cloud dashboard და თუ გაქვთ GitHub ან Google ანგარიში, უბრალოდ დარეგისტრირდით. წინააღმდეგ შემთხვევაში, დააჭირეთ ღილაკს Create a new Account და მიაწოდეთ საჭირო ინფორმაცია. ახლა შედით საინფორმაციო დაფაზე რწმუნებათა სიგელების გამოყენებით და გააფართოვეთ აპლიკაციების განყოფილება. გადადით ქვემოთ კლიენტის სერთიფიკატების განყოფილებისკენ, რომ ნახოთ კლიენტის ID და კლიენტის საიდუმლო დეტალები.

დაამატეთ რედაქციის ანოტაცია ჯავის გამოყენებით

ქვემოთ მოცემულ განყოფილებაში ჩვენ ავუხსენით ნაბიჯები, თუ როგორ უნდა დაამატოთ მართკუთხა ყუთი PDF ფაილების შინაარსის ამოსაშლელად Aspose.PDF Cloud SDK Java-სთვის.

უპირველეს ყოვლისა, ჩვენ უნდა შევქმნათ PdfApi-ს ობიექტი Aspose.Cloud დაფიდან მიღებული ClientId და ClientSecret დეტალების გადაცემისას.
მეორეც, შექმენით Rectangle კლასის ობიექტი, რათა მიუთითოთ რეგიონი გვერდზე, სადაც დაემატება ანოტაცია.
მესამე, აირჩიეთ ნაგულისხმევი მნიშვნელობა AnnotationFlags-დან და დაამატეთ იგი AnnotationFlags ტიპის სიაში.
ახლა შექმენით RedactionAnnotation კლასის მაგალითი და დააყენეთ მართკუთხა რეგიონი setRect(…) მეთოდის გამოყენებით.
დააყენეთ ჰორიზონტალური გასწორება setHorizontalAlignment(…) მეთოდის გამოყენებით და აირჩიეთ Center HorizontalAlignment enumeration-დან.
ანოტაციის შიგნით ფერის შესავსებად გამოიყენეთ setFillColor(…) მეთოდი და გადაიტანეთ Color ობიექტი.
დააყენეთ ანოტაციის ბოლო შეცვლილი თარიღი setModified(…) მეთოდის გამოყენებით.
ბოლო, შექმენით სია RedactionAnnotation ტიპის და დაამატეთ RedactAnnotation ობიექტი ამ სიაში.
და ბოლოს, გამოიძახეთ PdfApi-ის postPageRedactionAnnotations(…) მეთოდი და გაიარეთ წყაროს ფაილის სახელი, გვერდის ნომერი, სადაც ანოტაცია უნდა დაემატოს. ასევე, გადაიტანეთ RedactionAnnotation List, როგორც არგუმენტი რედაქციის პროცესის დასაწყებად.

// მიიღეთ ClientID და ClientSecret https://dashboard.aspose.cloud/-დან
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// createPdfApi მაგალითი
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// PDF დოკუმენტის შეყვანა
String sourcePDF = "PdfWithTable.pdf";

// PDF-ის გვერდი ანოტაციის განსათავსებლად
int pageNumber = 1;

// შექმენით მართკუთხედი ობიექტი, რათა მიუთითოთ რედაქტირების ანოტაციის რეგიონი
// რეგიონი გამოითვლება გვერდის ქვედა-მარცხნივ
Rectangle rect = new Rectangle()

// საზომი ერთეული არის წერტილი
  .LLX(100.)
  .LLY(700.)
  .URX(200.)
  .URY(600.);

// შექმენით AnnotationFlags მასივი
List<AnnotationFlags> flags = new ArrayList<>();

// დააყენეთ AnnotationFlag ნაგულისხმევად
flags.add(AnnotationFlags.DEFAULT);

// შექმენით ქულების ArrayList
List<Point> points = new ArrayList<>();
points.add(new Point().X(10.).Y(40.));
points.add(new Point().X(30.).Y(40.));

// შექმენით Redact Annotation ობიექტი
RedactionAnnotation annotation = new RedactionAnnotation();

// დააყენეთ ანოტაციის სახელი. 
// ის სასარგებლოა, როდესაც დოკუმენტში გვაქვს მრავალი ანოტაცია
annotation.setName("Name");
// დააყენეთ მართკუთხა რეგიონი Redact Annotation-ისთვის
annotation.setRect(rect);
annotation.setFlags(flags);

// დააყენეთ ჰორიზონტალური განლაგება ცენტრში
annotation.setHorizontalAlignment(HorizontalAlignment.CENTER);

// დააყენეთ ZIndex 1-ზე. 
annotation.setZindex(1);

// განსაზღვრეთ SlateBlue ფერი Hex კოდში
Color color = new Color();
color.setA(0x00);
color.setR(0x6A);
color.setG(0x5A);
color.setB(0xCD);
// მიუთითეთ ანოტაციის შევსების ფერი
annotation.setFillColor(color);

// თარიღი და დრო, როდესაც ანოტაცია ბოლოს შეიცვალა.
annotation.setModified("05/21/2021 12:00:00.000 AM");

// დააყენეთ 8xN რიცხვების მასივი კოორდინატების მითითებით 
// კონტენტის რეგიონი, რომელიც განზრახულია წაშლას.
annotation.setQuadPoint(points);
			        
// შექმენით List Object ტიპის RedactAnnotation
List<RedactionAnnotation> annotations = new ArrayList<>();

// დაამატეთ ადრე შექმნილი Annotations ობიექტი RedactAnnotation მასივში
annotations.add(annotation);

// დაამატეთ RedactAnnotation PDF დოკუმენტში
AsposeResponse response = pdfApi.postPageRedactionAnnotations(sourcePDF, pageNumber, annotations, null, null, true);
assertEquals(200, (int)response.getCode());

რედაქტირებული PDF დოკუმენტი — სურათი 1: - რედაქტირება ანოტაცია დაემატა PDF ფაილს.

ჩამოტვირთეთ ზემოთ მოცემულ მაგალითში გამოყენებული ფაილების ნიმუში

წაიკითხეთ გვერდის რედაქციის ანოტაციები

Aspose.PDF Cloud SDK Java-სთვის ასევე გთავაზობთ PDF დოკუმენტში არსებული Redact ანოტაციის შესახებ ინფორმაციის წაკითხვის შესაძლებლობებს. ქვემოთ მოცემული ნაბიჯები განსაზღვრავს, თუ როგორ უნდა წაიკითხოთ ანოტაციის დეტალები Java-ს გამოყენებით.

// მიიღეთ ClientID და ClientSecret https://dashboard.aspose.cloud/-დან
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// createPdfApi მაგალითი
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// PDF დოკუმენტის შეყვანა
String sourcePDF = "PdfWithTable.pdf";

// მიიღეთ დოკუმენტის რედაქტირების ანოტაციები
RedactionAnnotationsResponse responseAnnotations = pdfApi.getPageRedactionAnnotations(sourcePDF,1, null, null);
assertEquals(200, (int)responseAnnotations.getCode());

// დაბეჭდეთ დოკუმენტში არსებული ანოტაციების რაოდენობა
System.out.println(responseAnnotations.getAnnotations().getList().size());

განაახლეთ არსებული რედაქციის ანოტაცია

თუ PDF დოკუმენტი უკვე შეიცავს რედაქციის ანოტაციებს, ჩვენ ასევე შეგვიძლია მათი განახლება API-ის გამოყენებით. ქვემოთ მოცემულია დეტალები, თუ როგორ უნდა განაახლოთ არსებული ანოტაცია PDF დოკუმენტში.

შექმენით PdfApi-ს ეგზემპლარი არგუმენტებად კლიენტის ID და კლიენტის საიდუმლო დეტალების გადაცემისას.
შექმენით Rectangle ობიექტი ანოტაციის რეგიონის დასადგენად. ის გამოითვლება დოკუმენტის ქვედა-მარცხნივ და ნაგულისხმევი ერთეულია Point.
შექმენით AnnotationFlags List და დაამატეთ AnnotationFlags.DEFAULT მნიშვნელობა სიას.
ახლა ჩვენ უნდა შევქმნათ RedactionAnnotation ობიექტი და გამოვიძახოთ setRect(…) მეთოდი ანოტაციის მართკუთხა რეგიონის დასადგენად.
გამოიყენეთ setModified(…) მეთოდი ანოტაციის ბოლო შეცვლილი თარიღის დასაყენებლად.
გამოიძახეთ PdfApi ზარის getDocumentRedactionAnnotations(…) მეთოდი, რათა წაიკითხოთ ანოტაციების სია დოკუმენტიდან.
დაიჭირეთ კონკრეტული ანოტაციის ობიექტი answerAnnotations.getAnnotations().getList().get(0).getId().
და ბოლოს, გამოიძახეთ მეთოდი putRedactionAnnotation(…) PdfApi კლასიდან, რათა განაახლოთ არსებული რედაქციის ანოტაცია PDF ფაილში.

// მიიღეთ ClientID და ClientSecret https://dashboard.aspose.cloud/-დან
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// createPdfApi მაგალითი
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// PDF დოკუმენტის შეყვანა
String sourcePDF = "PdfWithAnnotations.pdf";	        
			        
// შექმენით მართკუთხა რეგიონი ანოტაციისთვის  
Rectangle rect = new Rectangle()
  .LLX(200.)
  .LLY(120.)
  .URX(150.)
  .URY(100.);

List<AnnotationFlags> flags = new ArrayList<>();
flags.add(AnnotationFlags.DEFAULT);

List<Point> points = new ArrayList<>();
points.add(new Point().X(10.).Y(40.));
points.add(new Point().X(30.).Y(40.));

// რედაქციის ანოტაციის ობიექტის შექმნა
RedactionAnnotation annotation = new RedactionAnnotation();
// დააყენეთ სახელი ანოტაციისთვის
annotation.setName("Name Updated");

// დააყენეთ მართკუთხა რეგიონი ანოტაციისთვის
annotation.setRect(rect);
annotation.setFlags(flags);
annotation.setHorizontalAlignment(HorizontalAlignment.CENTER);
annotation.setZindex(1);
annotation.setModified("01/01/2018 12:02:03.000 AM");
annotation.setQuadPoint(points);

// განსაზღვრეთ SlateBlue ფერი Hex კოდში
Color color = new Color();
color.setA(0x00);
color.setR(0x6A);
color.setG(0x5A);
color.setB(0xCD);

// მიუთითეთ ანოტაციის შევსების ფერი
annotation.setFillColor(color);

// მიიღეთ არსებული ანოტაცია დოკუმენტიდან
RedactionAnnotationsResponse responseAnnotations = pdfApi.getDocumentRedactionAnnotations(sourcePDF, null, null);
assertEquals(200, (int)responseAnnotations.getCode());

// მიიღეთ ანოტაცია ინდექსზე 0
String annotationId = responseAnnotations.getAnnotations().getList().get(0).getId();

// განაახლეთ ანოტაცია ინდექსზე 0
AsposeResponse response = pdfApi.putRedactionAnnotation(sourcePDF, annotationId, annotation, null, null, true);
assertEquals(200, (int)response.getCode());

რედაქტირების ანოტაცია განახლებულია — სურათი 2: - განახლებულია რედაქტირების ანოტაცია.

ზემოთ მოცემულ მაგალითში გამოყენებული რესურსების ფაილები შეგიძლიათ ჩამოტვირთოთ შემდეგი ბმულებიდან

დასკვნა

ამ სტატიაში ჩვენ განვიხილეთ ნაბიჯები, თუ როგორ უნდა დაარედაქტიროთ მგრძნობიარე ინფორმაცია PDF დოკუმენტებიდან. რედაქციის ანოტაციის გარდა, ანოტაციის სხვა ფუნქციების სიმრავლე მხარდაჭერილია API-ით და მათი დეტალების ნახვა შეგიძლიათ ბმულზე ანოტაციით მუშაობა. შეგიძლიათ ეწვიოთ პროდუქტის მთავარ გვერდს მისი შესაძლებლობების შესახებ დამატებითი ინფორმაციისთვის. თუ თქვენ გაქვთ რაიმე დაკავშირებული შეკითხვა, გთხოვთ, მოგერიდებათ დაუკავშირდეთ [პროდუქტის მხარდაჭერის უფასო ფორუმის] მეშვეობით 12.

SDK-ის ინსტალაცია#

დაამატეთ რედაქციის ანოტაცია ჯავის გამოყენებით#

წაიკითხეთ გვერდის რედაქციის ანოტაციები#

განაახლეთ არსებული რედაქციის ანოტაცია#

დასკვნა#

SDK-ის ინსტალაცია

დაამატეთ რედაქციის ანოტაცია ჯავის გამოყენებით

წაიკითხეთ გვერდის რედაქციის ანოტაციები

განაახლეთ არსებული რედაქციის ანოტაცია

დასკვნა