Σύγκριση Εγγράφων
ΣΥΝΔΕΣΗ ΕΓΓΡΑΦΩΝ
Αυτός ο οδηγός δείχνει πώς να συγκρίνετε δύο εκτελέσεις κειμένου και να δημιουργήσετε τη σειρά των επεξεργασιών μεταξύ τους χρησιμοποιώντας τη 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 Σύνοψη
| Κλάση / Μέθοδος | Περιγραφή |
|---|---|
Operation | Enum που ταξινομεί μια επεξεργασία ως 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 |