Σύγκριση Εγγράφων

Σύγκριση Εγγράφων

ΣΥΝΔΕΣΗ ΕΓΓΡΑΦΩΝ

Αυτός ο οδηγός δείχνει πώς να συγκρίνετε δύο εκτελέσεις κειμένου και να δημιουργήσετε τη σειρά των επεξεργασιών μεταξύ τους χρησιμοποιώντας τη Aspose.PDF FOSS text-diff μηχανή για .NET. Το σημείο εισόδου για αυτό το μοντέλο σύγκρισης είναι DiffOperation, μια μονή επεξεργασία που επισημαίνεται με ένα Operation (Equal, Delete, ή Insert), μαζί με το DiffUtils βοηθητική κλάση για την εντόπιση κοινού κειμένου και την επανένωση ενός diff πίσω στο πηγαίο και προορισμένο κείμενο. Ένα ξεχωριστό βήμα βελτιστοποίησης, περιγραφόμενο στο Βελτιστοποίηση Diff, κανονικοποιεί την ακατέργαστη έξοδο diff που παράγεται με αυτόν τον τρόπο πριν αυτή αποδοθεί ή εφαρμοστεί.


Το Μοντέλο Diff: Λειτουργία και DiffOperation

Operation είναι η απαρίθμηση (enum) που ταξινομεί κάθε επεξεργασία σε μια diff: το Equal σηματοδοτεί μια ακολουθία κειμένου που δεν έχει αλλάξει, το Delete σηματοδοτεί μια ακολουθία που αφαιρέθηκε από την πηγή, και το Insert σηματοδοτεί μια ακολουθία που προστέθηκε στον προορισμό. Το DiffOperation συνδυάζει μια τιμή Operation με το Text στο οποίο εφαρμόζεται, και υλοποιεί το IEquatable<DiffOperation> ώστε δύο επεξεργασίες να μπορούν να συγκριθούν για ισότητα.

using Aspose.Pdf.Comparison.Diff;

// A single edit consists of an Operation and the run of text it applies to.
var unchanged = new DiffOperation(Operation.Equal, "Aspose.PDF ");
var removed = new DiffOperation(Operation.Delete, "for .NET Framework");
var added = new DiffOperation(Operation.Insert, "FOSS for .NET");

Console.WriteLine(unchanged.Operation); // Equal
Console.WriteLine(added.Text);          // "FOSS for .NET"

Εντοπισμός Κοινού Κειμένου με DiffUtils

DiffUtils είναι μια στατική βοηθητική κλάση που χρησιμοποιείται από τη μηχανή diff για να βρει το κοινό πρόθεμα και την κοινή κατάληξη που μοιράζονται δύο αλφαριθμητικά πριν η διαφορετική μεσαία ενότητα υποβληθεί σε diff. Το FindCommonStartParts εντοπίζει το κοινό πρόθεμα, και το FindCommonEndParts εντοπίζει την κοινή κατάληξη· μια υπερφόρτωση του FindCommonEndParts δέχεται ένα startIndex ώστε η αναζήτηση κατάληξης να μπορεί να περιοριστεί σε κείμενο που ακολουθεί ένα ήδη εντοπισμένο πρόθεμα.

string original = "The quick brown fox";
string revised = "The quick red fox jumps";

var commonStart = DiffUtils.FindCommonStartParts(original, revised);
var commonEnd = DiffUtils.FindCommonEndParts(original, revised);

Επανασυναρμολόγηση Κειμένου από Diff

Μόλις ένα diff εκφραστεί ως μια ακολουθία τιμών DiffOperation, το DiffUtils μπορεί να ανασυνθέσει οποιαδήποτε πλευρά της σύγκρισης: το AssemblySourceText επαναδημιουργεί το αρχικό κείμενο από τις εκτελέσεις Equal και Delete, ενώ το AssemblyDestinationText επαναδημιουργεί το αναθεωρημένο κείμενο από τις εκτελέσεις Equal και Insert.

using System.Collections.Generic;

var diffs = new List<DiffOperation>
{
    new DiffOperation(Operation.Equal, "The quick "),
    new DiffOperation(Operation.Delete, "brown"),
    new DiffOperation(Operation.Insert, "red"),
    new DiffOperation(Operation.Equal, " fox")
};

string sourceText = DiffUtils.AssemblySourceText(diffs);
string destinationText = DiffUtils.AssemblyDestinationText(diffs);

Console.WriteLine(sourceText);      // "The quick brown fox"
Console.WriteLine(destinationText); // "The quick red fox"

Σύγκριση και Αναφορά Επεξεργασιών

Το DiffOperation παρακάμπτει το Equals, το GetHashCode και το ToString, ώστε οι επεξεργασίες να μπορούν να συγκριθούν για ισότητα ή να γραφούν σε αρχεία καταγραφής και έξοδο δοκιμών χωρίς πρόσθετο κώδικα μετατροπής.

var a = new DiffOperation(Operation.Equal, "PDF");
var b = new DiffOperation(Operation.Equal, "PDF");

bool same = a.Equals(b); // true - same Operation and Text
Console.WriteLine(a.ToString());

Συμβουλές και Καλύτερες Πρακτικές

  • Το DiffOperation είναι αμετάβλητο και υλοποιεί το IEquatable<DiffOperation> — χρησιμοποιήστε το Equals για να συγκρίνετε δύο επεξεργασίες αντί για ισότητα αναφοράς.
  • Εντοπίστε το κοινό πρόθεμα με το FindCommonStartParts πρώτα, στη συνέχεια περάστε το μήκος του στην υπερφόρτωση startIndex του FindCommonEndParts για να αποφύγετε το σύντομο κοινό πρόθεμα να μετρηθεί δύο φορές ως μέρος του καταλήγματος.
  • Χρησιμοποιήστε το AssemblySourceText και το AssemblyDestinationText για να επαληθεύσετε ότι μια ακολουθία τιμών DiffOperation επιστρέφει στο ακριβές αρχικό και αναθεωρημένο κείμενο πριν την χρησιμοποιήσετε αλλού.
  • Θεωρήστε τις εκτελέσεις Operation.Equal ως μη-ενέργειες κατά την απόδοση ενός οπτικού diff και επισημάνετε μόνο τις εκτελέσεις Delete και Insert.
  • Αυτή η μηχανή συγκρίνει κείμενο, όχι έγγραφα άμεσα — εξάγετε το κείμενο που θέλετε να συγκρίνετε (για παράδειγμα, από μια σελίδα ή ένα έγγραφο) πριν δημιουργήσετε τη διαφορά.

Κοινά Προβλήματα

ΠρόβλημαΑιτίαΔιόρθωση
AssemblySourceText / AssemblyDestinationText η έξοδος δεν ταιριάζει με τα αρχικάΗ λίστα diffs είναι ελλιπής ή οι καταχωρίσεις DiffOperation είναι εκτός σειράςΣυμπεριλάβετε κάθε επεξεργασία στη σειρά, με τη σειρά που εμφανίστηκαν αρχικά
FindCommonEndParts επιστρέφει ένα απρόσμενο αποτέλεσμα σε σύντομες, παρόμοιες συμβολοσειρέςΗ αναζήτηση κοινού επιθήματος επικαλύπτει κείμενο που έχει ήδη ταιριάξει από το FindCommonStartPartsΠερνάτε το μήκος που επιστρέφεται από το FindCommonStartParts ως το όρισμα startIndex
Equals επιστρέφει false για επεξεργασίες που φαίνονται πανομοιότυπεςΟι τιμές Text διαφέρουν σε λευκούς χαρακτήρες ή σε πεζά/κεφαλαίαΚανονικοποιήστε το κείμενο (αποκοπή / μετατροπή σε πεζά) πριν δημιουργήσετε τις τιμές DiffOperation που σκοπεύετε να συγκρίνετε
Η έξοδος diff φαίνεται θορυβώδης ή περιττά κατακερματισμένηΟι ακατέργαστες ακολουθίες DiffOperation δεν έχουν ακόμη κανανοποιηθείΕκτελέστε την ακολουθία μέσω του βήματος βελτιστοποίησης που περιγράφεται στο Βελτιστοποίηση Diff

FAQ

Τι συγκρίνει η μηχανή Diff;

Συγκρίνει ακολουθίες κειμένου και δημιουργεί μια σειρά από τιμές DiffOperation που περιγράφουν τις επεξεργασίες — αμετάβλητο, διαγραμμένο ή προστιθέμενο κείμενο — που απαιτούνται για να μετατραπεί μία συμβολοσειρά σε άλλη.

Τι τύποι επεξεργασίας υποστηρίζει το Operation;

Τρία: Equal για αμετάβλητο κείμενο, Delete για κείμενο που αφαιρέθηκε από την πηγή, και Insert για κείμενο που προστέθηκε στον προορισμό.

Πώς μπορώ να ελέγξω αν δύο επεξεργασίες είναι ίδιες;

Καλέστε το Equals σε ένα στιγμιότυπο DiffOperation, ή συγκρίνετε απευθείας τις ιδιότητες Operation και Text του.

Μπορώ να επανακτήσω το αρχικό και το τροποποιημένο κείμενο από ένα diff;

Ναι — περάστε τη λίστα των τιμών DiffOperation στο DiffUtils.AssemblySourceText για το αρχικό κείμενο και στο DiffUtils.AssemblyDestinationText για το τροποποιημένο κείμενο.

Καλύπτει αυτή η σελίδα τη συγχώνευση ή τον καθαρισμό ενός diff;

Όχι — η κανανοποίηση ενός ακατέργαστου diff (συγχώνευση γειτονικών τμημάτων, μετακίνηση επεξεργασιών μέσω ισοδυναμιών) καλύπτεται ξεχωριστά στο Βελτιστοποίηση Diff.


API Reference Σύνοψη

Κλάση / ΜέθοδοςΠεριγραφή
OperationEnum που ταξινομεί μια επεξεργασία ως Equal, Delete ή Insert
DiffOperationΜία ενιαία επεξεργασία: ένα Operation που συνδυάζεται με το Text στο οποίο εφαρμόζεται
DiffOperation.OperationΗ τιμή Operation για αυτήν την επεξεργασία
DiffOperation.TextΗ ακολουθία κειμένου στην οποία εφαρμόζεται αυτή η επεξεργασία
DiffOperation.EqualsΣυγκρίνει δύο επεξεργασίες για ισότητα με βάση το Operation και το Text
DiffOperation.ToStringΑποδίδει μια επεξεργασία ως συμβολοσειρά για καταγραφή ή εμφάνιση
DiffUtilsΣτατική βοηθητική κλάση με εργαλεία διαφοροποίησης κειμένου
DiffUtils.FindCommonStartPartsΒρίσκει το κοινό πρόθεμα που μοιράζονται δύο συμβολοσειρές
DiffUtils.FindCommonEndPartsΒρίσκει το κοινό επίθημα που μοιράζονται δύο συμβολοσειρές, προαιρετικά ξεκινώντας από ένα δείκτη
DiffUtils.AssemblySourceTextΣυναρμολογεί το αρχικό κείμενο από μια λίστα τιμών DiffOperation
DiffUtils.AssemblyDestinationTextΣυναρμολογεί το αναθεωρημένο κείμενο από μια λίστα τιμών DiffOperation

Δείτε επίσης

 Ελληνικά