Package org.projectnessie.api

Interface NamespaceApi

All Known Subinterfaces:

HttpNamespaceApi

public interface NamespaceApi

Method Summary

Modifier and Type	Method	Description
Namespace	createNamespace(@NotNull NamespaceParams params)	Creates a new namespace.
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.

Method Detail

createNamespace

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

Creates a new namespace.

Parameters:

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

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.