Package: DemoGameBuilder

DemoGameBuilder

Coverage

1: /*
2: * Copyright © 2021-2023 Fachhochschule für die Wirtschaft (FHDW) Hannover
3: *
4: * This file is part of ipspiel24-demo.
5: *
6: * Ipspiel24-demo is free software: you can redistribute it and/or modify it under the terms of the GNU General Public
7: * License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later
8: * version.
9: *
10: * Ipspiel24-demo is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied
11: * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
12: *
13: * You should have received a copy of the GNU General Public License along with ipspiel24-demo. If not, see
14: * <http://www.gnu.org/licenses/>.
15: */
16: package de.fhdw.gaming.ipspiel24.demo.domain;
17:
18: import de.fhdw.gaming.core.domain.Game;
19: import de.fhdw.gaming.core.domain.GameBuilder;
20: import de.fhdw.gaming.core.domain.GameException;
21: import de.fhdw.gaming.core.domain.ObserverFactoryProvider;
22: import de.fhdw.gaming.ipspiel24.demo.moves.DemoMove;
23:
24: /**
25: * A builder which allows to create a Demo game.
26: */
27: public interface DemoGameBuilder extends GameBuilder {
28:
29: /**
30: * Creates an {@link DemoPlayerBuilder} which allows to create and add a player to the game together with her
31: * strategy.
32: */
33: DemoPlayerBuilder createPlayerBuilder();
34:
35: /**
36: * Adds a player and her corresponding strategy.
37: *
38: * @param player The player.
39: * @param strategy The player's strategy.
40: * @throws GameException if adding the player is not allowed by the rules of the game.
41: */
42: DemoGameBuilder addPlayer(DemoPlayer player, DemoStrategy strategy) throws GameException;
43:
44: /**
45: * Changes the {@link ObserverFactoryProvider}.
46: *
47: * @param newObserverFactoryProvider The new {@link ObserverFactoryProvider}.
48: * @return {@code this}
49: */
50: DemoGameBuilder changeObserverFactoryProvider(ObserverFactoryProvider newObserverFactoryProvider);
51:
52: @Override
53: Game<DemoPlayer, DemoState, DemoMove, DemoStrategy> build(int id) throws GameException, InterruptedException;
54: }