Java로 OpenSearch 사용하기

Java 애플리케이션에서 OpenSearch를 사용하려면 OpenSearch Java 클라이언트를 활용하면 된다.

특히 Spring Boot 같은 프레임워크와 함께 사용하면 더욱 편리하다.

AWS SDK for Java 2.x와 연동하여 작업을 수행하고 일반적인 시나리오를 구현할 수 있다.

OutSearchClient의 search 메서드를 이용해서 OpenSearch에 요청을 보낼 수 있고,

그 결과는 SearchResponse 객체 형태로 받아올 수 있다.

1. 의존성 추가(build.gradle 기준)

dependencies {
    implementation 'org.opensearch.client:opensearch-java:2.x' // 최신 버전을 확인해 사용하세요.
    implementation 'org.apache.httpcomponents:httpclient:4.5.13' // HTTP 클라이언트도 필요할 수 있어요.
    implementation 'org.opensearch:opensearch-rest-client:2.x'
}

2. OpenSearchClient 설정

OpenSearch 클라이언트를 설정하는 부분이다.

보통 Spring Boot에서는 @Configuration을 사용해서 Bean으로 등록한다.

여기서 호스트, 사용자 아름, 비밀번호 등의 인증 정보를 설정할 수 있다.

import org.apache.http.HttpHost;
import org.apache.http.auth.AuthScope;
import org.apache.http.auth.UsernamePasswordCredentials;
import org.apache.http.impl.client.BasicCredentialsProvider;
import org.opensearch.client.opensearch.OpenSearchClient;
import org.opensearch.client.transport.rest.RestClientTransport;
import org.opensearch.client.transport.OpenSearchTransport;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.opensearch.client.RestClient;

@Configuration
public class OpenSearchConfig {

    @Value("${opensearch.host}")
    private String host;

    @Value("${opensearch.port}")
    private int port;

    @Value("${opensearch.username}")
    private String username;

    @Value("${opensearch.password}")
    private String password;

    @Bean
    public OpenSearchClient openSearchClient() {
        // HTTP 통신을 위한 인증 정보를 제공해요.
        final BasicCredentialsProvider credentialsProvider = new BasicCredentialsProvider();
        credentialsProvider.setCredentials(AuthScope.ANY, new UsernamePasswordCredentials(username, password));

        // RestClient를 빌드해서 OpenSearch와의 통신을 설정해요.
        RestClient restClient = RestClient.builder(new HttpHost(host, port, "https"))
                .setHttpClientConfigCallback(httpClientBuilder -> 
                    httpClientBuilder.setDefaultCredentialsProvider(credentialsProvider)
                )
                .build();

        // RestClient를 OpenSearchTransport에 연결해서 OpenSearchClient를 생성해요.
        OpenSearchTransport transport = new RestClientTransport(restClient, new org.opensearch.client.json.jackson.JacksonJsonpMapper());
        
        return new OpenSearchClient(transport);
    }
}