Package org.kiwiproject.config

Class EndpointConfiguration

java.lang.Object

org.kiwiproject.config.EndpointConfiguration

public class EndpointConfiguration
extends Object

Configuration for a specific REST endpoint. Can be used standalone or in conjunction with SecureEndpointsConfiguration.

As this is a configuration class generally intended to be populated from external configuration, it is mutable.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	EndpointConfiguration.Builder	To use this EndpointConfiguration.Builder standalone, use the builder() method.

Constructor Summary

Constructors

Constructor	Description
EndpointConfiguration()

Method Summary

Modifier and Type	Method	Description
static EndpointConfiguration.Builder	builder()	Return a new builder instance to create a standalone EndpointConfiguration.
static EndpointConfiguration.Builder	builder(SecureEndpointsConfiguration.Builder parent)	Return a new builder instance to create a EndpointConfiguration within a SecureEndpointsConfiguration.
List<String>	getDomains()	Return the domains as a list.
String	getURI()	Uses this endpoint's path to build a URI as a String.
URI	getUriObject()	Uses this endpoint's path to build a URI.
boolean	isSecure()	Returns true if the scheme is "wss" or "https".
void	setDomain(String singleDomainOrCsv)	Set the domain(s), which can be a single domain (e.g.
javax.ws.rs.core.UriBuilder	toUriBuilder()	Converts the URI returned by getURI() into a JAX-RS UriBuilder.

Methods inherited from class java.lang.Object

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

Constructor Detail

EndpointConfiguration

public EndpointConfiguration()

Method Detail

builder

public static EndpointConfiguration.Builder builder()

Return a new builder instance to create a standalone EndpointConfiguration.

Returns:

the builder instance

builder

public static EndpointConfiguration.Builder builder(SecureEndpointsConfiguration.Builder parent)

Return a new builder instance to create a EndpointConfiguration within a SecureEndpointsConfiguration. Supply the SecureEndpointsConfiguration.Builder which is being used to build the SecureEndpointsConfiguration.

Parameters:

parent - the parent builder

Returns:

the builder instance

isSecure

public boolean isSecure()

Returns true if the scheme is "wss" or "https".

Returns:

true if using a secure scheme

setDomain

public void setDomain(String singleDomainOrCsv)

Set the domain(s), which can be a single domain (e.g. example.org) or multiple domains separated by commas. If a comma-separated list of domains is specified, whitespace is allowed and trimmed. For example this is valid: " domain-1.test , domain-2.test , domain-3.test " and results in the three domains "domain-1.test", "domain-2.test", and "domain-3.test".

Parameters:

singleDomainOrCsv - a single domain like example.org or a comma-delimited list of domains

getDomains

public List<String> getDomains()

Return the domains as a list.

Returns:

the list of domains

getURI

public String getURI()

Uses this endpoint's path to build a URI as a String. The host in the returned URI will be the result of round-robin among the domains returned by getDomains().

Returns:

the URI as a String

Implementation Note:

This currently builds URIs using simple string substitution, any any leading or trailing slashes on the domain are stripped.

getUriObject

public URI getUriObject()

Uses this endpoint's path to build a URI.

Returns:

the URI as a URI

See Also:

getURI()

toUriBuilder

public javax.ws.rs.core.UriBuilder toUriBuilder()

Converts the URI returned by getURI() into a JAX-RS UriBuilder.

Note that JAX-RS must be in the classpath when calling this method.

Returns:

a JAX-RS UriBuilder instance