אריזה מחדש של קובץ WAR לקובץ JAR

אם אתם עוברים לגרסה העדכנית ביותר של Java שנתמכת, והאפליקציה שלכם לא משתמשת בשירותים מיושנים שצורפו לחבילה, אתם צריכים לארוז מחדש את אפליקציית האינטרנט שלכם ב-Java 8 ב-App Engine לקובץ JAR שניתן להפעלה.

באפליקציה שלכם צריך להיות מחלקה Main שמפעילה שרת אינטרנט שמגיב לבקשות HTTP ביציאה 8080, שאולי מצוינת על ידי משתנה הסביבה PORT.

לדוגמה:

import com.sun.net.httpserver.HttpServer;
import java.io.IOException;
import java.io.OutputStream;
import java.net.InetSocketAddress;

public class Main {

  public static void main(String[] args) throws IOException {
    // Create an instance of HttpServer bound to port defined by the 
    // PORT environment variable when present, otherwise on 8080.
    int port = Integer.parseInt(System.getenv().getOrDefault("PORT", "8080"));
    HttpServer server = HttpServer.create(new InetSocketAddress(port), 0);

    // Set root URI path.
    server.createContext("/", (var t) -> {
      byte[] response = "Hello World from Google App Engine Java 11.".getBytes();
      t.sendResponseHeaders(200, response.length);
      try (OutputStream os = t.getResponseBody()) {
        os.write(response);
      }
    });

    // Start the server.
    server.start();
  }
}

דוגמה להעברת WAR (Java 11)

ההוראות הבאות מסבירות איך לארוז מחדש אפליקציית Java 8 hello-world של App Engine כקובץ JAR כדי להפעיל אותה בסביבת זמן הריצה של Java 11.

ההעברה מתבצעת באמצעות ארטיפקט appengine-simple-jetty-main. הקוד הזה מספק מחלקה Main עם שרת אינטרנט פשוט של Jetty שטוען קובץ WAR ואורז את האפליקציה שלכם לקובץ JAR שניתן להפעלה:

1. משכפלים את ארטיפקט השרת Embedded Jetty למחשב המקומי:

   git clone https://github.com/GoogleCloudPlatform/java-docs-samples
   

   אפשרות נוספת היא להוריד את קובץ הדוגמה כקובץ ZIP ולחלץ אותו.

2. עוברים לספרייה שמכילה את הקוד לדוגמה:

   cd java-docs-samples/appengine-java11/appengine-simple-jetty-main/
   

3. מתקינים את יחסי התלות באופן מקומי:

   mvn install
   

4. מוסיפים את הקוד הבא לקובץ pom.xml של הפרויקט:

   • appengine-simple-jetty-main dependency:
     <dependency>
       <groupId>com.example.appengine</groupId>
       <artifactId>simple-jetty-main</artifactId>
       <version>1</version>
       <scope>provided</scope>
     </dependency>

   • maven-dependency plugin:
     <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-dependency-plugin</artifactId>
       <version>3.6.1</version>
       <executions>
         <execution>
           <id>copy</id>
           <phase>prepare-package</phase>
           <goals>
             <goal>copy-dependencies</goal>
           </goals>
           <configuration>
             <outputDirectory>
               ${project.build.directory}/appengine-staging
             </outputDirectory>
           </configuration>
         </execution>
       </executions>
     </plugin>

     ‫App Engine פורס קבצים שנמצאים בספרייה ${build.directory}/appengine-staging. אם מוסיפים את הפלאגין maven-dependency ל-build, ‏ App Engine מתקין את יחסי התלות שצוינו בתיקייה הנכונה.

5. יוצרים רכיב entrypoint בקובץ app.yaml כדי לקרוא לאובייקט appengine-simple-jetty-main ולהעביר את קובץ ה-WAR כארגומנט. לדוגמה, אפשר לעיין בקובץ helloworld-servlet לדוגמה: app.yaml

   runtime: java11
   entrypoint: 'java -cp "*" com.example.appengine.jetty.Main helloworld.war'

6. כדי להריץ את האפליקציה באופן מקומי:

   1. אורזים את האפליקציה:

      mvn clean package
      

   2. מפעילים את השרת עם קובץ ה-WAR כארגומנט.

      לדוגמה, כדי להפעיל את השרת בדוגמה helloworld-servlet, מריצים את הפקודה הבאה מהתיקייה java-docs-samples/appengine-java11/appengine-simple-jetty-main/:

      mvn exec:java -Dexec.args="../helloworld-java8/target/helloworld.war"
      

   3. בדפדפן האינטרנט, מזינים את הכתובת הבאה:

      http://localhost:8080

7. כדי לפרוס את האפליקציה:

   כלים של gcloud

   gcloud app deploy

   פלאגין Maven

   mvn package appengine:deploy -Dapp.deploy.projectId=PROJECT_ID

   מחליפים את PROJECT_ID במזהה הפרויקט. Google Cloud אם קובץ pom.xml שלכם כבר מציין את מזהה הפרויקט, אתם לא צריכים לכלול את המאפיין -Dapp.deploy.projectId בפקודה שאתם מריצים.