PokerHands (Java)

A poker deck contains 52 cards. Each card has a suit of either clubs, diamonds, hearts, or spades. Each card also has a value of either 2 through 10, jack, queen, king, or ace. For scoring purposes card values are ordered as above, with 2 having the lowest and ace the highest value. The suit has no impact on value.

A poker hand consists of five cards dealt from the deck. Poker hands are ranked by the following partial order from lowest to highest:

• High Card: Hands which do not fit any higher category are ranked by the value of their highest card. If the highest cards have the same value, the hands are ranked by the next highest, and so on.
• Pair: Two of the five cards in the hand have the same value. Hands which both contain a pair are ranked by the value of the cards forming the pair. If these values are the same, the hands are ranked by the values of the cards not forming the pair, in decreasing order.
• Two Pairs: The hand contains two different pairs. Hands which both contain two pairs are ranked by the value of their highest pair. Hands with the same highest pair are ranked by the value of their other pair. If these values are the same the hands are ranked by the value of the remaining card.
• Three of a Kind. Three of the cards in the hand have the same value. Hands which both contain three of a kind are ranked by the value of the three cards.
• Straight. Hand contains five cards with consecutive values. Hands which both contain a straight are ranked by their highest card.
• Flush. Hand contains five cards of the same suit. Hands which are both flushes are ranked using the rules for High Card.
• Full House. Three cards of the same value, with the remaining two cards forming a pair. Ranked by the value of the three cards.
• Four of a Kind. Four cards with the same value. Ranked by the value of the four cards.
• Straight Flush. Five cards of the same suit with consecutive values. Ranked by the highest card in the hand.

Your job is to compare several a pair of poker hands and to indicate which, if either, has a higher rank.

The input will consist of a JSON document like the following:

	{
		"hands": [
			{
				"name": "Ted",
				"hand": [ "2H", "3D", "5S", "9C", "KD" ]
			},
			{
				"name": "Louis",
				"hand": [ "2C", "3H", "4S", "8C", "AH" ]
			}
		]
	}

or

	{
		"hands": [
			{
				"name": "Black",
				"hand": [ "2H", "4S", "4C", "2D", "4H" ]
			},
			{
				"name": "White",
				"hand": [ "2S", "8S", "AS", "QS", "3S" ]
			}
		]
	}

The result will be a single message indicating which player's hand is the victorious one, suitable for display. The output will look like a JSON document like the following:

	{
		"result": "Ted wins"
	}

There should be just one endpoint, "/poker".