[S3] Add support for more user-friendly CopyObject source parameters

## Motivation and Context

The current S3Client interface has a cumbersome API for invoking
CopyObjectRequests. We require users to define the bucket name, key
name, and version ID in a raw string format. We require that the string
conform to the S3 API, which forces users to know the intricate details
for how to join these values together. Additionally, portions (but not
all) of the value must be URL encoded, further increasing the burden.

https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html#API_CopyObject_RequestParameters

In the Java SDK v1, users are given explicit parameters for the
different copy source attributes. But in v2, parity for this support is
clearly lacking. E.g.,

v1:
```
s3.copyObject(new CopyObjectRequest()
        .withSourceBucketName(SOURCE_BUCKET)
        .withSourceKey(key)
        .withSourceVersionId(versionId)
        .withDestinationBucketName(DESTINATION_BUCKET)
        .withDestinationKey(key));
```

v2:
```
s3.copyObject(CopyObjectRequest.builder()
        .copySource(SOURCE_BUCKET + "/" + key + "?versionId=" + versionId)
        .destinationBucket(DESTINATION_BUCKET)
        .destinationKey(key)
        .build());
```

The v1 SDK will also URL encode on the user's behalf, allowing users to
use the same input values as they would for a PutObjectRequest. The v2
code snippet above may appear to work for most users until they run into
unexpected source keys that require URL encoding, at which point they
will typically be given `NoSuchKey` errors.

This API deficiency has been called out by users in at least the
following issues:

* aws#1313
* aws#1452
* aws#1656
* awsdocs/aws-doc-sdk-examples#740

## Description
* For both CopyObjectRequest and UploadPartCopyRequest, add explicit
parameters for: SourceBucket, SourceKey, SourceVersionId
* If specified, these values will be used to construct a CopySource on
the user's behalf, including URL encoding the relevant portions.
* These values are introduced in a backwards compatible fashion. Users
who are already using CopySource today will see no change in behavior,
but these new fields may not be used in conjunction with CopySource.
* A follow-up PR will be submitted to propose deprecating the current
CopySource parameter. It is excluded from this PR since our current code
gen configuration lacks appropriate support.
* Add support for "DestinationBucket" & "DestinationKey" to
UploadPartCopyRequest (this support already existed for
CopyObjectRequest)
* Utility function added to detect if an ARN is for a particular S3
resource type. This is to conform with the S3 API requirements of
inserting "/object" in the path of these requests.

## Testing
* New unit tests added
* New integration tests added

Author: Bennett Lynch

services/s3/src/it/java/software/amazon/awssdk/services/s3/CopySourceIntegrationTest.java

@@ -25,8 +25,8 @@
 import java.util.HashMap;
 import java.util.Map;
 import java.util.UUID;
-import org.junit.After;
-import org.junit.Before;
+import org.junit.AfterClass;
+import org.junit.BeforeClass;
 import org.junit.Test;
 import org.junit.runner.RunWith;
 import org.junit.runners.Parameterized;
@@ -50,18 +50,24 @@
 @RunWith(Parameterized.class)
 public class CopySourceIntegrationTest extends S3IntegrationTestBase {
 
-    private static final String SOURCE_BUCKET_NAME = temporaryBucketName("copy-source-integ-test-src");
+    private static final String SOURCE_UNVERSIONED_BUCKET_NAME = temporaryBucketName("copy-source-integ-test-src");
+    private static final String SOURCE_VERSIONED_BUCKET_NAME = temporaryBucketName("copy-source-integ-test-versioned-src");
     private static final String DESTINATION_BUCKET_NAME = temporaryBucketName("copy-source-integ-test-dest");
 
-    @Before
-    public void initializeTestData() throws Exception {
-        createBucket(SOURCE_BUCKET_NAME);
+    @BeforeClass
+    public static void initializeTestData() throws Exception {
+        createBucket(SOURCE_UNVERSIONED_BUCKET_NAME);
+        createBucket(SOURCE_VERSIONED_BUCKET_NAME);
+        s3.putBucketVersioning(r -> r
+            .bucket(SOURCE_VERSIONED_BUCKET_NAME)
+            .versioningConfiguration(v -> v.status(BucketVersioningStatus.ENABLED)));
         createBucket(DESTINATION_BUCKET_NAME);
     }
 
-    @After
-    public void tearDown() {
-        deleteBucketAndAllContents(SOURCE_BUCKET_NAME);
+    @AfterClass
+    public static void tearDown() {
+        deleteBucketAndAllContents(SOURCE_UNVERSIONED_BUCKET_NAME);
+        deleteBucketAndAllContents(SOURCE_VERSIONED_BUCKET_NAME);
         deleteBucketAndAllContents(DESTINATION_BUCKET_NAME);
     }
 
@@ -87,12 +93,12 @@ public void copyObject_WithoutVersion_AcceptsSameKeyAsPut() throws Exception {
         String originalContent = UUID.randomUUID().toString();
 
         s3.putObject(PutObjectRequest.builder()
-                                     .bucket(SOURCE_BUCKET_NAME)
+                                     .bucket(SOURCE_UNVERSIONED_BUCKET_NAME)
                                      .key(key)
                                      .build(), RequestBody.fromString(originalContent, StandardCharsets.UTF_8));
 
         s3.copyObject(CopyObjectRequest.builder()
-                                       .sourceBucket(SOURCE_BUCKET_NAME)
+                                       .sourceBucket(SOURCE_UNVERSIONED_BUCKET_NAME)
                                        .sourceKey(key)
                                        .destinationBucket(DESTINATION_BUCKET_NAME)
                                        .destinationKey(key)
@@ -113,16 +119,12 @@ public void copyObject_WithoutVersion_AcceptsSameKeyAsPut() throws Exception {
      */
     @Test
     public void copyObject_WithVersion_AcceptsSameKeyAsPut() throws Exception {
-        s3.putBucketVersioning(r -> r
-            .bucket(SOURCE_BUCKET_NAME)
-            .versioningConfiguration(v -> v.status(BucketVersioningStatus.ENABLED)));
-
         Map<String, String> versionToContentMap = new HashMap<>();
         int numVersionsToCreate = 3;
         for (int i = 0; i < numVersionsToCreate; i++) {
             String originalContent = UUID.randomUUID().toString();
             PutObjectResponse response = s3.putObject(PutObjectRequest.builder()
-                                                                      .bucket(SOURCE_BUCKET_NAME)
+                                                                      .bucket(SOURCE_VERSIONED_BUCKET_NAME)
                                                                       .key(key)
                                                                       .build(),
                                                       RequestBody.fromString(originalContent, StandardCharsets.UTF_8));
@@ -131,7 +133,7 @@ public void copyObject_WithVersion_AcceptsSameKeyAsPut() throws Exception {
 
         versionToContentMap.forEach((versionId, originalContent) -> {
             s3.copyObject(CopyObjectRequest.builder()
-                                           .sourceBucket(SOURCE_BUCKET_NAME)
+                                           .sourceBucket(SOURCE_VERSIONED_BUCKET_NAME)
                                            .sourceKey(key)
                                            .sourceVersionId(versionId)
                                            .destinationBucket(DESTINATION_BUCKET_NAME)