Package org.projectnessie.client.http.v2api

Class HttpApiV2

java.lang.Object

org.projectnessie.client.http.v2api.HttpApiV2

All Implemented Interfaces:

java.lang.AutoCloseable, NessieApi, NessieApiV1, NessieApiV2

public class HttpApiV2
extends java.lang.Object
implements NessieApiV2

Constructor Summary

Constructors

Constructor	Description
HttpApiV2(HttpClient client)

Method Summary

Modifier and Type	Method	Description
AssignBranchBuilder	assignBranch()	Update a branch.
AssignReferenceBuilder	assignReference()	Update a branch or a tag (make it point to an arbitrary commit).
AssignTagBuilder	assignTag()	Update a tag.
void	close()
CommitMultipleOperationsBuilder	commitMultipleOperations()
CreateNamespaceBuilder	createNamespace()	Create a single Namespace.
CreateReferenceBuilder	createReference()	Create a new reference.
DeleteBranchBuilder	deleteBranch()	Delete a branch.
DeleteNamespaceBuilder	deleteNamespace()	Delete a single Namespace.
DeleteReferenceBuilder	deleteReference()	Delete a branch or a tag.
DeleteTagBuilder	deleteTag()	Delete a tag.
GetAllReferencesBuilder	getAllReferences()	Get all references.
GetCommitLogBuilder	getCommitLog()	Retrieve the commit log for a ref, potentially truncated by the backend.
org.projectnessie.model.NessieConfiguration	getConfig()	Get the server configuration.
GetContentBuilder	getContent()
org.projectnessie.model.Branch	getDefaultBranch()	Get details for the default reference.
GetDiffBuilder	getDiff()	Retrieve a diff between two references.
GetEntriesBuilder	getEntries()	Retrieve objects for a ref, potentially truncated by the backend.
GetMultipleNamespacesBuilder	getMultipleNamespaces()	Fetch one or more Namespaces based on a given prefix.
GetNamespaceBuilder	getNamespace()	Fetch a single Namespace.
GetReferenceBuilder	getReference()	Get details of a particular ref, if it exists.
GetRefLogBuilder	getRefLog()	Deprecated.
GetRepositoryConfigBuilder	getRepositoryConfig()
MergeReferenceBuilder	mergeRefIntoBranch()	merge mergeRef onto ref.
TransplantCommitsBuilder	transplantCommitsIntoBranch()	cherry pick a set of commits into a branch.
UpdateNamespaceBuilder	updateProperties()	Updates properties of a Namespace.
UpdateRepositoryConfigBuilder	updateRepositoryConfig()

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpApiV2

public HttpApiV2(HttpClient client)

Method Detail

close

public void close()

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface NessieApi

getConfig

public org.projectnessie.model.NessieConfiguration getConfig()

Description copied from interface: NessieApiV1

Get the server configuration.

Specified by:

getConfig in interface NessieApiV1

getDefaultBranch

public org.projectnessie.model.Branch getDefaultBranch()
                                                throws org.projectnessie.error.NessieNotFoundException

Description copied from interface: NessieApiV1

Get details for the default reference.

Specified by:

getDefaultBranch in interface NessieApiV1

Throws:

org.projectnessie.error.NessieNotFoundException

getContent

public GetContentBuilder getContent()

Specified by:

getContent in interface NessieApiV1

getAllReferences

public GetAllReferencesBuilder getAllReferences()

Description copied from interface: NessieApiV1

Get all references.

Specified by:

getAllReferences in interface NessieApiV1

createReference

public CreateReferenceBuilder createReference()

Description copied from interface: NessieApiV1

Create a new reference.

Specified by:

createReference in interface NessieApiV1

getReference

public GetReferenceBuilder getReference()

Description copied from interface: NessieApiV1

Get details of a particular ref, if it exists.

Specified by:

getReference in interface NessieApiV1

getEntries

public GetEntriesBuilder getEntries()

Description copied from interface: NessieApiV1

Retrieve objects for a ref, potentially truncated by the backend.

Retrieves up to maxRecords objects for the given named reference (tag or branch). The backend may respect the given max records hint, but return less or more entries. Backends may also cap the returned entries at a hard-coded limit, the default REST server implementation has such a hard-coded limit.

Invoking getEntries() does not guarantee to return all commit log entries of a given reference, because the result can be truncated by the backend.

To implement paging, check EntriesResponse.isHasMore() and, if true, pass the value of EntriesResponse.getToken() in the next invocation of getEntries() as the pageToken parameter.

Specified by:

getEntries in interface NessieApiV1

getCommitLog

public GetCommitLogBuilder getCommitLog()

Description copied from interface: NessieApiV1

Retrieve the commit log for a ref, potentially truncated by the backend.

Retrieves up to maxRecords commit-log-entries starting at the HEAD of the given named reference (tag or branch). The backend may respect the given max records hint, but return less or more entries. Backends may also cap the returned entries at a hard-coded limit, the default REST server implementation has such a hard-coded limit.

Invoking getCommitLog() does not guarantee to return all commit log entries of a given reference, because the result can be truncated by the backend.

To implement paging, check LogResponse.isHasMore() and, if true, pass the value of LogResponse.getToken() in the next invocation of getCommitLog() as the pageToken parameter.

Specified by:

getCommitLog in interface NessieApiV1

assignTag

public AssignTagBuilder assignTag()

Description copied from interface: NessieApiV2

Update a tag.

Specified by:

assignTag in interface NessieApiV1

Specified by:

assignTag in interface NessieApiV2

deleteTag

public DeleteTagBuilder deleteTag()

Description copied from interface: NessieApiV2

Delete a tag.

Specified by:

deleteTag in interface NessieApiV1

Specified by:

deleteTag in interface NessieApiV2

assignBranch

public AssignBranchBuilder assignBranch()

Description copied from interface: NessieApiV2

Update a branch.

Specified by:

assignBranch in interface NessieApiV1

Specified by:

assignBranch in interface NessieApiV2

deleteBranch

public DeleteBranchBuilder deleteBranch()

Description copied from interface: NessieApiV2

Delete a branch.

Specified by:

deleteBranch in interface NessieApiV1

Specified by:

deleteBranch in interface NessieApiV2

assignReference

public AssignReferenceBuilder assignReference()

Description copied from interface: NessieApiV2

Update a branch or a tag (make it point to an arbitrary commit).

Specified by:

assignReference in interface NessieApiV2

deleteReference

public DeleteReferenceBuilder deleteReference()

Description copied from interface: NessieApiV2

Delete a branch or a tag.

Specified by:

deleteReference in interface NessieApiV2

transplantCommitsIntoBranch

public TransplantCommitsBuilder transplantCommitsIntoBranch()

Description copied from interface: NessieApiV1

cherry pick a set of commits into a branch.

Specified by:

transplantCommitsIntoBranch in interface NessieApiV1

mergeRefIntoBranch

public MergeReferenceBuilder mergeRefIntoBranch()

Description copied from interface: NessieApiV1

merge mergeRef onto ref.

Specified by:

mergeRefIntoBranch in interface NessieApiV1

commitMultipleOperations

public CommitMultipleOperationsBuilder commitMultipleOperations()

Specified by:

commitMultipleOperations in interface NessieApiV1

getDiff

public GetDiffBuilder getDiff()

Description copied from interface: NessieApiV1

Retrieve a diff between two references.

Specified by:

getDiff in interface NessieApiV1

getRefLog

@Deprecated
public GetRefLogBuilder getRefLog()

Deprecated.

Description copied from interface: NessieApiV1

Retrieve the reflog from the HEAD of the RefLog resource, potentially truncated by the backend.

The Nessie reflog in this form is deprecated, likely for removal.

Retrieves up to maxRecords refLog-entries starting at the HEAD of the RefLog resource. The backend may respect the given max records hint, but return less or more entries. Backends may also cap the returned entries at a hard-coded limit, the default REST server implementation has such a hard-coded limit.

Invoking getRefLog() does not guarantee to return all reflog entries, because the result can be truncated by the backend.

To implement paging, check RefLogResponse.isHasMore() and, if true, pass the value of RefLogResponse.getToken() in the next invocation of getRefLog() as the pageToken parameter.

Specified by:

getRefLog in interface NessieApiV1

getNamespace

public GetNamespaceBuilder getNamespace()

Description copied from interface: NessieApiV1

Fetch a single Namespace.

Specified by:

getNamespace in interface NessieApiV1

getMultipleNamespaces

public GetMultipleNamespacesBuilder getMultipleNamespaces()

Description copied from interface: NessieApiV1

Fetch one or more Namespaces based on a given prefix.

Specified by:

getMultipleNamespaces in interface NessieApiV1

createNamespace

public CreateNamespaceBuilder createNamespace()

Description copied from interface: NessieApiV1

Create a single Namespace.

Specified by:

createNamespace in interface NessieApiV1

deleteNamespace

public DeleteNamespaceBuilder deleteNamespace()

Description copied from interface: NessieApiV1

Delete a single Namespace.

Specified by:

deleteNamespace in interface NessieApiV1

updateProperties

public UpdateNamespaceBuilder updateProperties()

Description copied from interface: NessieApiV1

Updates properties of a Namespace.

Specified by:

updateProperties in interface NessieApiV1

getRepositoryConfig

public GetRepositoryConfigBuilder getRepositoryConfig()

Specified by:

getRepositoryConfig in interface NessieApiV2

updateRepositoryConfig

public UpdateRepositoryConfigBuilder updateRepositoryConfig()

Specified by:

updateRepositoryConfig in interface NessieApiV2