Liking cljdoc? Tell your friends :D

jason

JSON encoding and decoding function construction with support for configurable key conversion.

Supports:

  • configuration of all key conversions
  • preservation of metadata fields (e.g., as in HAL) during conversion
  • additional Jackson modules for encoding / decoding various Java types

Includes convenience coders for wire (i.e., service to service) JSON and database JSON:

For wire JSON:

  • converts from kebab-case keywords to camelCase JSON and back again
  • includes serialisation of org.joda.time and java.time types

For database JSON:

  • converts from kebab-case keywords to snake_case JSON and back again
  • includes serialisation of org.joda.time and java.time types

Install

Add the following to your project.clj file:

[b-social/jason "0.1.5"]

Documentation

Usage

(require '[jason.core :refer [defcoders] :as jason])
(require '[camel-snake-kebab.core :refer [->snake_case_string
                                          ->snake_case_keyword]])

(defcoders standard)
(defcoders db
  :encode-key-fn (jason/->encode-key-fn ->snake_case_string)
  :decode-key-fn (jason/->decode-key-fn ->snake_case_keyword))

(->standard-json {:first-name "Jess"})
;; => "{\"first-name\": \"Jess\"}"

(->db-json {:first-name "Jess"})
;; => "{\"first_name\": \"Jess\"}"

(<-standard-json "{\"firstName\": \"Jess\"}")
;; => {"firstName" "Jess"}

(<-db-json "{\"first_name\": \"Jess\"}")
;; => {:first_name "Jess"}

See the Getting Started guide for more details.

License

Copyright © 2018 B-Social Ltd.

Distributed under the terms of the MIT License.

Can you improve this documentation? These fine people already did:
Toby Clemson & Corin Chaplin
Edit on GitHub

cljdoc is a website building & hosting documentation for Clojure/Script libraries

× close