hmtp sudoku demo

HMTP Sudoku Demo

Live Sudoku Demo

Sudoku Demo Whitepaper

Sudoku Demo Whitepaper

Files in this tutorial

Java source files

WEB-INF/classes/com/caucho/games/sudoku/SudokuService.java	SudokuService HTMP service
WEB-INF/classes/com/caucho/games/sudoku/SudokuAvatar.java	SudokuAvatar HMTP agent
WEB-INF/classes/com/caucho/games/sudoku/SudokuGameFactory.java	SudokuGame factory
WEB-INF/classes/com/caucho/games/sudoku/SudokuGame.java	SudokuGame logic
WEB-INF/classes/com/caucho/games/sudoku/SudokuDifficulty.java	SudokuDifficulty enum
WEB-INF/classes/com/caucho/games/sudoku/SudokuBoard.java	SudokuBoard
WEB-INF/classes/com/caucho/games/sudoku/SudokuEntry.java	SudokuEntry
WEB-INF/classes/com/caucho/games/sudoku/GameStartRequest.java	GameStartRequest event
WEB-INF/classes/com/caucho/games/sudoku/GameStart.java	GameStart event
WEB-INF/classes/com/caucho/games/sudoku/GameWait.java	GameWait event
WEB-INF/classes/com/caucho/games/sudoku/GameFinish.java	GameFinish event
WEB-INF/classes/com/caucho/games/sudoku/MoveQuery.java	MoveQuery event
WEB-INF/classes/com/caucho/games/sudoku/MoveResult.java	MoveResult event
WEB-INF/classes/com/caucho/games/sudoku/MoveError.java	MoveError event
WEB-INF/classes/com/caucho/games/sudoku/InvalidMoveException.java	InvalidMoveException

Flex/Flash source files

flash/src/com/caucho/games/sudoku/Sudoku.mxml	Top level Sudoku application
flash/src/com/caucho/games/sudoku/LoginComponent.mxml	LoginComponent
flash/src/com/caucho/games/sudoku/SelectDifficultyComponent.mxml	SelectDifficultyComponent
flash/src/com/caucho/games/sudoku/BoardComponent.mxml	BoardComponent
flash/src/com/caucho/games/sudoku/ScoreBoard.mxml	ScoreBoard
flash/src/com/caucho/games/sudoku/GameStartRequest.as	GameStartRequest query
flash/src/com/caucho/games/sudoku/GameStart.as	GameStart event
flash/src/com/caucho/games/sudoku/GameWait.as	GameWait event
flash/src/com/caucho/games/sudoku/GameFinish.as	GameFinish event
flash/src/com/caucho/games/sudoku/MoveQuery.as	MoveQuery event
flash/src/com/caucho/games/sudoku/MoveResult.as	MoveResult event
flash/src/com/caucho/games/sudoku/MoveError.as	MoveError event
flash/src/com/caucho/games/sudoku/SudokuBoard.as	SudokuBoard
flash/src/com/caucho/games/sudoku/SudokuDifficulty.as	SudokuDifficulty

Auxillary files

resin-web.xml	Configures the environment
flash/build.xml	Build file

Introduction

This example shows how to create an interactive Flash game using the Caucho BAM architecture. The game we will create is an interactive version of Sudoku in which two players compete on the same board at the same time to fill in the most number of correct squares.

Our example application has two main components: the server and the client. The server is constructed in Java while the client is in Flash/Flex.

Flash client

Game layout

        <mx:Panel title="Caucho Sudoku" id="panel" width="500" 
          paddingTop="20" paddingBottom="20" paddingLeft="20" paddingRight="20"
          horizontalAlign="center">
          <mx:VBox id="layoutBox" horizontalAlign="center">
            <sudoku:BoardComponent id="boardComponent" 
                                   scoreBoard="{scoreBoard}"
                                   infoLabel="{info}"/>
            <mx:Label id="info"/>
            <sudoku:ScoreBoard id="scoreBoard"/>
          </mx:VBox>
        </mx:Panel>

Embedding the client in a page using PHP

Java Server

SudokuService

The SudokuService is a BAM agent that manages players and matches them up in games.

The client's representative on the server: SudokuAvatar

The SudokuAvatar is a BAM agent that represents the player on the server within a certain game. In other words, there is one SudokuAvatar for each player, for each game. The SudokuAvatar is also responsible for routing message from the client agent to the game and vice versa.

Glossary

BAM	Brokered Agent Messaging - an architecture in which agents send messages and queries to one another. The broker handles the routing of these messages.
HMTP	Hessian Message Transport Protocol - the underlying wire protocol on which BAM is built.