Annotation Type BodyParam


@Retention(RUNTIME) @Target(PARAMETER) public @interface BodyParam
Annotation to annotate a parameter to send to a REST endpoint as HTTP Request content.

If the parameter type extends InputStream, this payload is streamed to server through "application/octet-stream". Otherwise, the body is serialized first and sent as "application/json" or "application/xml", based on the serializer.

Example 1: Put JSON

@Put("subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/"
    + "virtualMachines/{vmName}")
VirtualMachine createOrUpdate(@PathParam("resourceGroupName") String rgName,
    @PathParam("vmName") String vmName,
    @PathParam("subscriptionId") String subscriptionId,
    @BodyParam("application/json") VirtualMachine vm);

Example 2: Stream

@Post("formdata/stream/uploadfile")
void uploadFileViaBody(@BodyParam("application/octet-stream") FileInputStream fileContent);
  • Required Element Summary

    Required Elements
    Modifier and Type
    Required Element
    Description
    Gets the Content-Type for the body.
  • Element Details

    • value

      String value
      Gets the Content-Type for the body.
      Returns:
      The Content-Type for the body.