dengjia 68b6c59c4f mimic-real-msg with fake output		1 tháng trước cách đây
..
src	68b6c59c4f mimic-real-msg with fake output	1 tháng trước cách đây
publish.yaml	68b6c59c4f mimic-real-msg with fake output	1 tháng trước cách đây
readme.md	68b6c59c4f mimic-real-msg with fake output	1 tháng trước cách đây

rds-mysql-fc-http-java11 帮助文档

快速部署一个 JAVA 11 的 HTTP 类型的读写 Mysql 数据库函数到阿里云函数计算。在本案例中提供公网方式连接到 RDS MySQL数据库。

前期准备

使用该项目，推荐您拥有以下的产品权限 / 策略：

| 服务/业务 | 函数计算 |
| --- | --- |
| 权限/策略 | AliyunFCFullAccess |

使用该项目，您需要提前准备好 MySQL 数据库并执行以下 SQL 语句创建表:

    CREATE TABLE `users` (
      `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
      `name` varchar(20) NOT NULL,
      `age` tinyint(11) NOT NULL DEFAULT '0',
      PRIMARY KEY (`id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8;

MySQL 数据库既可以选择阿里云 MySQL 数据库也可以选择其它 MySQL 数据库。在本案例中我们使用公网方式连接到阿里云 MySQL 数据库，若使用vpc方式连接阿里云 MySQL 数据库，请参考文档配置网络配置VPC网络。

使用阿里云数据库RDS MySQL实例,创建教程可以参考这里
- 登陆 RDS 控制台为 MySQL 实例申请外网地址,便于公网访问数据库
- 设置 IP 白名单,本案例作为测试，可以将白名单配置成 0.0.0.0/0。（不要在生产环境使用!)
- 需要提供正确的数据库 URL 地址、数据库名称、用户、密码，用于连接数据库
使用其它 MySQL 数据库
- 需要提供正确的数据库 URL 地址、数据库名称、用户、密码，用于连接数据库

代码 & 预览

:smiley_cat: 源代码
为了能够成功部署本样例代码，您在部署过程中需要提供以下参数：
- 地域 (region): 您需要通过这个参数配置您函数计算服务需要部署的地域，默认值为 cn-hangzhou (杭州)。
  - 为您提供的地域选项为：
  - cn-beijing (北京)
  - cn-hangzhou (杭州)
  - cn-shanghai (上海)
  - cn-qingdao (青岛)
  - cn-zhangjiakou (张家口)
  - cn-huhehaote (呼和浩特)
  - cn-shenzhen (深圳)
  - cn-chengdu (成都)
  - cn-hongkong (香港)
  - ap-southeast-1 (新加坡)
  - ap-southeast-2 (悉尼)
  - ap-southeast-3 (吉隆坡)
  - ap-southeast-5 (雅加达)
  - ap-northeast-1 (东京)
  - eu-central-1 (法兰克福)
  - eu-west-1 (伦敦)
  - us-west-1 (硅谷)
  - us-east-1 (弗吉尼亚)
  - ap-south-1 (孟买)
- 服务名 (service name): 您需要给您的函数计算服务进行命名，服务名称，只能包含字母、数字、下划线和中划线。不能以数字、中划线开头。长度在 1-128 之间，默认值为 rds-mysql-quick-start。
- 函数名 (function name): 您需要给您的函数计算函数进行命名，函数名称，只能包含字母、数字、下划线和中划线。不能以数字、中划线开头。长度在 1-64 之间。默认值为 rds-mysql-event-function-java。
- MySQL 地址 (mysql url): MySQL 地址,可登陆RDS控制台->实例列表->基本信息->网络类型->外网地址查看，用于连接数据库。
- MySQL 端口号 (mysql port): MySQL 端口号,默认3306。
- MySQL 数据库名称 (mysql database name): MySQL 数据库名,可登陆RDS控制台->实例列表->数据库管理->数据库名称查看，用于连接数据库。
- MySQL 用户名 (mysql user): MySQL 用户,可登陆RDS控制台->实例列表->账号管理->用户账号查看，用于连接数据库。
- MySQL 密码 (mysql password): MySQL 密码,可登陆RDS控制台->实例列表->账号管理->用户账号查看，用于连接数据库。

部署 & 体验

:fire: 通过 Serverless 应用中心，该应用。

通过 Serverless Devs Cli 进行部署：
- 安装 Serverless Devs Cli 开发者工具，并进行授权信息配置；
- 初始化项目：s init rds-mysql-fc-http-java11 -d rds-mysql-fc-http-java11
- 填入在以上模块介绍的参数
- 进入项目，并进行项目部署：cd rds-mysql-fc-http-java11 && s deploy -y

应用详情

环境变量

| 参数名称 | 参数类型 | 是否必填 | 例子 | 参数含义 | | --- | --- | --- | --- | --- | | MYSQL_ENDPOINT | String | 必填 | rm-uf6rrswxxxxxxxxxxxx.mysql.rds.aliyuncs.com | 数据库网址，用于连接数据库 | | MYSQL_PORT | String | 必填 | 3306 | 数据库端口 | | MYSQL_DBNAME | String | 必填 | test | 数据库名称 | | MYSQL_USER | String | 必填 | fc | 数据库用户名 |
| MYSQL_PASSWORD | String | 必填 | xxxxxxxx | 数据库密码 |

代码测试
- 通过postman构造http请求
- 登陆函数控制台->服务->函数管理->触发器管理->配置信息->公网访问地址,粘贴公网地址
- 在postman构造请求，粘贴公网访问地址，其中request body需包含想要插入数据库的 JSON 格式内容，包含用户名字和年龄字段。
```
{
"name": "wanger",
"age": "12"
}
```
- 通过 POST 方法发送请求
- 结果如下所示: 如果用户不熟悉postman工具也可直接在控制台编辑测试用例
数据库访问限制
- 使用云数据库时，一般都会有访问控制，需要设置 IP 白名单,本案例作为测试，可以将白名单配置成 0.0.0.0/0。（不要在生产环境使用!)。
- 在生产环境，可以使用以下两种方式访问：
- VPC方式（推荐）参考文档：配置网络
- 公网方式参考文档：配置固定公网IP地址
- 本示例不是连接池方式，若要使用连接池，可以参考文档 Connection Pooling with Connector/J

本应用仅作为学习和参考使用，您可以基于本项目进行二次开发和完善，实现自己的业务逻辑

常见问题

未设置白名单，MySQL 网址或端口设置错误

 "errorMessage": "Communications link failure\n\nThe last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from the server."

MySQL 用户名、密码错误

 "errorMessage": "Access denied for user 'fc'@'120.76.207.131' (using password: YES)"

MySQL 数据库名称错误 ```bash "errorMessage": "Unknown database 'users1'"

开发者社区

您如果有关于错误的反馈或者未来的期待，您可以在 Serverless Devs repo Issues 中进行反馈和交流。如果您想要加入我们的讨论组或者了解 FC 组件的最新动态，您可以通过以下渠道进行：

| | | | |--- | --- | --- | | 微信公众号：`serverless` | 微信小助手：`xiaojiangwh` | 钉钉交流群：`33947367` |

readme.md