Developing and Deploying a Simple Clojure Web Application

http://mmcgrana.github.com/2010/07/develop-deploy-clojure-web-applications.html

by liebke • 16 years ago

158 40 16 years ago

mmcgrana.github.com

blueberry4• 16 years ago

If this is an easy way to create a web app that adds two numbers on Clojure, I'd say Clojure is not ready for web development yet.

kljensen• 16 years ago

That is a TON if code for such a simple fiction.

shoover• 16 years ago

That is a ton of code if the goal is writing a web page that does addition. Maybe that wasn't the goal.

swannodette4• 16 years ago

Huh. 45 LOC for templating, routing, and form processing and you don't need to configure a different webserver since jetty is production quality. Do you have links to something that takes less effort than what is being illustrated here that can be deployed immediately into production and perform well?

cmurphycode• 16 years ago

Agreed. This strikes me as a more robust walk-through than traditional Hello World-esque tutorials; as such, there is a little more to do than you'd expect. I'd rather have the details provided here, and I suspect many other hackers would too.

blueberry4• 16 years ago

Are you serious? 45 LOC is not a good metric btw, why are you omitting all that boilerplate configuration. Any reasonable tutorial on PHP/python/RoR would build something more sophisticated more concisely. Here is a python tutorial: http://www.turbogears.org/2.0/docs/main/ToscaWidgets/forms.h...

twism• 16 years ago

Not to mention: middlewares, logging, stack traces, exception handling, testing, production/dev environments, e.t.c. in a similarly succinct manner.

vegashacker• 16 years ago

It's interesting. I read your comment through the "backtype version" below the article, and, because it was out of context, I interpreted your meaning to be exactly the opposite of what I see it is now.

Jach2• 16 years ago

http://pastebin.com/PsecNBvB

(To be honest, I think clojure has its purposes, but a one-off calculator page isn't one of them. Use the right tool for the right job and all that.)

axod• 16 years ago

why are some people so lazy and short sighted.

"time to make trivial webapp" is NOT a good reason to choose anything.

ikitat• 16 years ago

Actually, it's an easy way to: - add two numbers - build the project with dependencies - display stack traces - deliver static files - generate html from code - validate user input - host with a web server - reload the web server during development - handle url routing - log requests - create custom middleware - deploy to EC2

You may have glossed over some of the details.

blueberry4• 16 years ago

No, I didn't gloss over the details with the possible exception of deployment to EC2. Most of the stuff you listed are a prerequisite to web development. For most other languages/frameworks database connection would be included too.

frognibble• 16 years ago

Perhaps you meant to say that the framework used in this example is not ready. I didn't see anything about Clojure the language that makes the example complicated.

As far as the framework is concerned, the example shows how to build a production deployment of the application. The author is not showing a toy teaser application. There are a lot of details there, but these are things that you would want to know if you actually want to run a production server.

blueberry4• 16 years ago

I agree with this, and yes I used the word 'clojure' to mean any frameworks/web servers/middleware that can be used to code in clojure. Just like when people say "php is good for web programming" most of them actually mean php, apache, mysql and their favorite framework.

bretthoerner• 16 years ago

You can thank people like Mark McGranaghan for taking languages that "aren't ready for X" yet and making them so.

KirinDave2• 16 years ago

There are a contingent of Lisp users who really, really, really like this fgen style, for EVERYTHING. I—as someone who's worked in the industry on lots of startup-level projects—think it's only useful for small, regular snippets. There is also this false-metric effect in play; there are only 45ish lines in one file here, so it must be elegant and great amirite?

But a real webapp would have lots of templates and lots of files.

Where Clojure really shines in web development is when you mix it with cgrand's Enlive templating engine (http://github.com/cgrand/enlive), which is an amazing project with lots of active development. This approach is so cool that even a lot of the Rails and Python startup folks are starting to copy it.

swannodette4• 16 years ago

I think the point of the article is to cover the absolute basics using Ring, not advocate any particular style of development. I mean the title of the blog post does say it all.

Having written a lengthy Enlive tutorial, http://github.com/swannodette/enlive-tutorial, I of course swear by it and scoff at inline html generation :D So I prefer coupling Ring+Enlive+Moustache (and tasty Aleph) myself but that would be an awful lot to cover in a single blog post now wouldn't it ;)

All in good time.

seanwoods• 16 years ago

This is a great tutorial. Over the past few months I've been struggling with getting a "barebones" app up and running with Clojure. Leiningen has really come into its own in 2010 and tutorials like this will be great for people who need a basic template in order to bootstrap them into the whole experience.

pietrofmaggi• 16 years ago

Another nice example can be found in the last "Functional Web" column on IEEE Internet Computing by Steve Vinosky: http://steve.vinoski.net/pdf/IC-Getting_Started_with_Google_...

In the July/August 2010 column, Getting Started with Google App Engine and Clojure, guest columnist Aaron Bedra shows how to use Clojure, a relatively new but robust Lisp implementation on the Java Virtual Machine, create and deploy an application using the Compojure web framework on the Google App Engine platform.

TY• 16 years ago

Great article, thanks for the link.

Couple more helpful links for some basics not covered in the article (all work in progress):

Compojure docs: http://www.compojure.org

Stub for "Clojure Web Development" book: https://docs.google.com/Doc?docid=0AQqGP1CDN0uIZGhmZjJmcGZfM...

deweller• 16 years ago

This is great information. I'd love to see a similar tutorial for NodeJS for comparison.

mahmud6• 16 years ago

In Common Lisp (without cheating or handwaving; this is it):

  (defpackage :add-nums
    (:use :cl :hunchentoot :cl-who))
  
  (in-package :add-nums)
  
  (defmacro with-html (&body body)
    `(with-html-output-to-string (*standard-output* nil :prologue t :indent t)
       ,@body))
  
  (define-easy-handler (add-nums :uri "/add-nums")
      ((a :parameter-type 'integer)
       (b :parameter-type 'integer))
    (with-html
      (:html
       (:head (:title "Add two numbers"))
       (:body
        (if (and a b)
          (htm (:p (str (+ a b)))))
        (:form :method :get
         (:input :type :text :name "a")
         (:input :type :text :name "b")
         (:input :type :submit))))))
  
  (defparameter *site* (make-instance 'acceptor :port 8080))
  
  (start *site*)

swannodette4• 16 years ago

Er, Clojure has CL style macros so you can easily get to this level of brevity if that is desired.

mahmud6• 16 years ago

The one custom macro I wrote is already in there. The rest is just the web server and cl-who.

I have been screaming for ages telling Clojurists to rip CL APIs and implement them in clojure. They're more tasteful and cultured than that entrerprisey crap that java is smearing all over this nice Lisp dialect.

The majority of open source clojure code that I have seen looks like Java FFI stubs; you need to tuck those loose ends in and tidy them up with macros. But this probably wont happen until Clojure is ported to another runtime/platform; portability is a surefire way to distill the essence of a language from its implementation detail.

ataggart3• 16 years ago

But you are cheating:

* you've omitted code to control the output content-type and the associated response headers (xhtml vs html)

* you've removed text, formatting from the form page

* you've discarded the results page altogether

* you aren't properly distinguishing between GET and POST

Do the same to the clojure code and it'll be about the same length as well.

mahmud6• 16 years ago

Your requests, when they're valid, are embarrassingly simple one-liners.

you've omitted code to control the output content-type and the associated response headers (xhtml vs html)

Add this single line to your WITH-HTML macro.

  (setf (html-mode) :xml)  ; for XML or :sgml for HTML.

http://weitz.de/cl-who/#html-mode

you've removed text, formatting from the form page

Add one line for a CSS file inclusion and style it to your heart's content. In real web apps I use html-template to template the code, and do not sloppily generate html like I did with the example; but I had to do what the clojure code did, in the same manner.

you've discarded the results page altogether

I am printing the results on the same page. Yeah, that's a better usability.

you aren't properly distinguishing between GET and POST

Says who? the DEFINE-EASY-HANDLER takes arguments, which correspond to the submitted form elements, via GET or POST. In fact, that macro also does some type conversion for you as well; since you declared your parameters to be integers they will be converted to integers when you get them, and not remain strings. This stuff is built into the web server.

http://weitz.de/hunchentoot/#define-easy-handler

If you're gonna implement a full REST then you have no business generating your display html from within your container.

What else do you think I omitted?

weavejester2• 16 years ago

The equivalent Clojure code is actually a few lines shorter than your example:

    (ns add-nums
      (:use compojure.core [hiccup core page-helpers] ring.adapter.jetty))

    (defroutes handler
      (GET "/add-nums" [a b]
        (let [a (Integer/parseInt a)
              b (Integer/parseInt b)]
          (html
            [:html
              [:head [:title "Add two numbers"]]
              [:body
                (if (and a b) [:p (+ a b)])
                (form-to [:get "/add-nums"]
                  (text-field :a)
                  (text-field :b)
                  (submit-button))]])))

    (run-jetty handler {:port 8080})

Mark's tutorial code is a little more complete than your example, and doesn't aim for brevity. It also doesn't use any of the form functions from Hiccup (admittedly, they're not as well documented as they could be).

mahmud6• 16 years ago

Finally, an actual programmer's response.

Thank you! It's good to know that verbosity was for the sake pedagogy and completeness, and not necessity.

ikbear• 16 years ago

Clojure is cool.

Developing and Deploying a Simple Clojure Web Application

Related Stories