public abstract class QueryTagSupport
extends jakarta.servlet.jsp.tagext.BodyTagSupport
implements jakarta.servlet.jsp.tagext.TryCatchFinally, jakarta.servlet.jsp.jstl.sql.SQLExecutionTag
Tag handler for <Query> in JSTL.
Modifier and Type | Field and Description |
---|---|
protected boolean |
dataSourceSpecified |
protected int |
maxRows |
protected boolean |
maxRowsSpecified |
protected Object |
rawDataSource |
protected String |
sql |
protected int |
startRow |
Constructor and Description |
---|
QueryTagSupport() |
Modifier and Type | Method and Description |
---|---|
void |
addSQLParameter(Object o)
Called by nested parameter elements to add PreparedStatement
parameter values.
|
void |
doCatch(Throwable t)
Just rethrows the Throwable.
|
int |
doEndTag()
Execute the SQL statement, set either through the
sql
attribute or as the body, and save the result as a variable
named by the var attribute in the scope specified
by the scope attribute, as an object that implements
the Result interface. |
void |
doFinally()
Close the
Connection , unless this action is used
as part of a transaction. |
int |
doStartTag()
Prepares for execution by setting the initial state, such as
getting the
Connection |
void |
setScope(String scopeName)
Setter method for the scope of the variable to hold the
result.
|
void |
setVar(String var)
Setter method for the name of the variable to hold the
result.
|
doAfterBody, doInitBody, getBodyContent, getPreviousOut, release, setBodyContent
findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue
protected Object rawDataSource
protected boolean dataSourceSpecified
protected String sql
protected int maxRows
protected boolean maxRowsSpecified
protected int startRow
public void setVar(String var)
public void setScope(String scopeName)
public void addSQLParameter(Object o)
addSQLParameter
in interface jakarta.servlet.jsp.jstl.sql.SQLExecutionTag
public int doStartTag() throws jakarta.servlet.jsp.JspException
Connection
doStartTag
in interface jakarta.servlet.jsp.tagext.Tag
doStartTag
in class jakarta.servlet.jsp.tagext.BodyTagSupport
jakarta.servlet.jsp.JspException
public int doEndTag() throws jakarta.servlet.jsp.JspException
Execute the SQL statement, set either through the sql
attribute or as the body, and save the result as a variable
named by the var
attribute in the scope specified
by the scope
attribute, as an object that implements
the Result interface.
The connection used to execute the statement comes either
from the DataSource
specified by the
dataSource
attribute, provided by a parent action
element, or is retrieved from a JSP scope attribute
named jakarta.servlet.jstl.sql.dataSource
.
doEndTag
in interface jakarta.servlet.jsp.tagext.Tag
doEndTag
in class jakarta.servlet.jsp.tagext.BodyTagSupport
jakarta.servlet.jsp.JspException
public void doCatch(Throwable t) throws Throwable
doCatch
in interface jakarta.servlet.jsp.tagext.TryCatchFinally
Throwable
public void doFinally()
Connection
, unless this action is used
as part of a transaction.doFinally
in interface jakarta.servlet.jsp.tagext.TryCatchFinally
Copyright © 2019,2020 Eclipse Foundation. All rights reserved.