Home/ Questions/Q 97785
In Process

The Archive Base Latest Questions

Editorial Team
  • 0
Asked: 2026-05-11T00:04:16+00:00

Every tutorial or explanation of REST just goes too complicated too quickly – the

  • 0

Every tutorial or explanation of REST just goes too complicated too quickly – the learning curve rises so fast after the initial explanation of CRUD and the supposed simplicity over SOAP. Why can’t people write decent tutorials anymore!

I’m looking at Restlet – and its not the best, there are things missing in the tutorial and the language/grammar is a bit confusing and unclear. It has took me hours to untangle their First Steps tutorial (with the help of another Java programmer!)

RESTlet Tutorial Comments

Overall I’m not sure exactly who the tutorial was aimed at – because there is a fair degree of assumed knowledge all round, so coming into REST and Restlet framework cold leaves you with a lot of ‘catchup work’ to do, and re-reading paragraphs over and over again.

  1. We had difficulty working out that the jars had to be in copied into the correct lib folder.

  2. Problems with web.xml creating a HTTP Status 500 error –

The server encountered an internal error () that prevented it from fulfilling this request

, the tutorial says:

‘Create a new Servlet Web application as usual, add a ‘com.firstStepsServlet’ package and put the resource and application classes in.’

This means that your fully qualified name for your class FirstStepsApplication is com.firstStepsServlet.FirstStepsApplication, so we had to alter web.xml to refer to the correct class e.g:

original:

<param-value>          firstStepsServlet.FirstStepsApplication </param-value>

should be:

<param-value>          com.firstStepsServlet.FirstStepsApplication </param-value>

Conclusion

I was under the impression that the concepts of REST were supposed to be much simpler than SOAP – but it seems just as bad if not more complicated – don’t get it at all! grrrr

Any good links – much appreciated.

Share

Leave an answer

You must login to add an answer.

Need An Account,

1 Answer

  1. It sounds like you could use a solid understanding of the fundamentals of REST, and for that I highly recommend RESTful Web Services by Leonard Richardson and Sam Ruby. I provides a great introduction to REST: what it is and how to implement a (practical) RESTful web service.

    Most of the example code in the book is actually Ruby, but it’s easy enough to understand even if you’re not a Ruby expert. But one thing that should help you specifically is that one of the later chapters of the book contains overviews of several RESTful frameworks, including Restlet. It doesn’t really get into any code (it’s a 50,000-foot flyover) but I think it’ll give you just what you need at this stage.

    • 0