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 sie selbst zu erstellen. SDK

Voraussetzungen

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

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

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 von für Java 2.x, die mit angegeben ist. SDK -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 Sie das als Abhängigkeit SDK

Um das AWS SDK for Java in Ihrem Projekt verwenden zu können, müssen Sie es als Abhängigkeit in der pom.xml Datei Ihres Projekts deklarieren.

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

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

Wenn Sie Ihr Maven-Projekt auf eine andere Weise erstellt haben, konfigurieren Sie die neueste Version von SDK für Ihr Projekt, indem Sie sicherstellen, dass die pom.xml Datei 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>

Legen Sie Abhängigkeiten für SDK Module fest

Nachdem Sie das konfiguriert habenSDK, können Sie Abhängigkeiten für eines oder mehrere AWS SDK for Java Module hinzufügen, die Sie in Ihrem Projekt verwenden möchten.

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 mithilfe des Stücklisten-Artefakts 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>

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

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 verwaltet werden, AWS SDK for Java BOM sind im zentralen Maven-Repository aufgeführt.

Bauen Sie SDK das Ganze in Ihr Projekt ein

Um Ihre Anwendung zu optimieren, empfehlen wir dringend, nur die Komponenten zu verwenden, die Sie benötigen, und nicht die gesamten KomponentenSDK. Um jedoch das Ganze AWS SDK for Java in Ihr Projekt einzubauen, deklarieren Sie es wie folgt in Ihrer pom.xml Datei.

<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 target Verzeichnis erstellt (z. B.myapp/target). Diese JAR enthält alle SDK Module, die Sie als Abhängigkeiten in Ihrer pom.xml Datei angegeben haben.