Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit dcbef42

Browse files
jeromevdljeromevdl
committedOct 12, 2023
chore: update v2 (#1409)
1 parent 7faea0b commit dcbef42

File tree

15 files changed

+731
-3
lines changed

15 files changed

+731
-3
lines changed
 

‎examples/powertools-examples-core-utilities/README.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,10 @@ We also provide an example showing the integration of SAM, Powertools, and Gradl
1515

1616
* [AWS SAM with a Gradle build](gradle/)
1717

18+
We also provide an example showing the integration of SAM, Powertools, and Gradle:
19+
20+
* [AWS SAM with a Gradle build](../powertools-examples-core-utilities/gradle/)
21+
1822
For each of the tools, the example application is the same, and consists of the following files:
1923

2024
- [App.java](sam/src/main/java/helloworld/App.java) - Code for the application's Lambda function.

‎examples/powertools-examples-core-utilities/cdk/app/pom.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@
33
<modelVersion>4.0.0</modelVersion>
44

55
<groupId>software.amazon.lambda.examples</groupId>
6-
<version>1.16.1</version>
7-
<artifactId>powertools-examples-core</artifactId>
6+
<version>1.17.0</version>
7+
<artifactId>powertools-examples-core-utilities-cdk</artifactId>
88
<packaging>jar</packaging>
99

1010
<name>Powertools for AWS Lambda (Java) library Examples - Core</name>

‎examples/powertools-examples-core-utilities/cdk/infra/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<modelVersion>4.0.0</modelVersion>
55
<groupId>software.amazon.lambda.examples</groupId>
66
<artifactId>cdk</artifactId>
7-
<version>1.18.0-SNAPSHOT</version>
7+
<version>2.0.0-SNAPSHOT</version>
88
<properties>
99
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
1010
<cdk.version>2.100.0</cdk.version>

‎examples/powertools-examples-core-utilities/gradle/README.md

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
# Powertools for AWS Lambda (Java) - Core Utilities Example with Gradle
2+
3+
This project demonstrates the Lambda for Powertools Java module deployed using [Serverless Application Model](https://aws.amazon.com/serverless/sam/) with
4+
[Gradle](https://gradle.org/) running the build. This example is configured for Java 1.8 only; in order to use a newer version, check out the Gradle
5+
configuration guide [in the main project README](../../../README.md).
6+
7+
You can also use `sam init` to create a new Gradle-powered Powertools application - choose to use the **AWS Quick Start Templates**,
8+
and then **Hello World Example with Powertools for AWS Lambda**, **Java 17** runtime, and finally **gradle**.
9+
10+
11+
For general information on the deployed example itself, you can refer to the parent [README](../../powertools-examples-core/README.md)
12+
13+
## Configuration
14+
SAM uses [template.yaml](template.yaml) to define the application's AWS resources.
15+
This file defines the Lambda function to be deployed as well as API Gateway for it.
16+
17+
The build of the project is managed by Gradle, and configured in [build.gradle](build.gradle).
18+
19+
## Deploy the sample application
20+
To get started, you can use the Gradle wrapper to bootstrap Gradle and run the build:
21+
22+
```bash
23+
./gradlew build
24+
```
25+
26+
Once this is done to deploy the example, check out the instructions for getting started with SAM in
27+
[the examples directory](../../README.md)
28+
29+
## Additional notes
30+
31+
You can watch the trace information or log information using the SAM CLI:
32+
```bash
33+
# Tail the logs
34+
sam logs --tail $MY_STACK
35+
36+
# Tail the traces
37+
sam traces --tail
38+
```

‎examples/powertools-examples-core-utilities/gradle/build.gradle

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
2+
plugins {
3+
id 'java'
4+
id "io.freefair.aspectj.post-compile-weaving" version "6.6.3"
5+
}
6+
7+
wrapper {
8+
gradleVersion = "7.6.1"
9+
}
10+
11+
compileJava {
12+
sourceCompatibility = "1.8"
13+
targetCompatibility = "1.8"
14+
15+
ajc {
16+
enabled = true
17+
}
18+
}
19+
20+
repositories {
21+
mavenCentral()
22+
}
23+
24+
dependencies {
25+
implementation 'com.amazonaws:aws-lambda-java-core:1.2.2'
26+
implementation 'com.fasterxml.jackson.core:jackson-annotations:2.13.2'
27+
implementation 'com.fasterxml.jackson.core:jackson-databind:2.13.2.2'
28+
implementation 'com.amazonaws:aws-lambda-java-events:3.11.0'
29+
implementation 'com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.13.2'
30+
aspect 'software.amazon.lambda:powertools-tracing:1.17.0'
31+
aspect 'software.amazon.lambda:powertools-logging:1.17.0'
32+
aspect 'software.amazon.lambda:powertools-metrics:1.17.0'
33+
testImplementation 'junit:junit:4.13.2'
34+
}
35+

‎examples/powertools-examples-core-utilities/gradle/events/event.json

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
{
2+
"body": "{\"message\": \"hello world\"}",
3+
"resource": "/{proxy+}",
4+
"path": "/path/to/resource",
5+
"httpMethod": "POST",
6+
"isBase64Encoded": false,
7+
"queryStringParameters": {
8+
"foo": "bar"
9+
},
10+
"pathParameters": {
11+
"proxy": "/path/to/resource"
12+
},
13+
"stageVariables": {
14+
"baz": "qux"
15+
},
16+
"headers": {
17+
"Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8",
18+
"Accept-Encoding": "gzip, deflate, sdch",
19+
"Accept-Language": "en-US,en;q=0.8",
20+
"Cache-Control": "max-age=0",
21+
"CloudFront-Forwarded-Proto": "https",
22+
"CloudFront-Is-Desktop-Viewer": "true",
23+
"CloudFront-Is-Mobile-Viewer": "false",
24+
"CloudFront-Is-SmartTV-Viewer": "false",
25+
"CloudFront-Is-Tablet-Viewer": "false",
26+
"CloudFront-Viewer-Country": "US",
27+
"Host": "1234567890.execute-api.us-east-1.amazonaws.com",
28+
"Upgrade-Insecure-Requests": "1",
29+
"User-Agent": "Custom User Agent String",
30+
"Via": "1.1 08f323deadbeefa7af34d5feb414ce27.cloudfront.net (CloudFront)",
31+
"X-Amz-Cf-Id": "cDehVQoZnx43VYQb9j2-nvCh-9z396Uhbp027Y2JvkCPNLmGJHqlaA==",
32+
"X-Forwarded-For": "127.0.0.1, 127.0.0.2",
33+
"X-Forwarded-Port": "443",
34+
"X-Forwarded-Proto": "https"
35+
},
36+
"requestContext": {
37+
"accountId": "123456789012",
38+
"resourceId": "123456",
39+
"stage": "prod",
40+
"requestId": "c6af9ac6-7b61-11e6-9a41-93e8deadbeef",
41+
"requestTime": "09/Apr/2015:12:34:56 +0000",
42+
"requestTimeEpoch": 1428582896000,
43+
"identity": {
44+
"cognitoIdentityPoolId": null,
45+
"accountId": null,
46+
"cognitoIdentityId": null,
47+
"caller": null,
48+
"accessKey": null,
49+
"sourceIp": "127.0.0.1",
50+
"cognitoAuthenticationType": null,
51+
"cognitoAuthenticationProvider": null,
52+
"userArn": null,
53+
"userAgent": "Custom User Agent String",
54+
"user": null
55+
},
56+
"path": "/prod/path/to/resource",
57+
"resourcePath": "/{proxy+}",
58+
"httpMethod": "POST",
59+
"apiId": "1234567890",
60+
"protocol": "HTTP/1.1"
61+
}
62+
}

‎examples/powertools-examples-core-utilities/gradle/gradle/wrapper/.gitignore

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
!gradle-wrapper.jar
2+

‎examples/powertools-examples-core-utilities/gradle/gradle/wrapper/gradle-wrapper.properties

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
distributionBase=GRADLE_USER_HOME
2+
distributionPath=wrapper/dists
3+
distributionUrl=https\://services.gradle.org/distributions/gradle-7.3.3-bin.zip
4+
networkTimeout=10000
5+
validateDistributionUrl=true
6+
zipStoreBase=GRADLE_USER_HOME
7+
zipStorePath=wrapper/dists

‎examples/powertools-examples-core-utilities/gradle/gradlew

Lines changed: 248 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,248 @@
1+
#!/bin/sh
2+
3+
#
4+
# Copyright © 2015-2021 the original authors.
5+
#
6+
# Licensed under the Apache License, Version 2.0 (the "License");
7+
# you may not use this file except in compliance with the License.
8+
# You may obtain a copy of the License at
9+
#
10+
# https://www.apache.org/licenses/LICENSE-2.0
11+
#
12+
# Unless required by applicable law or agreed to in writing, software
13+
# distributed under the License is distributed on an "AS IS" BASIS,
14+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15+
# See the License for the specific language governing permissions and
16+
# limitations under the License.
17+
#
18+
19+
##############################################################################
20+
#
21+
# Gradle start up script for POSIX generated by Gradle.
22+
#
23+
# Important for running:
24+
#
25+
# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
26+
# noncompliant, but you have some other compliant shell such as ksh or
27+
# bash, then to run this script, type that shell name before the whole
28+
# command line, like:
29+
#
30+
# ksh Gradle
31+
#
32+
# Busybox and similar reduced shells will NOT work, because this script
33+
# requires all of these POSIX shell features:
34+
# * functions;
35+
# * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
36+
# «${var#prefix}», «${var%suffix}», and «$( cmd )»;
37+
# * compound commands having a testable exit status, especially «case»;
38+
# * various built-in commands including «command», «set», and «ulimit».
39+
#
40+
# Important for patching:
41+
#
42+
# (2) This script targets any POSIX shell, so it avoids extensions provided
43+
# by Bash, Ksh, etc; in particular arrays are avoided.
44+
#
45+
# The "traditional" practice of packing multiple parameters into a
46+
# space-separated string is a well documented source of bugs and security
47+
# problems, so this is (mostly) avoided, by progressively accumulating
48+
# options in "$@", and eventually passing that to Java.
49+
#
50+
# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
51+
# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
52+
# see the in-line comments for details.
53+
#
54+
# There are tweaks for specific operating systems such as AIX, CygWin,
55+
# Darwin, MinGW, and NonStop.
56+
#
57+
# (3) This script is generated from the Groovy template
58+
# https://github.com/gradle/gradle/blob/HEAD/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
59+
# within the Gradle project.
60+
#
61+
# You can find Gradle at https://github.com/gradle/gradle/.
62+
#
63+
##############################################################################
64+
65+
# Attempt to set APP_HOME
66+
67+
# Resolve links: $0 may be a link
68+
app_path=$0
69+
70+
# Need this for daisy-chained symlinks.
71+
while
72+
APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path
73+
[ -h "$app_path" ]
74+
do
75+
ls=$( ls -ld "$app_path" )
76+
link=${ls#*' -> '}
77+
case $link in #(
78+
/*) app_path=$link ;; #(
79+
*) app_path=$APP_HOME$link ;;
80+
esac
81+
done
82+
83+
# This is normally unused
84+
# shellcheck disable=SC2034
85+
APP_BASE_NAME=${0##*/}
86+
APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit
87+
88+
# Use the maximum available, or set MAX_FD != -1 to use that value.
89+
MAX_FD=maximum
90+
91+
warn () {
92+
echo "$*"
93+
} >&2
94+
95+
die () {
96+
echo
97+
echo "$*"
98+
echo
99+
exit 1
100+
} >&2
101+
102+
# OS specific support (must be 'true' or 'false').
103+
cygwin=false
104+
msys=false
105+
darwin=false
106+
nonstop=false
107+
case "$( uname )" in #(
108+
CYGWIN* ) cygwin=true ;; #(
109+
Darwin* ) darwin=true ;; #(
110+
MSYS* | MINGW* ) msys=true ;; #(
111+
NONSTOP* ) nonstop=true ;;
112+
esac
113+
114+
CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
115+
116+
117+
# Determine the Java command to use to start the JVM.
118+
if [ -n "$JAVA_HOME" ] ; then
119+
if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
120+
# IBM's JDK on AIX uses strange locations for the executables
121+
JAVACMD=$JAVA_HOME/jre/sh/java
122+
else
123+
JAVACMD=$JAVA_HOME/bin/java
124+
fi
125+
if [ ! -x "$JAVACMD" ] ; then
126+
die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
127+
128+
Please set the JAVA_HOME variable in your environment to match the
129+
location of your Java installation."
130+
fi
131+
else
132+
JAVACMD=java
133+
if ! command -v java >/dev/null 2>&1
134+
then
135+
die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
136+
137+
Please set the JAVA_HOME variable in your environment to match the
138+
location of your Java installation."
139+
fi
140+
fi
141+
142+
# Increase the maximum file descriptors if we can.
143+
if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
144+
case $MAX_FD in #(
145+
max*)
146+
# In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
147+
# shellcheck disable=SC3045
148+
MAX_FD=$( ulimit -H -n ) ||
149+
warn "Could not query maximum file descriptor limit"
150+
esac
151+
case $MAX_FD in #(
152+
'' | soft) :;; #(
153+
*)
154+
# In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
155+
# shellcheck disable=SC3045
156+
ulimit -n "$MAX_FD" ||
157+
warn "Could not set maximum file descriptor limit to $MAX_FD"
158+
esac
159+
fi
160+
161+
# Collect all arguments for the java command, stacking in reverse order:
162+
# * args from the command line
163+
# * the main class name
164+
# * -classpath
165+
# * -D...appname settings
166+
# * --module-path (only if needed)
167+
# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
168+
169+
# For Cygwin or MSYS, switch paths to Windows format before running java
170+
if "$cygwin" || "$msys" ; then
171+
APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
172+
CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
173+
174+
JAVACMD=$( cygpath --unix "$JAVACMD" )
175+
176+
# Now convert the arguments - kludge to limit ourselves to /bin/sh
177+
for arg do
178+
if
179+
case $arg in #(
180+
-*) false ;; # don't mess with options #(
181+
/?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath
182+
[ -e "$t" ] ;; #(
183+
*) false ;;
184+
esac
185+
then
186+
arg=$( cygpath --path --ignore --mixed "$arg" )
187+
fi
188+
# Roll the args list around exactly as many times as the number of
189+
# args, so each arg winds up back in the position where it started, but
190+
# possibly modified.
191+
#
192+
# NB: a `for` loop captures its iteration list before it begins, so
193+
# changing the positional parameters here affects neither the number of
194+
# iterations, nor the values presented in `arg`.
195+
shift # remove old arg
196+
set -- "$@" "$arg" # push replacement arg
197+
done
198+
fi
199+
200+
201+
# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
202+
DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
203+
204+
# Collect all arguments for the java command;
205+
# * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of
206+
# shell script including quotes and variable substitutions, so put them in
207+
# double quotes to make sure that they get re-expanded; and
208+
# * put everything else in single quotes, so that it's not re-expanded.
209+
210+
set -- \
211+
"-Dorg.gradle.appname=$APP_BASE_NAME" \
212+
-classpath "$CLASSPATH" \
213+
org.gradle.wrapper.GradleWrapperMain \
214+
"$@"
215+
216+
# Stop when "xargs" is not available.
217+
if ! command -v xargs >/dev/null 2>&1
218+
then
219+
die "xargs is not available"
220+
fi
221+
222+
# Use "xargs" to parse quoted args.
223+
#
224+
# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
225+
#
226+
# In Bash we could simply go:
227+
#
228+
# readarray ARGS < <( xargs -n1 <<<"$var" ) &&
229+
# set -- "${ARGS[@]}" "$@"
230+
#
231+
# but POSIX shell has neither arrays nor command substitution, so instead we
232+
# post-process each arg (as a line of input to sed) to backslash-escape any
233+
# character that might be a shell metacharacter, then use eval to reverse
234+
# that process (while maintaining the separation between arguments), and wrap
235+
# the whole thing up as a single "set" statement.
236+
#
237+
# This will of course break if any of these variables contains a newline or
238+
# an unmatched quote.
239+
#
240+
241+
eval "set -- $(
242+
printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
243+
xargs -n1 |
244+
sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
245+
tr '\n' ' '
246+
)" '"$@"'
247+
248+
exec "$JAVACMD" "$@"

‎examples/powertools-examples-core-utilities/gradle/gradlew.bat

Lines changed: 92 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,92 @@
1+
@rem
2+
@rem Copyright 2015 the original author or authors.
3+
@rem
4+
@rem Licensed under the Apache License, Version 2.0 (the "License");
5+
@rem you may not use this file except in compliance with the License.
6+
@rem You may obtain a copy of the License at
7+
@rem
8+
@rem https://www.apache.org/licenses/LICENSE-2.0
9+
@rem
10+
@rem Unless required by applicable law or agreed to in writing, software
11+
@rem distributed under the License is distributed on an "AS IS" BASIS,
12+
@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13+
@rem See the License for the specific language governing permissions and
14+
@rem limitations under the License.
15+
@rem
16+
17+
@if "%DEBUG%"=="" @echo off
18+
@rem ##########################################################################
19+
@rem
20+
@rem Gradle startup script for Windows
21+
@rem
22+
@rem ##########################################################################
23+
24+
@rem Set local scope for the variables with windows NT shell
25+
if "%OS%"=="Windows_NT" setlocal
26+
27+
set DIRNAME=%~dp0
28+
if "%DIRNAME%"=="" set DIRNAME=.
29+
@rem This is normally unused
30+
set APP_BASE_NAME=%~n0
31+
set APP_HOME=%DIRNAME%
32+
33+
@rem Resolve any "." and ".." in APP_HOME to make it shorter.
34+
for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
35+
36+
@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
37+
set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
38+
39+
@rem Find java.exe
40+
if defined JAVA_HOME goto findJavaFromJavaHome
41+
42+
set JAVA_EXE=java.exe
43+
%JAVA_EXE% -version >NUL 2>&1
44+
if %ERRORLEVEL% equ 0 goto execute
45+
46+
echo.
47+
echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
48+
echo.
49+
echo Please set the JAVA_HOME variable in your environment to match the
50+
echo location of your Java installation.
51+
52+
goto fail
53+
54+
:findJavaFromJavaHome
55+
set JAVA_HOME=%JAVA_HOME:"=%
56+
set JAVA_EXE=%JAVA_HOME%/bin/java.exe
57+
58+
if exist "%JAVA_EXE%" goto execute
59+
60+
echo.
61+
echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
62+
echo.
63+
echo Please set the JAVA_HOME variable in your environment to match the
64+
echo location of your Java installation.
65+
66+
goto fail
67+
68+
:execute
69+
@rem Setup the command line
70+
71+
set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
72+
73+
74+
@rem Execute Gradle
75+
"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
76+
77+
:end
78+
@rem End local scope for the variables with windows NT shell
79+
if %ERRORLEVEL% equ 0 goto mainEnd
80+
81+
:fail
82+
rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
83+
rem the _cmd.exe /c_ return code!
84+
set EXIT_CODE=%ERRORLEVEL%
85+
if %EXIT_CODE% equ 0 set EXIT_CODE=1
86+
if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
87+
exit /b %EXIT_CODE%
88+
89+
:mainEnd
90+
if "%OS%"=="Windows_NT" endlocal
91+
92+
:omega

‎examples/powertools-examples-core-utilities/gradle/src/main/java/helloworld/App.java

Lines changed: 107 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,107 @@
1+
/*
2+
* Copyright 2023 Amazon.com, Inc. or its affiliates.
3+
* Licensed under the Apache License, Version 2.0 (the
4+
* "License"); you may not use this file except in compliance
5+
* with the License. You may obtain a copy of the License at
6+
* http://www.apache.org/licenses/LICENSE-2.0
7+
* Unless required by applicable law or agreed to in writing, software
8+
* distributed under the License is distributed on an "AS IS" BASIS,
9+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
10+
* See the License for the specific language governing permissions and
11+
* limitations under the License.
12+
*
13+
*/
14+
15+
package helloworld;
16+
17+
import static software.amazon.lambda.powertools.metrics.MetricsUtils.metricsLogger;
18+
import static software.amazon.lambda.powertools.metrics.MetricsUtils.withSingleMetric;
19+
import static software.amazon.lambda.powertools.tracing.TracingUtils.putMetadata;
20+
21+
import com.amazonaws.services.lambda.runtime.Context;
22+
import com.amazonaws.services.lambda.runtime.RequestHandler;
23+
import com.amazonaws.services.lambda.runtime.events.APIGatewayProxyRequestEvent;
24+
import com.amazonaws.services.lambda.runtime.events.APIGatewayProxyResponseEvent;
25+
import java.io.BufferedReader;
26+
import java.io.IOException;
27+
import java.io.InputStreamReader;
28+
import java.net.URL;
29+
import java.util.HashMap;
30+
import java.util.Map;
31+
import java.util.stream.Collectors;
32+
import org.apache.logging.log4j.LogManager;
33+
import org.apache.logging.log4j.Logger;
34+
import software.amazon.cloudwatchlogs.emf.model.DimensionSet;
35+
import software.amazon.cloudwatchlogs.emf.model.Unit;
36+
import software.amazon.lambda.powertools.logging.Logging;
37+
import software.amazon.lambda.powertools.logging.LoggingUtils;
38+
import software.amazon.lambda.powertools.metrics.Metrics;
39+
import software.amazon.lambda.powertools.tracing.CaptureMode;
40+
import software.amazon.lambda.powertools.tracing.Tracing;
41+
import software.amazon.lambda.powertools.tracing.TracingUtils;
42+
43+
/**
44+
* Handler for requests to Lambda function.
45+
*/
46+
public class App implements RequestHandler<APIGatewayProxyRequestEvent, APIGatewayProxyResponseEvent> {
47+
private final static Logger log = LogManager.getLogger(App.class);
48+
49+
@Logging(logEvent = true, samplingRate = 0.7)
50+
@Tracing(captureMode = CaptureMode.RESPONSE_AND_ERROR)
51+
@Metrics(namespace = "ServerlessAirline", service = "payment", captureColdStart = true)
52+
public APIGatewayProxyResponseEvent handleRequest(final APIGatewayProxyRequestEvent input, final Context context) {
53+
Map<String, String> headers = new HashMap<>();
54+
55+
headers.put("Content-Type", "application/json");
56+
headers.put("X-Custom-Header", "application/json");
57+
58+
metricsLogger().putMetric("CustomMetric1", 1, Unit.COUNT);
59+
60+
withSingleMetric("CustomMetrics2", 1, Unit.COUNT, "Another", (metric) ->
61+
{
62+
metric.setDimensions(DimensionSet.of("AnotherService", "CustomService"));
63+
metric.setDimensions(DimensionSet.of("AnotherService1", "CustomService1"));
64+
});
65+
66+
LoggingUtils.appendKey("test", "willBeLogged");
67+
68+
APIGatewayProxyResponseEvent response = new APIGatewayProxyResponseEvent()
69+
.withHeaders(headers);
70+
try {
71+
final String pageContents = this.getPageContents("https://checkip.amazonaws.com");
72+
log.info(pageContents);
73+
TracingUtils.putAnnotation("Test", "New");
74+
String output = String.format("{ \"message\": \"hello world\", \"location\": \"%s\" }", pageContents);
75+
76+
TracingUtils.withSubsegment("loggingResponse", subsegment ->
77+
{
78+
String sampled = "log something out";
79+
log.info(sampled);
80+
log.info(output);
81+
});
82+
83+
log.info("After output");
84+
return response
85+
.withStatusCode(200)
86+
.withBody(output);
87+
} catch (RuntimeException | IOException e) {
88+
return response
89+
.withBody("{}")
90+
.withStatusCode(500);
91+
}
92+
}
93+
94+
@Tracing
95+
private void log() {
96+
log.info("inside threaded logging for function");
97+
}
98+
99+
@Tracing(namespace = "getPageContents", captureMode = CaptureMode.DISABLED)
100+
private String getPageContents(String address) throws IOException {
101+
URL url = new URL(address);
102+
putMetadata("getPageContents", address);
103+
try (BufferedReader br = new BufferedReader(new InputStreamReader(url.openStream()))) {
104+
return br.lines().collect(Collectors.joining(System.lineSeparator()));
105+
}
106+
}
107+
}

‎examples/powertools-examples-core-utilities/gradle/src/main/java/helloworld/AppStream.java

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
/*
2+
* Copyright 2023 Amazon.com, Inc. or its affiliates.
3+
* Licensed under the Apache License, Version 2.0 (the
4+
* "License"); you may not use this file except in compliance
5+
* with the License. You may obtain a copy of the License at
6+
* http://www.apache.org/licenses/LICENSE-2.0
7+
* Unless required by applicable law or agreed to in writing, software
8+
* distributed under the License is distributed on an "AS IS" BASIS,
9+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
10+
* See the License for the specific language governing permissions and
11+
* limitations under the License.
12+
*
13+
*/
14+
15+
package helloworld;
16+
17+
import com.amazonaws.services.lambda.runtime.Context;
18+
import com.amazonaws.services.lambda.runtime.RequestStreamHandler;
19+
import com.fasterxml.jackson.databind.ObjectMapper;
20+
import java.io.IOException;
21+
import java.io.InputStream;
22+
import java.io.OutputStream;
23+
import java.util.Map;
24+
import software.amazon.lambda.powertools.logging.Logging;
25+
import software.amazon.lambda.powertools.metrics.Metrics;
26+
27+
public class AppStream implements RequestStreamHandler {
28+
private static final ObjectMapper mapper = new ObjectMapper();
29+
30+
@Override
31+
@Logging(logEvent = true)
32+
@Metrics(namespace = "ServerlessAirline", service = "payment", captureColdStart = true)
33+
public void handleRequest(InputStream input, OutputStream output, Context context) throws IOException {
34+
Map map = mapper.readValue(input, Map.class);
35+
36+
System.out.println(map.size());
37+
}
38+
}

‎examples/powertools-examples-core-utilities/gradle/src/test/java/helloworld/AppTest.java

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
package helloworld;
2+
3+
import com.amazonaws.services.lambda.runtime.events.APIGatewayProxyResponseEvent;
4+
5+
import static org.junit.Assert.assertEquals;
6+
import static org.junit.Assert.assertNotNull;
7+
import static org.junit.Assert.assertTrue;
8+
9+
import org.junit.Test;
10+
11+
public class AppTest {
12+
@Test
13+
public void successfulResponse() {
14+
App app = new App();
15+
APIGatewayProxyResponseEvent result = app.handleRequest(null, null);
16+
assertEquals(200, result.getStatusCode().intValue());
17+
assertEquals("application/json", result.getHeaders().get("Content-Type"));
18+
String content = result.getBody();
19+
assertNotNull(content);
20+
assertTrue(content.contains("\"message\""));
21+
assertTrue(content.contains("\"hello world\""));
22+
assertTrue(content.contains("\"location\""));
23+
}
24+
}

‎examples/powertools-examples-core-utilities/gradle/template.yaml

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
AWSTemplateFormatVersion: '2010-09-09'
2+
Transform: AWS::Serverless-2016-10-31
3+
Description: >
4+
gradle
5+
6+
Sample SAM Template for gradle
7+
8+
# More info about Globals: https://github.com/awslabs/serverless-application-model/blob/master/docs/globals.rst
9+
Globals:
10+
Function:
11+
Timeout: 20
12+
Runtime: java11
13+
MemorySize: 512
14+
Tracing: Active # https://docs.aws.amazon.com/lambda/latest/dg/lambda-x-ray.html
15+
Environment:
16+
Variables:
17+
# Powertools for AWS Lambda (Java) env vars: https://docs.powertools.aws.dev/lambda/java/#environment-variables
18+
POWERTOOLS_LOG_LEVEL: INFO
19+
POWERTOOLS_LOGGER_SAMPLE_RATE: 0.1
20+
POWERTOOLS_LOGGER_LOG_EVENT: true
21+
POWERTOOLS_METRICS_NAMESPACE: Coreutilities
22+
23+
Resources:
24+
HelloWorldFunction:
25+
Type: AWS::Serverless::Function # More info about Function Resource: https://github.com/awslabs/serverless-application-model/blob/master/versions/2016-10-31.md#awsserverlessfunction
26+
Properties:
27+
CodeUri: .
28+
Handler: helloworld.App::handleRequest
29+
Runtime: java8
30+
MemorySize: 512
31+
Environment: # More info about Env Vars: https://github.com/awslabs/serverless-application-model/blob/master/versions/2016-10-31.md#environment-object
32+
Variables:
33+
POWERTOOLS_SERVICE_NAME: hello
34+
Events:
35+
HelloWorld:
36+
Type: Api # More info about API Event Source: https://github.com/awslabs/serverless-application-model/blob/master/versions/2016-10-31.md#api
37+
Properties:
38+
Path: /hello
39+
Method: get
40+
41+
HelloWorldStreamFunction:
42+
Type: AWS::Serverless::Function
43+
Properties:
44+
CodeUri: .
45+
Handler: helloworld.AppStream::handleRequest
46+
Runtime: java8
47+
MemorySize: 512
48+
Tracing: Active
49+
Environment:
50+
Variables:
51+
POWERTOOLS_LOGGER_SAMPLE_RATE: 0.7
52+
Events:
53+
HelloWorld:
54+
Type: Api
55+
Properties:
56+
Path: /hellostream
57+
Method: get
58+
59+
Outputs:
60+
# ServerlessRestApi is an implicit API created out of Events key under Serverless::Function
61+
# Find out more about other implicit resources you can reference within SAM
62+
# https://github.com/awslabs/serverless-application-model/blob/master/docs/internals/generated_resources.rst#api
63+
HelloWorldApi:
64+
Description: "API Gateway endpoint URL for Prod stage for Hello World function"
65+
Value: !Sub "https://${ServerlessRestApi}.execute-api.${AWS::Region}.amazonaws.com/Prod/hello/"
66+
HelloWorldFunction:
67+
Description: "Hello World Lambda Function ARN"
68+
Value: !GetAtt HelloWorldFunction.Arn
69+
HelloWorldFunctionIamRole:
70+
Description: "Implicit IAM Role created for Hello World function"
71+
Value: !GetAtt HelloWorldFunctionRole.Arn

0 commit comments

Comments
 (0)
Please sign in to comment.