代码示例：使用 Spring Boot、Amazon RDS、AWS SES 和适用于 Java 的 AWS 开发工具包 2.x 创建 Java Web 应用程序

1. 介绍

涉及到的 AWS 服务：

  • Amazon Relational Database Service (Amazon RDS)（项目中使用 MySQL 数据库引擎）
  • Amazon Simple Email Service (the AWS SDK for Java SDK version 2 is used to access Amazon SES)
  • AWS Elastic Beanstalk

这个示例可以从 Web 页面提交数据到 AWS RDS 服务，并可以从 RDS 中获取数据进行展示。
使用 AWS SES 服务将 RDS 中的数据以 Excel 形式通过邮件发送给用户。
使用 AWS Elastic Beanstalk 部署应用。

用户从登陆页面进入应用 (user/password)
Java Web 应用调用 RDS 服务示例 - 图1
进入应用后看到主页
Java Web 应用调用 RDS 服务示例 - 图2
主页中提供的功能：

  • 创建一个 Item
  • 查看所有 Item
  • 修改 Item
  • 通过邮件发送报告给用户

2. 创建项目

在 IntelliJ 中创建一个 Maven 项目。

  • Name：AWSItemTracker
  • GroupId：spring-aws
  • ArtifactId：AWSItemTracker

3. 添加 POM 依赖

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <project xmlns="http://maven.apache.org/POM/4.0.0"
  3.          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4.          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  5.     <modelVersion>4.0.0</modelVersion>
  7.     <groupId>spring-aws</groupId>
  8.     <artifactId>AWSItemTracker</artifactId>
  9.     <version>1.0-SNAPSHOT</version>
  10.     <packaging>jar</packaging>
  12.     <parent>
  13.         <groupId>org.springframework.boot</groupId>
  14.         <artifactId>spring-boot-starter-parent</artifactId>
  15.         <version>2.0.4.RELEASE</version>
  16.         <relativePath /> <!-- lookup parent from repository -->
  17.     </parent>
  19.     <properties>
  20.         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  21.         <java.version>1.8</java.version>
  22.     </properties>
  25.     <dependencyManagement>
  26.         <dependencies>
  27.             <dependency>
  28.                 <groupId>software.amazon.awssdk</groupId>
  29.                 <artifactId>bom</artifactId>
  30.                 <version>2.10.30</version>
  31.                 <type>pom</type>
  32.                 <scope>import</scope>
  33.             </dependency>
  34.         </dependencies>
  35.     </dependencyManagement>
  37.     <dependencies>
  38.         <dependency>
  39.             <groupId>org.junit.jupiter</groupId>
  40.             <artifactId>junit-jupiter-api</artifactId>
  41.             <version>5.4.2</version>
  42.             <scope>test</scope>
  43.         </dependency>
  44.         <dependency>
  45.             <groupId>org.junit.jupiter</groupId>
  46.             <artifactId>junit-jupiter-engine</artifactId>
  47.             <version>5.4.2</version>
  48.             <scope>test</scope>
  49.         </dependency>
  50.         <dependency>
  51.             <groupId>org.junit.platform</groupId>
  52.             <artifactId>junit-platform-commons</artifactId>
  53.             <version>1.4.0</version>
  54.         </dependency>
  56.         <!-- https://mvnrepository.com/artifact/org.junit.platform/junit-platform-launcher -->
  57.         <dependency>
  58.             <groupId>org.junit.platform</groupId>
  59.             <artifactId>junit-platform-launcher</artifactId>
  60.             <version>1.4.0</version>
  61.             <scope>test</scope>
  62.         </dependency>
  64.         <!-- https://mvnrepository.com/artifact/software.amazon.awssdk/ses -->
  65.         <dependency>
  66.             <groupId>software.amazon.awssdk</groupId>
  67.             <artifactId>ses</artifactId>
  68.         </dependency>
  69.         <dependency>
  70.             <groupId>org.mockito</groupId>
  71.             <artifactId>mockito-all</artifactId>
  72.             <version>1.10.19</version>
  73.             <scope>test</scope>
  74.         </dependency>
  75.         <dependency>
  76.             <groupId>org.assertj</groupId>
  77.             <artifactId>assertj-core</artifactId>
  78.             <version>3.8.0</version>
  79.             <scope>test</scope>
  80.         </dependency>
  81.         <dependency>
  82.             <groupId>org.mockito</groupId>
  83.             <artifactId>mockito-core</artifactId>
  84.             <version>2.13.0</version>
  85.             <scope>test</scope>
  86.         </dependency>
  87.         <dependency>
  88.             <groupId>javax.mail</groupId>
  89.             <artifactId>javax.mail-api</artifactId>
  90.             <version>1.6.2</version>
  91.         </dependency>
  92.         <dependency>
  93.             <groupId>software.amazon.awssdk</groupId>
  94.             <artifactId>protocol-core</artifactId>
  95.         </dependency>
  96.         <dependency>
  97.             <groupId>junit</groupId>
  98.             <artifactId>junit</artifactId>
  99.             <version>4.5</version>
  100.             <scope>test</scope>
  101.         </dependency>
  102.         <dependency>
  103.             <groupId>javax.mail</groupId>
  104.             <artifactId>javax.mail-api</artifactId>
  105.             <version>1.5.5</version>
  106.         </dependency>
  107.         <dependency>
  108.             <groupId>com.sun.mail</groupId>
  109.             <artifactId>javax.mail</artifactId>
  110.             <version>1.5.5</version>
  111.         </dependency>
  112.         <dependency>
  113.             <groupId>org.springframework.boot</groupId>
  114.             <artifactId>spring-boot-starter-thymeleaf</artifactId>
  115.         </dependency>
  116.         <!-- bootstrap and jquery -->
  117.         <dependency>
  118.             <groupId>org.webjars</groupId>
  119.             <artifactId>bootstrap</artifactId>
  120.             <version>3.3.7</version>
  121.         </dependency>
  122.         <dependency>
  123.             <groupId>org.webjars</groupId>
  124.             <artifactId>jquery</artifactId>
  125.             <version>3.2.1</version>
  126.         </dependency>
  127.         <!-- mysql connector -->
  128.         <dependency>
  129.             <groupId>mysql</groupId>
  130.             <artifactId>mysql-connector-java</artifactId>
  131.             <scope>runtime</scope>
  132.         </dependency>
  133.         <dependency>
  134.             <groupId>net.sourceforge.jexcelapi</groupId>
  135.             <artifactId>jxl</artifactId>
  136.             <version>2.6.10</version>
  137.         </dependency>
  138.         <dependency>
  139.             <groupId>commons-io</groupId>
  140.             <artifactId>commons-io</artifactId>
  141.             <version>2.6</version>
  142.         </dependency>
  143.         <dependency>
  144.             <groupId>org.springframework.boot</groupId>
  145.             <artifactId>spring-boot-starter-web</artifactId>
  146.         </dependency>
  147.         <dependency>
  148.             <groupId>org.springframework.boot</groupId>
  149.             <artifactId>spring-boot-starter-security</artifactId>
  150.         </dependency>
  151.         <dependency>
  152.             <groupId>org.springframework.security</groupId>
  153.             <artifactId>spring-security-test</artifactId>
  154.             <scope>test</scope>
  155.         </dependency>
  156.         <dependency>
  157.             <groupId>org.springframework.boot</groupId>
  158.             <artifactId>spring-boot-starter-test</artifactId>
  159.             <scope>test</scope>
  160.             <exclusions>
  161.                 <exclusion>
  162.                     <groupId>org.junit.vintage</groupId>
  163.                     <artifactId>junit-vintage-engine</artifactId>
  164.                 </exclusion>
  165.             </exclusions>
  166.         </dependency>
  167.     </dependencies>
  169.     <build>
  170.         <plugins>
  171.             <plugin>
  172.                 <groupId>org.apache.maven.plugins</groupId>
  173.                 <artifactId>maven-compiler-plugin</artifactId>
  174.                 <version>3.1</version>
  175.                 <configuration>
  176.                     <source>${java.version}</source>
  177.                     <target>${java.version}</target>
  178.                 </configuration>
  179.             </plugin>
  180.             <plugin>
  181.                 <groupId>org.apache.maven.plugins</groupId>
  182.                 <artifactId>maven-checkstyle-plugin</artifactId>
  183.                 <version>3.1.0</version>
  184.                 <configuration>
  185.                     <configLocation>check.xml</configLocation>
  186.                     <encoding>UTF-8</encoding>
  187.                     <consoleOutput>true</consoleOutput>
  188.                     <failsOnError>true</failsOnError>
  189.                     <linkXRef>false</linkXRef>
  190.                 </configuration>
  191.                 <executions>
  192.                     <execution>
  193.                         <id>validate</id>
  194.                         <phase>validate</phase>
  195.                         <goals>
  196.                             <goal>check</goal>
  197.                         </goals>
  198.                     </execution>
  199.                 </executions>
  200.             </plugin>
  201.         </plugins>
  202.     </build>
  203. </project>

4. 项目代码

  • 后端代码：
    • SecuringWebApplication：SpringBoot 项目启动类；
    • WebSecurityConfig：Spring 配置类，对项目资源的做了认证授权；并且将项目的有效用户名和密码保存在内存中；
    • MainController：Restful API 接口；
    • WorkItem：实体类；
    • ConnectionHelper：创建一个与 RDS MySQL 实例的链接（配置 URL、User、Password）；
    • InjectWorkService：插入数据到 MySQL 实例；
    • RetrieveItems：从 MySQL 实例查询数据；
    • SendMessage：使用 AWS SDK 调用 AWS SES API，发送一封带 Excel 文档附件的邮件；
    • WriteExcel：从 MySQL 获取数据，并使用 Java Excel API 生成一个 Excel 报告文件；
  • 前端代码：
    • login.html：登录页面；
    • index.html：系统主页；
    • add.html：新建一个 Item 页面；
    • items.html：展示和修改 Items；
    • layout.html：以上所有 Views 的页面布局；
    • items.js：items.html 调用；
    • contact_me.js：add.html 调用；

image.png

5. 创建 RDS table

image.png
image.png
image.png
image.png
image.png
image.png
image.png :::info 默认情况下，数据库实例不允许访问。通过与 VPC 关联的安全组授予访问权限，该安全组允许流量进出数据库实例。(还需要检查 VPC 是否附加 Internet 网关，并将有与子网关联的路由将流量导向网关) ::: image.png
image.png
image.png :::info 修改 ConnectionHelper 数据库配置：

url = "jdbc:mysql://awstracker.<url to rds>.amazonaws.com/awstracker";
...
Class.forName("com.mysql.jdbc.Driver").newInstance();
        return DriverManager.getConnection(instance.url, "root","root1234");

:::

image.png

CREATE TABLE awstracker.work(
    idwork VARCHAR(45) PRIMARY KEY,
    date Date,
    description VARCHAR(400),
    guide VARCHAR(45),
    status VARCHAR(400),
    username VARCHAR(45),
    archive BOOLEAN
)  ENGINE=INNODB;

# 从 Workbench 添加一条数据
idwork - 4ea93f34-a45a-481e-bdc6-26c003bb93fc
date - 2020-01-20
description - Need to test all examples
guide - AWS Devloper Guide
status - Tested all of the Amazon S3 examples
username - user
archive - 0

6. 构建 JAR 包

通过 mvn package 命令构建 web 应用的 JAR 包，然后通过 Elastic Beanstalk 上传可执行的 JAR 文件，部署应用。

7. 部署应用到 Elastic Beanstalk

image.png
image.png
image.png
image.png
image.png