io.swagger.oas.annotations.servers

Annotation Type Server

@Target(value=FIELD)
 @Retention(value=RUNTIME)
 @Inherited
public @interface Server

An object representing a Server.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
String	description An optional string describing the host designated by the URL.
String	url Required.
ServerVariable[]	variables An array of variables used for substitution in the server's URL template.

Element Detail

url

public abstract String url

Required. A URL to the target host. This URL supports Server Variables and may be relative, to indicate that the host location is relative to the location where the OpenAPI definition is being served. Variable substitutions will be made when a variable is named in {brackets}.

Returns:

String url

Default:

""

description

public abstract String description

An optional string describing the host designated by the URL. CommonMark syntax MAY be used for rich text representation.

Returns:

String description

Default:

""

variables

public abstract ServerVariable[] variables

An array of variables used for substitution in the server's URL template.

Returns:

array of ServerVariables

Default:

{}