├── LICENSE
├── README.md
├── _config.yml
└── _layouts
    └── default.html


/LICENSE:
--------------------------------------------------------------------------------
 1 | MIT License
 2 | 
 3 | Copyright (c) 2017 Tanbir chowdhury
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy
 6 | of this software and associated documentation files (the "Software"), to deal
 7 | in the Software without restriction, including without limitation the rights
 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | ## Welcome to Json-Guide
  2 | JSON (JavaScript Object Notation) is a lightweight data-interchange format. It is easy for humans to read and write. It is easy for machines to parse and generate.
  3 | 
  4 | ## Comments
  5 | ---
  6 | Comments are not Supported in JSON :smiley:
  7 | 
  8 | ## Json Syntax
  9 | ---
 10 | ### Json data types:
 11 | * a string
 12 | * a number
 13 | * an object (JSON object)
 14 | * an array
 15 | * a boolean
 16 | * null
 17 | 
 18 | ### Json number types:
 19 | * Integer
 20 | * Fraction
 21 | * Exponent
 22 | 
 23 | ### Json Objects:
 24 | ```js
 25 | {
 26 | "developer":{ "name":"Rafi", "age":20, "city":"Barisal" }
 27 | }
 28 | ```
 29 | ### Json Array:
 30 | ```js
 31 | {
 32 | "developer":[ "Rafi", "Dhaka", "Bangladesh" ]
 33 | }
 34 | ```
 35 | ### Json Strings:
 36 | ```js
 37 | { "name":"Rafi" }
 38 | ```
 39 | ### Json Numbers:
 40 | ```js
 41 | { "year": 2017 }
 42 | ```
 43 | ### Json Booleans:
 44 | ```js
 45 | { "name": true }
 46 | ```
 47 | ### Json Null:
 48 | ```js
 49 | { "name": null }
 50 | ```
 51 | ### Example showing array containing multiple objects:
 52 | ```js
 53 | {
 54 |    "devlopers": [
 55 |       { "name":"nahid" , "skill":"laravel" },
 56 |       { "name":"rid" , "skill":"php" },
 57 |       { "name":"rafi" , "skill":"html" }
 58 |    ]
 59 | }
 60 | ```
 61 | ## Json Objects
 62 | ---
 63 | ### Json Object Syntax:
 64 | ```js
 65 | { "name":"rafi", "age":10, "class":null, "year": true }
 66 | ```
 67 | ### Json Accessing Object Values:
 68 | ```js
 69 | obj = { "name":"rafi", "age":10, "class":null, "year": true };
 70 | myobj= obj.name;
 71 | ```
 72 | or
 73 | ```js
 74 | obj = { "name":"rafi", "age":10, "class":null, "year": true };
 75 | myobj= obj["name"];
 76 | ```
 77 | ### Json Looping Object:
 78 | ```js
 79 | loopobj = { "name":"rafi", "age":10, "class":null, "year": true };
 80 | for (x in loopobj) {
 81 |     document.getElementById("demo").innerHTML += x;
 82 | }
 83 | ```
 84 | or
 85 | ```js
 86 | loopobj = { "name":"rafi", "age":10, "class":null, "year": true };
 87 | for (x in loopobj) {
 88 |     document.getElementById("demo").innerHTML += loopobj[x];
 89 | }
 90 | ```
 91 | ### Json Nested Objects:
 92 | ```js
 93 | Nesobj = {
 94 |     "name":"nahid",
 95 |     "age":30,
 96 |     "skill": {
 97 |         "skill1":"laravel",
 98 |         "skill2":"php",
 99 |         "skill3":"js",
100 |         "skill4":"vue.js"
101 |     }
102 |  }
103 |  ```
104 | > Access nested Json objects
105 | ```js
106 |  x = nesobj.skill.skill3;
107 | ```
108 | or
109 | ```js
110 | x = nesobj.skill["skill3"];
111 | ```
112 | ## Json Arrays
113 | ---
114 | ### Arrays in Json Objects:
115 | ```js
116 | arrobj = {
117 | "name":"Rafi",
118 | "phone":01723*****,
119 | "address": "Dhaka, Bangladesh",
120 | "skill":[ "php", "html", "css", "javascript" ]
121 | }
122 | ```
123 | > Access Array Values
124 | ```js
125 | x = arrobj.skill[0];
126 | ```
127 | ### Json Looping array:
128 | ```js
129 | for (i in arrobj.skill) {
130 |     x += arrobj.skill[i];
131 | }
132 | ```
133 | or
134 | ```js
135 | for (i = 0; i < arrobj.skill.length; i++) {
136 |     x += arrobj.skill[i];
137 | }
138 | ```
139 | ### Json Nested arrays:
140 | ```js
141 | nesarr = {
142 |     "name":"Rafi",
143 |     "age":10,
144 |     "year":2017,
145 |     "computer": [
146 |         { "name":"MacBook Pro ", "models":[ "MacBookPro14,1", "MacBookPro14,2", "MacBookPro14,3" ] },
147 |         { "name":"dell", "models":[ "XPS 13", "XPS 15", "XPS 13 2-in-1" ] },
148 |         { "name":"fujitsu", "models":[ "LH-532", "LH-531" ] }
149 |     ]
150 |  }
151 |  ```
152 |  > Access Nested array Values
153 |  ```js
154 |  for (i in nesarr.computer) {
155 |     x += "<p>" + nesarr.computer[i].name + "</p>";
156 |     for (j in nesarr.computer[i].models) {
157 |         x += nesarr.computer[i].models[j];
158 |     }
159 | }
160 | ```
161 | ### Json Modify array Values:
162 | ```js
163 | nesarr.computer[1] = "XPS 17"
164 | ```
165 | ### Json Delete array:
166 | ```js
167 | delete nesarr.computer[1];
168 | ```
169 | ## Json parse
170 | ---
171 | ### Json Parsing
172 | ```js
173 | '{ "name":"Rafi", "Phone":01723, "city":"Dhaka"}'
174 | ```
175 | ### Use the JavaScript function Json parse
176 | ```js
177 | var json = '{"name":"rafi", "result":true,"count":2}',
178 | obj = JSON.parse(json);
179 | ```
180 | > Use the JavaScript object
181 | ```js
182 | <h1 id="demo"></h1> 
183 | <script>
184 | document.getElementById("demo").innerHTML = json.name + ", " + json.city; 
185 | </script>
186 | ```
187 | ### get data from the server:
188 | ```js
189 | var xmlhttp = new XMLHttpRequest();
190 | xmlhttp.onreadystatechange = function() {
191 |     if (this.readyState == 4 && this.status == 200) {
192 |         var myObj = JSON.parse(this.responseText);
193 |         document.getElementById("demo").innerHTML = obj.name;
194 |     }
195 | };
196 | xmlhttp.open("GET", "json_demo.txt", true);
197 | xmlhttp.send();
198 | ```
199 | ## Json stringify
200 | ---
201 | ### Json Stringify with JavaScript Object:
202 | ```js
203 | var myobj = { "name":"Rafi", "hometown":"Barisal", "currentcity":"Dhaka", "phone":01723****};
204 | ```
205 | > JavaScript function JSON.stringify, and string data sent to be a server
206 | ```js
207 | var myJSON = JSON.stringify(myobj);
208 | document.getElementById("demo").innerHTML = myJSON;
209 | ```
210 | ### Json Stringify date:
211 | ```js
212 | var myobj = { "name":"Rafi", "date":new Date(), "home":"Barisal" };
213 | ```
214 | ### Json Stringify function:
215 | ```js
216 | var myobj = { "name":"Rafi", "phone":function () {return 01723***;}, "home":"Barisal" };
217 | ```
218 | ## JSON Schema
219 | ---
220 | ### Building a product schema:
221 | > JSON data for a product API
222 | ```js
223 | {
224 |     "id": 1,
225 |     "name": "Ace Plus",
226 |     "price": 12.50,
227 |     "tags": ["medicine", "drug"]
228 | }
229 | ```
230 | > Starting the schema
231 | ```js
232 | {
233 |    "$schema": "http://json-schema.org/draft-06/schema#",
234 |    "title": "Product",
235 |    "description": "A product from Medicine",
236 |    "type": "medicine"
237 | }
238 | ```
239 | ### Defining the properties:
240 | > what is id?
241 | ```js
242 | {
243 |    "$schema": "http://json-schema.org/draft-06/schema#",
244 |    "title": "Product",
245 |    "description": "A product from Medicine",
246 |    "type": "object",
247 |    "properties": {
248 |          "id": {
249 |             "description": "The unique indentifier for a product",
250 |             "type": "integer"
251 |          }
252 |      },
253 |     "required": ["id"]
254 | }
255 | ```
256 | > Is name required?
257 | ```js
258 | {
259 |    "$schema": "http://json-schema.org/draft-06/schema#",
260 |    "title": "Product",
261 |    "description": "A product from Medicine",
262 |    "type": "object",
263 |    "properties": {
264 |          "id": {
265 |              "description": "The unique identifier for a product",
266 |              "type": "integer"
267 |          },
268 |          "name": {
269 |               "description": "Name of the product",
270 |               "type": "string"
271 |          },
272 |          "required": ["id","name"]
273 | }
274 | ```
275 | > Can price be 0?
276 | ```js
277 | {
278 |     "$schema": "http://json-schema.org/draft-06/schema#",
279 |     "title": "Product",
280 |     "description": "A product from Acme's catalog",
281 |     "type": "object",
282 |     "properties": {
283 |         "id": {
284 |             "description": "The unique identifier for a product",
285 |             "type": "integer"
286 |         },
287 |         "name": {
288 |             "description": "Name of the product",
289 |             "type": "string"
290 |         },
291 |         "price": {
292 |             "type": "number",
293 |             "exclusiveMinimum": 0
294 |         }
295 |     },
296 |     "required": ["id", "name", "price"]
297 | }
298 | ```
299 | > Are all tags strings?
300 | ```js
301 | {
302 |     "$schema": "http://json-schema.org/draft-06/schema#",
303 |     "title": "Product",
304 |     "description": "A product from Acme's catalog",
305 |     "type": "object",
306 |     "properties": {
307 |         "id": {
308 |             "description": "The unique identifier for a product",
309 |             "type": "integer"
310 |         },
311 |         "name": {
312 |             "description": "Name of the product",
313 |             "type": "string"
314 |         },
315 |         "price": {
316 |             "type": "number",
317 |             "exclusiveMinimum": 0
318 |         },
319 |         "tags": {
320 |             "type": "array",
321 |             "items": {
322 |                 "type": "string"
323 |             },
324 |             "minItems": 1,
325 |             "uniqueItems": true
326 |         }
327 |     },
328 |     "required": ["id", "name", "price"]
329 | }
330 | ``` 
331 | > Summary of products:
332 | ```js
333 | [
334 |     {
335 |         "id": 2,
336 |         "name": "An ice sculpture",
337 |         "price": 12.50,
338 |         "tags": ["cold", "ice"],
339 |         "dimensions": {
340 |             "length": 7.0,
341 |             "width": 12.0,
342 |             "height": 9.5
343 |         },
344 |         "warehouseLocation": {
345 |             "latitude": -78.75,
346 |             "longitude": 20.4
347 |         }
348 |     },
349 |     {
350 |         "id": 3,
351 |         "name": "A blue mouse",
352 |         "price": 25.50,
353 |         "dimensions": {
354 |             "length": 3.1,
355 |             "width": 1.0,
356 |             "height": 1.0
357 |         },
358 |         "warehouseLocation": {
359 |             "latitude": 54.4,
360 |             "longitude": -32.7
361 |         }
362 |     }
363 | ]
364 | ```
365 | ## Json-Examples
366 | ---
367 | ### JSON with Php
368 | > encode
369 | ```js
370 | $myArray = array('Name' => 'Tanbir', 'Age' => 22, 'City' => 'Dhaka', 'Job' => 'nai');
371 | echo json_encode($myArray);
372 | ```
373 | > decode
374 | ```js
375 | $json = '{"Name": "Tanbir","Age": 22,"City": "Dhaka","Job": "nai"}';
376 | var_dump(json_decode($json));
377 | ```
378 | ### JSON with Python
379 | > encode
380 | ```js
381 | data = [ { 'Name' : 'Rafi', 'Age' : 8, 'City' : 'Dhaka', 'Job' : 'nai'} ]
382 | json = demjson.encode(data)
383 | print json
384 | ```
385 | > decode
386 | ```js
387 | json = '{"html":5,"css":3,"laravel":5.5}';
388 | text = demjson.decode(json)
389 | print  text
390 | ```
391 | ### JSON with Java
392 | 
393 | > encode
394 | ```js
395 | class JsonEncodeDemo {
396 | 
397 |    public static void main(String[] args){
398 |       JSONObject obj = new JSONObject();
399 | 
400 |       obj.put("name", "rafi");
401 |       obj.put("number", new Integer(01723));
402 |       obj.put("balance", new Double(123450.21));
403 |       obj.put("ip", new Boolean(true));
404 | 
405 |       System.out.print(obj);
406 |    }
407 | }
408 | ```
409 | > decode
410 | ```js
411 | String jsonString = "{\"stat\":{\"sdr\": \"aa:bb:cc:dd:ee:ff\",\"rcv\": \"aa:bb:cc:dd:ee:ff\",\"time\": \"UTC in millis\",\"type\": 1,\"subt\": 1,\"argv\": [{1,2},{2,3}]}}";
412 | JSONObject jsonObject = new JSONObject(jsonString);
413 | JSONObject newJSON = jsonObject.getJSONObject("stat");
414 | System.out.println(newJSON);
415 | ```
416 | 
417 | ### License 
418 | ![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
419 | 
420 | ### Admin 
421 | [Tanbir](https://github.com/totanbir)
422 | 
423 | ### Contributors
424 | [contributors](https://github.com/totanbir/json-guide/graphs/contributors)
425 | 


--------------------------------------------------------------------------------
/_config.yml:
--------------------------------------------------------------------------------
1 | theme: jekyll-theme-cayman
2 | title: JSON GUIDE
3 | description: For those who wanna learn JSON
4 | show_downloads: true 
5 | 


--------------------------------------------------------------------------------
/_layouts/default.html:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <html lang="{{ site.lang | default: "en-US" }}">
 3 |   <head>
 4 |     <meta charset="UTF-8">
 5 | 
 6 | {% seo %}
 7 |     <meta name="description" content="{{ page.description | default: site.description | default: site.github.project_tagline }}"/>
 8 |     <meta name="viewport" content="width=device-width, initial-scale=1">
 9 |     <meta name="theme-color" content="#157878">
10 |     
11 |     <link rel="stylesheet" href="{{ '/assets/css/style.css?v=' | append: site.github.build_revision | relative_url }}">
12 |     
13 |   </head>
14 |   <body">
15 |     <section class="page-header">
16 |       <h1 class="project-name">{{ site.title | default: site.github.repository_name }}</h1>
17 |       <h2 class="project-tagline">{{ site.description | default: site.github.project_tagline }}</h2>
18 |       {% if site.github.is_project_page %}
19 |         <a href="{{ site.github.repository_url }}" class="btn">Update this Page</a>
20 |       {% endif %}
21 |       {% if site.show_downloads %}
22 |         <a href="{{ site.github.zip_url }}" class="btn">Download .zip</a>
23 |         <a href="{{ site.github.tar_url }}" class="btn">Download .tar.gz</a>
24 |       {% endif %}
25 |       </br>
26 |       <!-- Place this tag where you want the button to render. -->
27 |       <a class="github-button" href="https://github.com/totanbir/json-guide" data-icon="octicon-star" data-size="large" data-show-count="true" aria-label="Star totanbir/json-guide on GitHub">Star</a>      
28 |       <!-- Place this tag where you want the button to render. -->
29 |       <a class="github-button" href="https://github.com/totanbir/json-guide/fork" data-icon="octicon-repo-forked" data-size="large" data-show-count="true" aria-label="Fork totanbir/json-guide on GitHub">Fork</a>      
30 |     </section>
31 |     <ins style="display:block; text-align:center;"></ins>
32 |     <section class="main-content">
33 |      
34 |       {{ content }}
35 | 
36 |       <footer class="site-footer">
37 |         {% if site.github.is_project_page %}
38 |           <span class="site-footer-owner"><a href="{{ site.github.repository_url }}">{{ site.title }}</a> is maintained by <a href="{{ site.github.owner_url }}">{{ site.github.owner_name }}</a>.</span>
39 |         {% endif %}
40 |         <span class="site-footer-credits">This page was generated by <a href="https://pages.github.com">GitHub Pages</a>.</span>
41 |       </footer>
42 |     </section>
43 | 
44 |     <!-- Place this tag in your head or just before your close body tag. -->
45 |     <script async defer src="https://buttons.github.io/buttons.js"></script>    
46 |   </body>
47 | </html>
48 | 


--------------------------------------------------------------------------------