Revature Swagg Shop

This repository holds the cart microservice which handles:

• cart creation
• cart updates
• cart retrieval
• cart deletion
• cart item creation
• cart item updates
• cart item retrieval
• cart item deletion

These requests are handled by two controllers: CartItemController and CartController

There is a DevController but it is for development purposes only and should probably be phased out in future iterations.

Endpoints and methods are mapped out below.

CartController

Endpoints

VERB	URL	USE
POST	/cart	saves cart to db
GET	/carts/{id}	find carts by user id
GET	/cart/{id}	find cart by id
PUT	/cart	update cart
DELETE	/cart/{id}	delete cart

Methods

public Cart createCart(
      @ApiParam(value = "Cart object", required = true)
      @RequestBody Cart cart)

Saves the Cart object to the database.

public List<Cart> getCartsByUserId(
    @ApiParam(value = "User ID", required = true)
    @PathVariable("id") int userId)

Retrieves a list of Carts with the matching User ID.

public Cart getCartById(
    @ApiParam(value = "Cart ID", required = true)
    @PathVariable("id") int id)

Retrieves an individual Cart by Cart ID.

public Cart updateCart(
    @ApiParam(value = "Cart object", required = true)
    @RequestBody Cart cart)

Updates an already existing Cart based on Cart ID.

public void deleteCartById(
    @ApiParam(value = "Cart ID", required = true)
    @PathVariable("id") int id)

Deletes a Cart from the database based on Cart ID.

CartItemController

Endpoints

VERB	URL	USE
POST	/cartitem	saves cartItem to db
GET	/cartitem/{id}	finds cartItem by id
GET	/cartitems/{id}	returns all cartItems by cart id
PUT	/cartitem	update cartItem
DELETE	/cartitem/{id}	delete cartItem

Methods

public CartItem createCartItem(@RequestBody CartItem ci)

Saves the CartItem object to the database. If a CartItem with a matching Cart and Product ID already exists in the database the existing CartItem will add the passed CartItem's quantity to its own.

public CartItem getCartItemById(
    @ApiParam(value = "CartItem ID", required = true)
    @PathVariable("id") int id)

Gets the CartItem object based on the CartItem ID.

public List<CartItem> getAllCartItems(
    @ApiParam(value = "Cart ID", required = true)
    @PathVariable("id") int cartId)

Returns all CartItems that have the matching Cart by Cart ID

public CartItem updateCartItem(
    @ApiParam(value = "CartItem", required = true)
    @RequestBody CartItem ci)

Updates the CartItem object in the database.

public void deleteCartItemById(
    @ApiParam(value = "CartItem ID", required = true)
    @PathVariable("id") int id)

Deletes the CartItem object from the database based on CartItem ID

Getting started

• If you already have Docker Desktop with Kubernetes running on your machine with the nginx-ingress service skip to the setup files portion of this walkthrough
• You need to have Docker installed on your computer. Install Docker here.
• If you are running windows Docker Desktop is your quickest option.
• Enable Kubernetes on Docker Desktop in settings.
• Install Helm on your machine if you are using Windows. This will allow for the quick installation of the nginx-ingress. Helm nginx-ingress.
• Once you have the nginx-ingress in your Kubernetes services use kubctl apply -f rss-cart-setup.yaml to deploy this service

Viewing Changes Locally for Testing

• You must have a Dockerhub account. Use docker build -t yourdockerhub/rss-cart-service . to build the Docker image and push that image to your Dockerhub.
• Change the image target in the rss-cart-setup.yaml in the deployment section to use the image from your Dockerhub that you just pushed.
• Use kubctl apply -f rss-cart-setup.yaml to redeploy your new image.