BlackjackEngine

All Known Implementing Classes:

Blackjack
```
public interface BlackjackEngine
```
BlackJackEngine - interface defining the methods expected from a class implementing the Blackjack game logic.

Author:

cmsc132 Copyright (C) 2019 University of Maryland

See Also:

Card

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`BLACKJACK`
`static int`	`BUST`
`static int`	`DEALER_WON`
`static int`	`DRAW`
`static int`	`GAME_IN_PROGRESS`
`static int`	`HAS_21`
`static int`	`LESS_THAN_21`
`static int`	`PLAYER_WON`

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`void`	`createAndShuffleGameDeck()` Creates and shuffles the card deck(s) using the random number generator that was passed in to the constructor.
`void`	`deal()` Creates new deck(s) of cards and shuffles them; assigns cards to the dealer and player.
`int`	`getAccountAmount()` Returns the player's account amount
`int`	`getBetAmount()` Returns an integer representing the bet amount.
`Card[]`	`getDealerCards()` Returns dealer's cards.
`int`	`getDealerCardsEvaluation()` Returns an integer value that can assume the values LESS_THAN_21 if the dealer's cards have a value less than 21, BUST if the dealer's cards have a value greater than 21, and BLACKJACK if the dealer has an Ace along with a "10", Jack, Queen, or King.
`int[]`	`getDealerCardsTotal()` Returns an array representing the possible value(s) associated with the dealer's cards if the cards represent a value less than or equal to 21.
`Card[]`	`getGameDeck()` Returns the current deck(s) of cards.
`int`	`getGameStatus()` Returns an integer representing the game status.
`int`	`getNumberOfDecks()` Returns the number of decks being used.
`Card[]`	`getPlayerCards()` Returns player's cards.
`int`	`getPlayerCardsEvaluation()` Returns an integer value that can assume the values LESS_THAN_21 if the player's cards have a value less than 21, BUST if the players's cards have a value greater than 21, and BLACKJACK if the player has an Ace along with a "10", Jack, Queen, or King.
`int[]`	`getPlayerCardsTotal()` Returns an array representing the possible value(s) associated with the player's cards if the cards represent a value less than or equal to 21.
`void`	`playerHit()` Retrieves a card from the deck and assigns the card to the player.
`void`	`playerStand()` Flips the dealer's card that is currently face down and assigns cards to the dealer as long as the dealer doesn't bust and the cards have a value less than 16.
`void`	`setAccountAmount(int amount)` Updates the player's account with the parameter value.
`void`	`setBetAmount(int amount)` Updates the bet amount to the provided value

- Field Detail
  - DRAW
```
static final int DRAW
```
    See Also:
    
    Constant Field Values
  - LESS_THAN_21
```
static final int LESS_THAN_21
```
    See Also:
    
    Constant Field Values
  - BUST
```
static final int BUST
```
    See Also:
    
    Constant Field Values
  - BLACKJACK
```
static final int BLACKJACK
```
    See Also:
    
    Constant Field Values
  - HAS_21
```
static final int HAS_21
```
    See Also:
    
    Constant Field Values
  - DEALER_WON
```
static final int DEALER_WON
```
    See Also:
    
    Constant Field Values
  - PLAYER_WON
```
static final int PLAYER_WON
```
    See Also:
    
    Constant Field Values
  - GAME_IN_PROGRESS
```
static final int GAME_IN_PROGRESS
```
    See Also:
    
    Constant Field Values
- Method Detail
  - getNumberOfDecks
```
int getNumberOfDecks()
```
    Returns the number of decks being used.
    
    Returns:
    
    number of decks
  - createAndShuffleGameDeck
```
void createAndShuffleGameDeck()
```
    Creates and shuffles the card deck(s) using the random number generator that was passed in to the constructor.
  - getGameDeck
```
Card[] getGameDeck()
```
    Returns the current deck(s) of cards.
    
    Returns:
    
    Card array representing deck(s) of cards.
  - deal
```
void deal()
```
    Creates new deck(s) of cards and shuffles them; assigns cards to the dealer and player. A total of four cards are dealt in the following order: Player (face up), Dealer (face down), Player (face up), Dealer (face up). Once the cards have been dealt, the game's status will be GAME_IN_PROGRESS. Delete the bet amount from the account.
  - getDealerCards
```
Card[] getDealerCards()
```
    Returns dealer's cards.
    
    Returns:
    
    Card array representing the dealer's cards.
  - getDealerCardsTotal
```
int[] getDealerCardsTotal()
```
    Returns an array representing the possible value(s) associated with the dealer's cards if the cards represent a value less than or equal to 21.
    
    Returns:
    
    Integer array representing the possible value(s) or null if cards represent a value higher than 21. The array will have a size of 1 if only one value is associated with the set of cards, and a size of two if two values are possible. For the case of an array of size two, the smaller value must appear in the first array entry.
  - getDealerCardsEvaluation
```
int getDealerCardsEvaluation()
```
    Returns an integer value that can assume the values LESS_THAN_21 if the dealer's cards have a value less than 21, BUST if the dealer's cards have a value greater than 21, and BLACKJACK if the dealer has an Ace along with a "10", Jack, Queen, or King. If the dealer's cards have a value equivalent to 21 and the hand does not correspond to a blackjack, HAS_21 will be returned.
    
    Returns:
    
    Integer value that corresponds to one of the following: LESS_THAN_21, BUST, BLACKJACK, HAS_21
  - getPlayerCards
```
Card[] getPlayerCards()
```
    Returns player's cards.
    
    Returns:
    
    Card array representing the player's cards.
  - getPlayerCardsTotal
```
int[] getPlayerCardsTotal()
```
    Returns an array representing the possible value(s) associated with the player's cards if the cards represent a value less than or equal to 21.
    
    Returns:
    
    integer array representing the possible value(s) or null if cards represent a value higher than 21. The array will have a size of 1 if only one value is associated with the set of cards, and a size of two if two values are possible. For the case of an array of size two, the smaller value must appear in the first array entry.
  - getPlayerCardsEvaluation
```
int getPlayerCardsEvaluation()
```
    Returns an integer value that can assume the values LESS_THAN_21 if the player's cards have a value less than 21, BUST if the players's cards have a value greater than 21, and BLACKJACK if the player has an Ace along with a "10", Jack, Queen, or King. If the players' cards have a value equivalent to 21 and the hand does not correspond to a blackjack, HAS_21 will be returned.
    
    Returns:
    
    Integer value that corresponds to one of the following: LESS_THAN_21, BUST, BLACKJACK, HAS_21
  - playerHit
```
void playerHit()
```
    Retrieves a card from the deck and assigns the card to the player. The new sets of cards will be evaluated. If the player busts, the game is over and the games's status will be updated to DEALER_WON. Otherwise the game's status is GAME_IN_PROGRESS.
  - playerStand
```
void playerStand()
```
    Flips the dealer's card that is currently face down and assigns cards to the dealer as long as the dealer doesn't bust and the cards have a value less than 16. Once the dealer has a hand with a value greater than or equal to 16, and less than or equal to 21, the hand will be compared against the player's hand and whoever has the hand with a highest value will win the game. If both have the same value we have a draw. The game's status will be updated to one of the following values: DEALER_WON, PLAYER_WON, or DRAW. The player's account will be updated with a value corresponding to twice the bet amount if the player wins. If there is a draw the player's account will be updated with the only the bet amount.
  - setBetAmount
```
void setBetAmount(int amount)
```
    Updates the bet amount to the provided value
  - getBetAmount
```
int getBetAmount()
```
    Returns an integer representing the bet amount.
    
    Returns:
    
    bet amount.
  - setAccountAmount
```
void setAccountAmount(int amount)
```
    Updates the player's account with the parameter value.
    
    Parameters:
    
    amount -
  - getAccountAmount
```
int getAccountAmount()
```
    Returns the player's account amount
    
    Returns:
    
    account amount
  - getGameStatus
```
int getGameStatus()
```
    Returns an integer representing the game status.
    
    Returns:
    
    DRAW, PLAYER_WON, DEALER_WON OR GAME_IN_PROGRESS

Interface BlackjackEngine

Field Summary

Method Summary

Field Detail

DRAW

LESS_THAN_21

BUST

BLACKJACK

HAS_21

DEALER_WON

PLAYER_WON

GAME_IN_PROGRESS

Method Detail

getNumberOfDecks

createAndShuffleGameDeck

getGameDeck

deal

getDealerCards

getDealerCardsTotal

getDealerCardsEvaluation

getPlayerCards

getPlayerCardsTotal

getPlayerCardsEvaluation

playerHit

playerStand

setBetAmount

getBetAmount

setAccountAmount

getAccountAmount

getGameStatus