com.fizzed.rocker.runtime.DefaultRockerModel Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of rocker-runtime Show documentation
The newest version!
/*
 * Copyright 2015 Fizzed Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.fizzed.rocker.runtime;

import com.fizzed.rocker.RenderingException;
import com.fizzed.rocker.RockerOutput;
import com.fizzed.rocker.RockerModel;
import com.fizzed.rocker.RockerOutputFactory;
import com.fizzed.rocker.RockerTemplateCustomizer;

public class DefaultRockerModel implements RockerModel {
    
    private boolean rendered;
    
    /**
     * Renders model and template content to output. Single use only.
     * @return The output of rendering process
     * @throws RenderingException Thrown if any error encountered while rendering
     *      template. Exception will include underlying cause as well as line
     *      and position of original template source that triggered exception.
     */
    @Override
    public RockerOutput render() throws RenderingException {
        return doRender(null, null, null);
    }
    
    @Override
    public  O render(RockerOutputFactory outputFactory) throws RenderingException {
        return (O)doRender(null, outputFactory, null);
    }
    
    @Override
    public  O render(RockerOutputFactory outputFactory,
                                             RockerTemplateCustomizer templateCustomizer) throws RenderingException {
        return (O)doRender(null, outputFactory, templateCustomizer);
    }
    
    protected RockerOutput doRender(DefaultRockerTemplate context,
                                    RockerOutputFactory outputFactory,
                                    RockerTemplateCustomizer templateCustomizer) throws RenderingException {
        // no real need for thread safety since templates should only be used by a single thread
        if (this.rendered) {
            throw new RenderingException("Template already rendered (templates are single use only!)");
        }
        
        DefaultRockerTemplate template = buildTemplate();
        
        if (templateCustomizer != null) {
            templateCustomizer.customize(template);
        }
        
        this.rendered = true;
        
        return template.__render(context, outputFactory);
    }
    
    protected DefaultRockerTemplate buildTemplate() throws RenderingException  {
        throw new RenderingException("Rocker model does not implement buildTemplate(). Did you forget to implement?");
    }
    
    @Override
    public String toString() {
        throw new UnsupportedOperationException("toString() not permitted on DefaultRockerTemplateModel. User render() method.");
    }
    
}