{% extends "../../layout.html" %}

{% block sectionClasses %}plugins hasBreadCrumb plugins-spincast-response{% endblock %}
{% block meta_title %}Plugins - Spincast Response{% endblock %}
{% block meta_description %}Spincast Response plugin to manipulate the headers and content sent.{% endblock %}

{% block scripts %}
<script>

    {#==========================================
    Initialize the Table Of Content
    ==========================================#}
    $(function() {
        app.toc(230);
    });

</script>
{% endblock %}

{% block body %}

<div class="container pluginDoc">

    <ol class="breadcrumb">
        <li><img class="inlineIcon breadIcon" src="/public/images/icons/bread.png" /> <a href="/plugins">Plugins</a></li>
        <li class="active">Spincast Response plugin</li>
    </ol>
    
    <div id="sectionTitle" class="row"> 
        <div class="col-xs-12"> 
            <a href="#top"><h2 class="shortTop noBottom"><img class="inlineIcon" src="/public/images/icons/breadPlugin.png" /> Spincast Response <span>plugin</span></h2></a>
            <div class="pluginBadges">
                <div class="pluginBadgeTop hint--bottom-left hint--bounce" 
                     data-hint="Plugin's Javadoc">
                     <a class="javadoc" href="/public/javadoc/index.html?org/spincast/plugins/response/package-summary.html"><img class="inlineIcon" src="/public/images/javadoc-badge.png" /></a>
                </div>
                <div class="pluginBadgeTop hint--bottom-left hint--bounce" 
                     data-hint="Default plugin included in the 'spincast-default' artifact"><img class="inlineIcon" src="/public/images/default-badge.png" /></div>
                <span class="clear"></span>
            </div>  
        </div>
    </div>
    
    <div id="sectionTitleFixed" class="row"> 
        <div class="col-xs-12">
            <a href="#top"><h2 class="shortTop"><img src="/public/images/logo_xsmall.png" /> Spincast Response <span>plugin</span></h2></a>
        </div>
    </div>

    <div class="row">
        <nav id="toc" class="longTitle col-md-3">
            <ul class="nav nav-stacked">
                <li class="openable"><a href="#top">Overview</a></li>
                <li class="openable"><a href="#installation">Installation</a></li>
                <li class="openable"><a href="#plugin_class">Plugin class</a></li>
                <li class="openable"><a href="#add-on">Suggested <em>add-on</em></a></li>
                <li class="openable"><a href="#javadoc">Javadoc</a></li>
            </ul>
        </nav>
        
        <div id="toc-content" class="col-md-9">

            <section id="overview">
	            <h3>
                    <a class="anchor" href="#overview" title="permanent link"></a>
                    Overview
                </h3>
	            <p>
                    This plugin provides a <code>add-on</code> to help building a response to the current HTTP request.
	            </p>
                <p>
                    Make sure you read the dedicated <a href="/documentation#sending_response">Sending the response</a> 
                    section for more information.
                </p>
            </section>
            
            <section id="installation">
                <h3>
                    <a class="anchor" href="#installation" title="permanent link"></a>
                    Installation
                </h3>
                <p>
                    <img class="inlineIcon" src="/public/images/default-badge.png" />
                    <em>If you use the <code>spincast-default</code> artifact and the standard <a href="/documentation#boot_bootstrapper">Bootstrapper</a>, 
                    this plugin is already installed by default so you have nothing to do!</em>
                </p>
                <p>
                    If you start from scratch, using the <code>spincast-core</code> artifact, you can use the
                    plugin by :
                </p>
                <p>
                    1. 
                    Adding this Maven artifact to your project:
                    <div>
                        <p>
                            <pre class="ace ace-xml"
>&lt;dependency&gt;
    &lt;groupId&gt;org.spincast&lt;/groupId&gt;
    &lt;artifactId&gt;spincast-plugins-response&lt;/artifactId&gt;
    &lt;version&gt;{{spincast.spincastCurrrentVersion}}&lt;/version&gt;
&lt;/dependency&gt;</pre> 
                        </p>
                    </div>  
                </p>
                <p>
                    2. Installing the provided <a class="javadoc" href="/public/javadoc/org/spincast/plugins/response/SpincastResponsePluginModule.html">SpincastResponsePluginModule</a> 
                    module to your Guice context.
                </p>
            </section>
            
            <section id="plugin_class">
                <h3>
                    <a class="anchor" href="#plugin_class" title="permanent link"></a>
                    Plugin class
                </h3>
                <p>
                    The class implementing the <a class="javadoc" href="/public/javadoc/org/spincast/core/guice/SpincastPlugin.html">SpincastPlugin</a> 
                    interface is <a class="javadoc" href="/public/javadoc/org/spincast/plugins/response/SpincastResponsePlugin.html">SpincastResponsePlugin</a>.
                </p>
            </section>
            
            <section id="add-on">
                <h3>
                    <a class="anchor" href="#add-on" title="permanent link"></a>
                    Suggested <em>add-on</em>
                </h3>
                <p>
                    <ul>
                        <li>
                            <strong>Name</strong> : <code>response()</code>
                        </li>
                        <li>
                            <strong>Component</strong> : <a class="javadoc" href="/public/javadoc/org/spincast/core/exchange/ResponseRequestContextAddon.html">ResponseRequestContextAddon</a>
                        </li>
                        <li>
                            <strong>Usage</strong> : to help building a response to the current HTTP request. It allows you to manipulate the
                            HTTP headers and provides utilities to build the body.
                        </li>
                    </ul>
                </p>
                <p>
                    Examples :
                    
              
	                <ul>
                        <li>
                            Sending content directly :
                            
                            <div>
                                <p>
                                    <pre class="ace ace-java"
>public void myHandler(AppRequestContext context) {
    context.response().setStatusCode(418);
    context.response().sendPlainText("Drink tea!");
}</pre>
                                </p>
                            </div> 
                        </li>
                        <li>
                            Building the <code>response model</code> and render <code>HTML</code> 
                            using a template :
                            
                            <div>
                                <p>
                                    <pre class="ace ace-java"
>public void myHandler(AppRequestContext context) {
    //...
    context.response().getModel().set("user", someUser);
    context.response().sendTemplateHtml("/templates/user.html");
}</pre>
                                </p>
                            </div> 
                        </li>  
                    </ul>

                </p>
                <p>
                    <img class="inlineIcon" src="/public/images/default-badge.png" />
                    <em>This add-on is already installed by default on the 
                    <a class="javadoc" href="/public/javadoc/org/spincast/core/exchange/RequestContext.html">Request Context</a> type.</em>
                </p>
            </section>
            
            <section id="javadoc">
                <h3>
                    <a class="anchor" href="#javadoc" title="permanent link"></a>
                    Javadoc
                </h3>
                <p>
                    <ul>
                        <li>
                            <a class="javadoc" href="/public/javadoc/org/spincast/core/exchange/ResponseRequestContextAddon.html">ResponseRequestContextAddon</a>
                        </li>
                    </ul>
                </p> 
            </section>
            

            
        </div>
    </div>
</div> 

{% endblock %}