Package org.projectnessie.api.v1

Interface NamespaceApi

All Known Subinterfaces:

HttpNamespaceApi

public interface NamespaceApi

Method Summary

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

Method Detail

createNamespace

Namespace createNamespace(@NotNull
                          @NotNull NamespaceParams params,
                          @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 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 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 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 NamespaceParams params,
                      @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.