Package org.projectnessie.api.v1.http
Interface HttpContentApi
-
- All Superinterfaces:
ContentApi
@Consumes("application/json") @Path("contents") public interface HttpContentApi extends ContentApi
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description ContentgetContent(ContentKey key, java.lang.String ref, java.lang.String hashOnRef)GetMultipleContentsResponsegetMultipleContents(java.lang.String ref, java.lang.String hashOnRef, GetMultipleContentsRequest request)Similar toContentApi.getContent(ContentKey, String, String), but takes multipleContentKeys and returns theContentfor the one or moreContentKeys in a named-reference (aBranchorTag).
-
-
-
Method Detail
-
getContent
@GET @Produces("application/json") @Path("{key}") Content getContent(@PathParam("key") ContentKey key, @QueryParam("ref") java.lang.String ref, @QueryParam("hashOnRef") java.lang.String hashOnRef) throws NessieNotFoundExceptionDescription copied from interface:ContentApiThis operation returns theContentfor aContentKeyin a named-reference (aBranchorTag).If the table-metadata is tracked globally (Iceberg), Nessie returns a
Contentobject, that contains the most up-to-date part for the globally tracked part (Iceberg: table-metadata) plus the per-Nessie-reference/hash specific part (Iceberg: snapshot-ID, schema-ID, partition-spec-ID, default-sort-order-ID).- Specified by:
getContentin interfaceContentApi- Parameters:
key- theContentKeys to retrieveref- named-reference to retrieve the content forhashOnRef- hash onrefto retrieve the content for, translates toHEAD, if missing/null- Returns:
- list of
GetMultipleContentsResponse.ContentWithKeys - Throws:
NessieNotFoundException- ifreforhashOnRefdoes not exist
-
getMultipleContents
@POST @Produces("application/json") @Consumes("application/json") GetMultipleContentsResponse getMultipleContents(@QueryParam("ref") java.lang.String ref, @QueryParam("hashOnRef") java.lang.String hashOnRef, GetMultipleContentsRequest request) throws NessieNotFoundExceptionDescription copied from interface:ContentApiSimilar toContentApi.getContent(ContentKey, String, String), but takes multipleContentKeys and returns theContentfor the one or moreContentKeys in a named-reference (aBranchorTag).If the table-metadata is tracked globally (Iceberg), Nessie returns a
Contentobject, that contains the most up-to-date part for the globally tracked part (Iceberg: table-metadata) plus the per-Nessie-reference/hash specific part (Iceberg: snapshot-id, schema-id, partition-spec-id, default-sort-order-id).- Specified by:
getMultipleContentsin interfaceContentApi- Parameters:
ref- named-reference to retrieve the content forhashOnRef- hash onrefto retrieve the content for, translates toHEAD, if missing/nullrequest- theContentKeys to retrieve- Returns:
- list of
GetMultipleContentsResponse.ContentWithKeys - Throws:
NessieNotFoundException- ifreforhashOnRefdoes not exist
-
-