Java 애플리케이션에서 OpenSearch를 사용하려면 OpenSearch Java 클라이언트를 활용하면 된다.
특히 Spring Boot 같은 프레임워크와 함께 사용하면 더욱 편리하다.
AWS SDK for Java 2.x와 연동하여 작업을 수행하고 일반적인 시나리오를 구현할 수 있다.
OutSearchClient의 search 메서드를 이용해서 OpenSearch에 요청을 보낼 수 있고,
그 결과는 SearchResponse 객체 형태로 받아올 수 있다.
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'
}
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);
}
}