org.apache.taglibs.standard.tag.el.xml.ParseTag Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jakarta.servlet.jsp.jstl Show documentation
Show all versions of jakarta.servlet.jsp.jstl Show documentation
Jakarta Standard Tag Library Implementation
/*
* Copyright (c) 1997-2020 Oracle and/or its affiliates. All rights reserved.
* Copyright 2004 The Apache Software Foundation
*
* 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 org.apache.taglibs.standard.tag.el.xml;
import jakarta.servlet.jsp.JspException;
import org.apache.taglibs.standard.tag.common.core.NullAttributeException;
import org.apache.taglibs.standard.tag.common.xml.ParseSupport;
import org.apache.taglibs.standard.tag.el.core.ExpressionUtil;
import org.xml.sax.XMLFilter;
/**
* A handler for <parse> that accepts attributes as Strings
* and evaluates them as expressions at runtime.
*
* @author Shawn Bayern
*/
public class ParseTag extends ParseSupport {
//*********************************************************************
// 'Private' state (implementation details)
private String xml_; // stores EL-based property
private String systemId_; // stores EL-based property
private String filter_; // stores EL-based property
//*********************************************************************
// Constructor
/**
* Constructs a new ParseTag. As with TagSupport, subclasses
* should not provide other constructors and are expected to call
* the superclass constructor
*/
public ParseTag() {
super();
init();
}
//*********************************************************************
// Tag logic
// evaluates expression and chains to parent
public int doStartTag() throws JspException {
// evaluate any expressions we were passed, once per invocation
evaluateExpressions();
// chain to the parent implementation
return super.doStartTag();
}
// Releases any resources we may have (or inherit)
public void release() {
super.release();
init();
}
//*********************************************************************
// Accessor methods
// for EL-based attribute
public void setFilter(String filter_) {
this.filter_ = filter_;
}
public void setXml(String xml_) {
this.xml_ = xml_;
}
public void setSystemId(String systemId_) {
this.systemId_ = systemId_;
}
//*********************************************************************
// Private (utility) methods
// (re)initializes state (during release() or construction)
private void init() {
// null implies "no expression"
filter_ = xml_ = systemId_ = null;
}
/* Evaluates expressions as necessary */
private void evaluateExpressions() throws JspException {
/*
* Note: we don't check for type mismatches here; we assume
* the expression evaluator will return the expected type
* (by virtue of knowledge we give it about what that type is).
* A ClassCastException here is truly unexpected, so we let it
* propagate up.
*/
xml = ExpressionUtil.evalNotNull(
"parse", "xml", xml_, Object.class, this, pageContext);
systemId = (String) ExpressionUtil.evalNotNull(
"parse", "systemId", systemId_, String.class, this, pageContext);
try {
filter = (XMLFilter) ExpressionUtil.evalNotNull(
"parse", "filter", filter_, XMLFilter.class, this, pageContext);
} catch (NullAttributeException ex) {
// explicitly let 'filter' be null
filter = null;
}
}
}