/*
* Copyright 2015 Red Hat, Inc.
*
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* and Apache License v2.0 which accompanies this distribution.
*
* The Eclipse Public License is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* The Apache License v2.0 is available at
* http://www.opensource.org/licenses/apache2.0.php
*
* You may elect to redistribute this code under either of these licenses.
*
*
* Copyright (c) 2015 The original author or authors
* ------------------------------------------------------
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* and Apache License v2.0 which accompanies this distribution.
*
* The Eclipse Public License is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* The Apache License v2.0 is available at
* http://www.opensource.org/licenses/apache2.0.php
*
* You may elect to redistribute this code under either of these licenses.
*
*/
package io.vertx.ext.shell;
import io.vertx.codegen.annotations.DataObject;
import io.vertx.core.json.JsonObject;
import java.io.ByteArrayOutputStream;
import java.io.InputStream;
The configurations options for the shell server.
Author: Julien Viet
/**
* The configurations options for the shell server.
*
* @author <a href="mailto:julien@julienviet.com">Julien Viet</a>
*/
@DataObject(generateConverter = true)
public class ShellServerOptions {
Default of how often, in ms, to check for expired sessions
/**
* Default of how often, in ms, to check for expired sessions
*/
public static final long DEFAULT_REAPER_INTERVAL = 1000;
Default time, in ms, that a shell session lasts for without being accessed before expiring.
/**
* Default time, in ms, that a shell session lasts for without being accessed before expiring.
*/
public static final long DEFAULT_SESSION_TIMEOUT = 30 * 60 * 1000; // 30 minutes
public static final String DEFAULT_WELCOME_MESSAGE;
static {
String welcome = "Welcome to Vert.x Shell";
InputStream resource = ShellServerOptions.class.getResourceAsStream("vertx-banner.txt");
if (resource != null) {
try(InputStream in = resource) {
ByteArrayOutputStream tmp = new ByteArrayOutputStream();
byte[] buf = new byte[256];
while (true) {
int len = in.read(buf);
if (len == -1) {
break;
}
tmp.write(buf, 0, len);
}
welcome = tmp.toString();
} catch (Exception ignore) {
// Could not load
}
}
DEFAULT_WELCOME_MESSAGE = welcome + "\n\n";
}
private String welcomeMessage;
private long sessionTimeout;
private long reaperInterval;
public ShellServerOptions() {
welcomeMessage = DEFAULT_WELCOME_MESSAGE;
sessionTimeout = DEFAULT_SESSION_TIMEOUT;
reaperInterval = DEFAULT_REAPER_INTERVAL;
}
public ShellServerOptions(ShellServerOptions that) {
welcomeMessage = that.welcomeMessage;
sessionTimeout = that.sessionTimeout;
reaperInterval = that.reaperInterval;
}
public ShellServerOptions(JsonObject json) {
this();
ShellServerOptionsConverter.fromJson(json, this);
}
Returns: the shell welcome message
/**
* @return the shell welcome message
*/
public String getWelcomeMessage() {
return welcomeMessage;
}
Set the shell welcome message, i.e the message displayed in the user console when he connects to the shell.
Params: - welcomeMessage – the welcome message
Returns: a reference to this, so the API can be used fluently
/**
* Set the shell welcome message, i.e the message displayed in the user console when he connects to the shell.
*
* @param welcomeMessage the welcome message
* @return a reference to this, so the API can be used fluently
*/
public ShellServerOptions setWelcomeMessage(String welcomeMessage) {
this.welcomeMessage = welcomeMessage;
return this;
}
Returns: the session timeout
/**
* @return the session timeout
*/
public long getSessionTimeout() {
return sessionTimeout;
}
Set the session timeout.
Params: - sessionTimeout – the new session timeout
Returns: a reference to this, so the API can be used fluently
/**
* Set the session timeout.
*
* @param sessionTimeout the new session timeout
* @return a reference to this, so the API can be used fluently
*/
public ShellServerOptions setSessionTimeout(long sessionTimeout) {
this.sessionTimeout = sessionTimeout;
return this;
}
Returns: the reaper interval
/**
* @return the reaper interval
*/
public long getReaperInterval() {
return reaperInterval;
}
Set the repear interval, i.e the period at which session eviction is performed.
Params: - reaperInterval – the new repeat interval
Returns: a reference to this, so the API can be used fluently
/**
* Set the repear interval, i.e the period at which session eviction is performed.
*
* @param reaperInterval the new repeat interval
* @return a reference to this, so the API can be used fluently
*/
public ShellServerOptions setReaperInterval(long reaperInterval) {
this.reaperInterval = reaperInterval;
return this;
}
}