README.md

Android WS OAuth2

Android app consuming a RESTful Web Service with OAuth2.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

• Android Studio or other.
• Spring Boot server with RESTful Web Service and OAuth2: spring-boot-ws-oauth2

Installing

1. Download the project by clicking the "Clone or download" button.
2. Unzip the project into the directory of your choice.
3. Using Android Studio (or another IDE), open the project you saved in the directory of your choice.
4. Click the Run (Shift + F10) button to run the project.

Deployment

Another project, spring-boot-ws-oauth2, will be the server that publish the services consumed in this project.

Testing

You can download the APK file on Releases Page, install on Android and test the project.

Screenshot

This are some of the App's screens:

Visitor Home

Create Account

Sign In

User Home

Product Main

New Product

List Product

Edit Product

Built With

• Gradle - Dependency Management.
• Gson - A Java serialization/deserialization library to convert Java Objects into JSON and back.
• HATEOAS (Hypermedia as the Engine of Application State) - Constraint of the REST application architecture.
• Jackson - Known as the standard JSON library for Java.
• OAuth2 - Industry-standard protocol for authorization.
• Spring's RestTemplate - Java-based REST client.

Versioning

We use Git for versioning.

Author

Diogo - Initial work - diogoaltoe

License

This project is licensed under the MIT License.