2. Handle REST API requests (implement Lambda functions)

Author: artem-korolev

.github/workflows/doc.yml

@@ -0,0 +1,36 @@
+name: Deploy Tutorial Site to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pages: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: "20" # Use the Node version you prefer
+
+      - name: Install Dependencies
+        run: cd doc && npm ci
+
+      - name: Build the VitePress Site
+        run: cd doc && npm run build
+        # This command builds the site into doc/.vitepress/dist
+
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./doc/.vitepress/dist

.vscode/settings.json

@@ -0,0 +1,10 @@
+{
+  "cSpell.words": [
+    "github",
+    "Korolev",
+    "peaceiris",
+    "serde",
+    "tokio",
+    "vitepress"
+  ]
+}

Cargo.toml

@@ -6,5 +6,13 @@ members = [
     "app/functions/function_two",
     "app/functions/function_three",
     # libraries
-    "app/libraries/common_lib",
+    "app/libraries/lambda_http_wrapper",
 ]
+
+[workspace.dependencies]
+serde = { version = "1.0", features = ["derive"] }
+serde_json = "1.0"
+lambda_runtime = "0.13.0"
+aws_lambda_events = "0.16.0"
+lambda_http = "0.14.0"
+tokio = { version = "1.0", features = ["macros"] }

README.md

@@ -1,3 +1,3 @@
 # AWS Lambda with Rust runtime
 
-This is tutorial project. Read here - [doc/tutorial.md](/doc/tutorial.md)
+This is tutorial project. Read here - [Tutorial - AWS Lambda with Rust runtime](/doc/)

app/functions/function_one/Cargo.toml

@@ -8,3 +8,8 @@ name = "function_one"
 path = "src/function_one.rs"
 
 [dependencies]
+tokio = { workspace = true }
+serde = { workspace = true }
+
+# internal dependencies
+lambda_http_wrapper = { path = "../../libraries/lambda_http_wrapper"}

app/functions/function_one/src/function_one.rs

@@ -1,3 +1,12 @@
-fn main() {
-    println!("Hello, world!");
+use lambda_http_wrapper::Error;
+
+use lambda_http_wrapper::run;
+
+mod function_one_controller;
+use function_one_controller::function_one_controller;
+mod function_one_types;
+
+#[tokio::main]
+async fn main() -> Result<(), Error> {
+    run(function_one_controller).await
 }

app/functions/function_one/src/function_one_controller.rs

@@ -0,0 +1,12 @@
+use crate::function_one_types::*;
+
+/// This is “business logic” controller
+pub(crate) async fn function_one_controller(req: Request) -> Result<Response, ErrorResponse> {
+    // For example, get a "name" from the query string (defaulting to "world")
+    let name = req.name;
+
+    // Here you would call into your service layer, etc.
+    Ok(Response {
+        message: format!("[Function_1] Hello {}, this is an AWS Lambda HTTP request using controller wrapper to avoid lots of boilerplate", name),
+    })
+}

app/functions/function_one/src/function_one_types.rs

@@ -0,0 +1,22 @@
+//! This module defines the “API types” that your controllers use.
+
+use serde::{Deserialize, Serialize};
+
+/// Your application’s Request – you can add more fields as needed (e.g. headers, body).
+#[derive(Debug, Serialize, Deserialize)]
+pub struct Request {
+    /// For simplicity we extract just the query parameters.
+    pub name: String,
+}
+
+/// Your successful Response.
+#[derive(Debug, Serialize, Deserialize)]
+pub struct Response {
+    pub message: String,
+}
+
+/// Your Error Response.
+#[derive(Debug, Serialize, Deserialize)]
+pub struct ErrorResponse {
+    pub error: String,
+}

app/functions/function_three/Cargo.toml

@@ -8,3 +8,8 @@ name = "function_three"
 path = "src/function_three.rs"
 
 [dependencies]
+tokio = { workspace = true }
+serde = { workspace = true }
+
+# internal dependencies
+lambda_http_wrapper = { path = "../../libraries/lambda_http_wrapper"}

app/functions/function_three/src/function_three.rs

@@ -1,3 +1,12 @@
-fn main() {
-    println!("Hello, world!");
+use lambda_http_wrapper::Error;
+
+use lambda_http_wrapper::run_no_input as run;
+
+mod function_three_controller;
+use function_three_controller::function_three_controller;
+mod function_three_types;
+
+#[tokio::main]
+async fn main() -> Result<(), Error> {
+    run(function_three_controller).await
 }