AWS SDK para Java 2.0 es una reescritura de 1.0 con algunas características nuevas excelentes. Al igual que con la versión 1.0, le permite trabajar fácilmente con Amazon Web Services pero también incluye características como IO sin bloqueo e implementación HTTP conectable para personalizar aún más sus aplicaciones. Puede comenzar en minutos usando Maven o cualquier sistema de compilación que admita MavenCentral como fuente de artefactos.
Antes de comenzar, necesita una cuenta de AWS. Consulte la sección Registrarse en AWS de la guía para desarrolladores para obtener información sobre cómo crear una cuenta de AWS y recuperar sus credenciales de AWS.
Para ejecutar el SDK necesitará Java 1.8+ . Para obtener más información sobre los requisitos y la configuración óptima para el SDK, consulte la sección Instalación de un entorno de desarrollo Java de la guía para desarrolladores.
La forma recomendada de utilizar AWS SDK para Java en su proyecto es consumirlo desde Maven Central.
Para administrar automáticamente las versiones de los módulos (actualmente todos los módulos tienen la misma versión, pero puede que no siempre sea así) le recomendamos utilizar la importación de Lista de materiales de la siguiente manera:
< dependencyManagement >
< dependencies >
< dependency >
< groupId >software.amazon.awssdk</ groupId >
< artifactId >bom</ artifactId >
< version >2.29.31</ version >
< type >pom</ type >
< scope >import</ scope >
</ dependency >
</ dependencies >
</ dependencyManagement >
Entonces los módulos individuales pueden omitir la version
de su declaración de dependencia:
< dependencies >
< dependency >
< groupId >software.amazon.awssdk</ groupId >
< artifactId >ec2</ artifactId >
</ dependency >
< dependency >
< groupId >software.amazon.awssdk</ groupId >
< artifactId >s3</ artifactId >
</ dependency >
< dependency >
< groupId >software.amazon.awssdk</ groupId >
< artifactId >dynamodb</ artifactId >
</ dependency >
</ dependencies >
Alternativamente, puede agregar dependencias para los servicios específicos que utiliza únicamente:
< dependency >
< groupId >software.amazon.awssdk</ groupId >
< artifactId >ec2</ artifactId >
< version >2.29.31</ version >
</ dependency >
< dependency >
< groupId >software.amazon.awssdk</ groupId >
< artifactId >s3</ artifactId >
< version >2.29.31</ version >
</ dependency >
Puede importar el SDK completo a su proyecto (incluye TODOS los servicios). Tenga en cuenta que se recomienda importar solo los módulos que necesita.
< dependency >
< groupId >software.amazon.awssdk</ groupId >
< artifactId >aws-sdk-java</ artifactId >
< version >2.29.31</ version >
</ dependency >
Consulte la sección Configurar AWS SDK para Java de la guía para desarrolladores para obtener más información de uso.
Proporciona una manera de conectar su propia implementación HTTP.
Proporciona soporte de primera clase para IO sin bloqueo en clientes asíncronos.
Una vez que consulte el código de GitHub, podrá compilarlo usando los siguientes comandos.
Linux:
./mvnw clean install
# Skip tests, checkstyles, findbugs, etc for quick build
./mvnw clean install -P quick
# Build a specific service module
./mvnw clean install -pl :s3 -P quick --am
Ventanas:
./mvnw.cmd clean install
Puede encontrar código de muestra para v2 en los siguientes lugares:
it
debajo de cada módulo de servicio, por ejemplo: s3-integration-tests Para obtener información sobre el mantenimiento y la compatibilidad con las versiones principales del SDK y sus dependencias subyacentes, consulte lo siguiente en la Guía de referencia de herramientas y SDK de AWS:
Mantenemos soporte completo en las versiones de soporte a largo plazo (LTS): Java 8, Java 11, Java 17 y Java 21. Tenga en cuenta que puede haber funciones individuales en las versiones más recientes que no sean compatibles, porque el SDK debe ser compatible con Java. 8.
Necesitamos su ayuda para hacer que este SDK sea excelente. Participe en la comunidad y contribuya a este esfuerzo enviando problemas, participando en foros de discusión y enviando solicitudes de extracción a través de los siguientes canales:
Gracias a estas maravillosas personas (tecla emoji):
sulli | Austin Brooks | Konrad "ktoso" Malawski | Andres Hopkins | Adán Tomás | Steven Swor | Carey Burgess | |
Anuraag Agrawal | jeffalder | boris | Guillaume Corré | henry yandell | Ryan Schmitt | somaya | |
Steven Aerts | Steven Wong | Tomasz Elendt | Will Erickson | Julien Hoarau | SEOKHYOENCHOI | adriannistor | |
Sol de Xian | Andreas Scheja | Antón Egorov | roexber | brarrington | Christopher Radek | Foivos | |
Frank Wesemann | Gergely Varga | guillermo | Henry Heikkinen | Jochen Schalanda | Joe Barnett | Kazuhiro Sera | |
Krishna Chaitanya Ganta | Lee Packham | Mateo Carrara | Michael Scharp | Miguel Jiménez | Russell Bolles | Russell Scheerer | |
Scott | Shin'ya Ueoka | sushilamazon | tomliu4uber | Vladimir Orany | Xin Yu Hu | Yosef Fertel | |
Denys Konakhevych | Alex Weibel | Ryan Carper | Jonathan Henson | Débora N. Ito | Bret Ambrosio | Anna-Karin Salander | |
Juan Viegas | Dongie Agnir | Mateo Miller | Benjamín Maizels | Quan Zhou | Zoé Wang | Varun Nandi | |
andres costa | Kyle Thomson | Sam Fink | jonathan enlace | ajs139 | David Nguyen | David Lee | |
michael li | bennet lynch | Ikko Ashimine | Jaime Liu | guillepb10 | Níquel Lorenz | Erin Yang | |
Roberto Tyley | Alvin ver | ron1 | Sai Kumar Reddy Chandupatla | David Ho | Thomas Turrell-Croft | Steven Shan | |
Barry O'Neill | Andy Kiesler | Martín | Paulo Lieuthier | Sébastien Crocquesel | David Negrete | Esteban Flavin | |
Olivier Applin | Adrian Chlebosz | Chad Wilson | manish dait | Dennis Kieselhorst | Nilesh PS | Steven Swartz | |
Michael Dimchuk | Nikita Sokolov | Manuel Sugawara | Anirudh | Hayden panadero | Jaykumar Gosar | Michael Graeb | |
Michael Grundi | Eckard Mühlich | Tobías Soloschenko | luis madrigal | Kirill Chaykin | cubas prateek | bole1155 | Thomas Farr |
Este proyecto sigue la especificación de todos los contribuyentes. ¡Bienvenidos aportes de cualquier tipo!