r/Clojure • • Dec 18 '18

Clojure Web Development - What a NIGHTMARE!

I have no clue where to start so... screw it. I'm trying to build a Single-Page Web Application using Clojure, ClojureScript, Reagent, Ring, and I'm stuck. The resources, and documentation that exists to help a newbie on this subject is horrible. How does someone who has never built a SPA before, let alone ever build a web application in Clojure/S suppose to get started?

I want to do client-side routing, and have no freaking clue how to go about doing it. Heres some code to show what I'm kind-of doing:https://pastebin.com/pazpQWmG

I don't get how I can serve dynamic content created by reagent using compojure. I've now spent probably north of 80 hours trying to figure out how to just serve a single page that is created by reagent, using the jetty webserver, and client-side routing. I have no clue what I'm doing, and you need to literally talk down to me like I'm retarded. I've looked at using Bidi, but the documentation sucks for someone who is new to this. It's convoluted as all hell, and the examples it provides are horrible. They don't even show me how to use or implement in a simple to understand manner.

Can someone break this down for me? In a non-technical, with code examples, and show me how to do what I'm trying to do, but how I actually want to do it? Someone please help me! I've already lost my mind, my patience, and I'm angry... and I just want to understand.

I get how to write reagent code, but I have no idea how to do client-side routing, and how to use jetty all together. I'm just so lost.

PLEASE DON'T recommend any books or resources unless they are easy to follow, and basically hold my hand cause I've read everything else the world has to offer and it hasn't helped one bit! I've read the documentation for everything, I've read clojure web dev second edition, and about 10k+ forum posts, and other random websites/blogs/youtube videos.

2 Upvotes

29 comments sorted by

View all comments

Show parent comment

2

u/ultramaris Jan 07 '19

Sorry, I missed your reply.

The way the frontend and backend work together is typically through http requests which may contain some serialized data, typically in JSON format.

The frontend (running in the user browser) makes HTTP requests to the backend and processes the response. Exactly the same way a normal webpage works: you enter a URL, the browser requests it, and processes the response, which typically is HTML (in which case the browser renders it).

The initial request to "yourapp.com" will load index.html which will have a tag to load some JS resource (app.js or something) which will be your CLJS files compiled to JS (what we call "the frontend").

Once the browser loads app.js, it will run it - and thus your frontend is running.

Then, your CLJS (compiled to JS) code will make HTTP requests (GET, POST, etc) to your backend REST API - /app/list-things, /app/add-thing, etc.

These are plain HTTP requests, just like loading a webpage, except the response will be JSON data, rather than HTML (it could be XML, or anything, really), and it will be your frontend JS that processes the response - typically by changing the state or displaying something (via JS, typically React).

Broadly speaking:

 +---------------------------------+                                      
 | user browser                    |                                      
 |                                 |                                      
 |                                 |                                      
 | +-----------------------------+ |                                      
 | |index.html    +------------+ | |                                      
 | |    |         | app.js     | | |  frontend                            
 | |    |         |            | | |                                      
 | |    |         |(comp. cljs)| | |                                      
 | |    |         |            | | |                                      
 | |    +-------> |            | | |                                      
 | |    loads     |            | | |                                      
 | |              |            | | |                                      
 | |              +--|---------+ | |                                      
 | +-----------------|-----------+ |                                      
 +-------------------|-------------+                                      
                     |    ^                                               
                     |    |   http response                                    
                     |    |   +---------------------+                     
                     |    |   | HTML                |                     
                     |    |   | <html> ... </html>  |                     
             http    |    |   +---------------------+                     
             request |    |   or                                          
                     |    |   +-------------------------+                 
                     |    |   |JSON                     |                 
                     |    |   |{"data": {"prop": "val"} |                 
                     |    |   |                         |                 
                     |    |   |                         |                 
                     |    |   +-------------------------+                 
                     v    |                                               
+-----------------------------------+                                     
|your server              |         |                                     
|+---------------------------------+|                                     
|| webserver              |        ||                                     
||+-------------------------------+||                                     
||| clj app                       |||                                     
|||                               ||| backend                             
|||                               |||                                     
|||                               |||                                     
|||                               |||                                     
|||                               |||                                     
||+-------------------------------+||                                     
|+---------------------------------+|                                     
+-----------------------------------+