A simple web client to view documents from AWS DynamoDB or DynamoDB Local

These instructions will help you how to make the dynamodb-client-web-gui web application running.

• Java 8 or newer
• DynamoDB Local Jar Download & Setup
• AWS Credentials File (if connecting to AWS DynamoDB)

• Using DynamoDB Local Your Dynamodb Local must be up and running

java -jar dynamodb-client-web-gui-1.0.0.jar --endpoint.url=[your dynamodb local endpoint] 

• Using AWS DynamoDB Before running the dynamodb-client-web-gui web application make sure that your AWS credentials file is in place.

java -jar dynamodb-client-web-gui-1.0.0.jar [--profile=<aws profile>] 

Wait for the web server to start up before connecting

• Creating records
• Updating records
• Deleting records
• Importing data from AWS DynamoDB]

• Java 8 - Programming Language
• Spring Boot - The web framework
• Mockito - Unit testing
• AngularJS 1 - Dynamic UI
• AWS SDK - API
• ui-grid - Grid data display
• angular-json-tree - JSON Tree display
• Bootstrap - UI
• Maven - Dependency Management

If you would like to contribute please see the instructions below.

• Download the DynamoDB Local jar or create an account in AWS to create tables in DymamoDB (Please visit AWS for more info)
• Install JDK 8
• Install Maven 3+ (I'm using v3.3.9)
• Get your favorite Java IDE (I'm using IntelliJ Community Edition)
• Forked this repository
• Create a branch for your changes

• Make sure that your changes has a corresponding test/s. Can be in a separate test file or modify the existing file
• No need for comments as long as the codes are readable

• if using AWS DynamoDB, make sure that your AWS credentials is in place. The command line argument profile is optional.

mvn clean spring-boot:run [-Drun.arguments="---profile=<profile>"] 

• if using DynamoDB Local, start your DynamoDB server first

mvn clean spring-boot:run -Drun.arguments="--endpoint.url=<your dynamodb url>" 

mvn cobertura:cobertura 

• Please make sure you run all the tests
• Push your branch in Github
• Make a pull request. In pull request please do not forget to add comment regarding the changes you want to submit.
• Monitor the pull request to make sure the Travis build succeeds. If it fails simply make the necessary changes to your branch and push it. Travis will re-test the changes.

Thanks!

• Quennie Teves - Initial work - simplymequeeny

See also the list of contributors who participated in this project.

I started this web application because I use DynamoDBLocal during the development and testing stages of the ReST WS project that I am involved with.

This project is licensed under the MIT License - see the LICENSE file for details

• Darky Theme - Bootstrap Theme from bootswatch