{"id":25777304,"url":"https://github.com/aws-powertools/powertools-lambda-java","last_synced_at":"2025-02-27T06:07:31.420Z","repository":{"id":37093409,"uuid":"279408800","full_name":"aws-powertools/powertools-lambda-java","owner":"aws-powertools","description":"Powertools is a developer toolkit to implement Serverless best practices and increase developer velocity.","archived":false,"fork":false,"pushed_at":"2024-04-12T14:56:50.000Z","size":21222,"stargazers_count":273,"open_issues_count":60,"forks_count":78,"subscribers_count":14,"default_branch":"main","last_synced_at":"2024-04-12T22:25:07.968Z","etag":null,"topics":["aws","java","lambda"],"latest_commit_sha":null,"homepage":"https://docs.powertools.aws.dev/lambda/java/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit-0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aws-powertools.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2020-07-13T20:49:09.000Z","updated_at":"2024-04-15T12:36:35.758Z","dependencies_parsed_at":"2023-10-16T18:22:51.002Z","dependency_job_id":"a8bcfea8-8255-4a82-b843-8bbc33d86d01","html_url":"https://github.com/aws-powertools/powertools-lambda-java","commit_stats":null,"previous_names":["aws-powertools/powertools-lambda-java","awslabs/aws-lambda-powertools-java"],"tags_count":41,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-powertools%2Fpowertools-lambda-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-powertools%2Fpowertools-lambda-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-powertools%2Fpowertools-lambda-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-powertools%2Fpowertools-lambda-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aws-powertools","download_url":"https://codeload.github.com/aws-powertools/powertools-lambda-java/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240987436,"owners_count":19889335,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","java","lambda"],"created_at":"2025-02-27T06:01:40.528Z","updated_at":"2025-02-27T06:07:31.413Z","avatar_url":"https://github.com/aws-powertools.png","language":"Java","readme":"# Powertools for AWS Lambda (Java)\n\n![aws provider](https://img.shields.io/badge/provider-AWS-orange?logo=amazon-aws\u0026color=ff9900) ![Build status](https://github.com/aws-powertools/powertools-lambda-java/actions/workflows/build.yml/badge.svg) ![Maven Central](https://img.shields.io/maven-central/v/software.amazon.lambda/powertools-parent) [![codecov.io](https://codecov.io/github/aws-powertools/powertools-lambda-java/branch/main/graphs/badge.svg)](https://app.codecov.io/gh/aws-powertools/powertools-lambda-java)\n\n\nPowertools for AWS Lambda (Java) is a developer toolkit to implement Serverless best practices and increase developer velocity.\n\n\u003e Also available in [Python](https://github.com/aws-powertools/powertools-lambda-python), [TypeScript](https://github.com/aws-powertools/powertools-lambda-typescript), and [.NET](https://github.com/aws-powertools/powertools-lambda-dotnet).\n\n**[📜Documentation](https://docs.powertools.aws.dev/lambda-java/)** | **[Feature request](https://github.com/aws-powertools/powertools-lambda-java/issues/new?assignees=\u0026labels=feature-request%2C+triage\u0026template=feature_request.md\u0026title=)** | **[🐛Bug Report](https://github.com/aws-powertools/powertools-lambda-java/issues/new?assignees=\u0026labels=bug%2C+triage\u0026template=bug_report.md\u0026title=)** | **[Detailed blog post](https://aws.amazon.com/blogs/opensource/simplifying-serverless-best-practices-with-aws-lambda-powertools-java/)**\n\n## Installation\n\nPowertools for AWS Lambda (Java) is available in Maven Central. You can use your favourite dependency management tool to install it\n\n### Maven:\n```xml\n\u003cdependencies\u003e\n    ...\n    \u003cdependency\u003e\n        \u003cgroupId\u003esoftware.amazon.lambda\u003c/groupId\u003e\n        \u003cartifactId\u003epowertools-tracing\u003c/artifactId\u003e\n        \u003cversion\u003e1.19.0-SNAPSHOT\u003c/version\u003e\n    \u003c/dependency\u003e\n    \u003cdependency\u003e\n        \u003cgroupId\u003esoftware.amazon.lambda\u003c/groupId\u003e\n        \u003cartifactId\u003epowertools-logging\u003c/artifactId\u003e\n        \u003cversion\u003e1.19.0-SNAPSHOT\u003c/version\u003e\n    \u003c/dependency\u003e\n    \u003cdependency\u003e\n        \u003cgroupId\u003esoftware.amazon.lambda\u003c/groupId\u003e\n        \u003cartifactId\u003epowertools-metrics\u003c/artifactId\u003e\n        \u003cversion\u003e1.19.0-SNAPSHOT\u003c/version\u003e\n    \u003c/dependency\u003e\n    ...\n\u003c/dependencies\u003e\n```\n\nNext, configure the aspectj-maven-plugin to compile-time weave (CTW) the aws-lambda-powertools-java aspects into your project. A different configuration is needed for projects on Java 8. \n\n\u003cdetails\u003e\n    \u003csummary\u003e\u003cb\u003eMaven - Java 11 and newer\u003c/b\u003e\u003c/summary\u003e\n    \n```xml\n\u003cbuild\u003e\n    \u003cplugins\u003e\n        ...\n        \u003cplugin\u003e\n             \u003cgroupId\u003edev.aspectj\u003c/groupId\u003e\n             \u003cartifactId\u003easpectj-maven-plugin\u003c/artifactId\u003e\n             \u003cversion\u003e1.13.1\u003c/version\u003e\n             \u003cconfiguration\u003e\n                 \u003csource\u003e1.8\u003c/source\u003e\n                 \u003ctarget\u003e1.8\u003c/target\u003e\n                 \u003ccomplianceLevel\u003e1.8\u003c/complianceLevel\u003e\n                 \u003caspectLibraries\u003e\n                     \u003caspectLibrary\u003e\n                         \u003cgroupId\u003esoftware.amazon.lambda\u003c/groupId\u003e\n                         \u003cartifactId\u003epowertools-logging\u003c/artifactId\u003e\n                     \u003c/aspectLibrary\u003e\n                     \u003caspectLibrary\u003e\n                         \u003cgroupId\u003esoftware.amazon.lambda\u003c/groupId\u003e\n                         \u003cartifactId\u003epowertools-tracing\u003c/artifactId\u003e\n                     \u003c/aspectLibrary\u003e\n                     \u003caspectLibrary\u003e\n                         \u003cgroupId\u003esoftware.amazon.lambda\u003c/groupId\u003e\n                         \u003cartifactId\u003epowertools-metrics\u003c/artifactId\u003e\n                     \u003c/aspectLibrary\u003e\n                 \u003c/aspectLibraries\u003e\n             \u003c/configuration\u003e\n             \u003cexecutions\u003e\n                 \u003cexecution\u003e\n                     \u003cgoals\u003e\n                         \u003cgoal\u003ecompile\u003c/goal\u003e\n                     \u003c/goals\u003e\n                 \u003c/execution\u003e\n             \u003c/executions\u003e\n        \u003c/plugin\u003e\n        ...\n    \u003c/plugins\u003e\n\u003c/build\u003e\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eMaven - Java 8\u003c/b\u003e\u003c/summary\u003e    \n    \n```xml\n\u003cbuild\u003e\n    \u003cplugins\u003e\n        ...\n        \u003cplugin\u003e\n             \u003cgroupId\u003eorg.codehaus.mojo\u003c/groupId\u003e\n             \u003cartifactId\u003easpectj-maven-plugin\u003c/artifactId\u003e\n             \u003cversion\u003e1.14.0\u003c/version\u003e\n             \u003cconfiguration\u003e\n                 \u003csource\u003e1.8\u003c/source\u003e\n                 \u003ctarget\u003e1.8\u003c/target\u003e\n                 \u003ccomplianceLevel\u003e1.8\u003c/complianceLevel\u003e\n                 \u003caspectLibraries\u003e\n                     \u003caspectLibrary\u003e\n                         \u003cgroupId\u003esoftware.amazon.lambda\u003c/groupId\u003e\n                         \u003cartifactId\u003epowertools-logging\u003c/artifactId\u003e\n                     \u003c/aspectLibrary\u003e\n                     \u003caspectLibrary\u003e\n                         \u003cgroupId\u003esoftware.amazon.lambda\u003c/groupId\u003e\n                         \u003cartifactId\u003epowertools-tracing\u003c/artifactId\u003e\n                     \u003c/aspectLibrary\u003e\n                     \u003caspectLibrary\u003e\n                         \u003cgroupId\u003esoftware.amazon.lambda\u003c/groupId\u003e\n                         \u003cartifactId\u003epowertools-metrics\u003c/artifactId\u003e\n                     \u003c/aspectLibrary\u003e\n                 \u003c/aspectLibraries\u003e\n             \u003c/configuration\u003e\n             \u003cexecutions\u003e\n                 \u003cexecution\u003e\n                     \u003cgoals\u003e\n                         \u003cgoal\u003ecompile\u003c/goal\u003e\n                     \u003c/goals\u003e\n                 \u003c/execution\u003e\n             \u003c/executions\u003e\n        \u003c/plugin\u003e\n        ...\n    \u003c/plugins\u003e\n\u003c/build\u003e\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eGradle - Java 11+\u003c/b\u003e\u003c/summary\u003e\n\n```groovy\n\n        plugins {\n            id 'java'\n            id 'io.freefair.aspectj.post-compile-weaving' version '8.2.2'\n        }\n        \n        // the freefair aspect plugins targets gradle 8.2.1\n        // https://docs.freefair.io/gradle-plugins/8.2.2/reference/\n        wrapper {\n            gradleVersion = \"8.2.1\"\n        }   \n\n        repositories {\n            mavenCentral()\n        }\n        \n        dependencies {\n            aspect 'software.amazon.lambda:powertools-logging:{{ powertools.version }}'\n            aspect 'software.amazon.lambda:powertools-tracing:{{ powertools.version }}'\n            aspect 'software.amazon.lambda:powertools-metrics:{{ powertools.version }}'\n            implementation \"org.aspectj:aspectjrt:1.9.8.RC3\"\n        }\n        \n        sourceCompatibility = 11\n        targetCompatibility = 11\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eGradle - Java 8\u003c/b\u003e\u003c/summary\u003e    \n\n```groovy\n        plugins {\n            id 'java'\n            id 'io.freefair.aspectj.post-compile-weaving' version '6.6.3'\n        }\n        \n        // the freefair aspect plugins targets gradle 7.6.1\n        // https://docs.freefair.io/gradle-plugins/6.6.3/reference/\n        wrapper {\n            gradleVersion = \"7.6.1\"\n        }\n\n        repositories {\n            mavenCentral()\n        }\n        \n        dependencies {\n            aspect 'software.amazon.lambda:powertools-logging:{{ powertools.version }}'\n            aspect 'software.amazon.lambda:powertools-tracing:{{ powertools.version }}'\n            aspect 'software.amazon.lambda:powertools-metrics:{{ powertools.version }}'\n        }\n        \n        sourceCompatibility = 1.8\n        targetCompatibility = 1.8\n```\n\u003c/details\u003e\n\n### Java Compatibility\nPowertools for AWS Lambda (Java) supports all Java version from 8 up to 21 as well as the\n[corresponding Lambda runtimes](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html).\nFor the modules that provide annotations, Powertools for AWS Lambda (Java) leverages the **aspectj** library.\nYou may need to add the good version of `aspectjrt` to your dependencies based on the JDK used for building your function:\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003eorg.aspectj\u003c/groupId\u003e\n    \u003cartifactId\u003easpectjrt\u003c/artifactId\u003e\n    \u003cversion\u003e1.9.??\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n\u003cdetails\u003e\n    \u003csummary\u003e\u003cb\u003eJDK - aspectj dependency matrix\u003c/b\u003e\u003c/summary\u003e\n\n| JDK version | aspectj version |\n|-------------|-----------------|\n| `1.8`       | `1.9.7`         |\n| `11-17`     | `1.9.20.1`      |\n| `21`        | `1.9.21`        |\n\nMore info [here](https://github.com/aws-powertools/powertools-lambda-java/pull/1519/files#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5R191).\n\n\u003c/details\u003e\n\n## Examples\n\nSee the latest release of the **[examples](https://github.com/aws-powertools/powertools-lambda-java/tree/v1.19.0-SNAPSHOT/examples)** for example projects showcasing usage of different utilities.\n\nHave a demo project to contribute which showcase usage of different utilities from powertools? We are happy to accept it [here](CONTRIBUTING.md#security-issue-notifications).\n\n## How to support Powertools for AWS Lambda (Java)?\n\n### Becoming a reference customer\n\nKnowing which companies are using this library is important to help prioritize the project internally. If your company is using Powertools for AWS Lambda (Java), you can request to have your name and logo added to the README file by raising a [Support Powertools for AWS Lambda (Java) (become a reference)](https://github.com/aws-powertools/powertools-lambda-java/issues/new?assignees=\u0026labels=customer-reference\u0026template=support_powertools.yml\u0026title=%5BSupport+Lambda+Powertools%5D%3A+%3Cyour+organization+name%3E) issue.\n\nThe following companies, among others, use Powertools:\n\n* [Capital One](https://www.capitalone.com/)\n* [Caylent](https://caylent.com/)\n* [CPQi (Exadel Financial Services)](https://cpqi.com/)\n* [Europace AG](https://europace.de/)\n* [Vertex Pharmaceuticals](https://www.vrtx.com/)\n\n## Credits\n\n* [MkDocs](https://www.mkdocs.org/)\n* [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/)\n\n## Connect\n\n* **Powertools for AWS Lambda on Discord**: `#java` - **[Invite link](https://discord.gg/B8zZKbbyET)**\n* **Email**: \u003caws-lambda-powertools-feedback@amazon.com\u003e\n\n## Security disclosures\n\nIf you think you’ve found a potential security issue, please do not post it in the Issues.  Instead, please follow the instructions [here](https://aws.amazon.com/security/vulnerability-reporting/) or [email AWS security directly](mailto:aws-security@amazon.com).\n\n## License\n\nThis library is licensed under the Apache License, Version 2.0. See the LICENSE file.\n","funding_links":[],"categories":["Serverless"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws-powertools%2Fpowertools-lambda-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faws-powertools%2Fpowertools-lambda-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws-powertools%2Fpowertools-lambda-java/lists"}