Package com.hazelcast.config

Class RestServerEndpointConfig

java.lang.Object

com.hazelcast.config.EndpointConfig

com.hazelcast.config.ServerSocketEndpointConfig

com.hazelcast.config.RestServerEndpointConfig

All Implemented Interfaces:

NamedConfig

@Deprecated(since="5.5",
            forRemoval=true)
public class RestServerEndpointConfig
extends ServerSocketEndpointConfig

Deprecated, for removal: This API element is subject to removal in a future version.

since 5.5, use RestConfig instead. Will be removed at 6.0.

Server socket endpoint config specialized for REST service Allows configuring access to REST groups similar to RestApiConfig

Since:

3.12

See Also:

• RestConfig

Field Summary

Fields inherited from class com.hazelcast.config.ServerSocketEndpointConfig

DEFAULT_PORT, PORT_AUTO_INCREMENT

Fields inherited from class com.hazelcast.config.EndpointConfig

DEFAULT_SOCKET_CONNECT_TIMEOUT_SECONDS, DEFAULT_SOCKET_KEEP_COUNT, DEFAULT_SOCKET_KEEP_IDLE_SECONDS, DEFAULT_SOCKET_KEEP_INTERVAL_SECONDS, DEFAULT_SOCKET_LINGER_SECONDS, DEFAULT_SOCKET_RECEIVE_BUFFER_SIZE_KB, DEFAULT_SOCKET_SEND_BUFFER_SIZE_KB, interfaces, name, protocolType, socketInterceptorConfig, sslConfig, symmetricEncryptionConfig

Constructor Summary

Constructors

Constructor	Description
RestServerEndpointConfig()	Deprecated, for removal: This API element is subject to removal in a future version.

Method Summary

Modifier and Type	Method	Description
RestServerEndpointConfig	addOutboundPort(int port)	Deprecated, for removal: This API element is subject to removal in a future version.
RestServerEndpointConfig	addOutboundPortDefinition(String portDef)	Deprecated, for removal: This API element is subject to removal in a future version.
RestServerEndpointConfig	disableAllGroups()	Deprecated, for removal: This API element is subject to removal in a future version. Disables all REST endpoint groups.
RestServerEndpointConfig	disableGroups(RestEndpointGroup... endpointGroups)	Deprecated, for removal: This API element is subject to removal in a future version. Disables provided REST endpoint groups.
RestServerEndpointConfig	enableAllGroups()	Deprecated, for removal: This API element is subject to removal in a future version. Enables all REST endpoint groups.
RestServerEndpointConfig	enableGroups(RestEndpointGroup... endpointGroups)	Deprecated, for removal: This API element is subject to removal in a future version. Enables provided REST endpoint groups.
boolean	equals(Object o)	Deprecated, for removal: This API element is subject to removal in a future version.
Set<RestEndpointGroup>	getEnabledGroups()	Deprecated, for removal: This API element is subject to removal in a future version. Returns a not-null set of enabled REST endpoint groups.
final com.hazelcast.instance.ProtocolType	getProtocolType()	Deprecated, for removal: This API element is subject to removal in a future version.
com.hazelcast.instance.EndpointQualifier	getQualifier()	Deprecated, for removal: This API element is subject to removal in a future version.
int	hashCode()	Deprecated, for removal: This API element is subject to removal in a future version.
boolean	isEnabledAndNotEmpty()	Deprecated, for removal: This API element is subject to removal in a future version. Return true if the REST API is enabled and at least one REST endpoint group is allowed.
boolean	isGroupEnabled(RestEndpointGroup group)	Deprecated, for removal: This API element is subject to removal in a future version. Checks if given REST endpoint group is enabled.
RestServerEndpointConfig	setEnabledGroups(Collection<RestEndpointGroup> groups)	Deprecated, for removal: This API element is subject to removal in a future version.
RestServerEndpointConfig	setInterfaces(InterfacesConfig interfaces)	Deprecated, for removal: This API element is subject to removal in a future version.
RestServerEndpointConfig	setName(String name)	Deprecated, for removal: This API element is subject to removal in a future version.
RestServerEndpointConfig	setOutboundPortDefinitions(Collection<String> outboundPortDefs)	Deprecated, for removal: This API element is subject to removal in a future version.
RestServerEndpointConfig	setOutboundPorts(Collection<Integer> outboundPorts)	Deprecated, for removal: This API element is subject to removal in a future version.
RestServerEndpointConfig	setPort(int port)	Deprecated, for removal: This API element is subject to removal in a future version. Sets the port the Hazelcast member will try to bind on.
RestServerEndpointConfig	setPortAutoIncrement(boolean portAutoIncrement)	Deprecated, for removal: This API element is subject to removal in a future version. Sets if a Hazelcast member is allowed to find a free port by incrementing the port number when it encounters an occupied port.
RestServerEndpointConfig	setPublicAddress(String publicAddress)	Deprecated, for removal: This API element is subject to removal in a future version. Overrides the public address of a member.
RestServerEndpointConfig	setReuseAddress(boolean reuseAddress)	Deprecated, for removal: This API element is subject to removal in a future version. Sets the reuse address.
RestServerEndpointConfig	setSocketBufferDirect(boolean socketBufferDirect)	Deprecated, for removal: This API element is subject to removal in a future version.
RestServerEndpointConfig	setSocketConnectTimeoutSeconds(int socketConnectTimeoutSeconds)	Deprecated, for removal: This API element is subject to removal in a future version.
RestServerEndpointConfig	setSocketInterceptorConfig(SocketInterceptorConfig socketInterceptorConfig)	Deprecated, for removal: This API element is subject to removal in a future version. Sets the SocketInterceptorConfig.
RestServerEndpointConfig	setSocketKeepAlive(boolean socketKeepAlive)	Deprecated, for removal: This API element is subject to removal in a future version.
RestServerEndpointConfig	setSocketKeepCount(int socketKeepCount)	Deprecated, for removal: This API element is subject to removal in a future version. Set the maximum number of TCP keep-alive probes to send before giving up and closing the connection if no response is obtained from the other side.
RestServerEndpointConfig	setSocketKeepIdleSeconds(int socketKeepIdleSeconds)	Deprecated, for removal: This API element is subject to removal in a future version. Set the number of seconds a connection needs to be idle before TCP begins sending out keep-alive probes.
RestServerEndpointConfig	setSocketKeepIntervalSeconds(int socketKeepIntervalSeconds)	Deprecated, for removal: This API element is subject to removal in a future version. Set the number of seconds between keep-alive probes.
RestServerEndpointConfig	setSocketLingerSeconds(int socketLingerSeconds)	Deprecated, for removal: This API element is subject to removal in a future version.
RestServerEndpointConfig	setSocketRcvBufferSizeKb(int socketRcvBufferSizeKb)	Deprecated, for removal: This API element is subject to removal in a future version.
RestServerEndpointConfig	setSocketSendBufferSizeKb(int socketSendBufferSizeKb)	Deprecated, for removal: This API element is subject to removal in a future version.
RestServerEndpointConfig	setSocketTcpNoDelay(boolean socketTcpNoDelay)	Deprecated, for removal: This API element is subject to removal in a future version.
RestServerEndpointConfig	setSSLConfig(SSLConfig sslConfig)	Deprecated, for removal: This API element is subject to removal in a future version. Sets the SSLConfig. null value indicates that no SSLConfig should be used.
RestServerEndpointConfig	setSymmetricEncryptionConfig(SymmetricEncryptionConfig symmetricEncryptionConfig)	Deprecated, for removal: This API element is subject to removal in a future version. Sets the SymmetricEncryptionConfig.
RestServerEndpointConfig	setTpcSocketConfig(TpcSocketConfig tpcSocketConfig)	Deprecated, for removal: This API element is subject to removal in a future version. Sets the TpcSocketConfig.
String	toString()	Deprecated, for removal: This API element is subject to removal in a future version.

Methods inherited from class com.hazelcast.config.ServerSocketEndpointConfig

getPort, getPortCount, getPublicAddress, isPortAutoIncrement, isReuseAddress, setPortCount, setProtocolType

Methods inherited from class com.hazelcast.config.EndpointConfig

getInterfaces, getName, getOutboundPortDefinitions, getOutboundPorts, getSocketConnectTimeoutSeconds, getSocketInterceptorConfig, getSocketKeepCount, getSocketKeepIdleSeconds, getSocketKeepIntervalSeconds, getSocketLingerSeconds, getSocketRcvBufferSizeKb, getSocketSendBufferSizeKb, getSSLConfig, getSymmetricEncryptionConfig, getTpcSocketConfig, isSocketBufferDirect, isSocketKeepAlive, isSocketTcpNoDelay

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

RestServerEndpointConfig

public RestServerEndpointConfig()

Deprecated, for removal: This API element is subject to removal in a future version.

Method Details

getProtocolType

public final com.hazelcast.instance.ProtocolType getProtocolType()

Deprecated, for removal: This API element is subject to removal in a future version.

Overrides:

getProtocolType in class EndpointConfig

getQualifier

public com.hazelcast.instance.EndpointQualifier getQualifier()

Deprecated, for removal: This API element is subject to removal in a future version.

Overrides:

getQualifier in class EndpointConfig

enableAllGroups

public RestServerEndpointConfig enableAllGroups()

Deprecated, for removal: This API element is subject to removal in a future version.

Enables all REST endpoint groups.

enableGroups

public RestServerEndpointConfig enableGroups(RestEndpointGroup... endpointGroups)

Deprecated, for removal: This API element is subject to removal in a future version.

Enables provided REST endpoint groups. It doesn't replace already enabled groups.

disableAllGroups

public RestServerEndpointConfig disableAllGroups()

Deprecated, for removal: This API element is subject to removal in a future version.

Disables all REST endpoint groups.

disableGroups

public RestServerEndpointConfig disableGroups(RestEndpointGroup... endpointGroups)

Deprecated, for removal: This API element is subject to removal in a future version.

Disables provided REST endpoint groups.

isEnabledAndNotEmpty

public boolean isEnabledAndNotEmpty()

Deprecated, for removal: This API element is subject to removal in a future version.

Return true if the REST API is enabled and at least one REST endpoint group is allowed.

getEnabledGroups

public Set<RestEndpointGroup> getEnabledGroups()

Deprecated, for removal: This API element is subject to removal in a future version.

Returns a not-null set of enabled REST endpoint groups.

isGroupEnabled

public boolean isGroupEnabled(RestEndpointGroup group)

Deprecated, for removal: This API element is subject to removal in a future version.

Checks if given REST endpoint group is enabled. It can return true even if the REST API itself is disabled.

setEnabledGroups

public RestServerEndpointConfig setEnabledGroups(Collection<RestEndpointGroup> groups)

Deprecated, for removal: This API element is subject to removal in a future version.

setPublicAddress

public RestServerEndpointConfig setPublicAddress(String publicAddress)

Deprecated, for removal: This API element is subject to removal in a future version.

Description copied from class: ServerSocketEndpointConfig

Overrides the public address of a member. Behind a NAT, two endpoints may not be able to see/access each other. If both nodes set their public addresses to their defined addresses on NAT, then that way they can communicate with each other. It should be set in the format “host IP address:port number”.

Overrides:

setPublicAddress in class ServerSocketEndpointConfig

setPort

public RestServerEndpointConfig setPort(int port)

Deprecated, for removal: This API element is subject to removal in a future version.

Description copied from class: ServerSocketEndpointConfig

Sets the port the Hazelcast member will try to bind on.

A valid port value is between 0 and 65535. A port number of 0 will let the system pick up an ephemeral port.

Overrides:

setPort in class ServerSocketEndpointConfig

Parameters:

port - the port the Hazelcast member will try to bind on

Returns:

NetworkConfig the updated NetworkConfig

See Also:

• ServerSocketEndpointConfig.getPort()
• for more information

setPortAutoIncrement

public RestServerEndpointConfig setPortAutoIncrement(boolean portAutoIncrement)

Deprecated, for removal: This API element is subject to removal in a future version.

Description copied from class: ServerSocketEndpointConfig

Sets if a Hazelcast member is allowed to find a free port by incrementing the port number when it encounters an occupied port.

If you explicitly want to control the port a Hazelcast member is going to use, you probably want to set portAutoincrement to false. In this case, the Hazelcast member is going to try the port ServerSocketEndpointConfig.setPort(int) and if the port is not free, the member will not start and throw an exception.

If this value is set to true, Hazelcast will start at the port specified by ServerSocketEndpointConfig.setPort(int) and will try until it finds a free port, or until it runs out of ports to try ServerSocketEndpointConfig.setPortCount(int).

Overrides:

setPortAutoIncrement in class ServerSocketEndpointConfig

Parameters:

portAutoIncrement - the portAutoIncrement to set

Returns:

the updated NetworkConfig

See Also:

• ServerSocketEndpointConfig.isPortAutoIncrement()
• ServerSocketEndpointConfig.setPortCount(int)
• ServerSocketEndpointConfig.setPort(int)

setReuseAddress

public RestServerEndpointConfig setReuseAddress(boolean reuseAddress)

Deprecated, for removal: This API element is subject to removal in a future version.

Description copied from class: ServerSocketEndpointConfig

Sets the reuse address.

When should setReuseAddress(true) be used?

When the member is shutdown, the server socket port will be in TIME_WAIT state for the next 2 minutes or so. If you start the member right after shutting it down, you may not be able to bind to the same port because it is in TIME_WAIT state. if you set reuseAddress=true then TIME_WAIT will be ignored, and you will be able to bind to the same port again.

This property should not be set to true on the Windows platform: see

1. http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6421091
2. http://www.hsc.fr/ressources/articles/win_net_srv/multiple_bindings.html

By default, if the OS is Windows then reuseAddress will be false.

Overrides:

setReuseAddress in class ServerSocketEndpointConfig

setName

public RestServerEndpointConfig setName(String name)

Deprecated, for removal: This API element is subject to removal in a future version.

Specified by:

setName in interface NamedConfig

Overrides:

setName in class ServerSocketEndpointConfig

setOutboundPortDefinitions

public RestServerEndpointConfig setOutboundPortDefinitions(Collection<String> outboundPortDefs)

Deprecated, for removal: This API element is subject to removal in a future version.

Overrides:

setOutboundPortDefinitions in class ServerSocketEndpointConfig

setOutboundPorts

public RestServerEndpointConfig setOutboundPorts(Collection<Integer> outboundPorts)

Deprecated, for removal: This API element is subject to removal in a future version.

Overrides:

setOutboundPorts in class ServerSocketEndpointConfig

setInterfaces

public RestServerEndpointConfig setInterfaces(InterfacesConfig interfaces)

Deprecated, for removal: This API element is subject to removal in a future version.

Overrides:

setInterfaces in class ServerSocketEndpointConfig

Parameters:

interfaces - the interfaces to set

setSocketBufferDirect

public RestServerEndpointConfig setSocketBufferDirect(boolean socketBufferDirect)

Deprecated, for removal: This API element is subject to removal in a future version.

Overrides:

setSocketBufferDirect in class ServerSocketEndpointConfig

setSocketKeepAlive

public RestServerEndpointConfig setSocketKeepAlive(boolean socketKeepAlive)

Deprecated, for removal: This API element is subject to removal in a future version.

Overrides:

setSocketKeepAlive in class ServerSocketEndpointConfig

setSocketTcpNoDelay

public RestServerEndpointConfig setSocketTcpNoDelay(boolean socketTcpNoDelay)

Deprecated, for removal: This API element is subject to removal in a future version.

Overrides:

setSocketTcpNoDelay in class ServerSocketEndpointConfig

setSocketSendBufferSizeKb

public RestServerEndpointConfig setSocketSendBufferSizeKb(int socketSendBufferSizeKb)

Deprecated, for removal: This API element is subject to removal in a future version.

Overrides:

setSocketSendBufferSizeKb in class ServerSocketEndpointConfig

setSocketRcvBufferSizeKb

public RestServerEndpointConfig setSocketRcvBufferSizeKb(int socketRcvBufferSizeKb)

Deprecated, for removal: This API element is subject to removal in a future version.

Overrides:

setSocketRcvBufferSizeKb in class ServerSocketEndpointConfig

setSocketLingerSeconds

public RestServerEndpointConfig setSocketLingerSeconds(int socketLingerSeconds)

Deprecated, for removal: This API element is subject to removal in a future version.

Overrides:

setSocketLingerSeconds in class ServerSocketEndpointConfig

setSocketConnectTimeoutSeconds

public RestServerEndpointConfig setSocketConnectTimeoutSeconds(int socketConnectTimeoutSeconds)

Deprecated, for removal: This API element is subject to removal in a future version.

Overrides:

setSocketConnectTimeoutSeconds in class ServerSocketEndpointConfig

setSocketInterceptorConfig

public RestServerEndpointConfig setSocketInterceptorConfig(SocketInterceptorConfig socketInterceptorConfig)

Deprecated, for removal: This API element is subject to removal in a future version.

Description copied from class: EndpointConfig

Sets the SocketInterceptorConfig. The value can be null if no socket interception is needed.

Overrides:

setSocketInterceptorConfig in class ServerSocketEndpointConfig

Parameters:

socketInterceptorConfig - the SocketInterceptorConfig to set

Returns:

the updated NetworkConfig

setSSLConfig

public RestServerEndpointConfig setSSLConfig(SSLConfig sslConfig)

Deprecated, for removal: This API element is subject to removal in a future version.

Description copied from class: EndpointConfig

Sets the SSLConfig. null value indicates that no SSLConfig should be used.

Overrides:

setSSLConfig in class ServerSocketEndpointConfig

Parameters:

sslConfig - the SSLConfig

Returns:

the updated NetworkConfig

See Also:

• EndpointConfig.getSSLConfig()

setTpcSocketConfig

@Beta
@Nonnull
public RestServerEndpointConfig setTpcSocketConfig(@Nonnull
 TpcSocketConfig tpcSocketConfig)

Deprecated, for removal: This API element is subject to removal in a future version.

Description copied from class: EndpointConfig

Sets the TpcSocketConfig. Can't return null.

Overrides:

setTpcSocketConfig in class ServerSocketEndpointConfig

Parameters:

tpcSocketConfig - Tpc socket config to set

Returns:

this endpoint config

See Also:

• TpcConfig

setSymmetricEncryptionConfig

public RestServerEndpointConfig setSymmetricEncryptionConfig(SymmetricEncryptionConfig symmetricEncryptionConfig)

Deprecated, for removal: This API element is subject to removal in a future version.

Description copied from class: EndpointConfig

Sets the SymmetricEncryptionConfig. The value can be null if no symmetric encryption should be used.

Overrides:

setSymmetricEncryptionConfig in class ServerSocketEndpointConfig

Parameters:

symmetricEncryptionConfig - the SymmetricEncryptionConfig to set

Returns:

the updated NetworkConfig

See Also:

• EndpointConfig.getSymmetricEncryptionConfig()

addOutboundPortDefinition

public RestServerEndpointConfig addOutboundPortDefinition(String portDef)

Deprecated, for removal: This API element is subject to removal in a future version.

Overrides:

addOutboundPortDefinition in class EndpointConfig

addOutboundPort

public RestServerEndpointConfig addOutboundPort(int port)

Deprecated, for removal: This API element is subject to removal in a future version.

Overrides:

addOutboundPort in class EndpointConfig

setSocketKeepIdleSeconds

public RestServerEndpointConfig setSocketKeepIdleSeconds(int socketKeepIdleSeconds)

Deprecated, for removal: This API element is subject to removal in a future version.

Description copied from class: EndpointConfig

Set the number of seconds a connection needs to be idle before TCP begins sending out keep-alive probes. Valid values are 1 to 32767.

This option is only applicable when keep alive is true. Requires a recent JDK 8, JDK 11 or greater version that includes the required JDK support.

Overrides:

setSocketKeepIdleSeconds in class ServerSocketEndpointConfig

See Also:

• jdk.net.ExtendedSocketOptions#TCP_KEEPIDLE

setSocketKeepIntervalSeconds

public RestServerEndpointConfig setSocketKeepIntervalSeconds(int socketKeepIntervalSeconds)

Deprecated, for removal: This API element is subject to removal in a future version.

Description copied from class: EndpointConfig

Set the number of seconds between keep-alive probes. Notice that this is the number of seconds between probes after the initial keep-alive idle time has passed. Valid values are 1 to 32767.

This option is only applicable when keep alive is true. Requires a recent JDK 8, JDK 11 or greater version that includes the required JDK support.

Overrides:

setSocketKeepIntervalSeconds in class ServerSocketEndpointConfig

See Also:

• jdk.net.ExtendedSocketOptions#TCP_KEEPINTERVAL

setSocketKeepCount

public RestServerEndpointConfig setSocketKeepCount(int socketKeepCount)

Deprecated, for removal: This API element is subject to removal in a future version.

Description copied from class: EndpointConfig

Set the maximum number of TCP keep-alive probes to send before giving up and closing the connection if no response is obtained from the other side. Valid values are 1 to 127.

This option is only applicable when keep alive is true. Requires a recent JDK 8, JDK 11 or greater version that includes the required JDK support.

Overrides:

setSocketKeepCount in class ServerSocketEndpointConfig

See Also:

• jdk.net.ExtendedSocketOptions#TCP_KEEPCOUNT

toString

public String toString()

Deprecated, for removal: This API element is subject to removal in a future version.

Overrides:

toString in class ServerSocketEndpointConfig

equals

public boolean equals(Object o)

Deprecated, for removal: This API element is subject to removal in a future version.

Overrides:

equals in class ServerSocketEndpointConfig

hashCode

public int hashCode()

Deprecated, for removal: This API element is subject to removal in a future version.

Overrides:

hashCode in class ServerSocketEndpointConfig