Package org.kohsuke.github

Class GHRepositoryVariableBuilder<S>

java.lang.Object

org.kohsuke.github.GHRepositoryVariableBuilder<S>

Type Parameters:

S - the type parameter

Direct Known Subclasses:

GHRepositoryVariable.Creator, GHRepositoryVariable.Setter

public class GHRepositoryVariableBuilder<S>
extends Object

The type Gh repository variable builder.

Field Summary

Fields

Modifier and Type	Field	Description
protected org.kohsuke.github.Requester	requester	The requester.
protected boolean	updateInPlace	The update in place.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	GHRepositoryVariableBuilder(Class<S> intermediateReturnType, GitHub root, GHRepositoryVariable baseInstance)	Instantiates a new GH Repository Variable builder.

Method Summary

Modifier and Type	Method	Description
protected S	continueOrDone()	Chooses whether to return a continuing builder or an updated data record If AbstractBuilder is the same as AbstractBuilder, this method will commit changes after the first value change and return a AbstractBuilder from done().
R	done()	Finishes an update, committing changes.
GitHub	getRoot()	Deprecated. For access to the GitHub instance, use a local copy instead of pulling it out of objects.
S	name(String value)	Name.
S	value(String value)	Name.
protected S	with(String name, Object value)	Applies a value to a name for this builder.

Methods inherited from class java.lang.Object

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

Field Detail

requester

@Nonnull
protected final org.kohsuke.github.Requester requester

The requester.

updateInPlace

protected boolean updateInPlace

The update in place.

Constructor Detail

GHRepositoryVariableBuilder

protected GHRepositoryVariableBuilder(@Nonnull
                                      Class<S> intermediateReturnType,
                                      @Nonnull
                                      GitHub root,
                                      @CheckForNull
                                      GHRepositoryVariable baseInstance)

Instantiates a new GH Repository Variable builder.

Parameters:

intermediateReturnType - Intermediate return type for this builder returned by calls to with(String, Object). If GHRepositoryVariableBuilder the same as GHRepositoryVariable, this builder will commit changes after each call to with(String, Object).

root - the GitHub instance to which updates will be sent

baseInstance - instance on which to base this builder. If null a new instance will be created.

Method Detail

name

@Nonnull
@BetaApi
public S name(String value)
       throws IOException

Name.

Parameters:

value - the value

Returns:

the s

Throws:

IOException - Signals that an I/O exception has occurred.

value

@Nonnull
@BetaApi
public S value(String value)
        throws IOException

Name.

Parameters:

value - the value

Returns:

the s

Throws:

IOException - Signals that an I/O exception has occurred.

done

@Nonnull
@BetaApi
public R done()
       throws IOException

Finishes an update, committing changes. This method may update-in-place or not. Either way it returns the resulting instance.

Returns:

an instance with updated current data

Throws:

IOException - if there is an I/O Exception

with

@Nonnull
@BetaApi
protected S with(@Nonnull
                 String name,
                 Object value)
          throws IOException

Applies a value to a name for this builder. If AbstractBuilder is the same as AbstractBuilder, this method will commit changes after the first value change and return a AbstractBuilder from done(). If AbstractBuilder is not the same as AbstractBuilder, this method will return an AbstractBuilder and letting the caller batch together multiple changes and call done() when they are ready.

Parameters:

name - the name of the field

value - the value of the field

Returns:

either a continuing builder or an updated data record

Throws:

IOException - if an I/O error occurs

continueOrDone

@Nonnull
@BetaApi
protected S continueOrDone()
                    throws IOException

Chooses whether to return a continuing builder or an updated data record If AbstractBuilder is the same as AbstractBuilder, this method will commit changes after the first value change and return a AbstractBuilder from done(). If AbstractBuilder is not the same as AbstractBuilder, this method will return an AbstractBuilder and letting the caller batch together multiple changes and call done() when they are ready.

Returns:

either a continuing builder or an updated data record

Throws:

IOException - if an I/O error occurs

getRoot

@Deprecated
public GitHub getRoot()

Deprecated.

For access to the GitHub instance, use a local copy instead of pulling it out of objects.

Get the root GitHub instance for this object.

Returns:

the root GitHub instance