org.sonar.api.platform

Class Server

java.lang.Object

org.sonar.api.platform.Server

@ScannerSide
 @ServerSide
 @ComputeEngineSide
public abstract class Server
extends Object

Runtime information about server

Since:

2.2

Constructor Summary

Constructors

Constructor and Description
Server()

Method Summary

Modifier and Type	Method and Description
abstract String	getContextPath() Context path of web server.
abstract String	getId() UUID identifying the installation.
abstract String	getPermanentServerId() Deprecated. replaced by getId() in 6.7.
abstract String	getPublicRootUrl() Return the public root url, for instance : https://nemo.sonarqube.org.
abstract File	getRootDir() Deprecated. in 6.0. Replaced by ServerFileSystem.getHomeDir()
abstract Date	getStartedAt() Date when server started.
abstract String	getURL() Deprecated. since 6.5, please use getPublicRootUrl() instead
abstract String	getVersion() Non-null version of SonarQube at runtime
abstract boolean	isDev() Deprecated. in 6.6
abstract boolean	isSecured() Deprecated. since 5.6, use instead HttpServletRequest.getHeader(String) and check that X-Forwarded-Proto header is set to "https".

Methods inherited from class java.lang.Object

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

Constructor Detail

Server

public Server()

Method Detail

getId

public abstract String getId()

UUID identifying the installation. It is persisted so that it does not change over time, even after a restart. In the context of cluster, the value is shared by all the nodes.

Returns:

a non-null UUID. Format can change over versions.

getPermanentServerId

@Deprecated
public abstract String getPermanentServerId()

Deprecated. replaced by getId() in 6.7.

Since 6.7, it returns exactly getId(). In previous versions it returned ab UUID generated on demand by system administrators and may be null.

Since:

2.10

getVersion

public abstract String getVersion()

Non-null version of SonarQube at runtime

getStartedAt

public abstract Date getStartedAt()

Date when server started. In the context of cluster, this is the date of the startup of the first node. Value is the same on all cluster nodes.

getRootDir

@Deprecated
public abstract File getRootDir()

Deprecated. in 6.0. Replaced by ServerFileSystem.getHomeDir()

Returns:

an existing directory in server and CE environments, null in scanner.

getContextPath

public abstract String getContextPath()

Context path of web server. Value is blank "" by default. When defined by the property sonar.web.context of conf/sonar.properties, then value starts but does not end with slash '/', for instance "/sonarqube".

Returns:

non-null but possibly blank path

getPublicRootUrl

public abstract String getPublicRootUrl()

Return the public root url, for instance : https://nemo.sonarqube.org. Default value is CoreProperties.SERVER_BASE_URL_DEFAULT_VALUE

Since:

5.4

isDev

@Deprecated
public abstract boolean isDev()

Deprecated. in 6.6

Before version 6.6, the dev mode is enabled when the property sonar.web.dev is true. Since 6.6, false is always returned.

Since:

5.4

isSecured

@Deprecated
public abstract boolean isSecured()

Deprecated. since 5.6, use instead HttpServletRequest.getHeader(String) and check that X-Forwarded-Proto header is set to "https".

Return whether or not the {#getPublicRootUrl} is started with https.

Since:

5.4

getURL

@Deprecated
public abstract String getURL()

Deprecated. since 6.5, please use getPublicRootUrl() instead

Returns:

the server URL

Since:

since 2.4 on batch side only, since 5.6 on both batch side and server side (WebServer and Compute Engine)