We all were in a situation when we wanted to cook something special but couldn't remember a recipe.
The program is a multi-user web service based on Spring Boot that allows storing, retrieving, updating, and deleting recipes.
Enter the project main directory.
$ ./gradlew run- POST
/api/recipe/newreceives a recipe as a JSON object and returns a JSON object with oneidfield; - GET
/api/recipe/{id}returns a recipe with a specified id as a JSON object. - DELETE
/api/recipe/{id}deletes a recipe with a specified id. - PUT
/api/recipe/{id}receives a recipe as a JSON object and updates a recipe with a specifiedid. Also, update thedatefield too. The server should return the204 (No Content)status code. If a recipe with a specified id does not exist, the server should return404 (Not found). The server should respond with 400 (Bad Request) if a recipe doesn't follow the restrictions indicated above (all fields are required, string fields can't be blank, arrays should have at least one item); - GET
/api/recipe/searchtakes one of the two mutually exclusive query parameters:category– if this parameter is specified, it returns a JSON array of all recipes of the specified category. Search is case-insensitive, sort the recipes by date (newer first);name– if this parameter is specified, it returns a JSON array of all recipes with the names that contain the specified parameter. Search is case-insensitive, sort the recipes by date (newer first). If no recipes are found, the program should return an empty JSON array. If 0 parameters were passed, or more than 1, the server should return400 (Bad Request). The same response should follow if the specified parameters are not valid. If everything is correct, it should return200 (Ok). - Store all recipes permanently in a database: after a server restart, all added recipes should be available to a user;
- Implement a new DELETE
/api/recipe/{id}endpoint. It deletes a recipe with a specified{id}. The server should respond with the204 (No Content)status code. If a recipe with a specified id does not exist, the server should return404 (Not found); - The service should accept only valid recipes – all fields are obligatory,
nameanddescriptionshouldn't be blank, and JSON arrays should contain at least one item. If a recipe doesn't meet these requirements, the service should respond with the400 (Bad Request)status code. categoryrepresents a category of a recipe. The field has the same restrictions asnameanddescription. It shouldn't be blank;datestores the date when the recipe has been added (or the last update). You can use any date/time format, for example2021-09-05T18:34:48.227624(the defaultLocalDateTimeformat), but the field should have at least 8 characters.- New endpoint POST
/api/registerreceives a JSON object with two fields:email(string), andpassword(string). If a user with a specified email does not exist, the program saves (registers) the user in a database and responds with200 (Ok). If a user is already in the database, respond with the400 (Bad Request)status code. Both fields are required and must be valid:emailshould contain@and.symbols,passwordshould contain at least 8 characters and shouldn't be blank. If the fields do not meet these restrictions, the service should respond with400 (Bad Request). Also, do not forget to use an encoder before storing a password in a database.BCryptPasswordEncoderis a good choice. - Include the Spring Boot Security dependency and configure access to the endpoints – all implemented endpoints (except
/api/register) should be available only to the registered and then authenticated and authorized via HTTP Basic auth users. Otherwise, the server should respond with the401 (Unauthorized)status code. - Add additional restrictions – only an author of a recipe can delete or update a recipe. If a user is not the author of a recipe, but they try to carry out the actions mentioned above, the service should respond with the
403 (Forbidden)status code.
Example 1: POST /api/recipe/new request
{
"name": "Fresh Mint Tea",
"category": "beverage",
"description": "Light, aromatic and refreshing beverage, ...",
"ingredients": ["boiled water", "honey", "fresh mint leaves"],
"directions": ["Boil water", "Pour boiling hot water into a mug", "Add fresh mint leaves", "Mix and let the mint leaves seep for 3-5 minutes", "Add honey and mix again"]
}Response:
{
"id": 1
}Further GET /api/recipe/1 response:
{
"name": "Fresh Mint Tea",
"category": "beverage",
"date": "2022-03-15T15:14:25.034734",
"description": "Light, aromatic and refreshing beverage, ...",
"ingredients": ["boiled water", "honey", "fresh mint leaves"],
"directions": ["Boil water", "Pour boiling hot water into a mug", "Add fresh mint leaves", "Mix and let the mint leaves seep for 3-5 minutes", "Add honey and mix again"]
}Example 2: PUT /api/recipe/1 request
{
"name": "Warming Ginger Tea",
"category": "beverage",
"description": "Ginger tea is a warming drink for cool weather, ...",
"ingredients": ["1 inch ginger root, minced", "1/2 lemon, juiced", "1/2 teaspoon manuka honey"],
"directions": ["Place all ingredients in a mug and fill with warm water (not too hot so you keep the beneficial honey compounds in tact)", "Steep for 5-10 minutes", "Drink and enjoy"]
}Further response for the GET /api/recipe/1 request:
{
"name": "Warming Ginger Tea",
"category": "beverage",
"date": "2022-03-15T15:19:55.234795",
"description": "Ginger tea is a warming drink for cool weather, ...",
"ingredients": ["1 inch ginger root, minced", "1/2 lemon, juiced", "1/2 teaspoon manuka honey"],
"directions": ["Place all ingredients in a mug and fill with warm water (not too hot so you keep the beneficial honey compounds in tact)", "Steep for 5-10 minutes", "Drink and enjoy"]
}Example 3: A database with several recipes
{
"name": "Iced Tea Without Sugar",
"category": "beverage",
"date": "2019-07-06T17:12:32.546987",
....
},
{
"name": "vegan avocado ice cream",
"category": "DESSERT",
"date": "2020-01-06T13:10:53.011342",
....
},
{
"name": "Fresh Mint Tea",
"category": "beverage",
"date": "2021-09-06T14:11:51.006787",
....
},
{
"name": "Vegan Chocolate Ice Cream",
"category": "dessert",
"date": "2021-04-06T14:10:54.009345",
....
},
{
"name": "warming ginger tea",
"category": "beverage",
"date": "2020-08-06T14:11:42.456321",
....
}Response for the GET /api/recipe/search/?category=dessert request:
[
{
"name": "Vegan Chocolate Ice Cream",
"category": "dessert",
"date": "2021-04-06T14:10:54.009345",
....
},
{
"name": "vegan avocado ice cream",
"category": "DESSERT",
"date": "2020-01-06T13:10:53.011342",
....
},
]Response for the GET /api/recipe/search/?name=tea request:
[
{
"name": "Fresh Mint Tea",
"category": "beverage",
"date": "2021-09-06T14:11:51.006787",
....
},
{
"name": "warming ginger tea",
"category": "beverage",
"date": "2020-08-06T14:11:42.456321",
....
},
{
"name": "Iced Tea Without Sugar",
"category": "beverage",
"date": "2019-07-06T17:12:32.546987",
....
},
]Search is case-insensitive, the recipes are sorted by date.
Example 4: POST /api/recipe/new request without authentication
{
"name": "Fresh Mint Tea",
"category": "beverage",
"description": "Light, aromatic and refreshing beverage, ...",
"ingredients": ["boiled water", "honey", "fresh mint leaves"],
"directions": ["Boil water", "Pour boiling hot water into a mug", "Add fresh mint leaves", "Mix and let the mint leaves seep for 3-5 minutes", "Add honey and mix again"]
}Status code: 401 (Unauthorized)
Example 5: POST /api/register request without authentication
{
"email": "Cook_Programmer@somewhere.com",
"password": "RecipeInBinary"
}Status code: 200 (Ok)
Further POST /api/recipe/new request with basic authentication; email (login): Cook_Programmer@somewhere.com, and password: RecipeInBinary
{
"name": "Mint Tea",
"category": "beverage",
"description": "Light, aromatic and refreshing beverage, ...",
"ingredients": ["boiled water", "honey", "fresh mint leaves"],
"directions": ["Boil water", "Pour boiling hot water into a mug", "Add fresh mint leaves", "Mix and let the mint leaves seep for 3-5 minutes", "Add honey and mix again"]
}Response:
{
"id": 1
}Further PUT /api/recipe/1 request with basic authentication; email (login): Cook_Programmer@somewhere.com, password: RecipeInBinary
{
"name": "Fresh Mint Tea",
"category": "beverage",
"description": "Light, aromatic and refreshing beverage, ...",
"ingredients": ["boiled water", "honey", "fresh mint leaves"],
"directions": ["Boil water", "Pour boiling hot water into a mug", "Add fresh mint leaves", "Mix and let the mint leaves seep for 3-5 minutes", "Add honey and mix again"]
}Status code: 204 (No Content)
Further GET /api/recipe/1 request with basic authentication; email (login): Cook_Programmer@somewhere.com, password: RecipeInBinary
Response:
{
"name": "Fresh Mint Tea",
"category": "beverage",
"date": "2020-01-02T12:11:25.034734",
"description": "Light, aromatic and refreshing beverage, ...",
"ingredients": ["boiled water", "honey", "fresh mint leaves"],
"directions": ["Boil water", "Pour boiling hot water into a mug", "Add fresh mint leaves", "Mix and let the mint leaves seep for 3-5 minutes", "Add honey and mix again"]
}Example 6: POST /api/register request without authentication
{
"email": "CamelCaseRecipe@somewhere.com",
"password": "C00k1es."
}Status code: 200 (Ok)
Further response for the GET /api/recipe/1 request with basic authentication; email (login): CamelCaseRecipe@somewhere.com, password: C00k1es.
{
"name": "Fresh Mint Tea",
"category": "beverage",
"date": "2020-01-02T12:11:25.034734",
"description": "Light, aromatic and refreshing beverage, ...",
"ingredients": ["boiled water", "honey", "fresh mint leaves"],
"directions": ["Boil water", "Pour boiling hot water into a mug", "Add fresh mint leaves", "Mix and let the mint leaves seep for 3-5 minutes", "Add honey and mix again"]
}Further PUT /api/recipe/1 request with basic authentication; email (login): CamelCaseRecipe@somewhere.com, password: C00k1es.
{
"name": "Warming Ginger Tea",
"category": "beverage",
"description": "Ginger tea is a warming drink for cool weather, ...",
"ingredients": ["1 inch ginger root, minced", "1/2 lemon, juiced", "1/2 teaspoon manuka honey"],
"directions": ["Place all ingredients in a mug and fill with warm water (not too hot so you keep the beneficial honey compounds in tact)", "Steep for 5-10 minutes", "Drink and enjoy"]
}Status code: 403 (Forbidden)
Further DELETE /api/recipe/1 request with basic authentication; email (login): CamelCaseRecipe@somewhere.com, password: C00k1es.
Status code: 403 (Forbidden)
MIT © OXL