Web Services: exemple Escacs

Article anterior: Web Services

Objectius

Proposem un exercici amb web services. Volem fer un joc d'escacs disponible per diversos clients (aplicació browser desktop, aplicació mòbil, etc.)

En l'anterior article Web Services es proposa treballar amb MongoDB i utilitzar el framework CherryPy. Fes-li un cop d'ull per veure exemple pertinent.

Passem a especificar les diverses funcions que necessitem per implementar el WS:

Objectes del servei

Els objectes de més alt nivell (usuaris, partides) corresponen a les col·leccions de MongoDB.

• Usuari:
  • uid
  • Nick
  • email
  • estat
• Partida:
  • pid
  • jugador_blanques: uid
  • jugador_negres: uid
  • fitxes: [] array amb les diverses peces del taulell i les seves posicions
    • { color:'b', tipus:'peo', fila:2, col:3 }
    • ...
• torn: nº de torn (parells=mou blanca, senars=mou negra)
• inici: data + hora d'inici de partida (timestamp)

Especificació

API

Endpoint	IN (GET o POST+JSON)	OUT (JSON)
/partida	pid: id de partida (GET)	status: ok/error msg: detalls del error partida: totes les dades de la partida
/en_espera		status: ok/error msg: detalls del error usuaris: [] array d'usuaris en espera
/juga	uid_adversari: uid de la persona amb qui ens volem enfrontar uid_usuari: la nostra uid	status: ok/error msg: detalls del error partida: totes les dades de la partida
/login	nick: pseudònim de l'usuari email: adreça electrònica	status: ok/error msg: detalls del error uid: identificador d'usuari
/mou	pid: id de partida fila_inici col_inici fila_dst col_dst	status: ok/error msg: detalls del error partida: totes les dades de la partida

Ús de la API i comprovacions

Per poder efectuar una partida haurem de seguir el següent procés:

1. /login : aconsegueixo el meu uid
2. /en_espera : aconsegueixo llista d'usuaris que volen començar partida
3. /juga : creem i comencem partida (pid)
4. /mou : efectuem moviments en la partida

El WS ha de controlar la partida. Per tant haurà de comprovar una sèrie de regles per donar un moviment per bo (en el mètode mou):

• Comprovar que el lloc de destí és correcte per la peça a l'origen.
• Comprovar que entremig del origen i destí no hi ha alguna peça obstaculitzant el pas (excepte pel cavall)
• Comprovar si al lloc de destí hi ha una peça enemiga, i si la hi ha, eliminar-la de la partida.
• Comprovar si el moviment ha creat una situació d'escac i mat, fet que acabaria la partida.
• Retornar {status:true} o {status:false} si el moviment és correcte.

Recomanacions

• Instal·la mongodb, pymongo i cherrypy
• Fes un script que crei una partida amb les figures, etc.