SerfJ 0.4.0 released

A new major version has been released with new features that makes the framework more powerful and flexible:

  • Feature: Default FileSerializer implementation, now is possible to serve files for downloading.
  • Feature: New default extension (.file) for serving files.
  • Feature: Within functional style you are able to implement generic serializers for whatever model you have.
  • Feature: Now javax.servlet.ServletContext, javax.servlet.http.HttpServletRequest and javax.servlet.http.HttpServletResponse are accessible from controllers.
  • Patch: Instead of implementing net.sf.serfj.serializers.Serializer developers must implement net.sf.serfj.serializers.ObjectSerializer for serializing objects.
  • Patch: RestController.addObject2request is deprecated in favour of RestController.putParam

The English documentation (reference, examples and Javadoc) has been updated, now I’m working on the Spanish reference.

Enjoy, and remember that any feedback will be welcome.



SerfJ 0.3.2 released!

Hello, a new version has been released. This time another user, Christian Kasper, has contributed to fix some problems he discovered while using SerfJ.

* Extension .64 in requests didn’t work as expected, SerfJ never found a Base64Serializer to attend those requests. The easiest way to solve the problem has been changing the extension to .base64.
* Other problem found by Christian was that the singular of ‘signatures’ didn’t return ‘signatures’ but ‘signatur’, so an exception for this word has been added to SerfJ.
* Now identifiers, which must start with a number, can contain alphabetic chars.
* Binaries are compiled on Java 6.
* Dependencies has been updated their versions.

You can read the complete release notes at the website.

Enjoy, and remember that any feedback will be welcome.

New version 0.3.1 released!

Hello folks, a fatal bug was discovered by some of serfj’s users, when using:

// Gets ID from URL /banks/1 
String id = this.getId(“bank”); 

return identifier is null.

So I have published a new version 0.3.1 that solves this problem. Another changes in this version are:

Now the above problem is solved, but also a little change in the API has been added. Now you can retrieve the main Id without using a resource name:

// URL /banks/1
String id = this.getId(“bank”);
// Or...
String theSameBankId = this.getId();

// URL /banks/1/accounts/2
String id = this.getId(“account”);
// Or...
String theSameAccountId = this.getId();
// Getting bank's id String bankId = this.getId(“bank”);

Manual de Referencia en Español

Lo prometido es deuda, y ya tenéis disponible el Manual de Referencia de SerfJ en su versión española para todos los que tengáis problemas con el inglés. Lo único que no he traducido son los comentarios dentro de los ejemplos.

Bueno, ya no tenéis excusa para usarlo, y si echáis en falta algo, así de cómo hacer esto o lo otro, no dudéis en preguntar.

Reference manual is ready

Finally I have finished a reference manual, it isn’t very long, but SerfJ is not a big framework, so I think this little manual gives enough information to use whole functionality.

This is the first version of the manual, I guess there will be typos, so if you find some, please tell me so I’ll be able to fix them as soon as possible. Also, if you think it misses some important information, please tell me too.

Now I have to translate it to Spanish, it’s easier than writting it from zero, so I think next week it’ll be ready.

There is another new thing you can notice at the website, under Documentation menu, there is a new Roadmap option where you can see what will be in next versions.

SerfJ en Español

Since this post is addressed to Spanish speaking people, I will write it in Spanish. But in short, now you’ll notice that a flag icon is on the top right corner of the website, well, now there is a Spanish version of the site.

Lo prometido es deuda, y he traducido las páginas que hay hasta ahora al español para todos aquellos que no se defiendan con el inglés. Como explico en la página de comunidad, el idioma de la lista de correo y del grupo de discusión de Google es el inglés, pero sois libres de preguntar y escribir en Español si lo deseáis. Si por lo que fuese la comunidad hispana fuese grande, ya me encargaría de crear una lista y/o grupo para tratar los temas en Español.

El enclace directo a la versión en Español es este:

Espero que lo disfrutéis.

Preparing the website for adding more documentation

Today I’ve been working on the site to have a drop-down menu. Yes, I know there are lots of them out there, but most of them have their own styles predefined. First of all I’ve tried JMenu, a JQuery’s plugin that I use at work in some projects, but I don’t know why, I haven’t got it working fine whit my stylesheets. So the next step has been do it myself. I like CSS and I thought I could do it without too much effort… erm I was wrong, I’ve got almost everything working, but I’ve gave up because of some problems with submenus and ‘hover’ :(.

Finally I’ve adopted an intermediate solution. I’ve used JMenu’s Javascript code, changing one line of it, and my stylesheets, so I haven’t needed JMenu’s stylesheets either it images folder. But it works fine!. Well, the menu is not beautiful, but it fit on the website’s style, so it’s fine for me.

Now with a place in the website to put more documentation, I’ll write a full documentation reference and some pieces of code to have little quick guides to develop a project with SerfJ.