io.gatling.plugin.client.http

Class HttpEnterpriseClient

java.lang.Object

io.gatling.plugin.client.http.HttpEnterpriseClient

All Implemented Interfaces:

EnterpriseClient

public final class HttpEnterpriseClient
extends java.lang.Object
implements EnterpriseClient

Constructor Summary

Constructors

Constructor and Description
HttpEnterpriseClient(java.net.URL baseUrl, java.lang.String token, java.lang.String client, java.lang.String version, java.net.URL privateControlPlaneUrl)

Method Summary

Modifier and Type	Method and Description
boolean	abortRun(java.util.UUID runId)
Pkg	createPackage(java.lang.String packageName, java.util.UUID teamId)
Simulation	createSimulation(java.lang.String simulationName, java.util.UUID teamId, java.lang.String className, java.util.UUID pkgId, java.util.Map<java.lang.String,HostByLocation> hostsByLocation)
java.net.URL	getBaseUrl()
java.util.List<Series>	getConcurrentUserMetric(java.util.UUID runId, java.lang.String scenario)
Locations	getLocations()
Pkg	getPackage(java.util.UUID pkgId)
java.util.List<PkgIndex>	getPackages()
RequestsSummary	getRequestsSummary(java.util.UUID runId)
RunInformation	getRunInformation(java.util.UUID runId)
ServerInformation	getServerInformation()
Simulation	getSimulation(java.util.UUID simulationId)
java.util.List<Simulation>	getSimulations()
java.util.List<Team>	getTeams()
RunSummary	startSimulation(java.util.UUID simulationId, java.util.Map<java.lang.String,java.lang.String> systemProperties, java.util.Map<java.lang.String,java.lang.String> environmentVariables)
SimulationClassName	updateSimulationClassName(java.util.UUID simulationId, java.lang.String className)
long	uploadPackage(java.util.UUID packageId, java.io.File file)
long	uploadPackageWithChecksum(java.util.UUID packageId, java.io.File file)

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpEnterpriseClient

public HttpEnterpriseClient(java.net.URL baseUrl,
                            java.lang.String token,
                            java.lang.String client,
                            java.lang.String version,
                            java.net.URL privateControlPlaneUrl)
                     throws EnterprisePluginException

Parameters:

baseUrl - Base URL for the Gatling Enterprise server, e.g. https://cloud.gatling.io

token - Authentication token used to access the public API

client - Name of the calling client, used to verify if it is supported by the API

version - Version of the calling client, used to verify if it is supported by the API

privateControlPlaneUrl - (optional) Base URL for a Gatling Enterprise private control plane providing a private repository. If this parameter is provided, packages will be registered as private packages and uploaded through this private control plane.

Throws:

EnterprisePluginException

Method Detail

getBaseUrl

public java.net.URL getBaseUrl()

Specified by:

getBaseUrl in interface EnterpriseClient

getServerInformation

public ServerInformation getServerInformation()
                                       throws EnterprisePluginException

Specified by:

getServerInformation in interface EnterpriseClient

Throws:

EnterprisePluginException

getSimulations

public java.util.List<Simulation> getSimulations()
                                          throws EnterprisePluginException

Specified by:

getSimulations in interface EnterpriseClient

Throws:

EnterprisePluginException

getSimulation

public Simulation getSimulation(java.util.UUID simulationId)
                         throws EnterprisePluginException

Specified by:

getSimulation in interface EnterpriseClient

Throws:

EnterprisePluginException

getTeams

public java.util.List<Team> getTeams()
                              throws EnterprisePluginException

Specified by:

getTeams in interface EnterpriseClient

Throws:

EnterprisePluginException

getLocations

public Locations getLocations()
                       throws EnterprisePluginException

Specified by:

getLocations in interface EnterpriseClient

Throws:

EnterprisePluginException

getPackages

public java.util.List<PkgIndex> getPackages()
                                     throws EnterprisePluginException

Specified by:

getPackages in interface EnterpriseClient

Throws:

EnterprisePluginException

getPackage

public Pkg getPackage(java.util.UUID pkgId)
               throws EnterprisePluginException

Specified by:

getPackage in interface EnterpriseClient

Throws:

EnterprisePluginException

uploadPackage

public long uploadPackage(java.util.UUID packageId,
                          java.io.File file)
                   throws EnterprisePluginException

Specified by:

uploadPackage in interface EnterpriseClient

Parameters:

packageId - Required

file - Required path to the packaged JAR file to upload; required

Throws:

PackageNotFoundException - if the packageId does not exist

EnterprisePluginException

startSimulation

public RunSummary startSimulation(java.util.UUID simulationId,
                                  java.util.Map<java.lang.String,java.lang.String> systemProperties,
                                  java.util.Map<java.lang.String,java.lang.String> environmentVariables)
                           throws EnterprisePluginException

Specified by:

startSimulation in interface EnterpriseClient

Parameters:

simulationId - Required

systemProperties - Required (can be an empty map)

environmentVariables - Required (can be an empty map)

Throws:

SimulationStartException - when start failed for any reason

EnterprisePluginException

uploadPackageWithChecksum

public long uploadPackageWithChecksum(java.util.UUID packageId,
                                      java.io.File file)
                               throws EnterprisePluginException

Specified by:

uploadPackageWithChecksum in interface EnterpriseClient

Parameters:

packageId - Required

file - Required

Returns:

file size if uploaded, -1 when checksum are equals

Throws:

EnterprisePluginException

updateSimulationClassName

public SimulationClassName updateSimulationClassName(java.util.UUID simulationId,
                                                     java.lang.String className)
                                              throws EnterprisePluginException

Specified by:

updateSimulationClassName in interface EnterpriseClient

Parameters:

simulationId - Required

className - Required

Returns:

updated simulation

Throws:

EnterprisePluginException

createSimulation

public Simulation createSimulation(java.lang.String simulationName,
                                   java.util.UUID teamId,
                                   java.lang.String className,
                                   java.util.UUID pkgId,
                                   java.util.Map<java.lang.String,HostByLocation> hostsByLocation)
                            throws EnterprisePluginException

Specified by:

createSimulation in interface EnterpriseClient

Throws:

EnterprisePluginException

createPackage

public Pkg createPackage(java.lang.String packageName,
                         java.util.UUID teamId)
                  throws EnterprisePluginException

Specified by:

createPackage in interface EnterpriseClient

Throws:

EnterprisePluginException

getRunInformation

public RunInformation getRunInformation(java.util.UUID runId)
                                 throws EnterprisePluginException

Specified by:

getRunInformation in interface EnterpriseClient

Parameters:

runId - Required

Returns:

Information on the requested run

Throws:

RunNotFoundException - if the runId does not exist

EnterprisePluginException

getConcurrentUserMetric

public java.util.List<Series> getConcurrentUserMetric(java.util.UUID runId,
                                                      java.lang.String scenario)
                                               throws EnterprisePluginException

Specified by:

getConcurrentUserMetric in interface EnterpriseClient

Parameters:

runId - Required

scenario - Required

Throws:

EnterprisePluginException

getRequestsSummary

public RequestsSummary getRequestsSummary(java.util.UUID runId)
                                   throws EnterprisePluginException

Specified by:

getRequestsSummary in interface EnterpriseClient

Parameters:

runId - Required

Throws:

EnterprisePluginException

abortRun

public boolean abortRun(java.util.UUID runId)
                 throws EnterprisePluginException

Specified by:

abortRun in interface EnterpriseClient

Parameters:

runId - Required

Returns:

false if there was no run to abort (run does not exist or is already stopped)

Throws:

EnterprisePluginException