Java ile GroupDocs.Search kullanarak arama sonuçlarını vurgulama

Uygulamalarınız için Java’da arama sonuçlarını vurgulamanız gerekiyorsa, doğru yerdesiniz. Bu kılavuz, GroupDocs.Search for Java kullanarak orijinal belgeler ve HTML ön izlemeler içinde eşleşen terimleri görsel olarak vurgulama sürecini adım adım anlatır. Bir belge‑arama portalı, kurumsal bilgi tabanı ya da basit bir dosya‑gezgini oluşturuyor olun, burada ele alınan teknikler daha net ve sezgisel bir kullanıcı deneyimi sunmanıza yardımcı olacaktır.

Hızlı yanıtlar

  • “highlight search results java” ne yapar?
    Bir belge ya da ön izleme içinde sorgu teriminin her oluşumunu görsel olarak işaretler, eşleşmeleri kolayca fark etmeyi sağlar.
  • Hangi dosya türleri desteklenir?
    Word, PDF, Excel, PowerPoint, düz metin ve GroupDocs.Search aracılığıyla daha birçok format.
  • Lisans gerekli mi?
    Geliştirme için geçici bir lisans yeterlidir; üretim kullanımı için tam lisans gerekir.
  • Vurgulama stilini özelleştirebilir miyim?
    Evet—renkler, yazı tipleri ve opaklık programatik olarak ayarlanabilir.
  • Ek bir kurulum gerekiyor mu?
    Tek yapmanız gereken GroupDocs.Search for Java kütüphanesini projenize eklemek ve API’ye referans vermek.

Java’da arama sonucu vurgulama nedir?

Java’da arama sonucu vurgulama, GroupDocs.Search tarafından bir belgede bulunan arama teriminin her örneğine (genellikle arka plan renkleri) görsel işaretler ekleme tekniğidir. Bu sayede son kullanıcılar, tüm dosyayı manuel olarak taramadan ilgili bilgiyi kolayca bulabilir.

Java için GroupDocs.Search vurgulamasını neden kullanmalısınız?

GroupDocs.Search 30’dan fazla dosya formatında vurgulamayı destekler; DOCX, PDF, XLSX, PPTX, TXT, HTML ve daha fazlası. 10 milyon belgeye kadar indeksleyebilir ve standart sunucu donanımında alt‑saniyelik sorgu gecikmesi sağlar. API, renkleri, opaklığı ve hatta terim bazında farklı stilleri özelleştirmenize olanak tanır; böylece marka UI kılavuzlarınıza tam uyum sağlayabilirsiniz.

Önkoşullar

  • Java 8 veya üzeri yüklü olmalı.
  • Projeye GroupDocs.Search for Java kütüphanesi (Maven/Gradle bağımlılığı) eklenmiş olmalı.
  • Geçici ya da tam bir GroupDocs.Search lisans dosyası.

Adım‑adım kılavuz

Adım 1: arama motorunu başlatma

SearchEngine belge koleksiyonunuzu indeksleyen ve sorgulayan temel sınıftır. SearchEngine bir örneği oluşturun ve aramak istediğiniz belgeleri içeren indeksi yükleyin.

Not: Bu adım için kod, aşağıdaki kapsamlı kılavuzda sağlanmıştır.

Adım 2: bir arama sorgusu yürütme

SearchResult kullanıcının sorgusuna eşleşen tek bir belgeyi temsil eder. Sorgu dizesiyle search metodunu çağırın; bu, SearchResult nesnelerinden oluşan bir koleksiyon döndürür.

Adım 3: orijinal belgede eşleşmeleri vurgulama

HighlightOptions görsel stili—renk, opaklık ve tüm parçayı mı yoksa sadece kesin terimi mi vurgulayacağını—belirlemenizi sağlar. Her SearchResult için vurgulama API’sini çağırarak görsel işaretleri doğrudan kaynak dosyaya ekleyin.

Adım 4: HTML ön izleme oluşturma (isteğe bağlı)

Orijinal dosya yerine web‑tabanlı bir ön izleme göstermek istiyorsanız, HighlightResult sınıfını kullanarak vurgulanan terimlerle bir HTML snippet’i üretin. Bu, tarayıcı‑tabanlı görüntüleyiciler veya hafif mobil uygulamalar için faydalıdır.

Adım 5: vurgulanan çıktıyı kaydetme veya akışa gönderme

Vurgulama işleminden sonra, orijinal belgeyi üzerine yazabilir, yeni bir vurgulu kopya kaydedebilir veya sonucu doğrudan istemcinin tarayıcısına akıtabilirsiniz.

PDF’de terimleri nasıl vurgularsınız

PDF’nizi SearchEngine ile yükleyin ve %30 opaklıkta parlak sarı bir renk kullanan HighlightOptions ayarlayın—bu kombinasyon tipik PDF arka planlarında net bir şekilde görülürken orijinal düzeni korur. API, her eşleşme için doğru koordinatları otomatik olarak hesaplar, metin akışını ve görselleri korur. Vurgulama sonrası, değiştirilmiş PDF’yi diske kaydedebilir veya doğrudan istemciye akıtabilirsiniz. Bu yöntem, tek sayfalı ve çok sayfalı PDF’lerde orijinal dosya yapısını bozmadan çalışır.

Word belgelerinde eşleşmeleri vurgulama

HighlightResult, Word dosyalarında aynı şekilde çalışır; ancak Word’ün yerel stilini bozmayan bir HighlightColor seçmelisiniz (örneğin, Microsoft Word’de açıldığında silinmeyen açık bir turkuaz). Bu, vurgunun farklı Word sürümlerinde kalıcı olmasını sağlar.

Yaygın sorunlar ve çözümler

  • Vurgular görünmüyor: Belge formatının desteklendiğinden ve arama sorgusunun dosyada gerçekten bir içerikle eşleştiğinden emin olun.
  • Büyük dosyalarda performans yavaşlıyor: Asenkron indekslemeyi etkinleştirin veya belgeleri partiler halinde işleyin.
  • Yanlış renkler: Doğru HighlightColor enum değerlerini kullandığınızı ve stilin UI’nizdeki CSS tarafından geçersiz kılınmadığını kontrol edin.

Mevcut öğreticiler

GroupDocs.Search for Java: Belgelerde Arama Terimlerini Vurgulama | Kapsamlı Kılavuz

GroupDocs.Search for Java’yı kullanarak belgelerde arama terimlerini nasıl vurgulayacağınızı öğrenin. Tüm belgeler ve belirli parçalar üzerinde vurgulama tekniklerini keşfedin.

Ek kaynaklar

Sıkça Sorulan Sorular

S: Şifre korumalı PDF’lerde arama sonuçlarını vurgulayabilir miyim?
C: Evet. Belgeyi yüklerken şifreyi sağlayın, ardından aynı vurgulama yöntemlerini uygulayın.

S: Vurgulama orijinal dosyayı kalıcı olarak değiştirir mi?
C: Varsayılan olarak yeni bir kopya oluşturulur, ancak isterseniz kaynağın üzerine yazmayı seçebilirsiniz.

S: Birden fazla sorgu terimini aynı anda vurgulamak mümkün mü?
C: Kesinlikle. Arama motoruna bir terim listesi gönderin; her terim yapılandırılmış stil ile vurgulanır.

S: Farklı terimler için vurgulama rengini nasıl değiştiririm?
C: HighlightOptions sınıfını kullanarak her terim için ayrı HighlightColor değerleri atayın, ardından vurgulama metodunu çağırın.

S: Bir belge milyonlarca sayfa içeriyorsa ne yapmalıyım?
C: Belgeyi parçalara bölerek işleyin ve tüm dosyayı belleğe yüklemeyi önlemek için akış API’lerini kullanın.

Son Güncelleme: 2026-09-27
Test Edilen Versiyon: GroupDocs.Search for Java 23.11
Yazar: GroupDocs

İlgili Öğreticiler