FakeEmailSender is a microservice made in Java with Spring Boot. Application is responsible for sending emails to users from its own database.
Application uses gmail account to sending emails, but you can configure it for other provider.
First, before run this application you have to update 'application.properties' file.
Replace "user" and "password" with your account credentials.
spring.mail.username=user
spring.mail.password=passwordAfter that you can run the application however you like (from IDE, from terminal using mvn spring-boot:run).
Application works with H2 database preconfigured with schema.sql and data.sql files. After application start there is one table named USERS with five users saved.
Service provides its API on the following endpoints:
- User Database - http://localhost:8080/api/v1/users
- Email Sender - http://localhost:8080/api/v1/email
Now you can:
-
get all users - GET http://localhost:8080/api/v1/users
-
get user with id - GET http://localhost:8080/api/v1/users/{id}
-
create new user - POST http://localhost:8080/api/v1/users
-
update user with id - PUT http://localhost:8080/api/v1/users/{id}
-
delete user with id - DELETE http://localhost:8080/api/v1/users/{id}
-
send email to all users - POST http://localhost:8080/api/v1/email
-
send email to user with id - POST http://localhost:8080/api/v1/email/{id}
All data should be sent in Request Body in JSON format:
- get user with id=1 returns {"id": 1, "name": "user name", "email": "user email"}
- create user expects {"name": "user name", "email": "user email"}
- update user expects {"name": "new user name", "email": "new user email"}
- send email expects {"subject": "Subject", "message": "Message"}
There is a validation mechanism on User.name and User.email fields. Application accept only NotBlank names and proper email addresses.
There are two independent logging mechanisms implemented in the application.
One (log4j2) to log general application events: ./logs/fakeemailsender.log
The second one is a simple self-made request logger to log all requests from REST API: ./logs/requests.log
Log files will be created automatically with first entry.