{"id":2194,"date":"2020-03-06T21:13:47","date_gmt":"2020-03-06T11:13:47","guid":{"rendered":"https:\/\/learntodroid.com\/?p=2194"},"modified":"2021-01-13T09:54:36","modified_gmt":"2021-01-12T23:54:36","slug":"how-to-send-json-data-in-a-post-request-in-android","status":"publish","type":"post","link":"http:\/\/10.0.0.14:32769\/how-to-send-json-data-in-a-post-request-in-android\/","title":{"rendered":"How to Send JSON Data in a POST Request in Android"},"content":{"rendered":"\n<p>Retrofit2 is a powerful HTTP client library developed by Square used in Android and Java development. I have put together a tutorial with code samples in Java covering how to send JSON data in a HTTP POST request within an Android app using Retrofit2. <\/p>\n\n\n\n<p>To send JSON data in a POST request in Android using Retrofit2 you need to complete the following steps.<\/p>\n\n\n\n<ol><li><strong>Obtain the dependencies for Retrofit2 using Gradle<\/strong><\/li><li><strong>Create the model for the API request and response<\/strong><\/li><li><strong>Create a Java interface representing the service and including Retrofit2 annotations<\/strong><\/li><li><strong>Set up the HTTP client using a singleton pattern within your app<\/strong><\/li><li><strong>Invoke the HTTP client generating the request and handling the response and errors<\/strong><\/li><li><strong>Configure the app manifest to give permission to access the internet<\/strong><\/li><\/ol>\n\n\n\n<p>Continue reading this post to deep dive into what Retrofit2 is and how it can be used to generate a POST request containing JSON data with code samples available in this article in Java.<\/p>\n\n\n\n<p>I have also added some information to the tutorial around an alternative approach for sending data in a POST request with Retrofit2 by using URL parameters instead of a JSON body inside the request.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Android HTTP JSON Body Post Request in Java Using Retrofit2 Example<\/h2>\n\n\n\n<p>We will be creating a very basic Android app for this tutorial to demonstrate how to make a HTTP POST request containing a JSON body using Retrofit2.<\/p>\n\n\n\n<p>Please see a screenshot of the Android app will be creating. The app contains a basic form that is used to capture a comment which is like something that you might see on a social media app or a news app with articles the public can comment on.<\/p>\n\n\n\n<p>As you can see it contains the following:<\/p>\n\n\n\n<ul><li>Three fields for capturing a Comment including a title, a body and an author<\/li><li>A radio button group containing three different options for creating the HTTP POST request using Retrofit2<\/li><li>And a button to send the HTTP POST request containing the data about the Comment<\/li><\/ul>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"414\" height=\"850\" src=\"http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Screenshot-of-Android-App-for-Creating-a-HTTP-Post-Request-1.png\" alt=\"\" class=\"wp-image-2253\" srcset=\"http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Screenshot-of-Android-App-for-Creating-a-HTTP-Post-Request-1.png 414w, http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Screenshot-of-Android-App-for-Creating-a-HTTP-Post-Request-1-146x300.png 146w\" sizes=\"(max-width: 414px) 100vw, 414px\" \/><\/figure><\/div>\n\n\n\n<p>I have uploaded the code for the Android app being created in this tutorial in GitHub &#8211; <a rel=\"noreferrer noopener\" aria-label=\" (opens in a new tab)\" href=\"https:\/\/github.com\/learntodroid\/PostRequestwithJSON\" target=\"_blank\">https:\/\/github.com\/learntodroid\/PostRequestwithJSON<\/a><\/p>\n\n\n\n<p>For the purposes of this tutorial I have written code for a very basic API using Python and the library Flask which is configured to respond with the same Comment sent to the API in POST request from the Android app.<\/p>\n\n\n\n<p>If you are interested in the code for the API written in Python using the Flask library it is also available on GitHub &#8211; <a rel=\"noreferrer noopener\" aria-label=\" (opens in a new tab)\" href=\"https:\/\/github.com\/learntodroid\/PostRequestFlaskApi\" target=\"_blank\">https:\/\/github.com\/learntodroid\/PostRequestFlaskApi<\/a><\/p>\n\n\n\n<p>If you want to run this API make sure you have Python and PyPi installed on your local machine where you are running the Android emulator and follow the brief instructions in the Readme to retrieve the dependencies for Flask and run the API.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Step 1: Obtaining the Retrofit2 Dependencies<\/h3>\n\n\n\n<p>In this tutorial we will be making use of various 3rd party libraries to simplify the effort required to integrate our Android app with an API to make a POST request.<\/p>\n\n\n\n<p>The 3rd party libraries we will use include Retrofit2, OkHttp3 and GSON. Each of the libraries will be retrieved into our Android project using Gradle.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Retrofit2<\/h4>\n\n\n\n<p>Retrofit2 is a HTTP client for Android and Java developed by Square which allows you to use a Java interface to simplify the process of integrating with a HTTP API.<\/p>\n\n\n\n<ul><li>Official docs &#8211; <a rel=\"noreferrer noopener\" aria-label=\" (opens in a new tab)\" href=\"https:\/\/square.github.io\/retrofit\/\" target=\"_blank\">https:\/\/square.github.io\/retrofit\/<\/a><\/li><li>Retrofit2 on GitHub &#8211; <a rel=\"noreferrer noopener\" aria-label=\" (opens in a new tab)\" href=\"https:\/\/github.com\/square\/retrofit\" target=\"_blank\">https:\/\/github.com\/square\/retrofit<\/a><\/li><\/ul>\n\n\n\n<p>To retrieve the Retrofit2 library using Gradle include the following implementation dependency inside your app&#8217;s build.gradle file (see a complete build.gradle file at the end of this section which covers all required dependencies). <\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">implementation <strong>'com.squareup.retrofit2:retrofit:2.7.1'<\/strong><\/pre>\n\n\n\n<p>Retrofit2 requires Java 8, to include Java 8 in an Android project, update your app&#8217;s build.gradle file to include compile options.<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">android {\n  compileOptions {\n    sourceCompatibility <strong>JavaVersion.VERSION_1_8<\/strong>\n    targetCompatibility <strong>JavaVersion.VERSION_1_8<\/strong>\n  }\n} <\/pre>\n\n\n\n<h4 class=\"wp-block-heading\">OkHttp3<\/h4>\n\n\n\n<p>OkHttp3 is a HTTP client for Java and Kotlin developed by Square.<\/p>\n\n\n\n<ul><li>Official docs &#8211; <a href=\"https:\/\/square.github.io\/okhttp\/\" target=\"_blank\" rel=\"noreferrer noopener\" aria-label=\" (opens in a new tab)\">https:\/\/square.github.io\/okhttp\/<\/a><\/li><li>OkHttp3 on GitHub &#8211; <a rel=\"noreferrer noopener\" aria-label=\" (opens in a new tab)\" href=\"https:\/\/github.com\/square\/okhttp\" target=\"_blank\">https:\/\/github.com\/square\/okhttp<\/a><\/li><\/ul>\n\n\n\n<p>For the purposes of this tutorial we will be using the logging interceptor included in the OkHttp3 library to give us visibility of the HTTP request and response logs for our Android app within Logcat. <\/p>\n\n\n\n<p>To get an idea of what we will be able to see in Logcat using the OkHttp3 logging interceptor, have a look at the screenshot below<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"969\" height=\"307\" src=\"http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Logcat-OkHttp3-Logging-Interceptor-Output.png\" alt=\"\" class=\"wp-image-2279\" srcset=\"http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Logcat-OkHttp3-Logging-Interceptor-Output.png 969w, http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Logcat-OkHttp3-Logging-Interceptor-Output-300x95.png 300w, http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Logcat-OkHttp3-Logging-Interceptor-Output-768x243.png 768w\" sizes=\"(max-width: 969px) 100vw, 969px\" \/><\/figure><\/div>\n\n\n\n<p>To retrieve the logging interceptor from the OkHttp3 library using Gradle include the following implementation dependency inside your app&#8217;s build.gradle file.<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">dependencies {\n<strong>    <\/strong>implementation <strong>'com.squareup.okhttp3:logging-interceptor:4.4.0'\n<\/strong>}<\/pre>\n\n\n\n<h4 class=\"wp-block-heading\">GSON<\/h4>\n\n\n\n<p>Gson is a Java library by Google that supports converting objects in Java into JSON format and back otherwise known as serialization and deserialization.<\/p>\n\n\n\n<ul><li>GSON on GitHub &#8211; <a rel=\"noreferrer noopener\" aria-label=\" (opens in a new tab)\" href=\"https:\/\/github.com\/google\/gson\" target=\"_blank\">https:\/\/github.com\/google\/gson<\/a><\/li><\/ul>\n\n\n\n<p>Retrofit2 has added support for different converters including GSON to support serialization and deserialization when handling an API&#8217;s request and response.<\/p>\n\n\n\n<p>To retrieve the GSON converter from the Retrofit2 library using Gradle include the following implementation dependency inside your app&#8217;s build.gradle file. <\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">dependencies {<strong>\n    <\/strong>implementation <strong>'com.squareup.retrofit2:converter-gson:2.7.1'\n<\/strong>}<\/pre>\n\n\n\n<p>The list of converters supported by Retrofit2 are:<\/p>\n\n\n\n<ul><li>Gson<\/li><li>Jackson<\/li><li>Moshi<\/li><li>Protobuf<\/li><li>Wire<\/li><li>SimpleXML<\/li><li>Scalars<\/li><\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Example &#8216;build.gradle&#8217; Containing Retrofit2, OkHttp3 &amp; GSON Dependencies<\/h4>\n\n\n\n<p>Please see the example build.gradle file covering all the dependencies highlighted in the section above.<\/p>\n\n\n<p><script src=\"https:\/\/gist.github.com\/learntodroid\/532f26658d55e6302a6f5322d8d0f2e6.js\"><\/script><\/p>\n\n\n<h3 class=\"wp-block-heading\">Step 2: Creating the Model for the API Request and Response<\/h3>\n\n\n\n<p>The comments we will capture in our Android app with contain three attributes entered by the user. These three attributes will all be strings and will contain the comment author, a title for the comment and a body for the comment.<\/p>\n\n\n\n<p>When we will be make a POST request to the API, we will use the GSON library to transform a Comment object into a JSON string (serialization) to send inside the body of the request.<\/p>\n\n\n\n<p>If the request was correctly formatted the API will request with the same JSON file we can then use GSON to transform that JSON string and transform it into a Comment object (deserialization).<\/p>\n\n\n\n<p>When building the model class, use the <em>@SerializedName(string)<\/em> annotation against each field to set the name of the attribute as it will appear in the JSON file. By default GSON will use the variable name in Java if there is no  <em>@SerializedName(string)<\/em> annotation provided.<\/p>\n\n\n\n<p>Please see the example class below containing the model for a comment.<\/p>\n\n\n<p><script src=\"https:\/\/gist.github.com\/learntodroid\/46538e24da6fd34d5e59d8b3a8a6b341.js\"><\/script><\/p>\n\n\n<h3 class=\"wp-block-heading\">Step 3: Creating a Java Interface for the API with Retrofit2<\/h3>\n\n\n\n<p>In this section of the tutorial we will be creating a Java interface and use the Retrofit2 library to add annotations to methods in the interface that will represent the operations exposed on the API.<\/p>\n\n\n\n<p>Please see the example Java interface using Retrofit2 annotations to describe the API will we be using to submit Comments.<\/p>\n\n\n<p><script src=\"https:\/\/gist.github.com\/learntodroid\/9371540df58f36a75a716fc283c8b7d2.js\"><\/script><\/p>\n\n\n<p>In this section we will focus the createComment(Comment) method defined on line 14.<\/p>\n\n\n\n<p>Line 13, contains both the request method and path that will be called on the API when the createComment(Comment) method is invoked. In this case we are using a POST request so we use the &#8220;@POST&#8221; Retrofit2 annotation. We will be sending the POST request to the &#8220;\/comments&#8221; end point on the API so  inside we pass the path as a parameter to the &#8220;@POST&#8221; annotation. <\/p>\n\n\n\n<p>The full list of request methods supported by Retrofit2 are:<\/p>\n\n\n\n<ul><li>GET<\/li><li>POST<\/li><li>PUT<\/li><li>PATCH<\/li><li>DELETE<\/li><li>HEAD<\/li><\/ul>\n\n\n\n<p>On line 14, we are defining the method for creating a comment and we are passing a @Body annotation with a Comment object as a parameter. Providing an @Body annotation with a Comment as a parameter indicates that we will be providing a request body when we invoke this API which in our case will be a JSON payload containing the details of the comment.<\/p>\n\n\n\n<p>The finally, the createComment(Comment) method returns a Call&lt;Comment&gt; object. This means that when we invoke the API to create the comment we expect to see a request body containing a JSON body that we will deserialize into a Comment object (in our case using Gson).<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Step 4: Setting Up the HTTP Client<\/h3>\n\n\n\n<p>In this part of the tutorial we will setting up access to the HTTP client using Retrofit2 inside a repository class that follows the singleton pattern. This will enable us in the next step of tutorial to retrieve the instance of the repository then invoke the API to create a comment.<\/p>\n\n\n\n<p>Please see the code below containing the CommentsRepository class which initialises the HTTP client using Retrofit2 inside the constructor.<\/p>\n\n\n<p><script src=\"https:\/\/gist.github.com\/learntodroid\/27bff18472f3d1c437e7dd1e30149c32.js\"><\/script><\/p>\n\n\n<p>Inside the constructor prior to setting up the API using Retrofit2 first we create an interceptor using the OkHttp3 library that we will use to allow us to log the HTTP request and responses inside Logcat. We create also use the OkHttp3 library for it&#8217;s HTTP client when interacting with the API.<\/p>\n\n\n\n<p>Using the Retrofit2 API builder we provide it with the base url of the API, we set the client to the OkHttp3 client and specify we will be using the Gson library for converting API request and response payloads.<\/p>\n\n\n\n<p>With regards to the base url, I have set it to use the host of &#8220;http:\/\/10.0.2.2&#8221; and the port number 5000. This is because I will use flask to run on it&#8217;s default port which is port 5000, and run it on the same host as where I am running the Android emulator.<\/p>\n\n\n\n<p>You cannot use &#8220;localhost&#8221; as the host for the Android emulator because as I learned in <a rel=\"noreferrer noopener\" aria-label=\"this helpful Stackoverflow answer (opens in a new tab)\" href=\"https:\/\/stackoverflow.com\/questions\/5528850\/how-do-you-connect-localhost-in-the-android-emulator\" target=\"_blank\">this helpful Stackoverflow answer<\/a> localhost on the Android emulator will point to the emulator&#8217;s own loopback service and you need to use &#8220;10.0.2.2&#8221; instead to access your local machine.<\/p>\n\n\n\n<p>And finally we create a reference to the web service using the interface of the API we defined in step 3.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Step 5: Invoking the API using Retrofit2<\/h3>\n\n\n\n<p>In this section of the tutorial for sending a JSON payload inside a POST request using Retrofit2 we will be creating our Activity that will invoke the API using Retrofit2.<\/p>\n\n\n\n<p>Please see the code below containing the CommentsActivity class which invokes the HTTP client with a POST request using Retrofit2 when the button is clicked. <\/p>\n\n\n<p><script src=\"https:\/\/gist.github.com\/learntodroid\/95e9716c4f679134d9e83c26068eaed8.js\"><\/script><\/p>\n\n\n<p>Inside the onCreate(Bundle) method we will get access to the single instance of the CommentsRepository which we will use in the OnClickListener assigned to the Button to generate a HTTP request to the Comments API.<\/p>\n\n\n\n<p>Inside the OnClickListener we first create the Comment object using the comment title, comment author and comment body captured by the use.<\/p>\n\n\n\n<p>Then using a switch statement check for which radio button was selected, in this section I will only cover the option sending the JSON payload which is defined in lines 55 &#8211; 66.<\/p>\n\n\n\n<p>To invoke the API we access the CommentService on the CommentRepository and call the createComment(Comment) method passing the Comment object we created based on the user input.<\/p>\n\n\n\n<p>We call the createComment(Comment) method using enqueue which allows use to define a callback method in case of either a response (defined in an onResponse method) or failure (defined in a onFailure method).<\/p>\n\n\n\n<p>In the onResponse method we expect to see a Comment object in the response and we use a toast to show the comment text which is present inside the HTTP response JSON body that gets deserialized into a Comment object using Gson.<\/p>\n\n\n\n<p>In the onFailure method we simply display the error encountered using a toast, this may occur if the API is down, if there are connectivity issues, or there is a coding error on the server side API.<\/p>\n\n\n\n<p>I have also included the layout resource below which I used for the CommentActivity class.<\/p>\n\n\n<p><script src=\"https:\/\/gist.github.com\/learntodroid\/f659ec1be3c16493ddef62dc03ff9942.js\"><\/script><\/p>\n\n\n<h3 class=\"wp-block-heading\">Step 6: Configure the Manifest to Access the Internet<\/h3>\n\n\n\n<p>One final thing you will need to do to ensure you have connectivity to the API is to enable the permission to access the internet (android.permission.INTERNET) inside your Android Manifest for your app.<\/p>\n\n\n\n<p>In addition to this, if you are going to use the Flask API I wrote and don&#8217;t want to configure a HTTPS certificate for the API, you will need to add an attribute  in the application tag (by setting &#8220;android:usesCleartextTraffic&#8221; to &#8220;true&#8221;)  inside the Android Manifest to specify that you want to send clear text traffic in your Android app. <strong>Warning: Sending clear text traffic should not be done in production for security reasons.<\/strong><\/p>\n\n\n\n<p>See the sample AndroidManifest.xml file below the shows how to configure the use of clear text traffic and setting the permission to access the internet.<\/p>\n\n\n<p><script src=\"https:\/\/gist.github.com\/learntodroid\/7c2570c737ebfdc6149986c5c0e9dd17.js\"><\/script><\/p>\n\n\n<h3 class=\"wp-block-heading\">Demonstration<\/h3>\n\n\n\n<p>Now if you run your Android app with the API running, and include the comment details and click the button, you should see something like the following in Logcat.<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"668\" src=\"http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Post-Request-with-JSON-Payload-Demo-1024x668.png\" alt=\"\" class=\"wp-image-2326\" srcset=\"http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Post-Request-with-JSON-Payload-Demo-1024x668.png 1024w, http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Post-Request-with-JSON-Payload-Demo-300x196.png 300w, http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Post-Request-with-JSON-Payload-Demo-768x501.png 768w, http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Post-Request-with-JSON-Payload-Demo.png 1200w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure><\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Sending Data in URL Parameters using a POST Request with Retrofit2<\/h2>\n\n\n\n<p>Retrofit2 also has support for sending data in a POST request using parameters within the URL.<\/p>\n\n\n\n<p>To achieve this using Retrofit2 inside the interface class you need to add @FormUrlEncoded annotation above the method name. For an example of this check out lines 16 and 20 in the interface code shared in Step 3 of this tutorial you will see the use of the @FormUrlEncoded annotation.<\/p>\n\n\n\n<p>To see the difference in the logs when using the @FormUrlEncoded annotation compare the Logcat results from the Demo section above to the results using the @FormUrlEncoded annotation below.<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"632\" src=\"http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Post-Request-with-FormUrlEncoded-Demo-1024x632.png\" alt=\"\" class=\"wp-image-2332\" srcset=\"http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Post-Request-with-FormUrlEncoded-Demo-1024x632.png 1024w, http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Post-Request-with-FormUrlEncoded-Demo-300x185.png 300w, http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Post-Request-with-FormUrlEncoded-Demo-768x474.png 768w, http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Post-Request-with-FormUrlEncoded-Demo.png 1200w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure><\/div>\n\n\n\n<p>As you can see one difference is that the Content-Type in the header of the request is to set &#8220;application\/x-www-form-urlencoded&#8221;. Another difference is that instead of a request body the the title, comment and author appear in an encoded format in the URL.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">How to Use @Field and @FieldMap in Retrofit2<\/h2>\n\n\n\n<p>When making a request to an API defined in Retrofit2 you opt to pass the attributes to be sent in the request as a set of fields or as a set of key value pairs.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Using @Field Annotation in Retrofit2<\/h3>\n\n\n\n<p>If you check out line 18 in the interface code shared in Step 3 of this tutorial you will see the use of the @Field annotation. Each of the field names and their data types are defined in the method parameters inside the interface.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"889\" height=\"63\" src=\"http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Retrofit2-Field-Annotation.png\" alt=\"\" class=\"wp-image-2335\" srcset=\"http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Retrofit2-Field-Annotation.png 889w, http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Retrofit2-Field-Annotation-300x21.png 300w, http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Retrofit2-Field-Annotation-768x54.png 768w\" sizes=\"(max-width: 889px) 100vw, 889px\" \/><\/figure>\n\n\n\n<p>If you have a look at line 69 in the activity code shared in Step 5 of this tutorial you will see that instead of passing the Comment object as a parameter to the createComment method, the title, comment and author are passed as individual strings instead.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"968\" height=\"116\" src=\"http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Retrofit2-Invoke-API-with-Fields.png\" alt=\"\" class=\"wp-image-2336\" srcset=\"http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Retrofit2-Invoke-API-with-Fields.png 968w, http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Retrofit2-Invoke-API-with-Fields-300x36.png 300w, http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Retrofit2-Invoke-API-with-Fields-768x92.png 768w\" sizes=\"(max-width: 968px) 100vw, 968px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Using @FieldSet Annotation in Retrofit2<\/h3>\n\n\n\n<p>If you check out line 22 in the interface code shared in Step 3 of this tutorial you will see the use of the @FieldMap annotation. A Map contain keys that are Strings and values that are Strings are defined as a parameter for that method inside the interface.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"477\" height=\"62\" src=\"http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Retrofit2-FieldMap-Annotation.png\" alt=\"\" class=\"wp-image-2339\" srcset=\"http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Retrofit2-FieldMap-Annotation.png 477w, http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Retrofit2-FieldMap-Annotation-300x39.png 300w\" sizes=\"(max-width: 477px) 100vw, 477px\" \/><\/figure>\n\n\n\n<p>If you have a look at lines 83 to 87 in the activity code shared in Step 5 of this tutorial you will see that instead of passing the Comment object as a parameter to the createComment method, a HashMap is passed as an parameter. This HashMap contains key value pairs of which the field names are defined as the keys and the comment title, comment body and comment author are defined as the values.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"717\" height=\"108\" src=\"http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Retrofit2-Invoke-API-with-FieldMap.png\" alt=\"\" class=\"wp-image-2343\" srcset=\"http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Retrofit2-Invoke-API-with-FieldMap.png 717w, http:\/\/10.0.0.14:32769\/wp-content\/uploads\/2020\/03\/Retrofit2-Invoke-API-with-FieldMap-300x45.png 300w\" sizes=\"(max-width: 717px) 100vw, 717px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Further Reading<\/h2>\n\n\n\n<p>If you want to learn using the Model View ViewModel software design pattern with Retrofit2 to integrate your Android app with an API, check out the other post I wrote below that goes into this.<\/p>\n\n\n\n<figure class=\"wp-block-embed is-type-wp-embed is-provider-learn-to-droid wp-block-embed-learn-to-droid\"><div class=\"wp-block-embed__wrapper\">\n<blockquote class=\"wp-embedded-content\" data-secret=\"A72jogQMum\"><a href=\"http:\/\/10.0.0.14:32769\/consuming-a-rest-api-using-retrofit2-with-the-mvvm-pattern-in-android\/\">Consuming a REST API using Retrofit2 with the MVVM Pattern in Android<\/a><\/blockquote><iframe class=\"wp-embedded-content\" sandbox=\"allow-scripts\" security=\"restricted\" style=\"position: absolute; clip: rect(1px, 1px, 1px, 1px);\" title=\"&#8220;Consuming a REST API using Retrofit2 with the MVVM Pattern in Android&#8221; &#8212; Learn to Droid\" src=\"http:\/\/10.0.0.14:32769\/consuming-a-rest-api-using-retrofit2-with-the-mvvm-pattern-in-android\/embed\/#?secret=pcFYZS7CEG#?secret=A72jogQMum\" data-secret=\"A72jogQMum\" width=\"600\" height=\"338\" frameborder=\"0\" marginwidth=\"0\" marginheight=\"0\" scrolling=\"no\"><\/iframe>\n<\/div><\/figure>\n\n\n\n<iframe loading=\"lazy\" src=\"https:\/\/docs.google.com\/forms\/d\/e\/1FAIpQLSe4aAItLWeIpKkTXMsbK3zMJFyWeY33iJeGDkrbcs8HXzlhoQ\/viewform?embedded=true\" width=\"640\" height=\"395\" frameborder=\"0\" marginheight=\"0\" marginwidth=\"0\">Loading\u2026<\/iframe>\n","protected":false},"excerpt":{"rendered":"<p>Retrofit2 is a powerful HTTP client library developed by Square used in Android and Java development. I have put together a tutorial with code samples in Java covering how to<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"nf_dc_page":"","footnotes":""},"categories":[12],"tags":[],"acf":[],"_links":{"self":[{"href":"http:\/\/10.0.0.14:32769\/wp-json\/wp\/v2\/posts\/2194"}],"collection":[{"href":"http:\/\/10.0.0.14:32769\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/10.0.0.14:32769\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/10.0.0.14:32769\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/10.0.0.14:32769\/wp-json\/wp\/v2\/comments?post=2194"}],"version-history":[{"count":4,"href":"http:\/\/10.0.0.14:32769\/wp-json\/wp\/v2\/posts\/2194\/revisions"}],"predecessor-version":[{"id":4933,"href":"http:\/\/10.0.0.14:32769\/wp-json\/wp\/v2\/posts\/2194\/revisions\/4933"}],"wp:attachment":[{"href":"http:\/\/10.0.0.14:32769\/wp-json\/wp\/v2\/media?parent=2194"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/10.0.0.14:32769\/wp-json\/wp\/v2\/categories?post=2194"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/10.0.0.14:32769\/wp-json\/wp\/v2\/tags?post=2194"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}