Google App Engine Java 标准环境项目教程

Google App Engine Java 标准环境项目教程

appengine-java-standard Google App Engine Standard Java runtime: Prod runtime, local devappserver, Cloud SDK Java components, GAE APIs, and GAE API emulators. 项目地址: https://gitcode.com/gh_mirrors/ap/appengine-java-standard

1. 项目的目录结构及介绍

本项目是基于Google App Engine Java标准环境的开源项目，其目录结构如下：

• api: 包含了Google App Engine的API源代码。
• appengine-api-1.0-sdk: Google App Engine Java 8 SDK的相关文件。
• appengine-api-stubs: 提供了API存根，用于本地开发和测试。
• appengine_init: 包含了初始化代码。
• appengine_jsr107: 与JSR 107相关的代码，用于缓存。
• appengine_resources: 包含项目资源文件。
• appengine_setup: 包含了设置代码。
• appengine_testing: 提供了测试相关的代码和工具。
• appengine_testing_tests: 测试用例代码。
• applications: 应用程序代码示例。
• docs: 项目文档。
• e2etests: 端到端测试代码。
• external/geronimo_javamail: 集成了Geronimo JavaMail组件。
• google3/third_party/java_src/appengine_standard/api_compatibility_tests: 兼容性测试代码。
• images: 图片资源。
• jetty12_assembly: Jetty 12的组装文件。
• kokoro/gcp_ubuntu: Kokoro持续集成环境配置。
• lib: 项目库文件。
• licenses/resources: 版权信息文件。
• local_runtime_shared_jetty12: 本地运行时共享的Jetty 12文件。
• local_runtime_shared_jetty9: 本地运行时共享的Jetty 9文件。
• protobuf: Protocol Buffers相关代码。
• quickstartgenerator: 快速启动生成器。
• remoteapi: 远程API代码。
• .gitignore: Git忽略文件。
• CODE_OF_CONDUCT.md: 项目行为准则。
• CONTRIBUTING.md: 贡献指南。
• LICENSE: 项目许可证。
• LICENSE_HEADER: 许可证头部信息。
• README.md: 项目自述文件。
• THIRD-PARTY.txt: 第三方依赖声明。
• TRYLATESTBITSINPROD.md: 在生产环境中尝试最新功能的指南。
• debugging.md: 调试指南。
• httpconnector.md: HTTP连接器信息。
• maven-version-rules.xml: Maven版本规则。
• mvnw, mvnw.cmd: Maven_wrapper脚本。
• pom.xml: Maven项目对象模型文件。
• renovate.json: Renovate配置文件。
• update_deps.sh: 更新依赖的脚本。

2. 项目的启动文件介绍

项目的启动通常依赖于appengine-web.xml文件，这是Google App Engine的标准配置文件。以下是一个简单的示例：

<?xml version="1.0" encoding="utf-8"?>
<appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
  <runtime>java8</runtime>
  <app-engine-apis>true</app-engine-apis>
</appengine-web-app>

此文件指定了运行时环境为Java 8，并启用了App Engine API。

3. 项目的配置文件介绍

项目的配置文件主要包括pom.xml，这是Maven项目的基本配置文件，用于定义项目依赖、构建配置等信息。以下是一个简化示例：

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.google.appengine</groupId>
    <artifactId>appengine-api-1.0-sdk</artifactId>
    <version>2.0.34</version>
    <packaging>war</packaging>
    <dependencies>
        <dependency>
            <groupId>com.google.appengine</groupId>
            <artifactId>appengine-api-1.0-sdk</artifactId>
            <version>2.0.34</version>
        </dependency>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>
</project>

此配置文件定义了项目依赖的App Engine SDK和Servlet API。scope设置为provided意味着这些依赖将由App Engine环境提供，不需要打包到最终的WAR文件中。

通过以上介绍，您可以对Google App Engine Java标准环境项目有一个基本的了解，并可以根据这些信息开始搭建和配置自己的项目。

appengine-java-standard Google App Engine Standard Java runtime: Prod runtime, local devappserver, Cloud SDK Java components, GAE APIs, and GAE API emulators. 项目地址: https://gitcode.com/gh_mirrors/ap/appengine-java-standard