Skirtumų nustatymo principas ir jo taikymas
Teksto ar struktūrizuotų duomenų palyginimas (angl. diff) yra fundamentalus procesas, leidžiantis tiksliai identifikuoti informacijos pokyčius tarp dviejų dokumento ar kodo versijų. Šis procesas padeda nustatyti, kokie elementai buvo pridėti, pašalinti arba pakeisti. Įrankis „Teksto / JSON palyginimas“ atlieka šią analizę tiesiogiai naudotojo sąsajoje, vizualiai išskirdamas skirtumus tarp pateiktų duomenų šaltinių.
Palyginimas yra naudingas įvairiose situacijose, pavyzdžiui, analizuojant konfigūracinių failų pakeitimus, lyginant API atsakymų struktūras, tikrinant JSON duomenis prieš ir po duomenų migracijos, taip pat peržiūrint trumpų tekstų redagavimo istoriją. Kūrėjams ir analitikams šis įrankis suteikia galimybę gauti atkuriamus struktūrinius pakeitimų kelius, o tai supaprastina klaidų paiešką ir duomenų auditą.
Teksto palyginimas pagal eilutes ir žodžius
Teksto režime (pasirinkus „Tekstas“) įrankis leidžia lyginti neapdorotą turinį naudojant du skirtingus detalumo lygius:
- Eilutės: palyginimas atliekamas eilutė po eilutės. Tai naudinga lyginant programinio kodo failus, konfigūracijas ar struktūrizuotus sąrašus, kur kiekviena eilutė atspindi atskirą įrašą.
- Žodžiai: palyginimas atliekamas žodžių tikslumu. Šis režimas idealiai tinka pastraipoms, straipsniams ar kitiems rišliems tekstams analizuoti, kai norima pamatyti konkrečius sakinio pakeitimus.
Atliekant palyginimą, sistema vizualiai išskiria tris pokyčių tipus:
- Pridėta: turinys, kurio nebuvo kairėje pusėje, bet jis atsirado dešinėje.
- Pašalinta: turinys, kuris buvo pašalintas iš kairiosios versijos.
- Pakeista: modifikuotos teksto dalys.
JSON duomenų struktūros analizė
Lyginant JSON duomenis (pasirinkus režimą „JSON“), įrankis veikia kitaip nei paprastas tekstinis palyginimas. Pirmiausia abi įvestys yra išanalizuojamos (atliekamas sintaksinis nagrinėjimas) ir nuosekliai suformatuojamos. Tai leidžia atskirti semantinius duomenų pasikeitimus nuo paprastų formatavimo ar sintaksės skirtumų.
JSON režimo taisyklės ir ypatybės:
- Objektų raktų tvarka: objekto raktai yra lyginami pagal pavadinimą. Jei pasikeitė tik raktų išsidėstymo tvarka, bet pačios reikšmės išliko tokios pačios, įrankis to nelaiko semantiniu pakeitimu ir apie tai nepraneša.
- Masyvų palyginimas: masyvų elementai yra lyginami griežtai pagal jų poziciją (indeksą).
- Struktūriniai keliai: nustatyti skirtumai pateikiami nurodant tikslius struktūrinius kelius (pavyzdžiui,
$.user.email).
Jei kairėje arba dešinėje pusėje įvestas JSON yra klaidingas, palyginimas negali būti įvykdytas. Tokiu atveju sistema pateikia pranešimus „Kairysis JSON yra klaidingas:“ arba „Dešinysis JSON yra klaidingas:“ kartu su nurodyta klaidos informacija. Jei struktūrinių skirtumų nerandama, rodomas pranešimas „JSON reikšmių pakeitimų nerasta“.
Duomenų apribojimai ir didelių įvesčių apdorojimas
Siekiant užtikrinti, kad interneto puslapis išliktų spartus ir reaguotų į naudotojo veiksmus, įrankyje įdiegti keli techniniai ribojimai:
- Simbolių limitas: vienos pusės įvestis („Originalas“ arba „Modifikuota“) yra ribojama iki 300 000 simbolių. Jei ši riba viršijama, rodomas pranešimas „Ši įvestis yra per didelė šiam įrankiui. Bandykite mažesnį palyginimą“.
- Laiko limitas (Timeout): palyginimo procesas automatiškai sustabdomas, jei jis trunka ilgiau nei 2,5 sekundės. Tokiu atveju naudotojui pateikiamas pranešimas „Šis palyginimas trunka per ilgai. Bandykite mažesnę įvestį arba eilučių režimą“.
- Rezultatų apribojimas: jei palyginimo rezultatas yra per didelis, sistema gali parodyti tik dalį duomenų, pateikdama įspėjimą „Rodomas apribotas rezultatas, kad puslapis išliktų spartus“.
- Kitos klaidos: jei įvyksta nenumatytas sutrikimas, rodomas pranešimas „Nepavyko palyginti šių įvesčių“.
Privatumas ir vietinis apdorojimas
Naudojantis šiuo įrankiu, jūsų įvedamas tekstas ir JSON duomenys yra lyginami tiesiogiai jūsų interneto naršyklėje. Duomenų apdorojimas vyksta kliento pusėje, todėl jokie jūsų įvesti tekstai ar konfidenciali informacija nėra perduodami į BroBroGo serverius. Tai užtikrina privatumą atliekant kasdienes duomenų analizės užduotis.
Naudojimosi instrukcija ir valdymo elementai
Įrankio sąsają sudaro dvi pagrindinės įvesties sritys ir valdymo skydelis:
- Originalas (kairėje): vieta, kur įklijuojamas pradinis tekstas arba JSON. Rodomas vietos užpildymo tekstas: „Įklijuokite originalų tekstą arba JSON čia...“.
- Modifikuota (dešinėje): vieta, kur įklijuojama pakeista versija. Rodomas vietos užpildymo tekstas: „Įklijuokite pakeistą tekstą arba JSON čia...“.
Sąsajoje esantys mygtukai leidžia atlikti šiuos veiksmus:
- Sukeisti: sukeičia kairįjį ir dešinįjį laukus vietomis. Atlikus šį veiksmą, rodomas pranešimas „Kairė ir dešinė pusės sukeistos“.
- Išvalyti: ištrina visą turinį iš abiejų įvesties laukų. Atlikus šį veiksmą, rodomas pranešimas „Abi pusės išvalytos“.
- Pavyzdys: įkelia demonstracinius duomenis greitam įrankio išbandymui. Įkėlus pavyzdį, rodomas pranešimas „Pavyzdys įkeltas“.
Po įvesties laukais pateikiama statistika „Kairėje“ ir „Dešinėje“, o žemiau esančioje sekcijoje „Skirtumai“ išvedami palyginimo rezultatai. Jei įvestys sutampa, rodomas pranešimas „Skirtumų nerasta“.
Dažniausiai užduodami klausimai (DUK)
Kuo skiriasi teksto ir JSON režimai?
Teksto režimas lygina neapdorotą turinį pagal eilutes arba žodžius. JSON režimas pirmiausia išanalizuoja abi puses, nuosekliai jas suformatuoja ir pateikia pakeistų kelių sąrašą, pavyzdžiui, $.user.email.
Ar įrankis gali apdoroti labai didelę įvestį?
Lėtas palyginimas sustabdomas po 2,5 sekundės. Labai dideli atsitiktiniai įklijavimai yra ribojami, kad puslapis išliktų spartus. Vieno lauko įvestis negali viršyti 300 000 simbolių.
Ar JSON režimas ignoruoja objektų raktų tvarką?
Struktūrizuotas pakeitimų sąrašas lygina objektų raktus pagal pavadinimą, todėl vien tik raktų tvarka nėra laikoma semantiniu pakeitimu. Masyvai lyginami pagal poziciją.
Kur yra apdorojami mano įvesti duomenys?
Jūsų tekstas ir JSON lyginami jūsų naršyklėje. Nieko neperduodama į BroBroGo serverius, todėl procesas vyksta lokaliai jūsų įrenginyje.