io.dropwizard.views.ViewBundle Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of dropwizard-views Show documentation
There is a newer version: 1.3.0-rc6
package io.dropwizard.views;

import com.google.common.collect.ImmutableSet;
import com.google.common.collect.ImmutableMap;
import io.dropwizard.Bundle;
import io.dropwizard.Configuration;
import io.dropwizard.ConfiguredBundle;
import io.dropwizard.setup.Bootstrap;
import io.dropwizard.setup.Environment;

import java.util.Collections;
import java.util.Map;
import java.util.ServiceLoader;

import static com.google.common.base.MoreObjects.firstNonNull;

/**
 * A {@link Bundle}, which by default, enables the rendering of FreeMarker & Mustache views by your application.
 *
 * Other instances of {@link ViewRenderer} can be used by initializing your {@link ViewBundle} with a
 * {@link Iterable} of the {@link ViewRenderer} instances to be used when configuring your {@link Bundle}:
 *
 * 
 * new ViewBundle(ImmutableList.of(myViewRenderer))
 * 
 *
 * A view combines a Freemarker or Mustache template with a set of Java objects:
 *
 * 
 * public class PersonView extends View {
 *     private final Person person;
 *
 *     public PersonView(Person person) {
 *         super("profile.ftl"); // or super("profile.mustache"); for a Mustache template
 *         this.person = person;
 *     }
 *
 *     public Person getPerson() {
 *         return person;
 *     }
 * }
 * 
 *
 *The {@code "profile.ftl"} or {@code "profile.mustache"} is the path of the template relative to the class name. If
 * this class was {@code com.example.application.PersonView}, Freemarker or Mustache would then look for the file
 * {@code src/main/resources/com/example/application/profile.ftl} or {@code
 * src/main/resources/com/example/application/profile.mustache} respectively. If the template path
 * starts with a slash (e.g., {@code "/hello.ftl"} or {@code "/hello.mustache"}), Freemarker or Mustache will look for
 * the file {@code src/main/resources/hello.ftl} or {@code src/main/resources/hello.mustache} respectively.
 *
 * 
A resource method with a view would looks something like this:
 *
 * 
 * \@GET
 * public PersonView getPerson(\@PathParam("id") String id) {
 *     return new PersonView(dao.find(id));
 * }
 * 
 *
 * Freemarker templates look something like this:
 *
 * {@code
 * <#-- @ftlvariable name="" type="com.example.application.PersonView" -->
 * 
 *     
 *         Hello, ${person.name?html}!
 *     
 * 
 * }
 *
 * In this template, {@code ${person.name}} calls {@code getPerson().getName()}, and the
 * {@code ?html} escapes all HTML control characters in the result. The {@code ftlvariable} comment
 * at the top indicate to Freemarker (and your IDE) that the root object is a {@code Person},
 * allowing for better type-safety in your templates.
 *
 * @see FreeMarker Manual
 *
 * Mustache templates look something like this:
 *
 * {@code
 * 
 *     
 *         Hello, {{person.name}}!
 *     
 * 
 * }
 *
 * In this template, {@code {{person.name}}} calls {@code getPerson().getName()}.
 *
 * @see Mustache Manual
 */
public class ViewBundle implements ConfiguredBundle, ViewConfigurable {
    private final Iterable viewRenderers;

    public ViewBundle() {
        this(ServiceLoader.load(ViewRenderer.class));
    }

    public ViewBundle(Iterable viewRenderers) {
        this.viewRenderers = ImmutableSet.copyOf(viewRenderers);
    }

    public Map> getViewConfiguration(T configuration) {
        return ImmutableMap.of();
    }

    @Override
    public void run(T configuration, Environment environment) throws Exception {
        final Map> options = getViewConfiguration(configuration);
        for (ViewRenderer viewRenderer : viewRenderers) {
            final Map viewOptions = options.get(viewRenderer.getSuffix());
            viewRenderer.configure(firstNonNull(viewOptions, Collections.emptyMap()));
        }
        environment.jersey().register(new ViewMessageBodyWriter(environment.metrics(), viewRenderers));
    }

    @Override
    public void initialize(Bootstrap bootstrap) {
        // nothing doing
    }
}