Skip to content

Commit

Permalink
Revert throwing on AwsSdk2 + ApacheHttpClient
Browse files Browse the repository at this point in the history
Signed-off-by: Thomas Farr <[email protected]>
  • Loading branch information
Xtansia committed Nov 27, 2024
1 parent d3509b5 commit b99edc6
Show file tree
Hide file tree
Showing 5 changed files with 16 additions and 57 deletions.
2 changes: 2 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,12 +43,14 @@ This section is for maintaining a changelog for all breaking changes for the cli
### Added

### Dependencies
- Upgraded aws-sdk-java dependencies to at least `2.19.22` ([#]())

### Changed

### Deprecated

### Removed
- Removed throwing of exception when using `AwsSdk2Transport` with AWS SDK's `ApacheHttpClient` to make an DELETE/GET request with a body ([#]())

### Fixed
- Fixed an issue where `FieldSort` was not implementing `SortOptionsVariant` ([#1323](https://github.com/opensearch-project/opensearch-java/pull/1323))
Expand Down
4 changes: 1 addition & 3 deletions guides/auth.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,7 @@
Requests to [OpenSearch Service and OpenSearch Serverless](https://docs.aws.amazon.com/opensearch-service/index.html) must be signed using the AWS signing protocol. Use `AwsSdk2Transport` to send signed requests.

> ⚠️ **Warning** ⚠️
> Using `software.amazon.awssdk.http.apache.ApacheHttpClient` is discouraged as it does not support request bodies on GET or DELETE requests.
> This leads to incorrect handling of requests such as `OpenSearchClient.clearScroll()` and `OpenSearchClient.deletePit()`.
> As such `AwsSdk2Transport` will throw a `TransportException` if an unsupported request is encountered while using `ApacheHttpClient`.
> If you are using `software.amazon.awssdk.http.apache.ApacheHttpClient` please ensure you use at least version `2.29.22` as earlier versions do not support request bodies on GET or DELETE requests, which leads to incorrect handling of requests such as `OpenSearchClient.clearScroll()` and `OpenSearchClient.deletePit()`.
```java
SdkHttpClient httpClient = AwsCrtHttpClient.builder().build();
Expand Down
22 changes: 11 additions & 11 deletions java-client/build.gradle.kts
Original file line number Diff line number Diff line change
Expand Up @@ -220,17 +220,17 @@ dependencies {
testImplementation("com.fasterxml.jackson.datatype", "jackson-datatype-jakarta-jsonp", jacksonVersion)

// For AwsSdk2Transport
"awsSdk2SupportCompileOnly"("software.amazon.awssdk", "sdk-core", "[2.21,3.0)")
"awsSdk2SupportCompileOnly"("software.amazon.awssdk", "auth", "[2.21,3.0)")
"awsSdk2SupportCompileOnly"("software.amazon.awssdk", "http-auth-aws", "[2.21,3.0)")
testImplementation("software.amazon.awssdk", "sdk-core", "[2.21,3.0)")
testImplementation("software.amazon.awssdk", "auth", "[2.21,3.0)")
testImplementation("software.amazon.awssdk", "http-auth-aws", "[2.21,3.0)")
testImplementation("software.amazon.awssdk", "aws-crt-client", "[2.21,3.0)")
testImplementation("software.amazon.awssdk", "apache-client", "[2.21,3.0)")
testImplementation("software.amazon.awssdk", "netty-nio-client", "[2.21,3.0)")
testImplementation("software.amazon.awssdk", "url-connection-client", "[2.21,3.0)")
testImplementation("software.amazon.awssdk", "sts", "[2.21,3.0)")
"awsSdk2SupportCompileOnly"("software.amazon.awssdk", "sdk-core", "[2.29.22,3.0)")
"awsSdk2SupportCompileOnly"("software.amazon.awssdk", "auth", "[2.29.22,3.0)")
"awsSdk2SupportCompileOnly"("software.amazon.awssdk", "http-auth-aws", "[2.29.22,3.0)")
testImplementation("software.amazon.awssdk", "sdk-core", "[2.29.22,3.0)")
testImplementation("software.amazon.awssdk", "auth", "[2.29.22,3.0)")
testImplementation("software.amazon.awssdk", "http-auth-aws", "[2.29.22,3.0)")
testImplementation("software.amazon.awssdk", "aws-crt-client", "[2.29.22,3.0)")
testImplementation("software.amazon.awssdk", "apache-client", "[2.29.22,3.0)")
testImplementation("software.amazon.awssdk", "netty-nio-client", "[2.29.22,3.0)")
testImplementation("software.amazon.awssdk", "url-connection-client", "[2.29.22,3.0)")
testImplementation("software.amazon.awssdk", "sts", "[2.29.22,3.0)")

testImplementation("org.apache.logging.log4j", "log4j-api","[2.17.1,3.0)")
testImplementation("org.apache.logging.log4j", "log4j-core","[2.17.1,3.0)")
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -85,7 +85,6 @@ public class AwsSdk2Transport implements OpenSearchTransport {

private static final byte[] NO_BYTES = new byte[0];
private final SdkAutoCloseable httpClient;
private final boolean isApacheHttpClient;
private final String host;
private final String signingServiceName;
private final Region signingRegion;
Expand Down Expand Up @@ -195,8 +194,6 @@ private AwsSdk2Transport(
) {
Objects.requireNonNull(host, "Target OpenSearch service host must not be null");
this.httpClient = httpClient;
this.isApacheHttpClient = httpClient instanceof SdkHttpClient
&& httpClient.getClass().getName().equals("software.amazon.awssdk.http.apache.ApacheHttpClient");
this.host = host;
this.signingServiceName = signingServiceName;
this.signingRegion = signingRegion;
Expand Down Expand Up @@ -299,25 +296,9 @@ private <RequestT> SignedRequest prepareRequest(
Endpoint<RequestT, ?, ?> endpoint,
@CheckForNull TransportOptions options,
@CheckForNull OpenSearchRequestBodyBuffer body
) throws UnsupportedEncodingException, TransportException {
) throws UnsupportedEncodingException {
SdkHttpMethod method = SdkHttpMethod.fromValue(endpoint.method(request));

// AWS Apache Http Client only supports request bodies on PATCH, POST & PUT requests.
// See:
// https://github.com/aws/aws-sdk-java-v2/blob/master/http-clients/apache-client/src/main/java/software/amazon/awssdk/http/apache/internal/impl/ApacheHttpRequestFactory.java#L118-L137
if (isApacheHttpClient
&& method != SdkHttpMethod.PATCH
&& method != SdkHttpMethod.POST
&& method != SdkHttpMethod.PUT
&& body != null
&& body.getContentLength() > 0) {
throw new TransportException(
"AWS SDK's ApacheHttpClient does not support request bodies for HTTP method `"
+ method
+ "`. Please use a different SdkHttpClient implementation."
);
}

SdkHttpFullRequest.Builder req = SdkHttpFullRequest.builder().method(method);

StringBuilder url = new StringBuilder();
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,6 @@
import static org.apache.hc.core5.http.HttpHeaders.CONTENT_TYPE;
import static org.junit.Assert.assertEquals;
import static org.junit.Assert.assertNotNull;
import static org.junit.Assert.assertThrows;

import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
Expand Down Expand Up @@ -57,7 +56,6 @@
import org.junit.runners.Parameterized;
import org.opensearch.client.opensearch.OpenSearchClient;
import org.opensearch.client.opensearch.generic.Requests;
import org.opensearch.client.transport.TransportException;
import org.opensearch.client.transport.util.FunnellingHttpsProxy;
import org.opensearch.client.transport.util.SelfSignedCertificateAuthority;
import software.amazon.awssdk.auth.credentials.AwsBasicCredentials;
Expand Down Expand Up @@ -410,27 +408,7 @@ private void assertSigV4Request(
String contentSha256,
String expectedSignature
) throws Exception {
OpenSearchClient client = getTestClient();

if (sdkHttpClientType != SdkHttpClientType.APACHE
|| contentLength == 0
|| "PATCH".equals(method)
|| "POST".equals(method)
|| "PUT".equals(method)) {
request.invoke(client);
} else {
// AWS Apache Http Client only supports content on PATCH, POST & PUT requests.
// See:
// https://github.com/aws/aws-sdk-java-v2/blob/master/http-clients/apache-client/src/main/java/software/amazon/awssdk/http/apache/internal/impl/ApacheHttpRequestFactory.java#L118-L137
assertThrows(
"AWS SDK's ApacheHttpClient does not support request bodies for HTTP method `"
+ method
+ "`. Please use a different SdkHttpClient implementation.",
TransportException.class,
() -> request.invoke(client)
);
return;
}
request.invoke(getTestClient());

assertEquals(1, receivedRequests.size());
ReceivedRequest req = receivedRequests.poll();
Expand Down

0 comments on commit b99edc6

Please sign in to comment.