org.refcodes.checkerboard.Player Maven / Gradle / Ivy
package org.refcodes.checkerboard;
import org.refcodes.exception.VetoException;
import org.refcodes.graphical.DraggableAccessor.DraggableBuilder;
import org.refcodes.graphical.DraggableAccessor.DraggableProperty;
import org.refcodes.graphical.Position.PositionBuilder;
import org.refcodes.graphical.Position.PositionProperty;
import org.refcodes.graphical.VisibleAccessor.VisibleBuilder;
import org.refcodes.graphical.VisibleAccessor.VisibleProperty;
import org.refcodes.mixin.StatusAccessor.StatusBuilder;
import org.refcodes.mixin.StatusAccessor.StatusMutator;
import org.refcodes.mixin.StatusAccessor.StatusProperty;
import org.refcodes.observer.Observable;
/**
* A {@link Player} defines an actor (player) on a playground (checkerboard). It
* is observable in order to signal observers (checkerboard) on state updates.
*
* @param the generic type
* @param The state if the player (dead, alive, strong, weak, king, queen,
* Pac-Man, ghost, fire, wood, water, strong queen, weak king, etc).
*/
public interface Player
, S> extends PositionProperty, PositionBuilder
, Observable>, StatusMutator, StatusProperty, StatusBuilder, VisibleProperty, VisibleBuilder, DraggableProperty, DraggableBuilder
{
/**
* Causes the {@link Player} to blink.
*/
default void blink() {
for ( int i = 0; i < 6; i++ ) {
setVisible( !isVisible() );
try {
Thread.sleep( 150 );
}
catch ( InterruptedException ignore ) {}
}
}
/**
* Moves the player one to the right.
*/
default void moveRight() {
setPosition( getPositionX() + 1, getPositionX() );
}
/**
* Moves the player one to the left.
*/
default void moveLeft() {
setPosition( getPositionX() - 1, getPositionX() );
}
/**
* Moves the player one up.
*/
default void moveUp() {
setPosition( getPositionX(), getPositionX() - 1 );
}
/**
* Moves the player one down.
*/
default void moveDown() {
setPosition( getPositionX(), getPositionX() - 1 );
}
/**
* Selects ("clicks") the player.
*/
void click();
/**
* Registers an according observer. For unregistering, use the returned
* handle.
*
* @param aObserver The observer to be registered.
*
* @return The accordingly registered {@link PlayerObserver}.
*/
default PlayerObserver onChangePosition( ChangePositionObserver aObserver ) {
PlayerObserver theObserver = new PlayerObserver() {
@Override
public void onPlayerEvent( PlayerEvent aPlayerEvent ) {}
@Override
public void onChangePositionEvent( ChangePositionEvent
aPlayerEvent ) throws VetoException {
aObserver.onChangePositionEvent( aPlayerEvent );
}
};
subscribeObserver( theObserver );
return theObserver;
}
/**
* Registers an according observer. For unregistering, use the returned
* handle.
*
* @param aObserver The observer to be registered.
*
* @return The accordingly registered {@link PlayerObserver}.
*/
default PlayerObserver onPositionChanged( PositionChangedObserver aObserver ) {
PlayerObserver theObserver = new PlayerObserver() {
@Override
public void onPlayerEvent( PlayerEvent aPlayerEvent ) {}
@Override
public void onPositionChangedEvent( PositionChangedEvent
aPlayerEvent ) {
aObserver.onPositionChangedEvent( aPlayerEvent );
}
};
subscribeObserver( theObserver );
return theObserver;
}
/**
* Registers an according observer. For unregistering, use the returned
* handle.
*
* @param aObserver The observer to be registered.
*
* @return The accordingly registered {@link PlayerObserver}.
*/
default PlayerObserver onStateChanged( StateChangedObserver aObserver ) {
PlayerObserver theObserver = new PlayerObserver() {
@Override
public void onPlayerEvent( PlayerEvent aPlayerEvent ) {}
@Override
public void onStateChangedEvent( StateChangedEvent aPlayerEvent ) {
aObserver.onStateChangedEvent( aPlayerEvent );
}
};
subscribeObserver( theObserver );
return theObserver;
}
/**
* Registers an according observer. For unregistering, use the returned
* handle.
*
* @param aObserver The observer to be registered.
*
* @return The accordingly registered {@link PlayerObserver}.
*/
default PlayerObserver onVisibilityChanged( VisibilityChangedObserver aObserver ) {
PlayerObserver theObserver = new PlayerObserver() {
@Override
public void onPlayerEvent( PlayerEvent aPlayerEvent ) {}
@Override
public void onVisibilityChangedEvent( VisibilityChangedEvent
aPlayerEvent ) {
aObserver.onVisibilityChangedEvent( aPlayerEvent );
}
};
subscribeObserver( theObserver );
return theObserver;
}
/**
* Registers an according observer. For unregistering, use the returned
* handle.
*
* @param aObserver The observer to be registered.
*
* @return The accordingly registered {@link PlayerObserver}.
*/
default PlayerObserver onDraggabilityChanged( DraggabilityChangedObserver aObserver ) {
PlayerObserver theObserver = new PlayerObserver() {
@Override
public void onPlayerEvent( PlayerEvent aPlayerEvent ) {}
@Override
public void onDraggabilityChangedEvent( DraggabilityChangedEvent
aPlayerEvent ) {
aObserver.onDraggabilityChangedEvent( aPlayerEvent );
}
};
subscribeObserver( theObserver );
return theObserver;
}
/**
* Registers an according observer. For unregistering, use the returned
* handle.
*
* @param aObserver The observer to be registered.
*
* @return The accordingly registered {@link PlayerObserver}.
*/
default PlayerObserver onClicked( ClickedObserver aObserver ) {
PlayerObserver theObserver = new PlayerObserver() {
@Override
public void onPlayerEvent( PlayerEvent aPlayerEvent ) {}
@Override
public void onClickedEvent( ClickedEvent
aPlayerEvent ) {
aObserver.onClickedEvent( aPlayerEvent );
}
};
subscribeObserver( theObserver );
return theObserver;
}
}