public class BasicPostStatement
extends java.lang.Object
The class holds a set of attributes that let Client and the server to communicate; it supports the generic sql statement to be stored either for data modification or for retrieving a record set from the database.
In the m_items
member it contains a java.util.Vector where the
elements (of type Item
) transfer multi purpose parameters.
By having the exclusive role, in the framework, to work as container of the
single generalized statement, its implementation is such that the instances
of it live on both sides of the Joty technology: on the client, to allow the
composition the box for delivering the statement on the channel, and on the
server, to compose the received content in a form known to the framework.
Even if this happens either the Accessor mode is active or not, most of its
implementation is relative to the use with the Accessor
object, that
is in Accessor mode.
The most frequent use of this class when the Accessor mode is on, is the
packaging of the information needed to address the statement within the
Accessor object plus the parameters context used by the Accessor object to
actualize the parameters of the statement addressed (see
addItemsFromParamContext
method). Another task of this class is to
carry the invocation of a method stored in the Accessor object, this method
definition can define an invocation of a dbms stored-procedure or something
different about whatever computation, accessing something or not. In this
task comes in to the scene another dual class: the org.joty.common.MethodExecutor
class; the instance of this class follows the Accessor object: the values
returned from the method call are collected, as final step, by this class
that makes them available to possible consumers (see
Application.invokeAccessMethod
).
Its methods load the content of the ParamContext and store it in an empty instance. They help in retrieving statements from the Accessor object or making literal substitutions when the contribution of the Accessor object is the obfuscation of the database name space.
ParamContext
Modifier and Type | Class and Description |
---|---|
class |
BasicPostStatement.Item
This inner class contains in a textual form a value compatible with the
datum wrapped by the
WrappedField object or the value of a ContextParam object. |
class |
BasicPostStatement.ReturnedValueItem |
Modifier and Type | Field and Description |
---|---|
java.lang.String |
m_AccessorContext
the absolute class name of the
DataAccessDialog that is used for discovering the corresponding Accessor context |
java.lang.String |
m_autoId
the name of the autoincrement id field
|
java.lang.String |
m_dataPanelIdx
the zero based position of the
DataAccessPanel within the
TabbedPane object: a second further coordinate added to the contribution of the m_AccessorContext member. |
java.lang.String |
m_firstOutParamPos |
java.lang.String |
m_genTable |
java.util.Vector<BasicPostStatement.Item> |
m_items
A vector of a general purpose parameters
|
java.lang.String |
m_iteration |
java.lang.String |
m_mainFilter |
java.lang.String |
m_method
the name of the method stored in the
Accessor object or the mode
of opening of a DataAccessDialog object having its statements context
stored in the Accessor object |
int |
m_nonManagedRollbackActionIden |
java.lang.String |
m_outParamsQty |
ParamContext |
m_paramContext |
java.util.Vector<BasicPostStatement.ReturnedValueItem> |
m_returnedValues |
CaselessStringKeyMap<BasicPostStatement.ReturnedValueItem> |
m_returnedValuesMap |
java.lang.String |
m_retVal |
java.lang.String |
m_sortExpr |
java.lang.String |
m_sql |
java.lang.String |
m_termName
the name of the
Term object within the DataAccessPanel
object layout: the third coordinate added to the contribution of the
m_dataPanelIdx member |
java.lang.String |
m_verifyExpr |
Constructor and Description |
---|
BasicPostStatement(JotyMessenger jotyMessanger) |
Modifier and Type | Method and Description |
---|---|
void |
addItem(java.lang.String item,
java.lang.String valueLiteral) |
void |
addItem(java.lang.String item,
java.lang.String valueLiteral,
int type) |
void |
addItemsFromParamContext(ParamContext paramContext) |
void |
addOutParam(java.lang.String name,
int type,
int returnPosition) |
void |
clear() |
void |
setDataDefCoordinates(java.lang.String dialogName,
int panelIdx,
java.lang.String termName) |
void |
setMethod(java.lang.String method,
java.lang.Integer returnedValuePos,
java.lang.Integer returnedValuesQty) |
public java.lang.String m_sql
public java.lang.String m_autoId
public java.lang.String m_genTable
public java.lang.String m_verifyExpr
public int m_nonManagedRollbackActionIden
public java.lang.String m_method
Accessor
object or the mode
of opening of a DataAccessDialog
object having its statements context
stored in the Accessor objectpublic java.lang.String m_firstOutParamPos
public java.lang.String m_outParamsQty
public java.lang.String m_AccessorContext
DataAccessDialog
that is used for discovering the corresponding Accessor contextpublic java.lang.String m_dataPanelIdx
DataAccessPanel
within the
TabbedPane
object: a second further coordinate added to the contribution of the m_AccessorContext
member.public java.lang.String m_termName
Term
object within the DataAccessPanel
object layout: the third coordinate added to the contribution of the
m_dataPanelIdx
memberpublic java.lang.String m_mainFilter
public java.lang.String m_sortExpr
public java.lang.String m_iteration
public java.util.Vector<BasicPostStatement.Item> m_items
public java.util.Vector<BasicPostStatement.ReturnedValueItem> m_returnedValues
public CaselessStringKeyMap<BasicPostStatement.ReturnedValueItem> m_returnedValuesMap
public java.lang.String m_retVal
public ParamContext m_paramContext
public BasicPostStatement(JotyMessenger jotyMessanger)
public void addItem(java.lang.String item, java.lang.String valueLiteral)
public void addItem(java.lang.String item, java.lang.String valueLiteral, int type)
public void addItemsFromParamContext(ParamContext paramContext)
public void addOutParam(java.lang.String name, int type, int returnPosition)
public void clear()
public void setDataDefCoordinates(java.lang.String dialogName, int panelIdx, java.lang.String termName)
public void setMethod(java.lang.String method, java.lang.Integer returnedValuePos, java.lang.Integer returnedValuesQty)