Διορθώστε το PDF στο διαδίκτυο χρησιμοποιώντας το Java REST API

Έχουμε την απαίτηση να απαλείψουμε ευαίσθητες λεπτομέρειες από αρχεία PDF λόγω του απορρήτου των δεδομένων, επομένως συνήθως διαγράφουμε (αφαιρούμε κείμενο, εικόνα κ.λπ.) από μια συγκεκριμένη περιοχή σελίδας ενός εγγράφου PDF. Ωστόσο, όταν έχουμε να κάνουμε με ένα μεγάλο σύνολο εγγράφων, πρέπει να χρησιμοποιούμε API για να εκπληρώσουμε αυτήν την απαίτηση.

Σε αυτό το άρθρο, θα συζητήσουμε τα βήματα σχετικά με τον τρόπο επεξεργασίας του PDF στο διαδίκτυο χρησιμοποιώντας την κλάση RedactionAnnotation του Aspose.PDF Cloud SDK για Java.

• Εγκατάσταση του SDK
• Προσθήκη σχολιασμού επεξεργασίας χρησιμοποιώντας Java
• Διαβάστε τους σχολιασμούς επεξεργασίας σελίδας
• Ενημερώστε τον υπάρχοντα σχολιασμό επεξεργασίας

Εγκατάσταση του 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.

<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>
copy

Μόλις εγκατασταθεί το SDK, το επόμενο βήμα είναι να αποκτήσετε το εξατομικευμένο Client ID και το Client Secret. Επισκεφτείτε το Aspose.Cloud dashboard και εάν έχετε λογαριασμό GitHub ή Google, απλώς Εγγραφείτε. Διαφορετικά, κάντε κλικ στο κουμπί Δημιουργία νέου λογαριασμού και δώστε τις απαιτούμενες πληροφορίες. Τώρα συνδεθείτε στον πίνακα ελέγχου χρησιμοποιώντας διαπιστευτήρια και αναπτύξτε την ενότητα Εφαρμογές. Κάντε κύλιση προς τα κάτω προς την ενότητα Διαπιστευτήρια πελάτη για να δείτε στοιχεία Client ID και Client Secret.

Προσθήκη σχολιασμού επεξεργασίας χρησιμοποιώντας Java

Στην ενότητα που δίνεται παρακάτω, έχουμε εξηγήσει τα βήματα σχετικά με τον τρόπο προσθήκης ενός ορθογώνιου πλαισίου για τη διαγραφή του περιεχομένου των αρχείων PDF χρησιμοποιώντας το Aspose.PDF Cloud SDK για Java.

• Πρώτα απ ‘όλα, πρέπει να δημιουργήσουμε ένα αντικείμενο του PdfApi διαβιβάζοντας τα στοιχεία ClientId και ClientSecret που λαμβάνονται από τον πίνακα ελέγχου Aspose.Cloud.
• Δεύτερον, δημιουργήστε ένα αντικείμενο της κλάσης Rectangle για να καθορίσετε την περιοχή στη σελίδα όπου θα προστεθεί το Annotation.
• Τρίτον, επιλέξτε την Προεπιλεγμένη τιμή από την απαρίθμηση AnnotationFlags και προσθέστε τη στη Λίστα τύπου AnnotationFlags.
• Τώρα δημιουργήστε μια παρουσία της κλάσης RedactionAnnotation και ορίστε την ορθογώνια περιοχή χρησιμοποιώντας τη μέθοδο setRect(…).
• Ορίστε την οριζόντια στοίχιση χρησιμοποιώντας τη μέθοδο setHorizontalAlignment(…) και επιλέξτε Κέντρο από την απαρίθμηση HorizontalAlignment.
• Για να γεμίσετε το χρώμα μέσα στο Annotation, χρησιμοποιήστε τη μέθοδο setFillColor(…) και περάστε το αντικείμενο Color.
• Ορίστε την ημερομηνία τελευταίας τροποποίησης του σχολιασμού χρησιμοποιώντας τη μέθοδο setModified(…).
• Προτελευταίο, δημιουργήστε μια λίστα τύπου RedactionAnnotation και προσθέστε αντικείμενο RedactAnnotation σε αυτήν τη λίστα.
• Τέλος, καλέστε τη μέθοδο postPageRedactionAnnotations(…) του PdfApi και περάστε το όνομα του αρχείου προέλευσης, τον αριθμό σελίδας όπου πρέπει να προστεθεί ο σχολιασμός. Επίσης, περάστε τη λίστα RedactionAnnotation ως όρισμα για την έναρξη της διαδικασίας σύνταξης.

// Λάβετε ClientID και ClientSecret από https://dashboard.aspose.cloud/
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// στιγμιότυπο δημιουργίαςPdfApi
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// εισαγωγή εγγράφου PDF
String sourcePDF = "PdfWithTable.pdf";

// σελίδα του PDF για να τοποθετήσετε Σχολιασμό
int pageNumber = 1;

// δημιουργήστε ορθογώνιο αντικείμενο για να καθορίσετε την περιοχή σχολιασμού redact
// η περιοχή υπολογίζεται από κάτω-αριστερά της σελίδας
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. 
// Είναι χρήσιμο όταν έχουμε πολλαπλούς σχολιασμούς σε ένα έγγραφο
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);
			        
// δημιουργήστε ένα αντικείμενο λίστας τύπου 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());
copy

Κατεβάστε τα δείγματα αρχείων που χρησιμοποιούνται στο παραπάνω παράδειγμα από

• PdfWithTable.pdf
• PdfWithTable-Redacted.pdf

Διαβάστε τους σχολιασμούς επεξεργασίας σελίδας

Το Aspose.PDF Cloud SDK για Java προσφέρει επίσης τις δυνατότητες ανάγνωσης των πληροφοριών σχετικά με τον υπάρχοντα σχολιασμό Redact σε έγγραφο PDF. Τα βήματα που δίνονται παρακάτω καθορίζουν τον τρόπο ανάγνωσης των λεπτομερειών σχολιασμού χρησιμοποιώντας Java.

// Λάβετε ClientID και ClientSecret από https://dashboard.aspose.cloud/
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// στιγμιότυπο δημιουργίαςPdfApi
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());
copy

Ενημερώστε τον υπάρχοντα σχολιασμό επεξεργασίας

Εάν ένα έγγραφο PDF περιέχει ήδη σχολιασμούς Redaction, μπορούμε επίσης να τους ενημερώσουμε χρησιμοποιώντας το API. Παρακάτω δίνονται οι λεπτομέρειες σχετικά με τον τρόπο ενημέρωσης του υπάρχοντος σχολιασμού σε ένα έγγραφο PDF.

• Δημιουργήστε μια παρουσία του PdfApi ενώ μεταβιβάζετε ως ορίσματα Client ID και Client Secret στοιχεία.
• Δημιουργήστε ένα αντικείμενο Ορθογώνιο για να ορίσετε την περιοχή του σχολιασμού. Υπολογίζεται από το κάτω-αριστερό μέρος του εγγράφου και η προεπιλεγμένη μονάδα είναι Σημείο.
• Δημιουργήστε τη λίστα AnnotationFlags και προσθέστε την τιμή AnnotationFlags.DEFAULT στη λίστα.
• Τώρα πρέπει να δημιουργήσουμε το αντικείμενο RedactionAnnotation και να καλέσουμε τη μέθοδο setRect(…) για να ορίσουμε την ορθογώνια περιοχή του σχολιασμού.
• Χρησιμοποιήστε τη μέθοδο setModified(…) για να ορίσετε την ημερομηνία τελευταίας τροποποίησης του Annotation.
• Καλέστε τη μέθοδο getDocumentRedactionAnnotations(…) της κλήσης PdfApi για να διαβάσετε τη λίστα των Annotations από το έγγραφο.
• Αποκτήστε ένα συγκεκριμένο αντικείμενο Annotation χρησιμοποιώντας το answerAnnotations.getAnnotations().getList().get(0).getId().
• Τέλος, καλέστε τη μέθοδο putRedactionAnnotation(…) της κλάσης PdfApi για να ενημερώσετε το υπάρχον Annotation Redaction σε αρχείο PDF.

// Λάβετε ClientID και ClientSecret από https://dashboard.aspose.cloud/
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// στιγμιότυπο δημιουργίαςPdfApi
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.));

// δημιουργία αντικειμένου Redaction Annotation
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());
copy

Τα αρχεία πόρων που χρησιμοποιούνται στο παραπάνω παράδειγμα μπορούν να ληφθούν από τους παρακάτω συνδέσμους

• PdfWithAnnotations.pdf
• PdfWithAnnotations-updated.pdf

σύναψη

Σε αυτό το άρθρο, έχουμε συζητήσει τα βήματα σχετικά με τον τρόπο επεξεργασίας ευαίσθητων πληροφοριών από έγγραφα PDF. Εκτός από τον σχολιασμό Redaction, μια πληθώρα άλλων λειτουργιών Annotation υποστηρίζονται από το API και οι λεπτομέρειες τους βρίσκονται στο Working with Annotation. Μπορείτε να επισκεφθείτε την αρχική σελίδα του προϊόντος για περισσότερες πληροφορίες σχετικά με τις δυνατότητές του. Εάν έχετε οποιοδήποτε σχετικό ερώτημα, μη διστάσετε να επικοινωνήσετε μέσω του Δωρεάν φόρουμ υποστήριξης προϊόντων.