summaryrefslogtreecommitdiff
path: root/src/main/java/net/transit/network/system/Node.java
blob: 8e0fcbb081158c3b8b36cd683055bcddd68cf70a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
package net.transit.network.system;

import net.transit.network.swap.Acceptor;
import net.transit.network.swap.Provider;

/**
 * @author Kyle Gunger
 * @apiNote A node inside or outside a system. Provides acceptors and providers to other nodes.
 */
public interface Node
{
	/**Returns the groupIDs of groups the node provide
	 * 
	 * @return String[]
	 */
	public String[] groupsProvided();
	
	/**Get the system managing the node or {@code null} if there isn't one
	 * 
	 * @return ISystem
	 */
	public System getSystem();
	
	/**Returns {@code true} if the node provides Acceptors
	 * 
	 * @return boolean
	 */
	public boolean isAcceptor();
	
	/**Returns an Acceptor or {@code null} depending on the requester and group
	 * 
	 * @param requester The object requesting the Acceptor
	 * @param group
	 * @return Acceptor
	 */
	public Acceptor<?> requestAcceptor(Object requester, String group);
	
	/**Returns {@code true} if the node provides Providers
	 * 
	 */
	public boolean isProvider();
	
	/**Returns an Provider or {@code null} depending on the requester and group
	 * 
	 * @param requester The object requesting the Provider
	 * @param group
	 * @return Provider
	 */
	public Provider<?> requestProvider(Object requestor, String group);
}