/*
* $Id: InsertTemplateTag.java 929598 2010-03-31 15:53:02Z apetrelli $
*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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 org.apache.tiles.jsp.taglib;
import java.io.IOException;
import javax.servlet.jsp.JspContext;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.SimpleTagSupport;
import org.apache.tiles.jsp.context.JspUtil;
import org.apache.tiles.template.InsertTemplateModel;
/**
* This is the tag handler for <tiles:insertTemplate>, which includes a
* template ready to be filled.
*
* @version $Rev: 929598 $ $Date: 2010-03-31 17:53:02 +0200 (mer, 31 mar 2010) $
*/
public class InsertTemplateTag extends SimpleTagSupport {
/**
* The template model.
*/
private InsertTemplateModel model = new InsertTemplateModel();
/**
* The role to check. If the user is in the specified role, the tag is taken
* into account; otherwise, the tag is ignored (skipped).
*
* @since 2.1.1
*/
private String role;
/**
* The view preparer to use before the rendering.
*
* @since 2.1.1
*/
private String preparer;
/**
* This flag, if <code>true</code>, flushes the content after rendering.
*
* @since 2.1.1
*/
private boolean flush;
/**
* This flag, if <code>true</code>, ignores exception thrown by preparers
* and those caused by problems with definitions.
*
* @since 2.1.1
*/
private boolean ignore;
/**
* A string representing the URI of a template (for example, a JSP page).
*
* @since 2.1.0
*/
private String template;
/**
* The type of the template attribute.
*
* @since 2.2.0
*/
private String templateType;
/**
* The expression to evaluate to get the value of the template.
*
* @since 2.2.0
*/
private String templateExpression;
/**
* Returns the role to check. If the user is in the specified role, the tag is
* taken into account; otherwise, the tag is ignored (skipped).
*
* @return The role to check.
* @since 2.1.1
*/
public String getRole() {
return role;
}
/**
* Sets the role to check. If the user is in the specified role, the tag is
* taken into account; otherwise, the tag is ignored (skipped).
*
* @param role The role to check.
* @since 2.1.1
*/
public void setRole(String role) {
this.role = role;
}
/**
* Returns the preparer name.
*
* @return The preparer name.
* @since 2.1.1
*/
public String getPreparer() {
return preparer;
}
/**
* Sets the preparer name.
*
* @param preparer The preparer name.
* @since 2.1.1
*/
public void setPreparer(String preparer) {
this.preparer = preparer;
}
/**
* Returns the flush flag. If <code>true</code>, current page out stream
* is flushed after insertion.
*
* @return The flush flag.
* @since 2.1.1
*/
public boolean isFlush() {
return flush;
}
/**
* Sets the flush flag. If <code>true</code>, current page out stream
* is flushed after insertion.
*
* @param flush The flush flag.
* @since 2.1.1
*/
public void setFlush(boolean flush) {
this.flush = flush;
}
/**
* Returns the ignore flag. If it is set to true, and the attribute
* specified by the name does not exist, simply return without writing
* anything. The default value is false, which will cause a runtime
* exception to be thrown.
*
* @return The ignore flag.
* @since 2.1.1
*/
public boolean isIgnore() {
return ignore;
}
/**
* Sets the ignore flag. If this attribute is set to true, and the attribute
* specified by the name does not exist, simply return without writing
* anything. The default value is false, which will cause a runtime
* exception to be thrown.
*
* @param ignore The ignore flag.
* @since 2.1.1
*/
public void setIgnore(boolean ignore) {
this.ignore = ignore;
}
/**
* Returns a string representing the URI of a template (for example, a JSP
* page).
*
* @return The template URI.
* @since 2.1.0
*/
public String getTemplate() {
return template;
}
/**
* Sets a string representing the URI of a template (for example, a JSP
* page).
*
* @param template The template URI.
* @since 2.1.0
*/
public void setTemplate(String template) {
this.template = template;
}
/**
* Returns the type of the template attribute.
*
* @return The template type.
* @since 2.2.0
*/
public String getTemplateType() {
return templateType;
}
/**
* Sets the type of the template attribute.
*
* @param templateType The template type.
* @since 2.2.0
*/
public void setTemplateType(String templateType) {
this.templateType = templateType;
}
/**
* Returns the expression to evaluate to get the value of the template.
*
* @return The template expression.
* @since 2.2.0
*/
public String getTemplateExpression() {
return templateExpression;
}
/**
* Sets the expression to evaluate to get the value of the template.
*
* @param templateExpression The template expression.
* @since 2.2.0
*/
public void setTemplateExpression(String templateExpression) {
this.templateExpression = templateExpression;
}
/** {@inheritDoc} */
@Override
public void doTag() throws JspException, IOException {
JspContext jspContext = getJspContext();
model.start(JspUtil.getCurrentContainer(jspContext), jspContext);
JspUtil.evaluateFragment(getJspBody());
model.end(JspUtil.getCurrentContainer(jspContext), template,
templateType, templateExpression, role, preparer, jspContext);
if(isFlush()){
jspContext.getOut().flush();
}
}
}