ratpack.server.ServerConfigBuilder Maven / Gradle / Ivy
/*
* Copyright 2015 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package ratpack.server;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.google.common.io.ByteSource;
import ratpack.config.ConfigData;
import ratpack.config.ConfigDataBuilder;
import ratpack.config.ConfigSource;
import ratpack.config.EnvironmentParser;
import ratpack.func.Action;
import ratpack.func.Function;
import javax.net.ssl.SSLContext;
import java.io.File;
import java.net.InetAddress;
import java.net.URI;
import java.net.URL;
import java.nio.file.Path;
import java.util.Map;
import java.util.Properties;
/**
* Builds a {@link ServerConfig}.
*
* @see RatpackServerSpec#serverConfig(Action)
*/
public interface ServerConfigBuilder extends ConfigDataBuilder {
/**
* Sets the root of the filesystem for the application.
*
* The {@link ServerConfig#getBaseDir() base dir} acts as the portable file system for the application.
* All paths within the application, resolved by Ratpack API are resolved from this point.
* For example, {@link ratpack.handling.Chain#files(Action)} allows serving static files within the base dir.
*
* The base dir is also used to resolve paths to file system locations when using {@link #json(String)}, {@link #yaml(String)} and {@link #props(String)}.
* This allows config files to travel with the application within the base dir.
*
* It is generally desirable to use the {@link BaseDir#find()} to dynamically find the base dir at runtime.
*
* @param baseDir the base dir
* @return {@code this}
*/
ServerConfigBuilder baseDir(Path baseDir);
/**
* Calls {@link #baseDir(Path)} after converting the given {@code File} to a {@code Path} using {@link File#toPath()}.
*
* @param file the base dir
* @return {@code this}
*/
default ServerConfigBuilder baseDir(File file) {
return baseDir(file.toPath());
}
/**
* Sets the port to listen for requests on.
*
* Defaults to 5050.
*
* @param port the port to listen for requests on
* @return {@code this}
* @see ratpack.server.ServerConfig#getPort()
*/
ServerConfigBuilder port(int port);
/**
* Sets the address to bind to.
*
* Default value is {@code null}.
*
* @param address The address to bind to
* @return {@code this}
* @see ServerConfig#getAddress()
*/
ServerConfigBuilder address(InetAddress address);
/**
* Whether or not the application is "development".
*
* Default value is {@code false}.
*
* @param development Whether or not the application is "development".
* @return {@code this}
* @see ServerConfig#isDevelopment()
*/
ServerConfigBuilder development(boolean development);
/**
* The number of threads to use.
*
* Defaults to {@link ServerConfig#DEFAULT_THREADS}
*
* @param threads the size of the event loop thread pool
* @return {@code this}
* @see ServerConfig#getThreads()
*/
ServerConfigBuilder threads(int threads);
/**
* The public address of the application.
*
* Default value is {@code null}.
*
* @param publicAddress the public address of the application
* @return {@code this}
* @see ServerConfig#getPublicAddress()
*/
ServerConfigBuilder publicAddress(URI publicAddress);
/**
* The max number of bytes a request body can be.
*
* Default value is {@code 1048576} (1 megabyte).
*
* @param maxContentLength the max content length to accept
* @return {@code this}
* @see ServerConfig#getMaxContentLength()
*/
ServerConfigBuilder maxContentLength(int maxContentLength);
/**
* The connect timeout of the channel.
*
* @param connectTimeoutMillis the connect timeout in milliseconds
* @return {@code this}
* @see ServerConfig#getConnectTimeoutMillis()
*/
ServerConfigBuilder connectTimeoutMillis(int connectTimeoutMillis);
/**
* The maximum number of messages to read per read loop.
*
* @param maxMessagesPerRead the max messages per read
* @return {@code this}
* @see ServerConfig#getMaxMessagesPerRead()
*/
ServerConfigBuilder maxMessagesPerRead(int maxMessagesPerRead);
/**
* The StandardSocketOptions.SO_RCVBUF option.
*
* @param receiveBufferSize the recieve buffer size
* @return {@code this}
* @see ServerConfig#getReceiveBufferSize()
*/
ServerConfigBuilder receiveBufferSize(int receiveBufferSize);
/**
* The maximum loop count for a write operation until WritableByteChannel.write(ByteBuffer) returns a non-zero value.
*
* @param writeSpinCount the write spin count
* @return {@code this}
* @see ServerConfig#getWriteSpinCount()
*/
ServerConfigBuilder writeSpinCount(int writeSpinCount);
/**
* The SSL context to use if the application serves content over HTTPS.
*
* @param sslContext the SSL context
* @return {@code this}
* @see ratpack.ssl.SSLContexts
* @see ServerConfig#getSslContext()
*/
ServerConfigBuilder ssl(SSLContext sslContext);
/**
* The server needs client SSL authentication.
*
* @param requireClientSslAuth whether or not server needs client SSL authentication
* @return {@code this}
*/
ServerConfigBuilder requireClientSslAuth(boolean requireClientSslAuth);
/**
* {@inheritDoc}
*/
@Override
ServerConfigBuilder env();
/**
* {@inheritDoc}
*/
@Override
ServerConfigBuilder env(String prefix);
/**
* {@inheritDoc}
*/
@Override
ServerConfigBuilder props(ByteSource byteSource);
/**
* Adds the properties file at the given path as a configuration source.
*
* If a base dir is set, the path will be resolved relative to it.
* Otherwise, it will be resolved relative to the file system root.
*
* @param path the path to the file
* @return {@code this}
*/
@Override
ServerConfigBuilder props(String path);
/**
* {@inheritDoc}
*/
@Override
ServerConfigBuilder props(Path path);
/**
* {@inheritDoc}
*/
@Override
ServerConfigBuilder props(Properties properties);
/**
* {@inheritDoc}
*/
@Override
ServerConfigBuilder props(Map map);
/**
* {@inheritDoc}
*/
@Override
ServerConfigBuilder props(URL url);
/**
* {@inheritDoc}
*/
@Override
ServerConfigBuilder sysProps();
/**
* {@inheritDoc}
*/
@Override
ServerConfigBuilder sysProps(String prefix);
/**
* {@inheritDoc}
*/
@Override
ServerConfigBuilder onError(Action errorHandler);
/**
* {@inheritDoc}
*/
@Override
ServerConfigBuilder configureObjectMapper(Action action);
/**
* {@inheritDoc}
*/
@Override
ServerConfigBuilder add(ConfigSource configSource);
/**
* {@inheritDoc}
*/
@Override
ServerConfigBuilder env(String prefix, Function mapFunc);
/**
* {@inheritDoc}
*/
@Override
ServerConfigBuilder env(EnvironmentParser environmentParser);
/**
* {@inheritDoc}
*/
@Override
ServerConfigBuilder json(ByteSource byteSource);
/**
* {@inheritDoc}
*/
@Override
ServerConfigBuilder json(Path path);
/**
* Adds the JSON file at the given path as a configuration source.
*
* If a base dir is set, the path will be resolved relative to it.
* Otherwise, it will be resolved relative to the file system root.
*
* @param path the path to the file
* @return {@code this}
*/
@Override
ServerConfigBuilder json(String path);
/**
* {@inheritDoc}
*/
@Override
ServerConfigBuilder json(URL url);
/**
* {@inheritDoc}
*/
@Override
ServerConfigBuilder yaml(ByteSource byteSource);
/**
* {@inheritDoc}
*/
@Override
ServerConfigBuilder yaml(Path path);
/**
* Adds the YAML file at the given path as a configuration source.
*
* If a base dir is set, the path will be resolved relative to it.
* Otherwise, it will be resolved relative to the file system root.
*
* @param path the path to the file
* @return {@code this}
*/
@Override
ServerConfigBuilder yaml(String path);
/**
* {@inheritDoc}
*/
@Override
ServerConfigBuilder yaml(URL url);
/**
* Declares that it is required that the server config provide an object of the given type at the given path.
*
* The {@link #build()} method will fail if the config is not able to provide the requested object.
*
* All objects declared using this method will also automatically be implicitly added to the base registry.
*
* The {@code pointer} argument is of the same format given to the {@link ConfigData#get(String, Class)} method.
*
{@code
* import org.junit.Assert;
* import ratpack.test.embed.EmbeddedApp;
*
* import java.util.Collections;
*
* public class Example {
* static class MyConfig {
* public String value;
* }
*
* public static void main(String... args) throws Exception {
* EmbeddedApp.of(a -> a
* .serverConfig(s -> s
* .props(Collections.singletonMap("config.value", "foo"))
* .require("/config", MyConfig.class)
* )
* .handlers(c -> c
* .get(ctx -> ctx.render(ctx.get(MyConfig.class).value))
* )
* ).test(httpClient ->
* Assert.assertEquals("foo", httpClient.getText())
* );
* }
* }
* }
*
* @param pointer a JSON Pointer specifying the point in the configuration data to bind from
* @param type the class of the type to bind to
* @return {@code this}
*/
ServerConfigBuilder require(String pointer, Class type);
/**
* Builds the server config.
*
* @return a server config
*/
@Override
ServerConfig build();
}