{"id":24589878,"url":"https://github.com/autonomouslogic/dynamo-mapper","last_synced_at":"2026-01-11T17:46:34.273Z","repository":{"id":37103232,"uuid":"489435092","full_name":"autonomouslogic/dynamo-mapper","owner":"autonomouslogic","description":"Map objects in AWS DynamoDB using Jackson.","archived":false,"fork":false,"pushed_at":"2025-10-04T07:17:27.000Z","size":579,"stargazers_count":3,"open_issues_count":10,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-04T09:15:02.535Z","etag":null,"topics":["aws","aws-dynamodb","jackson-databind","orm"],"latest_commit_sha":null,"homepage":"","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/autonomouslogic.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-05-06T17:11:09.000Z","updated_at":"2025-10-04T07:17:29.000Z","dependencies_parsed_at":"2024-01-02T13:57:58.098Z","dependency_job_id":"1dd3ab4e-9268-4ca3-a8e9-11b8b48bd8d0","html_url":"https://github.com/autonomouslogic/dynamo-mapper","commit_stats":null,"previous_names":[],"tags_count":53,"template":false,"template_full_name":null,"purl":"pkg:github/autonomouslogic/dynamo-mapper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autonomouslogic%2Fdynamo-mapper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autonomouslogic%2Fdynamo-mapper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autonomouslogic%2Fdynamo-mapper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autonomouslogic%2Fdynamo-mapper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/autonomouslogic","download_url":"https://codeload.github.com/autonomouslogic/dynamo-mapper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autonomouslogic%2Fdynamo-mapper/sbom","scorecard":{"id":217361,"data":{"date":"2025-08-11","repo":{"name":"github.com/autonomouslogic/dynamo-mapper","commit":"9acc396bda92d912c3a0bce3abc3725c5da525ce"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.8,"checks":[{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":4,"reason":"5 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 4","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Code-Review","score":1,"reason":"Found 5/30 approved changesets -- score normalized to 1","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Binary-Artifacts","score":9,"reason":"binaries present in source code","details":["Warn: binary detected: gradle/wrapper/gradle-wrapper.jar:1"],"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/build.yml:1","Warn: no topLevel permission defined: .github/workflows/codegen.yml:1","Warn: no topLevel permission defined: .github/workflows/semantic-pr.yml:1","Warn: no topLevel permission defined: .github/workflows/spotless.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:9: update your workflow using https://app.stepsecurity.io/secureworkflow/autonomouslogic/dynamo-mapper/build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/autonomouslogic/dynamo-mapper/build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/autonomouslogic/dynamo-mapper/build.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/autonomouslogic/dynamo-mapper/build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codegen.yml:9: update your workflow using https://app.stepsecurity.io/secureworkflow/autonomouslogic/dynamo-mapper/codegen.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codegen.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/autonomouslogic/dynamo-mapper/codegen.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codegen.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/autonomouslogic/dynamo-mapper/codegen.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/semantic-pr.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/autonomouslogic/dynamo-mapper/semantic-pr.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/spotless.yml:9: update your workflow using https://app.stepsecurity.io/secureworkflow/autonomouslogic/dynamo-mapper/spotless.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/spotless.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/autonomouslogic/dynamo-mapper/spotless.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/spotless.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/autonomouslogic/dynamo-mapper/spotless.yml/main?enable=pin","Warn: npmCommand not pinned by hash: release.sh:3","Info:   0 out of   9 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   2 third-party GitHubAction dependencies pinned","Info:   0 out of   1 npmCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT No Attribution: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact 2.1.18 not signed: https://api.github.com/repos/autonomouslogic/dynamo-mapper/releases/223203995","Warn: release artifact 2.1.17 not signed: https://api.github.com/repos/autonomouslogic/dynamo-mapper/releases/183814849","Warn: release artifact 2.1.16 not signed: https://api.github.com/repos/autonomouslogic/dynamo-mapper/releases/183464805","Warn: release artifact 2.1.15 not signed: https://api.github.com/repos/autonomouslogic/dynamo-mapper/releases/178990276","Warn: release artifact 2.1.14 not signed: https://api.github.com/repos/autonomouslogic/dynamo-mapper/releases/163678521","Warn: release artifact 2.1.18 does not have provenance: https://api.github.com/repos/autonomouslogic/dynamo-mapper/releases/223203995","Warn: release artifact 2.1.17 does not have provenance: https://api.github.com/repos/autonomouslogic/dynamo-mapper/releases/183814849","Warn: release artifact 2.1.16 does not have provenance: https://api.github.com/repos/autonomouslogic/dynamo-mapper/releases/183464805","Warn: release artifact 2.1.15 does not have provenance: https://api.github.com/repos/autonomouslogic/dynamo-mapper/releases/178990276","Warn: release artifact 2.1.14 does not have provenance: https://api.github.com/repos/autonomouslogic/dynamo-mapper/releases/163678521"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"SAST","score":6,"reason":"SAST tool is not run on all commits -- score normalized to 6","details":["Warn: 13 commits out of 20 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-17T01:54:12.607Z","repository_id":37103232,"created_at":"2025-08-17T01:54:12.607Z","updated_at":"2025-08-17T01:54:12.607Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278295793,"owners_count":25963424,"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","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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","aws-dynamodb","jackson-databind","orm"],"created_at":"2025-01-24T09:01:05.004Z","updated_at":"2025-10-05T15:31:49.072Z","avatar_url":"https://github.com/autonomouslogic.png","language":"Java","funding_links":[],"categories":["Tools"],"sub_categories":[],"readme":"# Dynamo Mapper\n\n[![GitHub release (latest by date)](https://img.shields.io/github/v/release/autonomouslogic/dynamo-mapper)](https://github.com/autonomouslogic/dynamo-mapper/releases)\n[![javadoc](https://javadoc.io/badge2/com.autonomouslogic.dynamomapper/dynamo-mapper/javadoc.svg)](https://javadoc.io/doc/com.autonomouslogic.dynamomapper/dynamo-mapper)\n[![GitHub Workflow Status (branch)](https://img.shields.io/github/workflow/status/autonomouslogic/dynamo-mapper/Test/main)](https://github.com/autonomouslogic/dynamo-mapper/actions)\n[![GitHub](https://img.shields.io/github/license/autonomouslogic/dynamo-mapper)](https://spdx.org/licenses/MIT-0.html)\n\nA simple mapper for converting to and from DynamoDB [AttributeValues](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_AttributeValue.html)\nand POJOs using [Jackson](https://github.com/FasterXML/jackson).\n\n## In development\nDynamo Mapper is still in development.\nCurrently, only single gets, puts, updates, and deletes are supported.\nMore is planned in the future and submissions are welcome.\n\n## Installation\nDynamo Mapper is available from [Maven Central](https://search.maven.org/search?q=g:com.autonomouslogic.dynamomapper%20AND%20a:dynamo-mapper).\n\n### Gradle\n\n```groovy\nimplementation 'com.autonomouslogic.dynamomapper:dynamo-mapper:version'\n```\n\n### Maven\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.autonomouslogic.dynamomapper\u003c/groupId\u003e\n    \u003cartifactId\u003edynamo-mapper\u003c/artifactId\u003e\n    \u003cversion\u003eversion\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n## Usage\nDynamo Mapper functions as a wrapper around the existing AWS DynamoDB v2 SDK.\nFirst, you need to construct a DynamoDB client object and a Jackson ObjectMapper, and then pass those to the\nDynamo Mapper builder.\nIf you do not provide a DynamoDB client or Jackson ObjectMapper, defaults will be used.\n\n```java\nvar dynamoMapper = DynamoMapper.builder()\n    .client(DynamoDbClient.create())\n    .objectMapper(new ObjectMapper())\n    .tableNameDecorator(decorator) // optional\n    .build();\n```\n\nOr, for the asynchronous API:\n```java\nvar asyncDynamoMapper = DynamoAsyncMapper.builder()\n    .client(DynamoDbAsyncClient.create())\n    .objectMapper(new ObjectMapper())\n\t.tableNameDecorator(decorator) // optional\n    .build();\n```\n\n### Defining schemas\nDynamo Mapper relies on Jackson for its serialization.\nGenerally, anything that works in Jackson will work in Dynamo Mapper.\nOnly a few extra annotations are required.\n\n```java\n@DynamoTableName(\"table-name\")\npublic class ModelObject {\n\t@JsonProperty\n\t@DynamoPrimaryKey\n\tprivate String primaryKey;\n\t\n\t@JsonProperty\n\tprivate String otherValue;\n\t\n\t/* etc. */\n}\n```\n\n### Getting items\nUsing the synchronous API:\n```java\nvar item = dynamoMapper.getItemFromPrimaryKey(\"key-value\", ModelObject.class).item();\n```\n\nUsing the asynchronous API:\n```java\ndynamoMapper.getItemFromPrimaryKey(\"key-value\", ModelObject.class).thenAccept(response -\u003e {\n\tvar item = response.item();\n});\n```\n\n### Putting items\nUsing the synchronous API:\n```java\nvar item = new ModelObject().setPrimaryKey(\"key-value\");\nvar response = dynamoMapper.putItemFromKeyObject(item);\n```\n\nUsing the asynchronous API:\n```java\nvar item = new ModelObject().setPrimaryKey(\"key-value\");\ndynamoMapper.putItemFromKeyObject(item).thenAccept(response -\u003e {\n\t// etc.\n});\n```\n\n## Best practices\n* Jackson will include all null values, to prevent this taking up space in DynamoDB, use `@JsonInclude(JsonInclude.Include.NON_NULL)`\n* To properly serialize BigDecimals, use `objectMapper.enable(JsonGenerator.Feature.WRITE_BIGDECIMAL_AS_PLAIN)`\n* To encode `java.time` objects properly, use `jackson-datatype-jsr310`\n\n## Comparison with DynamoDBMapper and DynamoDB Enhanced\nThe [DynamoDBMapper in the v1 AWS SDK](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBMapper.html)\nand the [DynamoDB Enhanced Client in the v2 AWS SDK](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/dynamodb-enhanced-client.html)\nboth provide similar mapping functionality.\n\nThis idea for this library was originally created to provide the same mapping as the v1 mapper, but for the v2 SDK,\nbefore the enhanced client was released.\nThe v2 SDK now provides this mapping functionality officially, but has a few short-comings.\nFor instance, the annotations must be added to methods and not properties.\nThis makes [Lombok](https://projectlombok.org/) models useless.\nJackson is a widely used and mature library. with advanced features that will never, and shouldn't, be implemented in\nthe enhanced client.\n\nThere are some cons to doing it this way.\nFor instance, it's not possible to have a different schema in the DynamoDB and JSON versions of an object.\n\n| Feature           | Dynamo Mapper | DynamoDBMapper (v1) | DynamoDb Enhanced Client (v2) |\n|-------------------|---------------|---------------------|-------------------------------|\n| Synchronous API   | Yes           | Yes                 | Yes                           |\n| Asynchronous API  | Yes           | No                  | Yes                           |\n| Lombok compatible | Yes           | Partial?            | No?                           |\n\n## Resources\n* https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_AttributeValue.html\n* https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.NamingRulesDataTypes.html\n* https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBMapper.html\n* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/dynamodb-enhanced-client.html\n* https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/package-summary.html\n* https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/dynamodb/package-summary.html\n\n## Versioning\nDynamo Mapper follows [semantic versioning](https://semver.org/).\n\n## Code Style\nDynamo Mapper follows Palantir with tabs.\nAutomatic code formatting can be done by running `./gradlew spotlessApply`.\n\n## License\nDynamo Mapper is licensed under the [MIT-0 license](https://spdx.org/licenses/MIT-0.html).\n\n## Status\n| Type          | Status                                                                                                                                                                                                                                                                                                                                                                                                                |\n|---------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| LGTM          | [![Language grade: Java](https://img.shields.io/lgtm/grade/java/g/autonomouslogic/dynamo-mapper.svg?logo=lgtm\u0026logoWidth=18)](https://lgtm.com/projects/g/autonomouslogic/dynamo-mapper/context:java) [![Total alerts](https://img.shields.io/lgtm/alerts/g/autonomouslogic/dynamo-mapper.svg?logo=lgtm\u0026logoWidth=18)](https://lgtm.com/projects/g/autonomouslogic/dynamo-mapper/alerts/)                              |\n| CodeClimate   | [![Maintainability](https://api.codeclimate.com/v1/badges/04243b52f38c8cecf66c/maintainability)](https://codeclimate.com/github/autonomouslogic/dynamo-mapper/maintainability)                                                                                                                                                                                                                                        |\n| SonarCloud    | [![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=autonomouslogic_dynamo-mapper\u0026metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=autonomouslogic_dynamo-mapper) [![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=autonomouslogic_dynamo-mapper\u0026metric=code_smells)](https://sonarcloud.io/summary/new_code?id=autonomouslogic_dynamo-mapper) |\n| Libraries.io  | ![Libraries.io dependency status for latest release](https://img.shields.io/librariesio/release/maven/com.autonomouslogic.dynamomapper:dynamo-mapper)                                                                                                                                                                                                                                                                 |\n| Snyk          | [![Known Vulnerabilities](https://snyk.io/test/github/autonomouslogic/dynamo-mapper/badge.svg)](https://snyk.io/test/github/autonomouslogic/dynamo-mapper)                                                                                                                                                                                                                                                            |\n| Codecov       | [![codecov](https://codecov.io/gh/autonomouslogic/dynamo-mapper/branch/main/graph/badge.svg?token=C5CO3GPGV3)](https://codecov.io/gh/autonomouslogic/dynamo-mapper)                                                                                                                                                                                                                                                   |\n| Synatype Lift | [link](https://lift.sonatype.com/)                                                                                                                                                                                                                                                                                                                                                                                    |\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fautonomouslogic%2Fdynamo-mapper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fautonomouslogic%2Fdynamo-mapper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fautonomouslogic%2Fdynamo-mapper/lists"}