Package org.projectnessie.api.v1

Interface NamespaceApi

All Known Subinterfaces:

HttpNamespaceApi

public interface NamespaceApi

Method Summary

Modifier and Type	Method	Description
Namespace	createNamespace(@NotNull @NotNull NamespaceParams params, @NotNull @NotNull Namespace namespace)	Creates a new namespace with Namespace properties.
void	deleteNamespace(@NotNull @NotNull NamespaceParams params)	Deletes the namespace if it doesn't contain any tables.
Namespace	getNamespace(@NotNull @NotNull NamespaceParams params)	Retrieves the Namespace instance if it exists.
GetNamespacesResponse	getNamespaces(@NotNull @NotNull MultipleNamespacesParams params)	Retrieves a list of Namespace instances that match a given namespace prefix.
void	updateProperties(@NotNull @NotNull NamespaceParams params, @NotNull @NotNull NamespaceUpdate namespaceUpdate)	Updates/removes properties for a given Namespace.

Method Details

createNamespace

Namespace createNamespace(@NotNull @NotNull
 @NotNull @NotNull NamespaceParams params,
 @NotNull @NotNull
 @NotNull @NotNull Namespace namespace)
                   throws NessieNamespaceAlreadyExistsException,
NessieReferenceNotFoundException

Creates a new namespace with Namespace properties.

Parameters:

params - The NamespaceParams that includes the parameters for the API call.

namespace - The instance including the namespace properties.

Returns:

A Namespace instance if creating the namespace succeeded.

Throws:

NessieReferenceNotFoundException - If the reference could not be found.

NessieNamespaceAlreadyExistsException - If the namespace already exists.

deleteNamespace

void deleteNamespace(@NotNull @NotNull
 @NotNull @NotNull NamespaceParams params)
              throws NessieReferenceNotFoundException,
NessieNamespaceNotEmptyException,
NessieNamespaceNotFoundException

Deletes the namespace if it doesn't contain any tables.

Parameters:

params - The NamespaceParams that includes the parameters for the API call.

Throws:

NessieReferenceNotFoundException - If the reference could not be found.

NessieNamespaceNotEmptyException - If the namespace is not empty and contains tables.

NessieNamespaceNotFoundException - If the namespace to be deleted could not be found.

getNamespace

Namespace getNamespace(@NotNull @NotNull
 @NotNull @NotNull NamespaceParams params)
                throws NessieNamespaceNotFoundException,
NessieReferenceNotFoundException

Retrieves the Namespace instance if it exists.

Parameters:

params - The NamespaceParams that includes the parameters for the API call.

Returns:

A Namespace instance if a namespace with the given name exists.

Throws:

NessieReferenceNotFoundException - If the reference could not be found.

NessieNamespaceNotFoundException - If the namespace does not exist.

getNamespaces

GetNamespacesResponse getNamespaces(@NotNull @NotNull
 @NotNull @NotNull MultipleNamespacesParams params)
                             throws NessieReferenceNotFoundException

Retrieves a list of Namespace instances that match a given namespace prefix.

Parameters:

params - The MultipleNamespacesParams that includes the parameters for the API call.

Returns:

A GetNamespacesResponse instance containing all the namespaces that match the given namespace prefix.

Throws:

NessieReferenceNotFoundException - If the reference could not be found.

updateProperties

void updateProperties(@NotNull @NotNull
 @NotNull @NotNull NamespaceParams params,
 @NotNull @NotNull
 @NotNull @NotNull NamespaceUpdate namespaceUpdate)
               throws NessieNamespaceNotFoundException,
NessieReferenceNotFoundException

Updates/removes properties for a given Namespace.

Parameters:

params - The NamespaceParams that includes the parameters for the API call.

namespaceUpdate - The instance including the property updates/deletes.

Throws:

NessieNamespaceNotFoundException - If the namespace does not exist.

NessieReferenceNotFoundException - If the reference could not be found.