AWS SDK for Java version 2 - NYJavaSIG 2019-11-21

AWS SDK for Java version 2.x
NY JavaSIG
November 21, 2019

#nyjavasig
#awscloud
#awssdk
#java

Transcript

1. Sean Sullivan
   November 21, 2019
   NY JavaSIG
   AWS SDK for Java
   version 2.x
   

   View Slide

2. software engineer
   Portland Oregon
   Java
   Scala
   About me
   

   View Slide

3. Agenda
   SDK for Java 2.x
   SDK internals
   Migrating from v1 to v2
   Scala and SDK v2
   

   View Slide

4. AWS SDK for Java
   

   View Slide

5. SDK v2
   announced
   June 2017
   @awsforjava
   

   View Slide

6. “Under the hood, we use an
   HTTP client built on top of
   Netty to make the non-
   blocking HTTP call”
   “first class support for
   non-blocking I/O
   in our async clients”
   source: AWS Developer Blog
   

   View Slide

7. “The AWS SDK for Java 2.0
   asynchronous client methods return
   CompletableFuture objects”
   source: SDK v2 Developer Guide
   

   View Slide

8. import java.util.concurrent.CompletableFuture;
   DynamoDBAsyncClient client = DynamoDBAsyncClient.builder()
   .region(Region.US_WEST_2)
   .build();
   CompletableFuture response =
   client.listTables(ListTablesRequest.builder().build());
   CompletableFuture> tableNames =
   response.thenApply(ListTablesResponse::tableNames);
   tableNames.whenComplete((tables, err) -> {
   if (tables != null) {
   tables.forEach(System.out::println);
   } else {
   err.printStackTrace();
   }
   });
   SDK v2
   

   View Slide

9. Github projects
   aws-sdk-java aws-sdk-java-v2
   

   View Slide

10. SDK v2
    

    View Slide

11. Pull Request
    

    View Slide

12. SDK v2
    Maven artifacts
    

    View Slide

13. https://search.maven.org/
    

    View Slide

14. 
    com.amazonaws
    aws-java-sdk-dynamodb
    1.11.679
    
    Maven dependencies
    SDK v1
    
    software.amazon.awssdk
    dynamodb
    2.10.20
    
    SDK v2
    

    View Slide

15. import com.amazonaws.services.cloudwatch.AmazonCloudWatchClient;
    import com.amazonaws.services.cloudwatch.AmazonCloudWatchClientBuilder;
    import com.amazonaws.services.cloudwatch.model.MetricDatum;
    import com.amazonaws.services.cloudwatch.model.PutMetricDataRequest;
    Java packages
    SDK v1
    import software.amazon.awssdk.services.cloudwatch.CloudWatchAsyncClient;
    import software.amazon.awssdk.services.cloudwatch.model.MetricDatum;
    import software.amazon.awssdk.services.cloudwatch.model.PutMetricDataRequest;
    SDK v2
    

    View Slide

16. distinct Maven artifact names
    distinct Java package names
    SDK v2 and SDK v1
    can co-exist in a
    Java application
    SDK v1 jar
    SDK v2 jar
    

    View Slide

17. SDK v2 programming API
    • Immutable clients and models
    • Enhanced pagination
    • Smart configuration merging
    • Forward-compatible enums
    • Streaming operations as first-class
    concepts
    

    View Slide

18. SDK
    internals
    

    View Slide

19. 1.7.28
    2.10.0
    4.1.42.Final
    Transitive dependencies
    

    View Slide

20. “To provide SDK support for the many
    services that AWS owns,
    the AWS SDKs make extensive use
    of code generation”
    Code generation
    https://aws.amazon.com/blogs/developer/aws-sdk-for-java-2-x-released/
    

    View Slide

21. Why code generation?
    

    View Slide

22. less boilerplate
    more consistency
    Why code generation?
    

    View Slide

23. class names
    parameter names
    method names
    exception names
    Consistency
    error handling
    logging
    JSON serialization
    network I/O
    

    View Slide

24. AWS SDK for Java v2
    

    View Slide

25. JavaPoet
    AWS SDK for Java v2
    

    View Slide

26. Migrating code from v1 to v2
    

    View Slide

27. aws-secretsmanager-caching-java
    

    View Slide

28. https://github.com/aws/aws-secretsmanager-caching-java/
    

    View Slide

29. “AWS Secrets Manager Java
    caching client enables
    in-process caching of secrets for
    Java applications”
    aws-secretsmanager-caching-java
    

    View Slide

30. aws-secretsmanager-caching-java
    is based on
    AWS SDK v1
    

    View Slide

31. https://github.com/aws/aws-secretsmanager-caching-java/issues/
    

    View Slide

32. how to migrate
    aws-secretsmanager-
    caching-java
    from
    SDK v1 to SDK v2 ?
    

    View Slide

33. https://github.com/
    aws/aws-
    secretsmanager-
    caching-java/pull/6
    

    View Slide

34. https://github.com/aws/aws-secretsmanager-caching-java/pull/6/files
    

    View Slide

35. https://github.com/aws/aws-secretsmanager-caching-java/pull/6/files
    

    View Slide

36. Scala
    and
    AWS SDK v2
    

    View Slide

37. val awsSdkVersion = “2.10.20”
    "org.scala-lang.modules" %% "scala-java8-compat" % “0.9.0",
    "software.amazon.awssdk" % "cloudwatch" % awsSdkVersion,
    "software.amazon.awssdk" % "dynamodb" % awsSdkVersion
    build.sbt
    

    View Slide

38. import scala.compat.java8.FutureConverters._
    import scala.collection.JavaConverters._
    

    View Slide

39. FutureConverters?
    

    View Slide

40. java.util.concurrent.CompletableFuture
    scala.concurrent.Future
    

    View Slide

41. FutureConverters.scala
    

    View Slide

42. migrating a
    Scala library
    from
    AWS SDK v1 to v2
    

    View Slide

43. “A tiny Scala wrapper
    around
    AWS CloudWatch Java client”
    gfc-aws-cloudwatch
    

    View Slide

44. https://github.com/gilt/gfc-aws-cloudwatch
    

    View Slide

45. https://github.com/
    gilt/gfc-aws-
    cloudwatch/pull/8/
    files
    

    View Slide

46. View Slide

47. View Slide

48. Conclusion
    SDK v1 — production ready
    SDK v2 — production ready
    github.com/aws
    twitter.com/awsforjava
    

    View Slide

49. The end
    

    View Slide

50. View Slide

51. Bonus material
    

    View Slide

52. “Hands-on in the AWS Java Ecosystem”
    AWS re:Invent 2018
    

    View Slide

53. “Developing Applications on AWS in the JVM”
    AWS re:Invent 2017
    

    View Slide

54. https://www.slideshare.net/AmazonWebServices/
    dev205developing-applications-on-aws-in-the-jvm
    

    View Slide