Richten Sie ein Apache Maven-Projekt ein

Sie können Apache Maven verwenden, um AWS SDK for Java Projekte einzurichten und zu erstellen oder um das SDK selbst zu erstellen.

Voraussetzungen

Um das AWS SDK for Java mit Maven zu verwenden, benötigen Sie Folgendes:

• Java 8.0 oder höher Sie können das neueste Java SE Development Kit unter http://www.oracle.com/technetwork/java/javase/downloads/ herunterladen. Das AWS SDK for Java kann auch mit OpenJDK und Amazon Corretto, einer Verteilung des Open Java Development Kit (OpenJDK), verwendet werden. Laden Sie die neuste Version des OpenJDK unter https://openjdk.java.net/install/index.html herunter. Laden Sie die neueste Version Amazon Corretto 8 oder Amazon Corretto 11 von der Corretto Seite herunter.

• Apache Maven. Wenn Sie Maven installieren müssen, navigieren Sie zu http://maven.apache.org/, um das Tool herunterzuladen und zu installieren.

Erstellen eines Maven-Projekts

Um ein Maven-Projekt von der Befehlszeile aus zu erstellen, führen Sie den folgenden Befehl in einem Terminal- oder Befehlszeilenfenster aus.

mvn -B archetype:generate \
 -DarchetypeGroupId=software.amazon.awssdk \
 -DarchetypeArtifactId=archetype-lambda -Dservice=s3 -Dregion=US_WEST_2 \
 -DarchetypeVersion=2.X.X \
 -DgroupId=com.example.myapp \
 -DartifactId=myapp

Anmerkung

Ersetzen Sie com.example.myapp durch den vollständigen Paket-Namespace Ihrer Anwendung. Ersetzen Sie auch myapp durch Ihren Projektnamen. Dies wird der Name des Verzeichnisses für Ihr Projekt.

Um die neueste Version des Archetyps zu verwenden, ersetzen Sie 2.X.X durch die neueste Version von Maven Central.

Dieser Befehl erstellt ein Maven-Projekt mit dem Archetype Templating Toolkit. Der Archetyp generiert das Gerüst für ein Function-Handler-Projekt. AWS Lambda Dieser Projekt-Archetyp ist für die Kompilierung mit Java SE 8 vorkonfiguriert und beinhaltet eine Abhängigkeit von der Version des SDK for Java 2.x, die mit spezifiziert ist. -DarchetypeVersion

Weitere Informationen zum Erstellen und Konfigurieren von Maven-Projekten finden Sie im Maven-Handbuch „Erste Schritte“.

Konfigurieren des Java-Compilers für Maven

Wenn Sie Ihr Projekt mit dem AWS Lambda Projekt-Archetyp wie zuvor beschrieben erstellt haben, ist die Konfiguration des Java-Compilers bereits für Sie erledigt.

Um zu überprüfen, ob diese Konfiguration vorhanden ist, öffnen Sie zunächst die Datei pom.xml aus dem Projektordner, den Sie erstellt haben (z. B. myapp), als Sie den vorherigen Befehl ausgeführt haben. In den Zeilen 11 und 12 sehen Sie die Einstellung der Java-Compiler-Version für dieses Maven-Projekt und in den Zeilen 71 bis 75 die erforderliche Einbindung des Maven-Compiler-Plug-ins.

<project>
  <properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
  </properties>
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>${maven.compiler.plugin.version}</version>
      </plugin>
    </plugins>
  </build>
</project>

Wenn Sie Ihr Projekt mit einem anderen Archetyp oder mit einer anderen Methode erstellen, müssen Sie sicherstellen, dass das Maven-Compiler-Plugin Teil des Builds ist und dass seine Quell- und Zieleigenschaften in der Datei beide auf 1.8 gesetzt sind. pom.xml

Eine Möglichkeit, diese erforderlichen Einstellungen zu konfigurieren, finden Sie im vorherigen Snippet.

Alternativ können Sie die Compiler-Konfiguration inline wie folgt mit der Plug-in-Deklaration konfigurieren.

<project>
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <configuration>
          <source>1.8</source>
          <target>1.8</target>
        </configuration>
      </plugin>
    </plugins>
  </build>
</project>

Deklarieren des SDK als Abhängigkeit

Sie können das AWS SDK for Java nur dann in Ihrem Projekt verwenden, wenn Sie es in der Datei pom.xml Ihres Projekts als Abhängigkeit deklarieren.

Wenn Sie Ihr Projekt mit dem Projekt-Archetyp wie zuvor beschrieben erstellt haben, ist die neueste Version des SDK bereits als Abhängigkeit in Ihrem Projekt konfiguriert.

Der Archetyp generiert eine Stücklisten-Artefaktabhängigkeit (Stückliste) für die Gruppen-ID. software.amazon.awssdk Bei einer Stückliste müssen Sie nicht die Maven-Version für einzelne Artefaktabhängigkeiten angeben, die dieselbe Gruppen-ID haben.

Wenn Sie Ihr Maven-Projekt auf andere Weise erstellt haben, konfigurieren Sie die neueste Version des SDK für Ihr Projekt, indem Sie sicherstellen, dass die Datei pom.xml Folgendes enthält.

<project>
  <properties>
    <aws.java.sdk.version>2.X.X</aws.java.sdk.version>
  </properties>
  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>software.amazon.awssdk</groupId>
        <artifactId>bom</artifactId>
        <version>${aws.java.sdk.version}</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>
</project>

Anmerkung

Ersetzen Sie 2.X.X in der pom.xml Datei durch die neueste Version von. AWS SDK for Java 2.x

Festlegen von Abhängigkeiten für SDK-Module

Nachdem Sie das SDK konfiguriert haben, können Sie Abhängigkeiten für eins oder mehrere der AWS SDK for Java-Module hinzufügen, die in Ihrem Projekt verwendet werden sollen.

Sie können zwar die Versionsnummer für jede Komponente angeben, müssen dies jedoch nicht, da Sie die SDK-Version bereits in dem dependencyManagement Abschnitt mit dem Stücklisten-Artefakt deklariert haben. Um eine andere Version eines bestimmten Moduls zu laden, geben Sie eine Versionsnummer für dessen Abhängigkeit an.

Wenn Sie Ihr Projekt mit dem Projekt-Archetyp wie zuvor beschrieben erstellt haben, ist Ihr Projekt bereits mit mehreren Abhängigkeiten konfiguriert. Dazu gehören Abhängigkeiten für AWS Lambda Funktionshandler und Amazon S3, wie folgt.

<project>
    <dependencies>
        <dependency>
            <groupId>software.amazon.awssdk</groupId>
            <artifactId>s3</artifactId>
            <exclusions>
                <exclusion>
                    <groupId>software.amazon.awssdk</groupId>
                    <artifactId>netty-nio-client</artifactId>
                </exclusion>
                <exclusion>
                    <groupId>software.amazon.awssdk</groupId>
                    <artifactId>apache-client</artifactId>
                </exclusion>
            </exclusions>
        </dependency>

        <dependency>
            <groupId>software.amazon.awssdk</groupId>
            <artifactId>url-connection-client</artifactId>
        </dependency>

        <dependency>
            <groupId>com.amazonaws</groupId>
            <artifactId>aws-lambda-java-core</artifactId>
            <version>${aws.lambda.java.version}</version>
        </dependency>
    </dependencies>
</project>

Anmerkung

Im obigen pom.xml Beispiel stammen die Abhängigkeiten von verschiedenen s. groupId Die s3 Abhängigkeit ist vonsoftware.amazon.awssdk, wohingegen die aws-lambda-java-core Abhängigkeit von istcom.amazonaws. Die Konfiguration der STL-Abhängigkeitsverwaltung wirkt sich auf Artefakte für aussoftware.amazon.awssdk, sodass für das aws-lambda-java-core Artefakt eine Version erforderlich ist.

Für die Entwicklung von Lambda-Funktionshandlern, die das SDK for Java 2.x verwenden, aws-lambda-java-core ist dies die richtige Abhängigkeit. Wenn Ihre Anwendung jedoch Lambda-Ressourcen mithilfe von Operationen wie,listFunctions, und createFunction verwalten muss deleteFunctioninvokeFunction, erfordert Ihre Anwendung die folgende Abhängigkeit.

<groupId>software.amazon.awssdk</groupId>
<artifactId>lambda</artifactId>

Anmerkung

Die s3 Abhängigkeit schließt die netty-nio-client und die apache-client transitiven Abhängigkeiten aus. Anstelle eines dieser HTTP-Clients beinhaltet der Archetyp die url-connection-client Abhängigkeit, wodurch die Startlatenz für Funktionen reduziert wird. AWS Lambda

Fügen Sie Ihrem Projekt die Module für die Funktionen hinzu, die AWS-Service Sie für Ihr Projekt benötigen. Die Module (Abhängigkeiten), die von der AWS SDK for Java BOM verwaltet werden, sind im zentralen Maven-Repository aufgeführt.

Anmerkung

Sie können die Datei pom.xml anhand eines Codebeispiels betrachten, um zu ermitteln, welche Abhängigkeiten Sie für Ihr Projekt benötigen. Wenn Sie beispielsweise an den Abhängigkeiten für den DynamoDB-Dienst interessiert sind, sehen Sie sich dieses Beispiel aus dem AWSCode Examples Repository unter an. GitHub (Suchen Sie unter /javav2/example_code/dynamodb nach der pom.xml Datei.)

Aufnehmen des gesamten SDK in Ihr Projekt

Zur Optimierung Ihrer Anwendung empfehlen wir dringend, nur die benötigten Komponenten abzurufen, und nicht das gesamte SDK. Wenn Sie jedoch das gesamte AWS SDK for Java in Ihr Projekt aufnehmen möchten, deklarieren Sie es wie folgt in Ihrer Datei pom.xml.

<project>
  <dependencies>
    <dependency>
      <groupId>software.amazon.awssdk</groupId>
      <artifactId>aws-sdk-java</artifactId>
      <version>2.X.X</version>
    </dependency>
  </dependencies>
</project>

Erstellen Ihres Projekts

Nachdem Sie die Datei pom.xml konfiguriert haben, können Sie Ihr Projekt mithilfe von Maven erstellen.

Um ein Maven-Projekt über die Befehlszeile zu erstellen, öffnen Sie ein Terminal- oder Eingabeaufforderungsfenster, navigieren Sie zu Ihrem Projektverzeichnis (z. B. myapp), geben oder fügen Sie den folgenden Befehl ein und drücken Sie dann die Eingabe.

mvn package

Dadurch wird eine einzelne .jar-Datei (JAR) im Verzeichnis target erstellt (z. B. myapp/target). Diese JAR enthält alle SDK-Module, die Sie als Abhängigkeiten in Ihrer Datei pom.xml angegeben haben.