sessionservice.java

来自「Java mulitplayer strategy game. Adaptati」· Java 代码 · 共 57 行

package net.sf.jawp.gf.api.services;

import java.rmi.Remote;
import java.rmi.RemoteException;
import java.util.Collection;
import net.sf.jawp.gf.api.domain.GameOptions;

import net.sf.jawp.gf.api.domain.GameWorld;
import net.sf.jawp.gf.api.domain.Player;
import net.sf.jawp.gf.api.domain.User;

/**
 * session object for logged user
 * @author jarek
 * @version $Revision: 1.5 $
 * 
 * @param <GAMESERVICE> service definition for game
 */
public interface SessionService<GAMESERVICE >
{
	User getLoggedUser();
	
	GameWorld createGame(final String name, final GameOptions options);
	
	/**
	 * lists available games
	 * @return available games.
	 */
	Collection<GameWorld> getGames();
	
	/**
	 * joins as new player
	 * @return
	 */
	Player joinGame(final long gameKey );
	
	void quitGame(final long gameKey, final long playerKey);
	
		
	/**
	 * retrieves all players for current user
	 * @return
	 */
	Collection<Player> getUserPlayersForGame(final long gameKey);
	
	/**
	 * retrieves native game service for given keys
	 * @param gameKey
	 * @param playerKey
	 * @return
	 */
	GAMESERVICE getGameService( final long gameKey, final long playerKey );
	
	//TODO: remove this stupid method
	Remote getGameServiceRemote( final long gameKey, final long playerKey ) throws RemoteException;
}