Uploaded image for project: 'Seam 2'
  1. Seam 2
  2. JBSEAM-3988

Support for mapping RESTful XHTML resource representations with Facelets templates



    • Type: Feature Request
    • Status: Open (View Workflow)
    • Priority: Major
    • Resolution: Unresolved
    • Affects Version/s: None
    • Fix Version/s: The future
    • Component/s: WS
    • Labels:


      What I wrote a while ago about this feature:

      I'm thinking about a special provider that can marshal an object graph into an XHTML (not just XML) response body and back from an XHTML request body to an object graph. This is about the "connectedness" of resources, see the O'Reilly REST book. As a developer I should write a Facelets XHTML template that defines the transformation. Imagine that you write it the same way you write a JSF template today, with bidirectional binding using EL expressions, from object getter/setter pair to XML attribute or element value. We can even have built-in Facelets "widgets" that render certain microformats. Seam has some machinery for this already but we might need an extra interceptor on resource methods to trigger the transformation. Or we use Seams pages.xml navigation rules ("when this resource method finishes, render this template").

      Later I did some prototype experiments - note that this only considers uni-directional mapping for GET, handling POST/PUT resource representation is more difficult:

      package org.jboss.seam.resteasy;

      import java.lang.annotation.*;


      • @author Christian Bauer
        @Target( {ElementType.METHOD}

        public @interface FaceletsXhtmlResponse {
        String template();

      package org.jboss.seam.resteasy;

      import org.jboss.seam.core.Interpolator;
      import org.jboss.seam.faces.Renderer;
      import org.jboss.seam.log.Log;
      import org.jboss.seam.log.Logging;

      import javax.ws.rs.ProduceMime;
      import javax.ws.rs.core.MediaType;
      import javax.ws.rs.core.MultivaluedMap;
      import javax.ws.rs.ext.MessageBodyWriter;
      import javax.ws.rs.ext.Provider;
      import java.io.IOException;
      import java.io.OutputStream;
      import java.lang.annotation.Annotation;
      import java.lang.reflect.Type;


      • @author Christian Bauer
        public class FaceletsXhtmlProvider implements MessageBodyWriter<Object> {

      Log log = Logging.getLog(FaceletsXhtmlProvider.class);

      public boolean isWriteable(Class<?> type, Type genericType, Annotation[] annotations) {
      for (Annotation annotation : annotations) {
      if (annotation.annotationType().equals(FaceletsXhtmlResponse.class))

      { return true; }

      return false;

      public long getSize(Object o)

      { return -1; }

      public void writeTo(Object o, Class<?> type, Type genericType, Annotation[] annotations,
      MediaType mediaType, MultivaluedMap<String, Object> httpHeaders, OutputStream entityStream)
      throws IOException {
      log.debug("writing XHTML response for entity type: " + type.getName());
      FaceletsXhtmlResponse respAnnotation = null;
      for (Annotation annotation : annotations)

      { if (annotation.annotationType().equals(FaceletsXhtmlResponse.class)) respAnnotation = (FaceletsXhtmlResponse) annotation; }

      if (respAnnotation == null) throw new IllegalStateException("@FaceletsXhtmlResponse annotation disappeared");
      String template = getTemplatePath(respAnnotation);
      log.debug("rendering XHTML template: " + template);
      String output = Renderer.instance().render(template);

      protected String getTemplatePath(FaceletsXhtmlResponse annotation)

      { return isTemplatePathInterpolated() ? Interpolator.instance().interpolate(annotation.template()) : annotation.template(); }

      protected boolean isTemplatePathInterpolated()

      { return true; }


      public class CustomerResource {

      template = "#


      @Out(value = "customers", scope = ScopeType.EVENT)
      public List<Customer> getCustomers()

      { return mockCustomers(); }


      <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
      <html xmlns="http://www.w3.org/1999/xhtml"
      <t:repeat var="cust" value="#


      <h:outputText value="#




          Issue Links



              Unassigned Unassigned
              christian.bauer Christian Bauer (Inactive)
              1 Vote for this issue
              2 Start watching this issue