Java에서 여러 파일 유형을 검색하고 문서를 인덱싱하는 방법

현대 기업에서는 종종 비밀 파일을 비밀번호로 잠궈 두면서 여러 파일 유형을 검색해야 합니다. 이 튜토리얼에서는 GroupDocs.Search를 사용하여 Java에서 비밀번호로 보호된 문서에 대한 검색 가능한 인덱스를 구축하는 방법을 보여줍니다. 비밀번호 사전을 구성하고, 비밀번호 필요 이벤트를 처리하며, 대량 배치에 대한 성능을 최적화하는 방법을 확인할 수 있습니다—맞춤형 복호화 로직을 작성할 필요 없이.

빠른 답변

  • 이 튜토리얼은 무엇을 다루나요? 비밀번호 사전 및 이벤트 리스너를 사용한 비밀번호 보호 문서 인덱싱.
  • 필요한 라이브러리는 무엇인가요? GroupDocs.Search for Java (최신 버전).
  • 라이선스가 필요합니까? 평가용으로 임시 무료 체험 라이선스를 사용할 수 있습니다.
  • 다른 파일 유형도 인덱싱할 수 있나요? 예, GroupDocs.Search는 PDF, DOCX, XLSX, PPTX 및 이미지 등을 포함한 120개 이상의 형식을 지원합니다.
  • 필요한 Java 버전은? JDK 8 이상.

“create document index java”란 무엇인가요?

create document index java는 용어를 Java 관리 파일의 위치에 매핑하는 검색 가능한 데이터 구조를 구축하는 과정을 의미합니다. GroupDocs.Search를 사용하면 엔진이 지원되는 형식(암호화된 PDF, Office 문서, 이미지 포함)에서 텍스트를 자동으로 추출하므로 직접 복호화 코드를 작성하지 않고도 전체 텍스트 검색을 수행할 수 있습니다. 이 접근 방식은 검색 구현을 단순화하면서 문서 보안을 유지합니다.

비밀번호 보호 파일에 GroupDocs.Search를 사용하는 이유

GroupDocs.Search는 사전이나 이벤트 핸들러에서 비밀번호를 적용하는 무접촉 잠금 해제 메커니즘을 제공하여 암호화된 파일을 한 번에 인덱싱할 수 있게 합니다. 표준 8코어 서버에서 시간당 최대 2 백만 개의 문서를 처리하며, 120개 이상의 파일 유형을 지원하고, Boolean, 와일드카드, 퍼지 연산자를 포함한 풍부한 쿼리 언어를 제공합니다—다양한 콘텐츠를 포괄하는 검색 가능한 인덱스를 구축하는 데 필수적입니다.

사전 요구 사항

  • Java Development Kit (JDK) 8+이 설치되고 PATH에 추가되었습니다.
  • IntelliJ IDEA 또는 Eclipse와 같은 IDE.
  • 의존성 관리를 위한 Maven.
  • GroupDocs.Search for Java – Maven을 통해 라이브러리를 추가하세요 (설정 섹션 참조).

Java용 GroupDocs.Search 설정

Maven 사용

Add the repository and dependency to your pom.xml file:

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

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-search</artifactId>
      <version>25.4</version>
   </dependency>
</dependencies>

직접 다운로드

또는 최신 버전을 직접 GroupDocs.Search for Java releases에서 다운로드할 수 있습니다.

체험 라이선스를 시작하려면 GroupDocs의 임시 라이선스 페이지를 방문하고 안내에 따라 무료 체험을 받으세요.

비밀번호 사전을 사용하여 문서 인덱싱하는 방법

파일 경로를 비밀번호에 매핑하는 사전을 제공하여 검색 가능한 인덱스를 구축할 수 있습니다. 엔진은 인덱싱 중에 자동으로 올바른 비밀번호를 검색합니다.

개요

문서 비밀번호를 간단한 키‑값 맵에 저장하여 인덱싱 엔진이 필요할 때 파일을 잠금 해제할 수 있도록 합니다.

단계 1: 인덱스 및 문서 폴더 정의

String indexFolder = "YOUR_OUTPUT_DIRECTORY/IndexUsingPasswordDictionary";
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY"; // Path to password‑protected documents

단계 2: 인덱스 생성

// Initialize the Index object in the specified directory
Index index = new Index(indexFolder);

단계 3: 문서 비밀번호 추가

// Add passwords for specific files using their absolute paths
String path1 = new File(documentsFolder + "/English.docx").getAbsolutePath();
index.getDictionaries().getDocumentPasswords().add(path1, "123456");

String path2 = new File(documentsFolder + "/SampleDocument.docx").getAbsolutePath();
index.getDictionaries().getDocumentPasswords().add(path2, "123456");

단계 4: 문서 인덱싱

// Automatically retrieve passwords from the dictionary during indexing
index.add(documentsFolder);

단계 5: 인덱스에서 검색

String query = "sample OR increasing";
SearchResult result = index.search(query);

// Handle search results (e.g., display or process them)

팁: 실제 환경에서는 비밀번호를 하드코딩하는 대신 보안 금고(예: Azure Key Vault 또는 AWS Secrets Manager)에서 로드하세요.

문제 해결

  • 각 비밀번호가 파일의 실제 보호 비밀번호와 일치하는지 확인하세요.
  • 파일 경로를 다시 확인하세요; 잘못된 경로는 FileNotFoundException을 발생시킵니다.

비밀번호 요구 이벤트 리스너를 사용하여 문서 인덱싱하는 방법?

엔진이 비밀번호 필요 이벤트를 발생시킬 때만 비밀번호를 제공함으로써 자격 증명을 메모리에서 제외하고 동적 비밀번호 해석을 허용할 수 있습니다.

인덱싱 엔진이 암호화된 파일을 만나면 콜백이 트리거되어 보안 저장소에서 비밀번호를 조회하거나 즉시 계산할 수 있습니다. 이 방법은 모든 비밀번호를 사전에 저장하는 것보다 공격 표면을 줄입니다.

개요

이벤트 콜백을 통해 실시간으로 비밀번호를 제공하여 자격 증명 저장소를 격리합니다.

단계 1: 인덱스 및 문서 폴더 정의

String indexFolder = "YOUR_OUTPUT_DIRECTORY/IndexUsingPasswordEvent";
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY"; // Path to password‑protected documents

단계 2: 인덱스 생성

// Initialize the Index object in the specified directory
Index index = new Index(indexFolder);

단계 3: 비밀번호 필요 이벤트 구독

index.getEvents().PasswordRequired.add(new EventHandler<PasswordRequiredEventArgs>() {
    @Override
    public void invoke(Object sender, PasswordRequiredEventArgs args) {
        // Provide password for DOCX files when needed
        if (args.getDocumentFullPath().endsWith(".docx")) {
            args.setPassword("123456");
        }
    }
});

단계 4: 문서 인덱싱

// The event handler will supply passwords as required during indexing
index.add(documentsFolder);

단계 5: 인덱스에서 검색

String query = "sample OR increasing";
SearchResult result = index.search(query);

// Handle search results (e.g., display or process them)

문제 해결

  • 이벤트 핸들러가 인덱싱하려는 모든 파일 확장자를 포함하도록 확인하세요.
  • 먼저 몇 개의 샘플 파일로 테스트하여 비밀번호가 적용되는지 확인하세요.

실용적인 적용 사례

  1. 기업 문서 관리 – 기밀 계약서, 인사 파일, 재무 보고서를 자동으로 인덱싱하면서 저장 시 암호화된 상태를 유지합니다.
  2. 법률 아카이브 – 민감한 내용을 노출하지 않고 사건 파일을 신속하게 검색합니다.
  3. 헬스케어 기록 – HIPAA 요구 사항을 준수하면서 환자 PDF 및 Word 문서를 인덱싱합니다.

성능 고려 사항

  • 메모리 할당 – 대량 배치를 위해 충분한 힙 메모리(-Xmx2g 이상)를 할당하세요.
  • 병렬 인덱싱 – index.addAsync(...)를 사용하거나 여러 인덱싱 스레드를 실행하여 8코어 머신에서 시간당 2 백만 문서까지 처리합니다. index.addAsync(...)는 비동기 인덱싱을 위해 문서를 큐에 넣는 메서드입니다.
  • 인덱스 유지 관리 – 주기적으로 index.optimize()를 호출하여 인덱스를 압축하고 쿼리 속도를 향상시킵니다.

일반적인 문제와 해결책

  • 잘못된 비밀번호 – 문서가 건너뛰어지고 경고가 기록됩니다. 비밀번호 소스를 다시 확인하세요.
  • 지원되지 않는 형식 – 필요한 형식 플러그인을 설치하거나 인덱싱 전에 파일을 지원되는 유형으로 변환하세요.
  • 대용량 파일 – 힙 크기를 늘리고 OutOfMemoryError를 방지하기 위해 작은 배치로 인덱싱하는 것을 고려하세요.

자주 묻는 질문

Q: 다양한 파일 형식을 어떻게 처리하나요?
A: GroupDocs.Search는 PDF, DOCX, XLSX, PPTX 및 일반 이미지 유형을 포함한 120개 이상의 형식을 지원합니다. 필요하면 형식 플러그인을 설치하세요.

Q: 비밀번호가 틀리면 어떻게 되나요?
A: 문서가 건너뛰어지고 경고가 기록됩니다; 비밀번호 사전이나 이벤트 핸들러를 확인하세요.

Q: 클라우드에 저장된 파일을 인덱싱할 수 있나요?
A: 예, 하지만 엔진이 파일 시스템 경로와 함께 작동하므로 먼저 로컬 임시 폴더에 다운로드해야 합니다.

Q: 검색 관련성을 어떻게 향상시킬 수 있나요?
A: IndexOptions로 점수를 조정하고, 동의어를 추가하며, field:term~와 같은 고급 쿼리 구문을 사용해 퍼지 매칭을 수행하세요. IndexOptions는 점수 및 인덱싱 동작을 제어하는 구성 객체입니다.

Q: 일부 파일에 대해 인덱싱이 실패하면 어떻게 해야 하나요?
A: 로그 출력을 검토하세요; 일반적인 원인은 비밀번호 누락, 파일 손상, 지원되지 않는 형식입니다.

리소스

이 가이드를 따라 하면 이제 Java에서 여러 파일 유형을 검색하고 비밀번호 보호 문서를 인덱싱하는 방법을 알게 되어, 애플리케이션의 보안과 검색 가능성을 모두 향상시킬 수 있습니다.


마지막 업데이트: 2026-10-28
테스트 환경: GroupDocs.Search 25.4 for Java
작성자: GroupDocs

관련 튜토리얼