Difference between revisions of "Chess Game Example"

Revision as of 08:45, 17 March 2013

This is a protected page for the Chess Game Example.

The chess game example demonstrates the creation of a chess game for two-players. The chess game has many rules and that are implemented in this example, see [chess]. The games interface is throught mouse clicks on the peices and the chess board's squares. A click on a square highlights valid user moves according to the rules of chess and the selected piece. The game is implemented with LSCs that can created in different ways, in this example, we present requirements created in two ways: one using the natural language interface to LSCs (NL-Play-In) and the other using the editor. We also review the differences between the approaches.

Game Board

Example 1 - LSCs created with NL-Play-In

The LSCs in this section were created with the NL-Play-In. The natural language text was parsed automatically to create the LSC.

Name	Natural Language Text	LSC
SelectSource	when the user clicks any Square, if the board sourcetargetValue is "0" and the Square type is not "vacent" then the Square selectSource and the board sourcetargetValue changes to "1".	LSC
SelectTarget	when the user clicks any Square, if the board sourcetargetValue is "1" then the Square selectTarget and the board sourcetargetValue changes to "0".	LSC
CheckPossibility	when any Square selectTarget then the Square checkPossibility.	LSC
MovePiece	when any Square checkPossibility, if the Square possibility is "true" then the Square MovePiece.	LSC
TurnChange	when any Square MovePiece, if the board state is "black" then the board state changes to "white" otherwise if the board state is "white" then the board state changes to "black" .	LSC
ChessNL WrongTurn	when any Square selectSource, if the Square type is "black" and the board state is "white" then the Square showMessage.	LSC
WrongTurn2	when any Square selectSource, if the Square type is "white" and the board state is "black" then the Square showMessage.	LSC
ResetBoard	when any Square showMessage then the board sourcetargetValue changes to "0".	LSC
PawnPossiblePosition	when any Square selectSource, if the Square piecename is "pawn" then the Square setPossiblePawnSquares.	LSC
RookPossiblePosition	when any Square selectSource, if the Square piecename is "rook" then the Square setPossibleRookSquares .	LSC
KnightPossiblePosition	when any Square selectSource, if the Square piecename is "knight" then the Square setPossibleKnightSquares.	LSC
BishopPossiblePosition	when any Square selectSource, if the Square piecename is "bishop" then the Square setPossibleBishopSquares.	LSC
QueenPossiblePosition	when any Square selectSource, if the Square piecename is "queen" then the Square setPossibleQueenSquares .	LSC
KingPossiblePosition	when any Square selectSource, if the Square piecename is "king" then the Square setPossibleKingSquares .	LSC

Example 2 - LSC for the game

The following LSCs where created with the use of the editor. Our intention was to create a specification with more than one symbolic lifeline in the LSCs and possibly more than one monitored event at the chart start.

Name	Description	LSC
PieceClick	When the user click any square Sq1, and then click any square Sq2, if the board next turn is equals to the Sq1 piece type then the square Sq1 check_Move square Sq2.	LSC
MovePiece	When the square Sq1 check_Move square Sq2, canmove is assigned whether the movement of piece from square Sq1 to Sq2 is possible,  if the piece canmove and Sq1 piecetype is not equals to Sq2 piecetype then the square Sq1 move_Piece to square Sq2.	LSC
Square RemovePiece	When the square Sq1 move_Piece to square Sq2,  then the square Sq2 emptyPiece the square Sq2.	LSC
NextMove	When the square Sq1 move_Piece to square Sq2, if the board next turn is "white" the board next turn changes to "black" otherwise if the board next turn is "black" the board next turn changes to "white".	LSC
SetSource	When the user click any square Sq1, if the Issource is "empty" then the square Sq1's possible positions are set and the IsSource changes to "set".	LSC
ShowMessage	When the user click any square Sq1, if the square IsSource is "empty" and the board next turn not equals the Sq1 piecetype then the square showmessage and the Issource is set to "empty".	LSC
ShowMessageReset	When the user click any square Sq1, if the square IsSource is "empty" and the board next turn not equals the Sq1 piecetype then the square showmessage and the Issource is set to "empty".	LSC
ResetPossiblePosition	When the user click any square Sq1, the square Sq1 setPossiblePosition and the user click any other square Sq2 then the Sq2 resetPossiblePosition of the Sq1.	LSC
CheckMate	When the any square Sq2 emptypiece any square Sq1, then isCheck is assigned whether there is any checkmate, if the checkmate is true then the square show the checkmate otherwise square removecheckmate.
kingposition	When the any square Sq2 emptypiece any square Sq1, then isCheck is assigned whether there is any checkmate, if the checkmate is true then the square show the checkmate otherwise square removecheckmate.	LSC
Loadgame	When the any square Sq2 emptypiece any square Sq1, then isCheck is assigned whether there is any checkmate, if the checkmate is true then the square show the checkmate otherwise square removecheckmate.	LSC
showturn	When the any square Sq2 emptypiece any square Sq1, then isCheck is assigned whether there is any checkmate, if the checkmate is true then the square show the checkmate otherwise square removecheckmate.	LSC
BlackPiecepoint	When the any square Sq2 emptypiece any square Sq1, then isCheck is assigned whether there is any checkmate, if the checkmate is true then the square show the checkmate otherwise square removecheckmate.	LSC
WhitePiecepoint	When the any square Sq2 emptypiece any square Sq1, then isCheck is assigned whether there is any checkmate, if the checkmate is true then the square show the checkmate otherwise square removecheckmate.	LSC
GameOver	When the any square Sq2 emptypiece any square Sq1, then isCheck is assigned whether there is any checkmate, if the checkmate is true then the square show the checkmate otherwise square removecheckmate.	LSC

Graph and Connections

Example1


Example2

Example 3 - a non working LSC

In this example, we demonstrate an LSC created, that seems to work, but will not work due to an unbound lifeline.

Name	Explanation	LSC
Square ResetHighlight	when the square sq2 is highlighed and the user click that square Sq2 then the square reset the highlight.	LSC

Since Sq2 is dynamic and there are more highlighted squares it leads to the universal binding.