com.mesosphere.velocity.marathon.interfaces

Class MarathonBuilder

java.lang.Object

com.mesosphere.velocity.marathon.interfaces.MarathonBuilder

Direct Known Subclasses:

MarathonBuilderImpl

public abstract class MarathonBuilder
extends Object

This builds MarathonClients from Jenkins, file system, and JSON pieces. This allows the construction of the final payload as well as sending it to the target Marathon instance.

Constructor Summary

Constructors

Constructor and Description
MarathonBuilder()

Method Summary

Modifier and Type	Method and Description
abstract MarathonBuilder	build() Compose the builder.
static MarathonBuilder	getBuilder(AppConfig config) Create a new builder instance from config.
abstract net.sf.json.JSONObject	getJson()
abstract MarathonBuilder	read() Read in default file (marathon.json) as JSON.
abstract MarathonBuilder	read(String filename) Read in filename as JSON.
abstract MarathonBuilder	setConfig(AppConfig config) Set the Application Configuration to config.
abstract MarathonBuilder	setEnvVars(hudson.EnvVars vars) Set the Jenkins Environment Variables to vars.
abstract MarathonBuilder	setJson(net.sf.json.JSONObject json) Set the JSON for this builder to json.
abstract MarathonBuilder	setWorkspace(hudson.FilePath ws) Set the Jenkins workspace to ws.
abstract MarathonBuilder	toFile() Write the JSON that will be sent to the target Marathon instance to the default file (marathon-rendered-${BUILD_NUMBER}.json).
abstract MarathonBuilder	toFile(String filename) Write the JSON that will be sent to the target Marathon instance to filename.
abstract MarathonBuilder	update() Update the Marathon application.

Methods inherited from class java.lang.Object

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

Constructor Detail

MarathonBuilder

public MarathonBuilder()

Method Detail

getBuilder

public static MarathonBuilder getBuilder(AppConfig config)

Create a new builder instance from config.

Parameters:

config - Application configuration

Returns:

A new builder

update

public abstract MarathonBuilder update()
                                throws mesosphere.marathon.client.utils.MarathonException

Update the Marathon application.

Returns:

This builder

Throws:

mesosphere.marathon.client.utils.MarathonException

read

public abstract MarathonBuilder read(String filename)
                              throws IOException,
                                     InterruptedException,
                                     MarathonFileMissingException,
                                     MarathonFileInvalidException

Read in filename as JSON.

Parameters:

filename - Path to the JSON file

Returns:

This builder

Throws:

IOException

InterruptedException

MarathonFileMissingException

MarathonFileInvalidException

read

public abstract MarathonBuilder read()
                              throws IOException,
                                     InterruptedException,
                                     MarathonFileMissingException,
                                     MarathonFileInvalidException

Read in default file (marathon.json) as JSON.

Returns:

This builder

Throws:

IOException

InterruptedException

MarathonFileMissingException

MarathonFileInvalidException

See Also:

read(String)

setJson

public abstract MarathonBuilder setJson(net.sf.json.JSONObject json)

Set the JSON for this builder to json. This will overwrite the value set by read(String).

Parameters:

json - The JSON value to use for this builder

Returns:

This builder

getJson

public abstract net.sf.json.JSONObject getJson()

setEnvVars

public abstract MarathonBuilder setEnvVars(hudson.EnvVars vars)

Set the Jenkins Environment Variables to vars. These are used when building the final Marathon payload to convert Jenkins variables to their values.

Parameters:

vars - Jenkins environment variables

Returns:

This builder

setConfig

public abstract MarathonBuilder setConfig(AppConfig config)

Set the Application Configuration to config.

Parameters:

config - application configuration

Returns:

This builder

setWorkspace

public abstract MarathonBuilder setWorkspace(hudson.FilePath ws)

Set the Jenkins workspace to ws.

Parameters:

ws - Jenkins workspace

Returns:

This builder

build

public abstract MarathonBuilder build()

Compose the builder. This populates certain fields with the proper Jenkins values and creates a Marathon Client.

Returns:

This builder

See Also:

MarathonClient

toFile

public abstract MarathonBuilder toFile(String filename)
                                throws InterruptedException,
                                       MarathonFileInvalidException,
                                       IOException

Write the JSON that will be sent to the target Marathon instance to filename.

Parameters:

filename - File to write rendered JSON

Returns:

This builder

Throws:

InterruptedException

MarathonFileInvalidException

IOException

toFile

public abstract MarathonBuilder toFile()
                                throws InterruptedException,
                                       IOException,
                                       MarathonFileInvalidException

Write the JSON that will be sent to the target Marathon instance to the default file (marathon-rendered-${BUILD_NUMBER}.json).

Returns:

This builder

Throws:

InterruptedException

IOException

MarathonFileInvalidException

See Also:

toFile(String)