Package dev.qixils.crowdcontrol.builder

Class CrowdControlServerBuilder

java.lang.Object

dev.qixils.crowdcontrol.builder.CrowdControlServerBuilder

All Implemented Interfaces:

CrowdControlBuilder

public final class CrowdControlServerBuilder
extends Object

Builds a new CrowdControl instance that acts as a server for Crowd Control clients to connect to.

Field Summary

Fields

Modifier and Type	Field	Description
protected int	port	The port that the client/server will connect to or listen on.
protected @NotNull Function<@NotNull CrowdControl,@NotNull SocketManager>	socketManagerCreator	A function (usually a constructor) that creates a new SocketManager given a CrowdControl instance.

Constructor Summary

Constructors

Constructor	Description
CrowdControlServerBuilder()	Creates a new CrowdControl server builder.

Method Summary

Modifier and Type	Method	Description
@NotNull CrowdControl	build()	Builds a new CrowdControl instance using the provided variables.
@NotNull CrowdControlServerBuilder	password(@NotNull String password)	Sets the password required for Crowd Control clients to connect.
@NotNull CrowdControlServerBuilder	port(int port)	Sets the port that will be used by the Crowd Control server.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

socketManagerCreator

@NotNull
protected final @NotNull Function<@NotNull CrowdControl,@NotNull SocketManager> socketManagerCreator

A function (usually a constructor) that creates a new SocketManager given a CrowdControl instance.

port

protected int port

The port that the client/server will connect to or listen on.

Constructor Detail

CrowdControlServerBuilder

@CheckReturnValue
public CrowdControlServerBuilder()

Creates a new CrowdControl server builder.

Method Detail

password

@CheckReturnValue
@Contract("_ -> this")
@NotNull
public @NotNull CrowdControlServerBuilder password(@NotNull
                                                   @NotNull String password)
                                            throws IllegalArgumentException

Sets the password required for Crowd Control clients to connect.

Parameters:

password - password clients must enter to connect

Returns:

this builder

Throws:

IllegalArgumentException - the password was null or blank

port

@CheckReturnValue
@Contract("_ -> this")
@NotNull
public @NotNull CrowdControlServerBuilder port(int port)
                                        throws IllegalArgumentException

Sets the port that will be used by the Crowd Control server.

Specified by:

port in interface CrowdControlBuilder

Parameters:

port - port to listen for new connections on

Returns:

this builder

Throws:

IllegalArgumentException - the port was outside the expected bounds of [1,65536]

build

@CheckReturnValue
@Contract("-> new")
@NotNull
public @NotNull CrowdControl build()
                            throws IllegalStateException

Builds a new CrowdControl instance using the provided variables.

Returns:

new CrowdControl instance

Throws:

IllegalStateException - port(int) or password(String) was not called