Java - Jakarta EE Web Application

Jakarta EE Web Application - Java

This is an application written in Java to implement a web application with “Sprite” objects, users with various permissions and a REST API. The web application implements Jakarta Enterprise Edition as well as JavaServer Faces.

The Java web app provides functionality to manipulate “Sprite” objects using JavaServer Faces (JSF) and includes a converter class for converting colors to strings and vice versa. It incorporates data validation to ensure the integrity of Sprite manipulations. The app also offers a Restful HTTP interface for performing Create, Read, Update, and Delete operations on Sprites, with proper response codes and preserving existing values during updates. User administration includes authentication and access restrictions based on user groups, granting access to specific parts of the application. Additionally, the app includes automated unit tests using JUnit, with a focus on testing Sprite movement functionality.

A video demonstrating the output and the code is shown below:

Alternate Link

A Sample of the Source Code is below, view the full codebase on GitHub

AppUser Entity

Sprite Entity

REST API

Exported from Notepad++

 /*
 Authors:        abde
 File:           Appuser.java
 Description:    Definition of the AppUser Entity
 */
 package cst.entities;

 import java.io.Serializable;
 import java.util.HashMap;
import javax.enterprise.inject.Instance;
import javax.enterprise.inject.spi.CDI;
import javax.persistence.Basic;
import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.NamedQueries;
import javax.persistence.NamedQuery;
import javax.persistence.Table;
import javax.security.enterprise.identitystore.DatabaseIdentityStoreDefinition;
import javax.security.enterprise.identitystore.PasswordHash;
import javax.security.enterprise.identitystore.Pbkdf2PasswordHash;
import javax.validation.constraints.NotNull;
import javax.validation.constraints.Size;
import javax.xml.bind.annotation.XmlRootElement;

/**
 * AppUser entity class
 * @author abde
 */
@Entity
@Table(name = "APPUSER")
@XmlRootElement
// change depending on database definition
@NamedQueries({
    @NamedQuery(name = "Appuser.findAll", query = "SELECT a FROM Appuser a"),
    @NamedQuery(name = "Appuser.findById", query = "SELECT a FROM Appuser a WHERE a.id = :id"),
//    @NamedQuery(name = "Appuser.findById", query = "SELECT a FROM Appuser a WHERE a.id = :userid"),
    @NamedQuery(name = "Appuser.findByGroupname", query = "SELECT a FROM Appuser a WHERE a.groupname = :groupname"),
    @NamedQuery(name = "Appuser.findByPassword", query = "SELECT a FROM Appuser a WHERE a.password = :password")})
public class Appuser implements Serializable {

    private static final long serialVersionUID = 1L;
    
    @Id
    @Basic(optional = false)
    @NotNull
    @Size(min = 1, max = 255)
    // change depending on database definition
    @Column(name = "ID")
    // @Column(name = "USERID")
    private String id;
    
    @Size(max = 255)
    @Column(name = "GROUPNAME")
    private String groupname;
    
    @Size(max = 255)
    @Column(name = "PASSWORD")
    private String password;

    /**
     * Default Constructor
     */
    public Appuser() {
    }

    /**
     * Overloaded constructor to set id
     * @param id The id being set
     */
    public Appuser(String id) {
        this.id = id;
    }

    /**
     * Return user id
     * @return the user id
     */
    public String getId() {
        return id;
    }

    /**
     * Set the user id
     * @param id new user id
     */
    public void setId(String id) {
        this.id = id;
    }

    /**
     * Return the user group name
     * @return user group name
     */
    public String getGroupname() {
        return groupname;
    }

    /**
    * Set the user group name
    * @param groupname new user group name
    */
   public void setGroupname(String groupname) {
       this.groupname = groupname;
   }
106
   /**
    * Get the user password, returns null, do not display user passwords
    * @return null
    */
   public String getPassword() {
       return null;
   }
114
   /**
    * Sets the user password
    * @param password new user password
    */
   public void setPassword(String password) {
       if ((password == null || password == "") && (this.password != null || this.password != "")) {
           return;
       }
123
       // initialize a PasswordHash object which will generate password hashes
       Instance<? extends PasswordHash> instance = CDI.current().select(Pbkdf2PasswordHash.class);
       PasswordHash passwordHash = instance.get();
       passwordHash.initialize(new HashMap<String, String>()); // todo: are the defaults good enough?
128
       // now we can generate a password entry for a given password
       String passwordEntry = password; //pretend the user has chosen a password mySecretPassword
       passwordEntry = passwordHash.generate(passwordEntry.toCharArray());
       //at this point, passwordEntry refers to a salted/hashed password entry corresponding to mySecretPassword
133
       this.password = passwordEntry;
   }
136
   /**
    * Sets an id hash code
    * @return id hash code
    */
   @Override
   public int hashCode() {
       int hash = 0;
       hash += (id != null ? id.hashCode() : 0);
       return hash;
   }
147
   /**
    * Checks if two users are equal
    * @param object user to compare to
    * @return true or false whether users are equal
    */
   @Override
   public boolean equals(Object object) {
       // TODO: Warning - this method won't work in the case the id fields are not set
       if (!(object instanceof Appuser)) {
           return false;
       }
       Appuser other = (Appuser) object;
       if ((this.id == null && other.id != null) || (this.id != null && !this.id.equals(other.id))) {
           return false;
       }
       return true;
   }
165
   /**
    * Returns a string of the user id
    * @return string of user info
    */
   @Override
   public String toString() {
       return "Appuser[ id=" + id + " ]";
   }
   
}
176

Exported from Notepad++

 /*
 Authors:        abde
 File:           Sprite.java
 Description:    Defines our "sprite" entities
 */
 package cst.entities;

 import utility.ColorAdapter;
 import utility.JsonColorSerializer;
import utility.JsonColorDeserializer;
import java.awt.Color;
import java.awt.Graphics;
import java.io.Serializable;
import java.util.Random;
import javax.json.bind.annotation.JsonbTypeDeserializer;
import javax.json.bind.annotation.JsonbTypeSerializer;
import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;
import javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter;

/**
 * Sprite entity class
 * @author abde
 */
@Entity
@XmlRootElement
@XmlAccessorType(XmlAccessType.FIELD)
public class Sprite implements Serializable {

    private static final long serialVersionUID = 1L;

    public final static Random random = new Random();

    public final static int SIZE = 10;
    public final static int MAX_SPEED = 5;
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private Long id;

    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }
    @Column
    private Integer panelWidth;
    @Column
    private Integer panelHeight;
    @Column
    private Integer x;
    @Column
    private Integer y;
    @Column
    private Integer dx;
    @Column
    private Integer dy;
    
    @XmlElement
    @XmlJavaTypeAdapter(ColorAdapter.class)
    @JsonbTypeDeserializer(JsonColorDeserializer.class)
    @JsonbTypeSerializer(JsonColorSerializer.class)
    @Column
    private Color color = Color.BLUE;

    /**
     * Default Constructor
     */
    public Sprite() {
    }

    /**
     * Overloaded constructor to set panel height and width
     * @param height the panel height
     * @param width the panel width
     */
    public Sprite(int height, int width) {
        this.panelWidth = width;
        this.panelHeight = height;
        x = random.nextInt(width);
        y = random.nextInt(height);
        dx = random.nextInt(2 * MAX_SPEED) - MAX_SPEED;
        dy = random.nextInt(2 * MAX_SPEED) - MAX_SPEED;
    }

    /**
     * Overloaded constructor to set panel height, panel width and color
     * @param height the panel height
     * @param width the panel width
     * @param color the color
     */
   public Sprite(int height, int width, Color color) {
       this(height, width);
       this.color = color;
   }
104
   /**
    * Get the panel width
    * @return the panel width
    */
   public Integer getPanelWidth() {
       return panelWidth;
   }
112
   /**
    * Set the panel width
    * @param panelWidth new panel width
    */
   public void setPanelWidth(Integer panelWidth) {
       this.panelWidth = panelWidth;
   }
120
   /**
    * Get the panel height
    * @return the panel height
    */
   public Integer getPanelHeight() {
       return panelHeight;
   }
128
   /**
    * Set the panel height
    * @param panelHeight new panel height
    */
   public void setPanelHeight(Integer panelHeight) {
       this.panelHeight = panelHeight;
   }
136
   /**
    * Get the x position
    * @return the x position
    */
   public Integer getX() {
       return x;
   }
144
   /**
    * Set the x position
    * @param x new x position
    */
   public void setX(Integer x) {
       this.x = x;
   }
152
   /**
    * Get the y position
    * @return the y position
    */
   public Integer getY() {
       return y;
   }
160
   /**
    * Set the y position
    * @param y new y position
    */
   public void setY(Integer y) {
       this.y = y;
   }
168
   /**
    * Get the dx or horizontal speed
    * @return the dx speed
    */
   public Integer getDx() {
       return dx;
   }
176
   /**
    * Set the dx or horizontal speed
    * @param dx new dx speed
    */
   public void setDx(Integer dx) {
       this.dx = dx;
   }
184
   /**
    * Get the dy or vertical speed
    * @return the dy speed
    */
   public Integer getDy() {
       return dy;
   }
192
   /**
    * Set the dy or vertical speed
    * @param dy new dy speed
    */
   public void setDy(Integer dy) {
       this.dy = dy;
   }
200
   /**
    * Get the color
    * @return the color
    */
   public Color getColor() {
       return color;
   }
208
   /**
    * Set the color
    * @param color new color
    */
   public void setColor(Color color) {
       this.color = color;
   }
216
   /**
    * Set the graphics
    * @param g the graphics object
    */
   public void draw(Graphics g) {
       g.setColor(color);
       g.fillOval(x, y, SIZE, SIZE);
   }
225
   /**
    * Move the sprite based on position, speed, and panel dimensions
    */
   public void move() {
230
       // check for bounce and make the ball bounce if necessary
       //
       if (x < 0 && dx < 0) {
           //bounce off the left wall 
           x = 0;
           dx = -dx;
       }
       if (y < 0 && dy < 0) {
           //bounce off the top wall
           y = 0;
           dy = -dy;
       }
       if (x > panelWidth - SIZE && dx > 0) {
           //bounce off the right wall
           x = panelWidth - SIZE;
           dx = -dx;
       }
       if (y > panelHeight - SIZE && dy > 0) {
           //bounce off the bottom wall
           y = panelHeight - SIZE;
           dy = -dy;
       }
253
       //make the ball move
       x += dx;
       y += dy;
   }
   
   /**
    * Get the id hash code
    * @return id hash code
    */
   @Override
   public int hashCode() {
       int hash = 0;
       hash += (id != null ? id.hashCode() : 0);
       return hash;
   }
269
   /**
    * Compare if two sprites are equal
    * @param object the sprite to compare it to
    * @return true or false if they are equal
    */
   @Override
   public boolean equals(Object object) {
       // TODO: Warning - this method won't work in the case the id fields are not set
       if (!(object instanceof Sprite)) {
           return false;
       }
       Sprite other = (Sprite) object;
       if ((this.id == null && other.id != null) || (this.id != null && !this.id.equals(other.id))) {
           return false;
       }
       return true;
   }
   
   /**
    * Returns a string of the sprite id
    * @return string of sprite info
    */
   @Override
   public String toString() {
       return "Sprite[ id=" + id + " ]";
   }
296
}
298

Exported from Notepad++

 /*
 Authors:        abde
 File:           SpriteFacadeREST.java
 Description:    Routes and handles all the http REST requests implementing AbstractFacade interface
  */

 package service;

 import cst.entities.Sprite;
import java.awt.Color;
import java.util.ArrayList;
import java.util.HashSet;
import java.util.List;
import java.util.Objects;
import javax.persistence.EntityManager;
import javax.persistence.PersistenceContext;
import javax.ws.rs.core.Response;
import cst.entities.AbstractFacade;
import javax.annotation.security.DeclareRoles;
import javax.annotation.security.RolesAllowed;

/**
 * Defines our RESTful API endpoints
 * @author abde
 */
@javax.ejb.Stateless
@javax.ws.rs.Path("sprites")
@DeclareRoles({"Admin", "RestGroup"})
public class SpriteFacadeREST extends AbstractFacade<Sprite> {

    @PersistenceContext(unitName = "SpriteUsersPU")
    private EntityManager em;

    public SpriteFacadeREST() {
        super(Sprite.class);
    }

    /**
     * POST on root resource Without an id - Creates a new sprite without an id
     * provided With an id - Checks there is a sprite to update, non-existent id
     * returns error
     *
     * @param entity Sprite entity provided sprite values
     * @return response code with requested information
     */
    @javax.ws.rs.POST
    @javax.ws.rs.Consumes({javax.ws.rs.core.MediaType.APPLICATION_XML, javax.ws.rs.core.MediaType.APPLICATION_JSON})
    @RolesAllowed({"Admin", "RestGroup"})
    public Response createUpdate(Sprite entity) {
        // check if id exists
        Long id = entity.getId();
        if (id == null) {
            // verify the attributes
            String verification = validateSprite(entity, false, null);
            if (verification.compareTo("") == 0) {
                // create new sprite
                super.create(entity);
                return Response.status(Response.Status.CREATED).entity("New sprite created").build();
            } else {
                // invalid attribute(s)
                return Response.status(Response.Status.NOT_ACCEPTABLE).entity(verification).build();
            }
        } else {
            // check if id exists
            Sprite sprite = findId(id);
            if (sprite == null) {
                // error if no sprite with this ID exists
                return Response.status(Response.Status.NOT_ACCEPTABLE).entity("Sprite ID cannot be manually set").build();
            } else {
                // verify the attributes
                String verification = validateSprite(entity, true, sprite);
                if (verification.compareTo("") == 0) {
                    // update existing sprite
                    updateSprite(entity, sprite);
                    return Response.ok("Sprite with id " + id + " updated").build();
                } else {
                    // invalid attribute(s)
                    return Response.status(Response.Status.NOT_ACCEPTABLE).entity(verification).build();
                }
            }
        }
    }

    /**
     * PUT on root resource Unsupported - return error
     *
     * @param entity Sprite entity provided sprite values
     * @return response code with requested information
     */
    @javax.ws.rs.PUT
    @javax.ws.rs.Consumes({javax.ws.rs.core.MediaType.APPLICATION_XML, javax.ws.rs.core.MediaType.APPLICATION_JSON})
    @RolesAllowed({"Admin", "RestGroup"})
    public Response invCreate(Sprite entity) {
        return Response.status(Response.Status.NOT_IMPLEMENTED).entity("Can not PUT on the root resource").build();
    }

    /**
     * PUT request with an id Replaces a sprite with the matching id
     *
    * @param id provided sprite id
    * @param entity sprite entity provided sprite values
    * @return response code with requested information
    */
   @javax.ws.rs.PUT
   @javax.ws.rs.Path("{id}")
   @javax.ws.rs.Consumes({javax.ws.rs.core.MediaType.APPLICATION_XML, javax.ws.rs.core.MediaType.APPLICATION_JSON})
   @RolesAllowed({"Admin", "RestGroup"})
   public Response replace(@javax.ws.rs.PathParam("id") Long id, Sprite entity) {
       // make sure IDs are not contradictory
       if (entity.getId() != null && !Objects.equals(entity.getId(), id)){
           return Response.status(Response.Status.NOT_ACCEPTABLE).entity("Body ID " + entity.getId() + " must be null or match provided ID " + id).build();
       }
       
       // check if id exists
       Sprite sprite = findId(id);
       if (sprite == null) {
           // error if no sprite with this ID exists
           return Response.status(Response.Status.NOT_ACCEPTABLE).entity("Sprite with ID " + id + " cannot be found").build();
       } else {
           // verify the attributes
           String verification = validateSprite(entity, false, null);
           if (verification.compareTo("") == 0) {
               // replace the sprite
               entity.setId(id);
               super.edit(entity);
               return Response.status(Response.Status.OK).entity("Sprite with id " + id + " replaced").build();
           } else {
               // invalid attribute(s)
               return Response.status(Response.Status.NOT_ACCEPTABLE).entity(verification).build();
           }
       }
   }
133
   /**
    * POST request with an id Updates a sprite with the matching id with the
    * non-null values
    *
    * @param id provided sprite id
    * @param entity sprite entity provided sprite values
    * @return response code with requested information
    */
   @javax.ws.rs.POST
   @javax.ws.rs.Path("{id}")
   @javax.ws.rs.Consumes({javax.ws.rs.core.MediaType.APPLICATION_XML, javax.ws.rs.core.MediaType.APPLICATION_JSON})
   @RolesAllowed({"Admin", "RestGroup"})
   public Response update(@javax.ws.rs.PathParam("id") Long id, Sprite entity) {
       // make sure IDs are not contradictory
       if (entity.getId() != null && !Objects.equals(entity.getId(), id)){
           return Response.status(Response.Status.NOT_ACCEPTABLE).entity("Body ID " + entity.getId() + " must be null or match provided ID " + id).build();
       }
       
       // check if id exists
       Sprite sprite = findId(id);
       if (sprite == null) {
           // error if no sprite with this ID exists
           return Response.status(Response.Status.NOT_ACCEPTABLE).entity("Sprite with ID " + id + " cannot be found").build();
       } else {
           // verify the attributes
           String verification = validateSprite(entity, true, sprite);
           if (verification.compareTo("") == 0) {
               // update existing sprite
               updateSprite(entity, sprite);
               return Response.ok("Sprite with id " + id + " updated").build();
           } else {
               // invalid attribute(s)
               return Response.status(Response.Status.NOT_ACCEPTABLE).entity(verification).build();
           }
       }
   }
170
   /**
    * DELETE with an id Delete the selected sprite if it exists
    *
    * @param id provided sprite id
    * @return response code with requested information
    */
   @javax.ws.rs.DELETE
   @javax.ws.rs.Path("{id}")
   @RolesAllowed({"Admin", "RestGroup"})
   public Response remove(@javax.ws.rs.PathParam("id") Long id) {
       // check if id exists
       Sprite sprite = findId(id);
       if (sprite == null) {
           return Response.status(Response.Status.NOT_ACCEPTABLE).entity("Sprite with ID " + id + " cannot be found").build();
       } else {
           super.remove(super.find(id));
           return Response.status(Response.Status.OK).entity("Sprite with id " + id + " removed").build();
       }
   }
190
   /**
    * GET with an id Returns found sprite if any
    *
    * @param id provided sprite id
    * @return response code with requested information
    */
   @javax.ws.rs.GET
   @javax.ws.rs.Path("{id}")
   @javax.ws.rs.Produces({javax.ws.rs.core.MediaType.APPLICATION_XML, javax.ws.rs.core.MediaType.APPLICATION_JSON})
   @RolesAllowed({"Admin", "RestGroup"})
   public Response find(@javax.ws.rs.PathParam("id") Long id) {
       // check if id exists
       Sprite sprite = findId(id);
       if (sprite == null) {
           return Response.status(Response.Status.NO_CONTENT).entity("Sprite with ID " + id + " does not exist").build();
       } else {
           return Response.status(Response.Status.OK).entity(sprite).build();
       }
   }
210
   /**
    * GET root resource Returns all sprites if any
    *
    * @return response code with requested information
    */
   @javax.ws.rs.GET
   @javax.ws.rs.Produces({javax.ws.rs.core.MediaType.APPLICATION_XML, javax.ws.rs.core.MediaType.APPLICATION_JSON})
   @RolesAllowed({"Admin", "RestGroup"})
   public Response getAll() {
       List<Sprite> sprites = super.findAll();
       if (sprites.isEmpty()) {
           return Response.status(Response.Status.NO_CONTENT).entity("No sprites exist").build();
       } else {
           return Response.status(Response.Status.OK).entity(sprites).build();
       }
   }
227
   /**
    * GET with id range Returns the sprites with applicable ids if any
    *
    * @param from beginning id range
    * @param to end id range
    * @return response code with requested information
    */
   @javax.ws.rs.GET
   @javax.ws.rs.Path("{from}/{to}")
   @javax.ws.rs.Produces({javax.ws.rs.core.MediaType.APPLICATION_XML, javax.ws.rs.core.MediaType.APPLICATION_JSON})
   @RolesAllowed({"Admin", "RestGroup"})
   public Response findRange(@javax.ws.rs.PathParam("from") Integer from, @javax.ws.rs.PathParam("to") Integer to) {
       //return super.findRange(new int[]{from, to});
       List<Sprite> sprites = super.findRange(new int[]{from, to});
       if (sprites.isEmpty()) {
           return Response.status(Response.Status.NO_CONTENT).entity("No sprites exist").build();
       } else {
           return Response.status(Response.Status.OK).entity(sprites).build();
       }
   }
248
   /**
    * GET with count Returns the how many sprites there are
    *
    * @return response code with requested information
    */
   @javax.ws.rs.GET
   @javax.ws.rs.Path("count")
   @javax.ws.rs.Produces({javax.ws.rs.core.MediaType.APPLICATION_XML, javax.ws.rs.core.MediaType.APPLICATION_JSON, 
   javax.ws.rs.core.MediaType.TEXT_PLAIN})
   @RolesAllowed({"Admin", "RestGroup"})
   public Response countREST() {
       return Response.status(Response.Status.OK).entity(super.count()).build();
   }
262
   /**
    * Returns an entity manager
    *
    * @return entity manager
    */
   @Override
   protected EntityManager getEntityManager() {
       return em;
       // return Response.ok(em).build();
   }
273
   /**
    * Validates the sprites attributes and returns a string of errors if any
    *
    * @param sprite the sprite to validate
    * @param Boolean whether we are validating for an update or a replace
    * @param ogSprite sprite being updated for extra validation
    * @return string of errors if any
    */
   private String validateSprite(Sprite sprite, Boolean update, Sprite ogSprite) {
       String response = "";
       int maxSpeed = Sprite.MAX_SPEED;
       int size = Sprite.SIZE;
       List<String> invalidVals = new ArrayList<>();
       
       if (((update && sprite.getPanelWidth() != null) || !update) && (sprite.getPanelWidth() == null || sprite.getPanelWidth() <= size)) {
           invalidVals.add(String.format("PanelWidth (must be whole number greater than sprite size of %d)", size));
       }
       
       if (((update && sprite.getPanelHeight() != null) || !update) && (sprite.getPanelHeight() == null || sprite.getPanelHeight() <= size)) {
           invalidVals.add(String.format("PanelHeight (must be whole number greater than sprite size of %d)", size));
       }
       
       if ((!update) && (sprite.getX() == null || sprite.getX() < 0 || sprite.getX() > (sprite.getPanelWidth() - size))) {
           invalidVals.add(String.format("X (must be %d or under, less than PanelWidth (%d) minus size of sprite (%d))", 
           (sprite.getPanelHeight() - size),sprite.getPanelHeight(), size));
       }
300
       if ((!update) && (sprite.getY() == null || sprite.getY() < 0 || sprite.getY() > (sprite.getPanelHeight() - size))) {
           invalidVals.add(String.format("Y (must be %d or under, less than PanelHeight (%d) minus size of sprite (%d))", 
           (sprite.getPanelHeight() - size), sprite.getPanelHeight(), size));
       }
       
       // validate x and y coordinates for updates
       if (update){
           Integer panelWidth = sprite.getPanelWidth();
           Integer x = sprite.getX();
           if (panelWidth == null){
               panelWidth = ogSprite.getPanelWidth();
           }
           if (x == null){
               x = ogSprite.getX();
           }
           if (x < 0 || x > (panelWidth - size)) {
               invalidVals.add(String.format("X (must be %d or under, less than PanelWidth (%d) minus size of sprite (%d))", 
               (panelWidth - size), panelWidth, size));
           }
           
           Integer panelHeight = sprite.getPanelHeight();
           Integer y = sprite.getY();
           if (panelHeight == null){
               panelHeight = ogSprite.getPanelHeight();
           }
           if (y == null){
               y = ogSprite.getY();
           }
           if (y < 0 || y > (panelHeight - size)) {
               invalidVals.add(String.format("Y (must be %d or under, less than PanelHeight (%d) minus size of sprite (%d))", (panelHeight - size), panelHeight, size));
           }
       }
333
334
       if (((update && sprite.getDx() != null) || !update) && (sprite.getDx() == null || 
       sprite.getDx() < -1 * (maxSpeed) || sprite.getDx() > maxSpeed)) {
           invalidVals.add(String.format("dX (must be whole number between -%d to %d)", maxSpeed, maxSpeed));
       }
339
       if (((update && sprite.getDy() != null) || !update) && (sprite.getDy() == null || 
       sprite.getDy() < -1 * (maxSpeed) || sprite.getDy() > maxSpeed)) {
           invalidVals.add(String.format("dY (must be whole number between -%d to %d)", maxSpeed, maxSpeed));
       }
344
       for (int i = 0; i < invalidVals.size(); i++) {
           response += invalidVals.get(i);
           if (i < invalidVals.size()) {
               response += ", ";
           }
       }
351
       return response;
   }
354
   /**
    * Updates a sprite with received non-null values
    *
    * @param entity the updated values
    * @param sprite the original sprite
    */
   private void updateSprite(Sprite entity, Sprite sprite) {
       Color color =  entity.getColor();
       
       if (color != null) {
           sprite.setColor(color);
       }
       
       if (entity.getX() != null) {
           sprite.setX(entity.getX());
       }
371
       if (entity.getY() != null) {
           sprite.setY(entity.getY());
       }
375
       if (entity.getDx() != null) {
           sprite.setDx(entity.getDx());
       }
379
       if (entity.getDy() != null) {
           sprite.setDy(entity.getDy());
       }
       
       if (entity.getPanelWidth() != null) {
           sprite.setPanelWidth(entity.getPanelWidth());
       }
387
       if (entity.getPanelHeight() != null) {
           sprite.setPanelHeight(entity.getPanelHeight());
       }
391
       super.edit(sprite);
   }
394
   /**
    * Find the sprite with a specified id or null
    *
    * @param id provided sprite id
    * @return the sprite with the selected id or null
    */
   private Sprite findId(Long id) {
       List<Sprite> sprites = super.findAll();
       Sprite found = null;
       for (Sprite sprite : sprites) {
           if (Objects.equals(sprite.getId(), id)) {
               found = sprite;
               return found;
           }
       }
       return found;
   }
412
}
414