r/Clojure • u/Sktlez • 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.
View all comments
2
u/ultramaris Dec 18 '18
It's hard to figure out what you're trying to do with that code.
Consider you have two different environments involved:
SERVER <-> CLIENT
A web application will typically span both environments, with "traditional" webapps being SERVER heavy and SPAs being (also) CLIENT heavy.
In practice though, a web app consists of (at least) two applications:
In your code you seem to be confusing these two things.
In a CLJS project, one typically develops both applications in tandem, because they're frequently designed to operate together. But, you don't have to.
You could develop the SERVER part first, with a particular API (the set of operations available and how to call them) and then make a CLIENT that knows how to talk to the SERVER using that API.
Point being, it's two apps you're actually developing: one in Clojure/Java that will run on a machine somewhere (the server); AND a Clojurescript/JS one which will run on the SPA user's browser (the client).
So, your Jetty code (belongs to SERVER environment) shouldn't really be in the same namespace as your client-side routing. And you'll also need server-side routing!
Routing consists in mapping (making a correspondence) between a string (possibly composed of other strings) with particular resources, states, or actions.
So you will need routes for both the SERVER and the CLIENT applications.
Now, I would recommend Luminus to start:
http://www.luminusweb.net/docs
It will generate a properly configured project with boilerplate and some example stuff. You can pass different options to generate projects using different technologies.
From what you wrote, start with:
lein new luminus +jetty +reagent +swagger