View Javadoc

1   package net.sf.josceleton.connection.api.service.user;
2   
3   import net.sf.josceleton.core.api.async.Listener;
4   import net.sf.josceleton.core.api.entity.User;
5   
6   /**
7    * @since 0.3
8    */
9   public interface UserServiceListener extends Listener {
10  
11  	/**
12  	 * Notification about a new tracked <code>User</code>, which needs to be calibrated via the Psi position yet.
13  	 * 
14  	 * @since 0.3
15  	 */
16  	void onUserWaiting(User user);
17  
18  	/**
19  	 * Notification about a successfull calibration, soon joint messages will come ;)
20  	 * 
21  	 * @since 0.3
22  	 */
23  	void onUserProcessing(User user);
24  	
25  	/**
26  	 * Notification about a lost user.
27  	 * 
28  	 * ATTENTION: The passed <code>user</code> argument can be null!
29  	 * This can happen if we entered an already running session, and only received the last bit (lost message).
30  	 * To be honest, this is a very very rare case :) 
31  	 * 
32  	 * @param user which was lost, or null if was in unpredictable state.
33  	 * @since 0.3
34  	 */
35  	void onUserDead(User user);
36  }