GroupDocs Redaction Java में फ़ाइलनाम में उपसर्ग कैसे जोड़ें

इस groupdocs redaction java ट्यूटोरियल में आप सीखेंगे कि GroupDocs.Redaction के साथ दस्तावेज़ों को रीडैक्ट करते समय आउटपुट फ़ाइल नाम में स्वचालित रूप से उपसर्ग कैसे जोड़ा जाए। उपसर्ग जोड़ने से मैन्युअल रीनेमिंग समाप्त हो जाता है, अनरेडैक्टेड फ़ाइलों के लीक होने का जोखिम कम होता है, और यह उन CI/CD पाइपलाइनों में सुगमता से फिट होता है जो नामकरण मानकों पर निर्भर करती हैं। यह गाइड आपको Maven सेटअप, स्ट्रीमिंग दस्तावेज़ लोडिंग, एनोटेशन हटाने, और सेव ऑप्शन कॉन्फ़िगर करने के माध्यम से ले जाता है—सभी संक्षिप्त, प्रोडक्शन‑रेडी कोड के साथ।

त्वरित उत्तर

  • “add suffix to filename” क्या करता है?
    जब आप उपसर्ग विकल्प को सक्षम करते हैं, तो SDK स्वचालित रूप से एक पूर्वनिर्धारित स्ट्रिंग (डिफ़ॉल्ट रूप से “_redacted”) को आउटपुट फ़ाइल के बेस नाम में एक्सटेंशन से पहले जोड़ देता है। इससे यह तुरंत स्पष्ट हो जाता है कि कौन सी फ़ाइलें प्रोसेस हुई हैं, मूल सामग्री के आकस्मिक वितरण को रोकने में मदद मिलती है, और नामकरण पैटर्न पर निर्भर डाउनस्ट्रीम ऑटोमेशन को सरल बनाता है।
  • क्या मैं दस्तावेज़ को स्ट्रीम से लोड कर सकता हूँ?
    हाँ—GroupDocs.Redaction किसी भी InputStream से लोडिंग का समर्थन करता है, जो क्लाउड स्टोरेज या इन‑मेमोरी प्रोसेसिंग के लिए उपयुक्त है।
  • क्या मुझे इस फीचर के लिए लाइसेंस चाहिए?
    बेसिक रीडैक्शन के लिए एक फ्री ट्रायल काम करता है; एक टेम्पररी या फुल लाइसेंस सभी एडवांस्ड विकल्पों को अनलॉक करता है, जिसमें उपसर्ग हैंडलिंग भी शामिल है।
  • कौन से फ़ॉर्मेट समर्थित हैं?
    लाइब्रेरी DOCX, PDF, PPTX, XLSX और कई अन्य फ़ॉर्मेट को संभालती है।
  • क्या PDF आउटपुट के लिए रास्टराइज़ेशन आवश्यक है?
    रास्टराइज़ेशन वैकल्पिक है; इसे तब सक्षम करें जब आपको अतिरिक्त सुरक्षा के लिए दस्तावेज़ को फ्लैट करना हो।

“add suffix to filename” क्या करता है?

जब आप उपसर्ग विकल्प को सक्षम करते हैं, तो SDK स्वचालित रूप से एक पूर्वनिर्धारित स्ट्रिंग (डिफ़ॉल्ट रूप से “_redacted”) को आउटपुट फ़ाइल के बेस नाम में एक्सटेंशन से पहले जोड़ देता है। इससे यह तुरंत स्पष्ट हो जाता है कि कौन सी फ़ाइलें प्रोसेस हुई हैं, मूल सामग्री के आकस्मिक वितरण को रोकने में मदद मिलती है, और नामकरण पैटर्न पर निर्भर डाउनस्ट्रीम ऑटोमेशन को सरल बनाता है।

इस कार्य के लिए GroupDocs.Redaction का उपयोग क्यों करें?

GroupDocs.Redaction एक हाई‑परफ़ॉर्मेंस Java API प्रदान करता है जो रीडैक्शन एक्शन को लचीले फ़ाइल‑हैंडलिंग विकल्पों जैसे स्वचालित उपसर्ग जोड़ना, स्ट्रीमिंग सपोर्ट, और बैच प्रोसेसिंग के साथ संयोजित करता है। यह 50 से अधिक इनपुट और आउटपुट फ़ॉर्मेट को सपोर्ट करता है और पूरी फ़ाइल को मेमोरी में लोड किए बिना कई‑सौ पेज़ दस्तावेज़ों को प्रोसेस कर सकता है, जिससे कम मेमोरी उपयोग और तेज़ निष्पादन सुनिश्चित होता है।

पूर्वापेक्षाएँ

  • Java Development Kit (JDK): संस्करण 8 या उससे ऊपर।
  • GroupDocs.Redaction Library: रीडैक्शन कार्यों के लिए कोर लाइब्रेरी।
  • IDE: IntelliJ IDEA, Eclipse, या कोई भी Java‑compatible एडिटर।
  • Maven: डिपेंडेंसी मैनेजमेंट के लिए।

ज्ञान पूर्वापेक्षाएँ

Java I/O और बेसिक ऑब्जेक्ट‑ओरिएंटेड कॉन्सेप्ट्स की परिचितता उदाहरणों को आसानी से समझने में मदद करेगी।

Java के लिए GroupDocs.Redaction सेटअप

Maven सेटअप

अपने pom.xml फ़ाइल में निम्न कॉन्फ़िगरेशन शामिल करें ताकि Maven के माध्यम से GroupDocs लाइब्रेरीज़ तक पहुँच सकें:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/redaction/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-redaction</artifactId>
      <version>24.9</version>
   </dependency>
</dependencies>

सीधे डाउनलोड

वैकल्पिक रूप से, नवीनतम संस्करण सीधे यहाँ से डाउनलोड करें: GroupDocs.Redaction for Java releases।

लाइसेंस प्राप्ति

  1. Free trial: बिना प्रतिबंधों के बेसिक फ़ंक्शनैलिटी तक पहुँच।
  2. Temporary license: एडवांस्ड फीचर्स को एक्सप्लोर करने के लिए टेम्पररी लाइसेंस प्राप्त करें।
  3. Purchase: दीर्घकालिक उपयोग के लिए फुल लाइसेंस खरीदने पर विचार करें।

बेसिक इनिशियलाइज़ेशन और सेटअप

आवश्यक इम्पोर्ट्स जोड़कर अपने प्रोजेक्ट को इनिशियलाइज़ करें:

import com.groupdocs.redaction.Redactor;

इस सेटअप के साथ, आप दस्तावेज़ रीडैक्शन फ़ंक्शनैलिटी को लागू करने के लिए तैयार हैं।

कार्यान्वयन गाइड

फीचर 1: स्ट्रीम से दस्तावेज़ लोड करें

समीक्षा: प्रोसेसिंग के लिए InputStream में दस्तावेज़ लोड करना सीखें।

InputStream एक Java I/O क्लास है जो बाइट्स की स्ट्रीम का प्रतिनिधित्व करती है, जिससे आप फ़ाइलों, नेटवर्क कनेक्शनों या अन्य स्रोतों से डेटा पढ़ सकते हैं बिना पूरी सामग्री को मेमोरी में लोड किए।

चरण 1.1: इनपुटस्ट्रीम बनाएं

import java.io.FileInputStream;
import java.io.InputStream;

try (InputStream stream = new FileInputStream("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    final Redactor redactor = new Redactor(stream);
    try {
        // Document is now loaded and ready for further processing
    } finally {
        redactor.close();
    }
}
  • Why: InputStream का उपयोग करके आप क्लाउड बकेट्स, डेटाबेस या इन‑मेमोरी बफ़र्स जैसी विभिन्न लोकेशनों में संग्रहीत दस्तावेज़ों को डिस्क पर पहले लिखे बिना हैंडल कर सकते हैं। यह दृष्टिकोण माइक्रो‑सर्विस आर्किटेक्चर में load document from stream की आवश्यकता होने पर अत्यंत आवश्यक है।

फीचर 2: एनोटेशन डिलीशन रीडैक्शन लागू करें

समीक्षा: DeleteAnnotationRedaction का उपयोग करके अपने दस्तावेज़ से एनोटेशन हटाएँ।

DeleteAnnotationRedaction एक रीडैक्शन ऑपरेशन है जो दस्तावेज़ से सभी एनोटेशन—जैसे कमेंट्स, हाइलाइट्स, और नोट्स—हटा देता है।

चरण 2.1: deleteannotationredaction लागू करें

import com.groupdocs.redaction.redactions.DeleteAnnotationRedaction;

try (Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    // Apply the DeleteAnnotationRedaction to remove annotations from the document
    redactor.apply(new DeleteAnnotationRedaction());
}
  • Why: यह चरण सुनिश्चित करता है कि कोई भी संवेदनशील एनोटेशन (कमेंट्स, हाइलाइट्स या छिपे नोट्स) दस्तावेज़ से हटाए जाएँ, जिससे प्राइवेसी और कंप्लायंस बढ़ती है।

फीचर 3: विकल्पों के साथ दस्तावेज़ सहेजें

समीक्षा: रास्टराइज़ेशन और add suffix filename java जैसे विशिष्ट विकल्पों के साथ प्रोसेस्ड दस्तावेज़ को कैसे सहेजें सीखें।

SaveOptions सेटिंग्स को एन्कैप्सुलेट करता है जो नियंत्रित करती हैं कि रीडैक्टेड दस्तावेज़ कैसे लिखा जाता है, जिसमें फ़ॉर्मेट, रास्टराइज़ेशन, और नामकरण मानक शामिल हैं।

चरण 3.1: saveoptions कॉन्फ़िगर करें

import java.io.ByteArrayOutputStream;
import com.groupdocs.redaction.options.SaveOptions;

try (Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    // Apply necessary redactions before saving
    redactor.apply(new DeleteAnnotationRedaction());
    try (ByteArrayOutputStream bA = new ByteArrayOutputStream()) {
        SaveOptions options = new SaveOptions();
        options.setRasterizeToPDF(true);  // Option to rasterize document to PDF format
        options.setAddSuffix(true);      // Option to add a suffix to the saved file name
        redactor.save(bA, options.getRasterization());
    }
}
  • Why: सेव ऑप्शन को कस्टमाइज़ करने से लचीले आउटपुट फ़ॉर्मेट और नामकरण मानक मिलते हैं। setAddSuffix(true) को सक्षम करने से adds suffix to filename, जिससे यह स्पष्ट हो जाता है कि फ़ाइल रीडैक्टेड है।

दस्तावेज़ सहेजते समय suffix filename java कैसे जोड़ें?

Redactor क्लास वह कोर कंपोनेंट है जो दस्तावेज़ लोड करता है और रीडैक्शन ऑपरेशन लागू करता है। SaveOptions निर्धारित करता है कि रीडैक्टेड दस्तावेज़ कैसे सहेजा जाए, जिसमें फ़ॉर्मेट, रास्टराइज़ेशन, और नामकरण मानक शामिल हैं। एक Redactor इंस्टेंस बनाएं, आवश्यक रीडैक्शन लागू करें, फिर setAddSuffix(true) के साथ एक SaveOptions ऑब्जेक्ट कॉन्फ़िगर करें। redactor.save(outputPath, options) को कॉल करें। SDK स्वचालित रूप से “_redacted” (या कॉन्फ़िगर किया गया उपसर्ग) फ़ाइल नाम में जोड़ देता है, इसलिए आपको फ़ाइल को मैन्युअली रीनेम करने की जरूरत नहीं पड़ती।

GroupDocs Maven निर्भरता अवलोकन

groupdocs maven dependency एक ही <dependency> एंट्री के साथ पूरे Redaction SDK को आपके प्रोजेक्ट में लाता है। यह ट्रांज़िटिव डिपेंडेंसीज़ को संभालता है, लाइब्रेरीज़ को अप‑टू‑डेट रखता है, और बिल्ड ऑटोमेशन को सरल बनाता है। pom.xml में डिपेंडेंसी घोषित करके आप मैन्युअल JAR मैनेजमेंट से बचते हैं और नवीनतम सुरक्षा पैच के साथ संगतता सुनिश्चित करते हैं।

उपसर्ग जोड़ना क्यों महत्वपूर्ण है

उपसर्ग जोड़ने से यह तुरंत दृश्य पुष्टि मिलती है कि फ़ाइल प्रोसेस हुई है, जो ऑडिट ट्रेल्स, ऑटोमेटेड वर्कफ़्लोज़, और रेगुलेटरी कंप्लायंस के लिए अत्यंत महत्वपूर्ण है। यह स्क्रिप्ट्स को रीडैक्टेड फ़ाइलों को फ़िल्टर करने, मूल सामग्री के आकस्मिक वितरण को रोकने, और कई इंडस्ट्री स्टैंडर्ड्स को पूरा करने में मदद करता है जो सैनिटाइज़्ड दस्तावेज़ों के स्पष्ट लेबलिंग की मांग करते हैं।

व्यावहारिक अनुप्रयोग

  1. कानूनी दस्तावेज़ रीडैक्शन: क्लाइंट शेयर करने से पहले कॉन्ट्रैक्ट्स को सुरक्षित करें।
  2. मेडिकल रिकॉर्ड हैंडलिंग: रोगी पहचानकर्ताओं की सुरक्षा करें जबकि क्लिनिकल डेटा को संरक्षित रखें।
  3. फ़ाइनेंशियल रिपोर्टिंग: बाहरी ऑडिट के दौरान संवेदनशील नंबरों को गोपनीय रखें।
  4. CRM इंटीग्रेशन: थर्ड‑पार्टी टूल्स को एक्सपोर्ट करने से पहले ग्राहक डेटा को स्वचालित रूप से रीडैक्ट करें।
  5. कोलैबोरेशन टूल्स: सुनिश्चित करें कि साझा ड्राफ्ट्स कभी भी छिपे कमेंट्स या मेटाडेटा को उजागर न करें।

प्रदर्शन विचार

प्रदर्शन अनुकूलन

  • स्ट्रीमिंग (load document from stream) का उपयोग करें ताकि पूरी फ़ाइल को मेमोरी में लोड करने से बचा जा सके।
  • संसाधनों को मुक्त करने के लिए Redactor इंस्टेंस को तुरंत बंद करें।

संसाधन उपयोग दिशानिर्देश

  • बैच रन के दौरान CPU और मेमोरी की निगरानी करें।
  • मध्यम आकार की फ़ाइलों के साथ काम करते समय इन‑मेमोरी सेव के लिए ByteArrayOutputStream को प्राथमिकता दें।

जावा मेमोरी प्रबंधन के लिए सर्वोत्तम प्रथाएँ

  • समान प्रकार की कई फ़ाइलों को प्रोसेस करते समय Redactor ऑब्जेक्ट्स को पुनः उपयोग करें।
  • लीक रोकने के लिए try‑with‑resources ब्लॉक में close() को कॉल करें।

सामान्य समस्याएँ और समाधान

समस्याकारणसमाधान
Suffix not appearingsetAddSuffix(false) या कॉल गायबsave() से पहले options.setAddSuffix(true) सेट करना सुनिश्चित करें।
OutOfMemoryError on large DOCXपूरी फ़ाइल को मेमोरी में लोड करनाInputStream लोडिंग पर स्विच करें (देखें फीचर 1)।
Annotations still visibleसहेजने से पहले रीडैक्शन लागू नहीं हुआsave() से पहले redactor.apply(new DeleteAnnotationRedaction()) कॉल करें।
PDF rasterization not appliedsetRasterizeToPDF(false) या छोड़ा गयाजब आपको फ्लैटेड PDF चाहिए तो options.setRasterizeToPDF(true) सेट करें।

अक्सर पूछे जाने वाले प्रश्न

Q: क्या मैं GroupDocs.Redaction का उपयोग करके PDF दस्तावेज़ रीडैक्ट कर सकता हूँ?
A: हाँ, लाइब्रेरी PDFs, DOCX, PPTX, XLSX और कई अन्य फ़ॉर्मेट को सपोर्ट करती है।

Q: GroupDocs.Redaction के साथ बड़े फ़ाइलों को संभालने का सबसे अच्छा तरीका क्या है?
A: स्ट्रीमिंग (load document from stream) का उपयोग करें और मेमोरी उपयोग कम रखने के लिए संसाधनों को तुरंत बंद करें।

Q: क्या उपसर्ग टेक्स्ट को कस्टमाइज़ करना संभव है?
A: API डिफ़ॉल्ट रूप से एक उपसर्ग (जैसे “_redacted”) जोड़ती है। कस्टम उपसर्ग के लिए, सेव करने के बाद आउटपुट फ़ाइल को रीनेम करें।

Q: GroupDocs.Redaction के लिए टेम्पररी लाइसेंस कैसे प्राप्त करें?
A: Temporary License page पर जाएँ और निर्देशों का पालन करें।

Q: यदि समस्याएँ आती हैं तो मदद कहाँ से प्राप्त करूँ?
A: विशेषज्ञ सहायता के लिए GroupDocs Support Forum में शामिल हों।

संसाधन

  • Documentation: विस्तृत गाइड्स के लिए देखें GroupDocs Documentation।
  • API reference: व्यापक API विवरण के लिए देखें GroupDocs API Reference।
  • Download: नवीनतम संस्करण प्राप्त करें GroupDocs Downloads से।
  • GitHub repository: स्रोत कोड में योगदान दें या देखें GroupDocs GitHub।

अंतिम अपडेट: 2026-11-02
परीक्षित संस्करण: GroupDocs.Redaction 24.9 for Java
लेखक: GroupDocs

संबंधित ट्यूटोरियल