filmov
tv
Retrofit Tutorial — How to Upload Files to Server
Показать описание
In this video you'll learn how to upload files to a server with Retrofit.
Tip: turn on subtitles to deal with my accent. A shortened transcript is also available below.
Find the tutorial for an easy read here:
Watch 20+ Retrofit videos in our playlist here:
----------------------------------------
Our book on Retrofit is also available on leanpub:
----------------------------------------
Checkout 320+ technical in-depth tutorials:
Subscribe for two new videos every week:
----------------------------------------
Follow us on social media to get updates on new content:
----------------------------------------
In this video we will look at so-called multi-part requests, which is more or less a fancy word for file upload requests. Once you have seen a bit of theory behind multi-part requests you'll create them this Retrofit. Specifically we will implement an app which let's the user upload photos with the description to the server. We start at the beginning and we will look at every necessary step to upload files from an Android app.
You will learn about new annotations like @MultiPart and @Part. You'll also get to know the request and response body classes and finally OkHttp's MultipartBody.Part class Multi-part requests are HTTP requests which are usually used if you're trying to send files to the server.
The file can be audio, video, photo, or any kind of binary data. As always when implementing a new endpoint with Retrofit we will start with describing the endpoint in the interface class. You're going to add an additional endpoint to upload a file. When you're sending data even if it's files, it needs to be POST or PUT request. We can do that with the @MultiPart annotation. Retrofit now knows that this request is multi-part request.
In our demo case we will simply send a description and a photo file. Consequently, we need to annotate every parameter with @Part annotation. That's not enough, we also need to specify what types the parameters are. Finally the @Part annotation offers you to name the part and set the encoding.
As with any other Retrofit request you can pass null values if something should be emitted from the request. If the user doesn't have a description you can simply pass null. This would also work for the photo parameter even though this upload endpoint wouldn't make much sense then.
The final thing you have to add is a return type. This really depends on the API and use case. In our demo API you won't return anything meaningful. So we just keep it unspecific with the ResponseBody class. You won't get any typed Java objects but you can still access general information like the status code or also the response body itself as a string.
Our main activity only has a bunch of code to deal with the permissions, file selection in views. The interesting part is the uploadFile method, which takes the file URI. Basically this function gets called when the user gave all the permissions and selected a file to upload.
First up is a string description of the photo. As we have specified in the API endpoint description we need to create and pass the RequestBody object. The RequestBody class offers a static create() method, which we'll use now.The first parameter is the media type of the RequestBody This needs to be multipart-form when sending additional data along with the file.
The second parameter is our file. This is a two-step process. First, we're also creating a RequestBody for the file again using the RequestBody. create() method. This time the first parameter is actually the content type of the file. We will use a ContentResolver to get the type dynamically and then parse the content type in OkHttp's media type. Getting a file object from a file URI surprisingly difficult and really depends on a variety of things like Android OS version, phone model, and so on. I'm using a FileUtils class.
Last, but not least, we will pass a file part object.
In future videos we will show you how you can upload multiple files and how to set more than just one description.
Tip: turn on subtitles to deal with my accent. A shortened transcript is also available below.
Find the tutorial for an easy read here:
Watch 20+ Retrofit videos in our playlist here:
----------------------------------------
Our book on Retrofit is also available on leanpub:
----------------------------------------
Checkout 320+ technical in-depth tutorials:
Subscribe for two new videos every week:
----------------------------------------
Follow us on social media to get updates on new content:
----------------------------------------
In this video we will look at so-called multi-part requests, which is more or less a fancy word for file upload requests. Once you have seen a bit of theory behind multi-part requests you'll create them this Retrofit. Specifically we will implement an app which let's the user upload photos with the description to the server. We start at the beginning and we will look at every necessary step to upload files from an Android app.
You will learn about new annotations like @MultiPart and @Part. You'll also get to know the request and response body classes and finally OkHttp's MultipartBody.Part class Multi-part requests are HTTP requests which are usually used if you're trying to send files to the server.
The file can be audio, video, photo, or any kind of binary data. As always when implementing a new endpoint with Retrofit we will start with describing the endpoint in the interface class. You're going to add an additional endpoint to upload a file. When you're sending data even if it's files, it needs to be POST or PUT request. We can do that with the @MultiPart annotation. Retrofit now knows that this request is multi-part request.
In our demo case we will simply send a description and a photo file. Consequently, we need to annotate every parameter with @Part annotation. That's not enough, we also need to specify what types the parameters are. Finally the @Part annotation offers you to name the part and set the encoding.
As with any other Retrofit request you can pass null values if something should be emitted from the request. If the user doesn't have a description you can simply pass null. This would also work for the photo parameter even though this upload endpoint wouldn't make much sense then.
The final thing you have to add is a return type. This really depends on the API and use case. In our demo API you won't return anything meaningful. So we just keep it unspecific with the ResponseBody class. You won't get any typed Java objects but you can still access general information like the status code or also the response body itself as a string.
Our main activity only has a bunch of code to deal with the permissions, file selection in views. The interesting part is the uploadFile method, which takes the file URI. Basically this function gets called when the user gave all the permissions and selected a file to upload.
First up is a string description of the photo. As we have specified in the API endpoint description we need to create and pass the RequestBody object. The RequestBody class offers a static create() method, which we'll use now.The first parameter is the media type of the RequestBody This needs to be multipart-form when sending additional data along with the file.
The second parameter is our file. This is a two-step process. First, we're also creating a RequestBody for the file again using the RequestBody. create() method. This time the first parameter is actually the content type of the file. We will use a ContentResolver to get the type dynamically and then parse the content type in OkHttp's media type. Getting a file object from a file URI surprisingly difficult and really depends on a variety of things like Android OS version, phone model, and so on. I'm using a FileUtils class.
Last, but not least, we will pass a file part object.
In future videos we will show you how you can upload multiple files and how to set more than just one description.
0:34:49
The Ultimate Retrofit Crash Course
0:09:18
Android Retrofit Tutorial Using Kotlin 2023 | Getting JSON Response From Api Using Retrofit Kotlin
0:53:37
Retrofit Android Tutorial - Make API Calls
0:16:40
Retrofit Tutorial #1 - Basic Concepts [Retrofit with Android Studio]
0:03:41
Flutter Rest API - Simplifying Make API Call Using Retrofit
0:29:34
Retrofit Android Tutorial for Beginners with Kotlin
0:12:56
Getting started with Retrofit | android studio | java
0:11:59
Retrofit Tutorial — Getting Started and Creating an Android Client
0:02:59
MaxLite Flat Panel Retrofit Kit (FPR Series) - Installation Video
0:11:23
Android Retrofit Tutorial With Coroutines in Hindi | CheezyCode - #17
0:16:24
KOTLIN Retrofit Tutorial | Part 1 | Simple GET Request | For Beginners | Easiest Way to API Call
0:00:16
Retrofit Android Tutorial : Example of Retrofit 2.0 capturing JSON Array and JSON Object from URL
0:12:37
Retrofit - Send a simple GET Request | Android Studio Tutorial
0:29:06
Retrofit Tutorial #1 - GET Simple JSON [Retrofit with Android Studio]
0:31:17
Retrofit Tutorial #6 - POST in Retrofit - [Retrofit Course]
0:13:13
Retrofit Part - 1 in Tamil | What is Retrofit in Tamil
0:11:42
Retrofit Tutorial #4 - Parsing JSON from Array using Retrofit - [Movie App 2]
0:15:59
Retrofit android studio tutorial how to call API using Retrofit in android example in Hindi
0:14:39
Retrofit android studio kotlin tutorial how to call API using Retrofit in android example in Hindi
0:09:13
Retrofit Tutorial — Send Objects In Request Body
0:11:37
Retrofit Tutorial — Basics of API Description
0:18:46
#4 Kotlin Retrofit Tutorial - User Login
0:11:49
Retrofit Tutorial — How to Upload Files to Server
0:14:23
Retrofit Tutorial — Creating a Sustainable Android Client
Комментарии