In the previous two tutorials, we covers how to build Json encoders in Scala using Circe. You can review them here:<\/p>\n
In this tutorial, we would cover how to build Json Decoders in Scala using Circe. So let’s get started<\/p>\n
<\/p>\n
Remember that a decoder is used to decode some Json value into a type. Now let’s create some Json values that we would be using to test the decode we’ll build.<\/p>\n
\/\/ Create two Author Json Objects, one valid and on inValid<\/span>\r\nval<\/span> validAuthor =<\/span> Json<\/span>.<\/span>obj(<\/span>\r\n \"name\"<\/span> -><\/span> \"Kindson\"<\/span>.<\/span>asJson\r\n)<\/span>\r\nval<\/span> invalidAuthor =<\/span> Json<\/span>.<\/span>obj(<\/span>\r\n \"name\"<\/span> -><\/span> 45.<\/span>asJson\r\n)<\/span>\r\n<\/pre>\n <\/p>\n
Then we also create two more Json objects for article<\/p>\n
\/\/ Create two Article objects<\/span>\r\nval<\/span> validArticle:<\/span> Json<\/span> =<\/span> Json<\/span>.<\/span>obj(<\/span>\r\n \"id\"<\/span> -><\/span> \"5cc24c45-e692-45d5-8092-64c73d886abd\"<\/span>.<\/span>asJson,<\/span>\r\n \"title\"<\/span> -><\/span> \"Candle in the wind\"<\/span>.<\/span>asJson,<\/span>\r\n \"content\"<\/span> -><\/span> \"..\"<\/span>.<\/span>asJson,<\/span>\r\n \"author\"<\/span> -><\/span> Json<\/span>.<\/span>obj(<\/span>\r\n \"name\"<\/span> -><\/span> \"John Munonye\"<\/span>.<\/span>asJson\r\n )<\/span>\r\n)<\/span>\r\n\r\nval<\/span> inValidArticle:<\/span> Json<\/span> =<\/span> Json<\/span>.<\/span>obj(<\/span>\r\n \"id\"<\/span> -><\/span> \"5cc24c45-e692-45d5-8092-64c73d886abd\"<\/span>.<\/span>asJson,<\/span>\r\n \"content\"<\/span> -><\/span>998.<\/span>asJson,<\/span>\r\n \"author\"<\/span> -><\/span> Json<\/span>.<\/span>obj(<\/span>\r\n \"name\"<\/span> -><\/span> \"John Munonye\"<\/span>.<\/span>asJson\r\n )<\/span>\r\n)<\/span>\r\n<\/pre>\n <\/p>\n
2. Building Decoders Using forProductN<\/em><\/strong><\/h4>\nThe easiest way to define a decoder is the use the forProductN method of the decoder where N is the number of fields in the case class. This method take the two parameter lists as specified. The second parameter list expects a function that can build the Author instance out of the two arguments provided. This is the Apply method. The complete decoder is given below:<\/p>\n
\/\/ Build an author decoder using the forProductN method of the Docoder<\/span>\r\nimplicit<\/span> val<\/span> authorDecoder =<\/span> Decoder<\/span>.<\/span>forProduct2(<\/span>\"name\"<\/span>,<\/span> \"bio\"<\/span>)(<\/span>Author<\/span>.<\/span>apply)<\/span>\r\n<\/pre>\n <\/p>\n
Decoders built in this way using the forProductN is known as applicative-based<\/em>\u00a0decoders<\/em><\/strong> and it gives us the ability to accumulate errors. However, this limits our ability to model complex logic<\/p>\n <\/p>\n
3. Using Our Decoder to Decode<\/strong><\/h4>\nGiven our decoder, we can convert our validAuthor into an instance of Author using one of two ways:<\/p>\n
Method 1 – using hcursor<\/strong><\/p>\n\/\/ Perform decoding using the hcursor method<\/span>\r\nauthorDecoder(<\/span>validAuthor.<\/span>hcursor)<\/span>\r\n<\/pre>\n <\/p>\n
Method 2 – using as() method<\/strong><\/p>\n\/\/ Perform decoding by calling the .as() method on the Json Object<\/span>\r\nvalidAuthor.<\/span>as[<\/span>Author<\/span>]<\/span>\r\n<\/pre>\nThis gives use a Decode Result which could either be a decode failure on the Left<\/em>, or a valid author instance on the Right<\/em><\/p>\n <\/p>\n
4. Using Decode Accumulating Method<\/strong><\/h4>\nThe decodeAccumulating method can be used as well to perform decoding. The benefit of the decodeAccumulating method is that it can give a list of decoding failures indicates all the problems with the Json object.<\/p>\n
\/\/ Using the DecodeAccumulating method to perform decoding. This approach helps us accumulate errors<\/span>\r\nauthorDecoder.<\/span>decodeAccumulating(<\/span>invalidAuthor.<\/span>hcursor)<\/span>\r\n<\/pre>\n <\/p>\n
5. Decoder for Article Using for() Comprehension<\/strong><\/h4>\nWe would create a function and in the body of that function, we would decode every field one by one and in the final yield we build an instance of Article.<\/p>\n
\/\/ Build an article decoder using the for comprehension<\/span>\r\nimplicit<\/span> val<\/span> articleDecoder:<\/span> Decoder<\/span>[<\/span>Article<\/span>]<\/span> =<\/span> json =><\/span>\r\n for<\/span> {<\/span>\r\n id <-<\/span> json.<\/span>get[<\/span>UUID<\/span>](<\/span>\"id\"<\/span>)<\/span>\r\n title <-<\/span> json.<\/span>get[<\/span>String<\/span>](<\/span>\"title\"<\/span>)<\/span>\r\n content <-<\/span> json.<\/span>get[<\/span>String<\/span>](<\/span>\"content\"<\/span>)<\/span>\r\n author <-<\/span> json.<\/span>get[<\/span>Author<\/span>](<\/span>\"author\"<\/span>)<\/span>\r\n }<\/span> yield<\/span> Article<\/span>(<\/span>id,<\/span> title,<\/span> content,<\/span> author)<\/span>\r\n<\/pre>\nNote that the direction of the arrows indicate that decoded field are assigned to variables. In the yield, we then build an Article instance using these variables that we obtained from decoding. This is called monadic decoders and it gives us the ability to model complex logic\u00a0 but we’ll not have error accumulation.<\/p>\n
In the same way we can decode the Article Json object using this new decoder. We can use either hcursor<\/em><\/strong> or as()<\/strong><\/em> method as earlier explained.<\/p>\n <\/p>\n
Exercise<\/strong><\/p>\nCreate a couple of invalid Json Articles and try to decode them<\/p>\n","protected":false},"excerpt":{"rendered":"
In the previous two tutorials, we covers how to build Json encoders in Scala using Circe. You can review them here: Scala \u2013 Json Encoding … <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[41,45],"class_list":["post-241","post","type-post","status-publish","format-standard","hentry","category-scala-programming","tag-circe","tag-json-decoder"],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/www.kindsonthegenius.com\/scala\/wp-json\/wp\/v2\/posts\/241","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.kindsonthegenius.com\/scala\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.kindsonthegenius.com\/scala\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.kindsonthegenius.com\/scala\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.kindsonthegenius.com\/scala\/wp-json\/wp\/v2\/comments?post=241"}],"version-history":[{"count":4,"href":"https:\/\/www.kindsonthegenius.com\/scala\/wp-json\/wp\/v2\/posts\/241\/revisions"}],"predecessor-version":[{"id":245,"href":"https:\/\/www.kindsonthegenius.com\/scala\/wp-json\/wp\/v2\/posts\/241\/revisions\/245"}],"wp:attachment":[{"href":"https:\/\/www.kindsonthegenius.com\/scala\/wp-json\/wp\/v2\/media?parent=241"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.kindsonthegenius.com\/scala\/wp-json\/wp\/v2\/categories?post=241"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.kindsonthegenius.com\/scala\/wp-json\/wp\/v2\/tags?post=241"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}