retrofit2.http

Annotation Type Part

@Documented
 @Target(value=PARAMETER)
 @Retention(value=RUNTIME)
public @interface Part

Denotes a single part of a multi-part request.

The parameter type on which this annotation exists will be processed in one of three ways:

• If the type is MultipartBody.Part the contents will be used directly. Omit the name from the annotation (i.e., @Part MultipartBody.Part part).
• If the type is RequestBody the value will be used directly with its content type. Supply the part name in the annotation (e.g., @Part("foo") RequestBody foo).
• Other object types will be converted to an appropriate representation by using a converter. Supply the part name in the annotation (e.g., @Part("foo") Image photo).

Values may be null which will omit them from the request body.

 @Multipart
 @POST("/")
 Call<ResponseBody> example(
     @Part("description") String description,
     @Part(value = "image", encoding = "8-bit") RequestBody image);
 

Part parameters may not be null.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
String	encoding The Content-Transfer-Encoding of this part.
String	value The name of the part.

Element Detail

value

public abstract String value

The name of the part. Required for all parameter types except MultipartBody.Part.

Default:

""

encoding

public abstract String encoding

The Content-Transfer-Encoding of this part.

Default:

"binary"