Tips | NooCodeCommit

Imaginez le Diagramme UML suivant :

Qui pourrait parfaitement représenter les Objets d’un Blog, mais pas que.

Imaginez que vous souhaitiez réaliser un API, compatible REST, qui vous permette de récupérer vos Posts et Comments au format JSon.

Nos Objets Métiers

Commençons tout d’abord par écrire nos objets Model :
app/models/Post.java

package models;

import java.util.List;
import javax.persistence.CascadeType;
import javax.persistence.Entity;
import javax.persistence.OneToMany;
import play.data.validation.Required;
import play.db.jpa.Model;

@Entity
public class Post extends Model {
    @Required
    public String author;

    @Required
    public String title;

    @OneToMany(mappedBy = "post", cascade = CascadeType.ALL)
    public List<Comment> comments;
}

package models;

import java.util.List;

import javax.persistence.CascadeType;

import javax.persistence.Entity;

import javax.persistence.OneToMany;

import play.data.validation.Required;

import play.db.jpa.Model;

@Entity

public class Post extends Model {

@Required

public String author;

@Required

public String title;

@OneToMany(mappedBy = "post", cascade = CascadeType.ALL)

public List<Comment> comments;

}

app/models/Comment.java

package models;

import javax.persistence.Entity;
import javax.persistence.Lob;
import javax.persistence.ManyToOne;
import play.data.validation.MaxSize;
import play.data.validation.Required;
import play.db.jpa.Model;

@Entity
public class Comment extends Model {
    @Required
    public String author;

    @Lob
    @Required
    @MaxSize(10000)
    public String content;

    @ManyToOne
    @Required
    public Post post;
}

package models;

import javax.persistence.Entity;

import javax.persistence.Lob;

import javax.persistence.ManyToOne;

import play.data.validation.MaxSize;

import play.data.validation.Required;

import play.db.jpa.Model;

@Entity

public class Comment extends Model {

@Required

public String author;

@Lob

@Required

@MaxSize(10000)

public String content;

@ManyToOne

@Required

public Post post;

}

Données de référence & Configuration

Pour nous simplifier la vie, Play! prévoit un mécanisme très pratique d’import de données, basé sur l’utilisation d’un fichier au format YAML
conf/initial-data.yml

Post(post1):
  author: moi
  title: Post 1
  
Post(post2):
  author: moi
  title: Post 2

Comment(c1):
  author: moi
  content: du Contenu
  post: post1

Comment(c2):
  author: moi
  content: du Contenu
  post: post1

Comment(c3):
  author: moi
  content: du Contenu
  post: post2

Post(post1):

author: moi

title: Post 1

Post(post2):

author: moi

title: Post 2

Comment(c1):

author: moi

content: du Contenu

post: post1

Comment(c2):

author: moi

content: du Contenu

post: post1

Comment(c3):

author: moi

content: du Contenu

post: post2

conf/application.conf

...
db=mem
...

...

db=mem

...

Bootstrap Job & Controller

Le Bootstrap Job va nous permettre d’importer nos données de référence sans effort, et notre contrôleur devra réaliser notre besoin initial, à savoir nous retourner la liste des Posts
app/controllers/Bootstrap.java

package controllers;

import models.Post;
import play.jobs.Job;
import play.jobs.OnApplicationStart;
import play.test.Fixtures;

@OnApplicationStart
public class Bootstrap extends Job {
    public void doJob() {
        if (Post.count() == 0) {
            Fixtures.loadModels("initial-data.yml");
        }
    }
}

package controllers;

import models.Post;

import play.jobs.Job;

import play.jobs.OnApplicationStart;

import play.test.Fixtures;

@OnApplicationStart

public class Bootstrap extends Job {

public void doJob() {

if (Post.count() == 0) {

Fixtures.loadModels("initial-data.yml");

}

app/controllers/Application.java

package controllers;

import java.util.List;
import models.Post;
import play.mvc.Controller;

public class Application extends Controller {
    public static void index() {
        List<Post> posts = Post.findAll();
        renderJSON(posts);
    }
}

package controllers;

import java.util.List;

import models.Post;

import play.mvc.Controller;

public class Application extends Controller {

public static void index() {

List<Post> posts = Post.findAll();

renderJSON(posts);

}

Premier résultat

Après avoir accédé via votre navigateur à l’adresse http://localhost:9000, vous devriez avoir l’erreur suivante :

Et dans votre console :

@67jf5njpa
Internal Server Error (500) for request GET /

Execution exception (In /app/controllers/Application.java around line 12)
IllegalStateException occured : circular reference error   Offending field: post    Offending object: preserveType: false, type: class models.Post, obj: Post[1]

@67jf5njpa

Internal Server Error (500) for request GET /

Execution exception (In /app/controllers/Application.java around line 12)

IllegalStateException occured : circular reference error Offending field: post Offending object: preserveType: false, type: class models.Post, obj: Post[1]

Corrections

La méthode renderJSON prévoit l’utilisation de vos propre JSonSerializer. Ce que nous allons faire pour nos Objets Post et Comment.

app/models/serializer/PostJSonSerializer.java

package models.serializer;

import java.lang.reflect.Type;

import models.Post;

import com.google.gson.JsonElement;
import com.google.gson.JsonObject;
import com.google.gson.JsonSerializationContext;
import com.google.gson.JsonSerializer;

public class PostJSonSerializer implements JsonSerializer<Post> {
    public static PostJSonSerializer instance;

    private PostJSonSerializer() {
    }

    public static PostJSonSerializer get() {
        if (instance == null) {
            instance = new PostJSonSerializer();
        }
        return instance;
    }

    public JsonElement serialize(Post post, Type type, JsonSerializationContext jsonSerializationContext) {
        JsonObject obj = new JsonObject();
        obj.addProperty("author", post.author);
        obj.addProperty("title", post.title);
        obj.add("comments", jsonSerializationContext.serialize(post.comments));
        return obj;
    }
}

package models.serializer;

import java.lang.reflect.Type;

import models.Post;

import com.google.gson.JsonElement;

import com.google.gson.JsonObject;

import com.google.gson.JsonSerializationContext;

import com.google.gson.JsonSerializer;

public class PostJSonSerializer implements JsonSerializer<Post> {

public static PostJSonSerializer instance;

private PostJSonSerializer() {

}

public static PostJSonSerializer get() {

if (instance == null) {

instance = new PostJSonSerializer();

}

return instance;

}

public JsonElement serialize(Post post, Type type, JsonSerializationContext jsonSerializationContext) {

JsonObject obj = new JsonObject();

obj.addProperty("author", post.author);

obj.addProperty("title", post.title);

obj.add("comments", jsonSerializationContext.serialize(post.comments));

return obj;

}

app/models/serializer/CommentJSonSerializer.java

package models.serializer;

import java.lang.reflect.Type;
import models.Comment;
import com.google.gson.JsonElement;
import com.google.gson.JsonObject;
import com.google.gson.JsonSerializationContext;
import com.google.gson.JsonSerializer;

public class CommentJSonSerializer implements JsonSerializer<Comment> {
    public static CommentJSonSerializer instance;

    private CommentJSonSerializer() {
    }

    public static CommentJSonSerializer get() {
        if (instance == null) {
            instance = new CommentJSonSerializer();
        }
        return instance;
    }

    public JsonElement serialize(Comment comment, Type type, JsonSerializationContext jsonSerializationContext) {
        JsonObject obj = new JsonObject();
        obj.addProperty("author", comment.author);
        obj.addProperty("content", comment.content);
        return obj;
    }
}

package models.serializer;

import java.lang.reflect.Type;

import models.Comment;

import com.google.gson.JsonElement;

import com.google.gson.JsonObject;

import com.google.gson.JsonSerializationContext;

import com.google.gson.JsonSerializer;

public class CommentJSonSerializer implements JsonSerializer<Comment> {

public static CommentJSonSerializer instance;

private CommentJSonSerializer() {

}

public static CommentJSonSerializer get() {

if (instance == null) {

instance = new CommentJSonSerializer();

}

return instance;

}

public JsonElement serialize(Comment comment, Type type, JsonSerializationContext jsonSerializationContext) {

JsonObject obj = new JsonObject();

obj.addProperty("author", comment.author);

obj.addProperty("content", comment.content);

return obj;

}

On modifie par la suite l’appel à la méthode renderJSon dans le fichier app/controllers/Application.java:

...
    public static void index() {
        List<Post> posts = Post.findAll();
        renderJSON(posts, PostJSonSerializer.get(), CommentJSonSerializer.get());
    }
...

...

public static void index() {

List<Post> posts = Post.findAll();

renderJSON(posts, PostJSonSerializer.get(), CommentJSonSerializer.get());

}

...

Résultat final

Rafraîchissez l’adresse http://localhost:9000 pour obtenir le résultat suivant :

[
   {
      "author":"moi",
      "title":"Post 1",
      "comments":[
         {
            "author":"moi",
            "content":"du Contenu"
         },
         {
            "author":"moi",
            "content":"du Contenu"
         }
      ]
   },
   {
      "author":"moi",
      "title":"Post 2",
      "comments":[
         {
            "author":"moi",
            "content":"du Contenu"
         }
      ]
   }
]

[

{

"author":"moi",

"title":"Post 1",

"comments":[

{

"author":"moi",

"content":"du Contenu"

{

"author":"moi",

"content":"du Contenu"

}

]

{

"author":"moi",

"title":"Post 2",

"comments":[

{

"author":"moi",

"content":"du Contenu"

}

]

}

]

ps: Je vous livre ici mes observations sur le fonctionnement des JSonSerializer. Si vous voyez une façon de mieux les écrire, ou de mieux faire n’hésitez pas à commenter ce billet.

Considérons le contrôleur suivant :

app/controllers/Application.java

package controllers;

import play.mvc.After;
import play.mvc.Before;
import play.mvc.Controller;

public class Application extends Controller {

    @Before
    static void before() {
        System.out.println("before");
        renderArgs.put("nom", "Michel");
    }

    @After
    static void after() {
        System.out.println("after");
        renderArgs.put("nom", "Serge");
    }

    public static void index() {
        System.out.println("index");
        redirect();
    }
    public static void redirect() {
        System.out.println("redirect");
        renderArgs.put("nom", "Robert");
        render();
    }
}

package controllers;

import play.mvc.After;

import play.mvc.Before;

import play.mvc.Controller;

public class Application extends Controller {

@Before

static void before() {

System.out.println("before");

renderArgs.put("nom", "Michel");

}

@After

static void after() {

System.out.println("after");

renderArgs.put("nom", "Serge");

}

public static void index() {

System.out.println("index");

redirect();

}

public static void redirect() {

System.out.println("redirect");

renderArgs.put("nom", "Robert");

render();

}

Ainsi que le template associé :
app/views/Application/redirect.html

#{extends 'main.html' /}
#{set title:'Home' /}

${nom}

#{extends 'main.html' /}

#{set title:'Home' /}

${nom}

Lequel des trois prénoms suivants, Michel, Serge et Robert, va t’il s’afficher dans votre navigateur à l’adresse http://localhost:9000 ?

La réponse est Robert.

Conclusion : Un renderArgs.put dans un @After ne sert à rien!

NooCodeCommit

Masquer l’icône “Préférences d’accès universel” du System Tray sous Ubuntu 12.04

Play! Framework Tips : Circular reference avec renderJSON

Nos Objets Métiers

Données de référence & Configuration

Bootstrap Job & Controller

Premier résultat

Corrections

Résultat final

Play! Framework Tips : un renderArgs.put dans un @After sert t’il à quelque chose

Play! Framework Tips : Attention au Controller nommé “Tags”

Wicket, DropDownChoice & ChoiceRenderer : ou comment afficher ses données