|
Oracle Data-aware Controls Reference | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectoracle.dacf.dataset.DacObject
oracle.dacf.dataset.DataItemImpl
oracle.dacf.dataset.RowsetAccessImpl
oracle.dacf.dataset.MappingRowsetAccessImpl
Maps the actions performed through this RowsetAccess to another RowsetAccess
This allows an independent query, which can be views as a subset of
a second query, to keep the second query synchronized with the first
query.
Any inserts into the second query will be echoed into the underlying
query provided that the row being inserted passes the RowFilter if
one is defined. If not filter is defined, then the row will be
automatically inserted.
Field Summary | |
protected oracle.dacf.dataset.RowSetState |
_curState
|
protected boolean |
_exceptionRunning
|
protected java.lang.Object |
_exceptionRunningGate
|
protected oracle.jbo.RowSet |
_rowset
|
protected oracle.jbo.RowSetIterator |
_rowsetIter
|
protected oracle.dacf.dataset.ViewArrayAccessImpl |
_view
|
protected static int |
COLUMN_ALIGNMENTS
|
protected static int |
COLUMN_LABELS
|
protected static int |
COLUMN_WIDTHS
|
protected static java.lang.String |
ERR_PROD_CODE
|
protected static int |
QUERYABLE_COLUMNS
|
protected static int |
RETURN_ITEMS
|
protected static int |
SORTING_ENABLED
|
Fields inherited from class oracle.dacf.dataset.DacObject |
EMPTY_PREFIX, INITIAL_CAPACITY, ITEMNAME_DELIMITER |
Constructor Summary | |
MappingRowsetAccessImpl()
|
|
MappingRowsetAccessImpl(java.lang.String name,
javax.infobus.InfoBusEventListener source,
ResultSetInfo rsInfo)
|
|
MappingRowsetAccessImpl(java.lang.String name,
javax.infobus.InfoBusEventListener source,
ResultSetInfo rsInfo,
DacObject parent)
|
Method Summary | |
boolean |
absolute(int rowNumber)
Move to a specific row in the rowset. |
protected void |
addChild(DataItemImpl child)
Adds a child to this RowsetAccessImpl. |
boolean |
canDelete()
|
boolean |
canInsert()
|
boolean |
canUpdate()
|
boolean |
canUpdate(int columnIndex)
|
boolean |
canUpdate(java.lang.String columnName)
|
java.lang.Object |
clone()
Implements a deep copy of the object. |
void |
deferredNavigated(oracle.jbo.NavigationEvent e)
|
void |
deferredRangeRefreshed(oracle.jbo.RangeRefreshEvent e)
|
void |
deferredRangeScrolled(oracle.jbo.ScrollEvent e)
|
void |
deferredRowDeleted(oracle.jbo.DeleteEvent e)
|
void |
deferredRowInserted(oracle.jbo.InsertEvent e)
|
void |
deferredRowUpdated(oracle.jbo.UpdateEvent e)
|
void |
deleteRow()
|
void |
destroy()
Internal: Applications should not use this method. |
protected void |
doPostRollback()
Internal: Applications should not use this method. |
protected void |
doPreRollback()
Internal: Applications should not use this method. |
int |
findRangeIndexOf(java.lang.String[] colNames,
java.lang.Object[] values)
Searches for a row, like the findRow method above. |
boolean |
findRow(java.lang.String[] colNames,
java.lang.Object[] values)
Finds a the first row within the result set that contains values in columns. |
boolean |
first()
Move to the first row of the result set. |
void |
flush()
|
int |
getBufferSize()
Returns the size of the "visible" buffer. |
java.lang.Object[] |
getColumnAlignments()
get all the column horizontal alignments |
int |
getColumnCount()
|
java.lang.String |
getColumnDatatypeName(int columnIndex)
|
int |
getColumnDatatypeNumber(int index)
|
int |
getColumnIndex(java.lang.String columnName)
Returns the index of the specified column |
java.lang.Object |
getColumnItem(int colNum)
|
java.lang.Object |
getColumnItem(java.lang.String colName)
|
java.lang.Object[] |
getColumnLabels()
get all the column labels |
java.lang.String |
getColumnName(int colIndex)
Gets the name of the column at postion n. |
java.lang.Object[] |
getColumnWidths()
get all the column widths |
javax.infobus.DbAccess |
getDb()
|
long |
getEstimatedRowCount()
|
int |
getHighWaterMark()
|
java.lang.Object |
getProperty(java.lang.String propertyName)
Returns a property of the data item. |
java.lang.Object[] |
getQueryableColumnDataItemNames()
get all the 'queryable columns data item names' |
java.lang.Object[] |
getReturnItemNames()
get all the 'return item names' |
int |
getRow()
|
int |
getRowCount()
|
oracle.jbo.RowSet |
getRowSet()
Returns the server-side RowSet that is associated with this RowsetAccessImpl. |
oracle.jbo.RowSetIterator |
getRowSetIterator()
Returns the server-side RowSetiterator that is associated with this RowsetAccessImpl. |
java.lang.Object[] |
getSortingEnabled()
get if sorting should be allowed for each column |
oracle.dacf.dataset.RowsetAccessImpl |
getTarget()
Internal: Applications should not use this method. |
javax.infobus.ArrayAccess |
getView(int viewSize)
Returns an ArrayAccess that provides access to the rows in range. |
int |
getViewStart()
Returns the start row of the view. |
boolean |
hasMoreRows()
|
boolean |
hasNext()
|
boolean |
hasPrevious()
|
boolean |
hasRows()
|
protected void |
insertChildAt(DataItemImpl child,
int index)
Adds a child to this RowsetAccessImpl at a specific index position. |
boolean |
isFromLinkAccessor()
|
protected boolean |
isFromViewAccessor()
|
boolean |
isRangeAtBottom()
|
boolean |
isRangeAtTop()
|
boolean |
last()
Move to the last row of the result set. |
void |
lockRow()
|
void |
navigated(oracle.jbo.NavigationEvent e)
Invoked when the current-row designation changes. |
javax.infobus.ScrollableRowsetAccess |
newCursor()
|
void |
newRow()
Adds a new row to the Rowset. |
boolean |
next()
Move to the next row relative to the current row. |
boolean |
previous()
Move to the previous row relative to the current row. |
protected void |
publish(boolean publishKids)
|
void |
rangeRefreshed(oracle.jbo.RangeRefreshEvent e)
Invoked when the range changes. |
void |
rangeScrolled(oracle.jbo.ScrollEvent e)
Invoked when the range is scrolled. |
boolean |
relative(int numRows)
Move numRows relative to the current row in the rowset. |
protected void |
removeChild(DataItemImpl child)
Removes a child from this RowsetAccessImpl. |
void |
rowDeleted(oracle.jbo.DeleteEvent e)
Invoked when a row has been deleted. |
void |
rowInserted(oracle.jbo.InsertEvent e)
Invoked when a row has been inserted. |
void |
rowUpdated(oracle.jbo.UpdateEvent e)
Invoked when an attribute of the row has been changed. |
void |
scrollView(int numRows)
|
void |
setBufferSize(int size)
Specifies the size of the "visible" buffer. |
void |
setColumnValue(int columnIndex,
java.lang.Object obj)
|
void |
setColumnValue(java.lang.String columnName,
java.lang.Object obj)
|
protected void |
setFromViewAccessor(boolean fromViewAccessor)
|
void |
setRowSet(oracle.jbo.RowSet rowset)
Sets the server-side RowSet for this RowsetAccessImpl. |
void |
setRowSetIterator(oracle.jbo.RowSetIterator rowsetIter)
Sets the server-side RowSetIterator for this RowsetAccessImpl. |
void |
setTarget(oracle.dacf.dataset.RowsetAccessImpl target)
Internal: Applications should not use this method. |
void |
setViewStart(int viewStart)
Specify the start row of the view. |
protected void |
shutdown()
Internal: Applications should not use this method. |
java.lang.String |
toString()
Returns a string naming the class, the current row number on both the client side and the server side. |
void |
validateCurrentRow()
|
void |
validateRowset()
|
Methods inherited from class oracle.dacf.dataset.DataItemImpl |
addDataItemChangeListener, findDataItem, fireItemsAvailable, fireItemsAvailable, fireItemsRevoked, getDataItemChangeSupport, getProducerObject, getSource, isPublished, postRollback, preRollback, publish, release, removeDataItemChangeListener, revoke, setProducerObject, setSource, validateItem |
Methods inherited from class oracle.dacf.dataset.DacObject |
addChild, findDescendant, genCloneName, getChild, getChildIndex, getChildren, getName, getNumOfChildren, getParent, getPrefix, insertChildAt, removeChild, removeChildren, setChildren, setName, setParent, setPrefix |
Methods inherited from class java.lang.Object |
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
protected oracle.jbo.RowSet _rowset
protected oracle.jbo.RowSetIterator _rowsetIter
protected oracle.dacf.dataset.ViewArrayAccessImpl _view
protected oracle.dacf.dataset.RowSetState _curState
protected boolean _exceptionRunning
protected java.lang.Object _exceptionRunningGate
protected static final java.lang.String ERR_PROD_CODE
protected static final int COLUMN_LABELS
protected static final int COLUMN_WIDTHS
protected static final int RETURN_ITEMS
protected static final int QUERYABLE_COLUMNS
protected static final int COLUMN_ALIGNMENTS
protected static final int SORTING_ENABLED
Constructor Detail |
public MappingRowsetAccessImpl()
public MappingRowsetAccessImpl(java.lang.String name, javax.infobus.InfoBusEventListener source, ResultSetInfo rsInfo)
public MappingRowsetAccessImpl(java.lang.String name, javax.infobus.InfoBusEventListener source, ResultSetInfo rsInfo, DacObject parent)
Method Detail |
public void setTarget(oracle.dacf.dataset.RowsetAccessImpl target)
public oracle.dacf.dataset.RowsetAccessImpl getTarget()
public void newRow() throws java.sql.SQLException, javax.infobus.RowsetValidationException
oracle.dacf.dataset.RowsetAccessImpl
Inserts a new row into the RowSet and initialized the new row to the
defined default values provided that:
javax.infobus.RowsetValidationException
- if the RowSet can't be updated or if
inserting into a Detail RowSet when
the Master RowSet is null.
java.sql.SQLException
- if the row creation or insert failspublic void deleteRow() throws java.sql.SQLException, javax.infobus.RowsetValidationException
java.sql.SQLException
javax.infobus.RowsetValidationException
public boolean next() throws java.sql.SQLException, javax.infobus.RowsetValidationException
oracle.dacf.dataset.RowsetAccessImpl
java.sql.SQLException
javax.infobus.RowsetValidationException
public boolean previous() throws java.sql.SQLException, javax.infobus.RowsetValidationException
oracle.dacf.dataset.RowsetAccessImpl
java.sql.SQLException
javax.infobus.RowsetValidationException
public boolean first() throws java.sql.SQLException, javax.infobus.RowsetValidationException
oracle.dacf.dataset.RowsetAccessImpl
java.sql.SQLException
javax.infobus.RowsetValidationException
public boolean last() throws java.sql.SQLException, javax.infobus.RowsetValidationException
oracle.dacf.dataset.RowsetAccessImpl
java.sql.SQLException
javax.infobus.RowsetValidationException
public boolean relative(int numRows) throws java.sql.SQLException, javax.infobus.RowsetValidationException
oracle.dacf.dataset.RowsetAccessImpl
numRows
relative to the current row in the rowset.
numRows
- the number of rows to move.
java.sql.SQLException
javax.infobus.RowsetValidationException
public boolean absolute(int rowNumber) throws java.sql.SQLException, javax.infobus.RowsetValidationException
oracle.dacf.dataset.RowsetAccessImpl
java.sql.SQLException
javax.infobus.RowsetValidationException
public java.lang.Object getProperty(java.lang.String propertyName)
oracle.dacf.dataset.RowsetAccessImpl
DataItemProperties defines the properties supported.
propertyName
- The name of the property.
public java.lang.Object clone()
clone
in class DataItemImpl
public void destroy()
destroy
in interface RowSetManager
protected void shutdown()
shutdown
in class DataItemImpl
protected void publish(boolean publishKids)
publish
in class DataItemImpl
protected void addChild(DataItemImpl child)
child
- the child to be added.protected void insertChildAt(DataItemImpl child, int index)
child
- the child to be added.index
- the 0-based index of the new child.protected void removeChild(DataItemImpl child)
child
- the child to be removed.public final oracle.jbo.RowSet getRowSet()
getRowSet
in interface RowSetManager
public void setRowSet(oracle.jbo.RowSet rowset)
setRowSet
in interface RowSetManager
rowset
- the server-side RowSetpublic final oracle.jbo.RowSetIterator getRowSetIterator()
getRowSetIterator
in interface RowSetManager
public void setRowSetIterator(oracle.jbo.RowSetIterator rowsetIter)
setRowSetIterator
in interface RowSetManager
public boolean findRow(java.lang.String[] colNames, java.lang.Object[] values) throws javax.infobus.ColumnNotFoundException, javax.infobus.DuplicateColumnException, java.sql.SQLException
There must be a one-to-one correspondence between the colNames and values arrays. The columns listed in colNames must be the primary keys used to produce the result set. The value values[n] will be used as the search value for colNames[n]. Individual null entries are allowed in values and will be mapped to the SQL null value. If the row is found, it will be made the current row.
findRow
in interface SearchableRowsetAccess
colNames
- The name of the columns to search withinvalues
- The values to use for the comparison
javax.infobus.ColumnNotFoundException,
- javax.infobus.DuplicateColumnException,
java.sql.SQLException;
javax.infobus.ColumnNotFoundException
javax.infobus.DuplicateColumnException
java.sql.SQLException
public int findRangeIndexOf(java.lang.String[] colNames, java.lang.Object[] values) throws javax.infobus.ColumnNotFoundException, javax.infobus.DuplicateColumnException, java.sql.SQLException
findRangeIndexOf
in interface SearchableRowsetAccess
colNames
- The name of the columns to search withinvalues
- The values to use for the comparison
javax.infobus.ColumnNotFoundException,
- javax.infobus.DuplicateColumnException,
java.sql.SQLException;
javax.infobus.ColumnNotFoundException
javax.infobus.DuplicateColumnException
java.sql.SQLException
RowSetIterator
public final int getColumnCount()
getColumnCount
in interface javax.infobus.RowsetAccess
public final java.lang.String getColumnName(int colIndex) throws java.lang.IndexOutOfBoundsException
getColumnName
in interface javax.infobus.RowsetAccess
colIndex
- the base 1 offset of the column; the first column is at
colIndex value 1.
java.lang.IndexOutOfBoundsException
public final int getColumnDatatypeNumber(int index) throws java.lang.IndexOutOfBoundsException
getColumnDatatypeNumber
in interface javax.infobus.RowsetAccess
java.lang.IndexOutOfBoundsException
public final java.lang.String getColumnDatatypeName(int columnIndex) throws java.lang.IndexOutOfBoundsException
getColumnDatatypeName
in interface javax.infobus.RowsetAccess
java.lang.IndexOutOfBoundsException
public final int getHighWaterMark()
getHighWaterMark
in interface javax.infobus.RowsetAccess
public final boolean hasMoreRows()
hasMoreRows
in interface javax.infobus.RowsetAccess
public final boolean hasRows()
hasRows
in interface RowSetManager
public final java.lang.Object getColumnItem(int colNum) throws java.lang.IndexOutOfBoundsException
getColumnItem
in interface javax.infobus.RowsetAccess
java.lang.IndexOutOfBoundsException
public java.lang.Object getColumnItem(java.lang.String colName) throws javax.infobus.ColumnNotFoundException, javax.infobus.DuplicateColumnException
getColumnItem
in interface javax.infobus.RowsetAccess
javax.infobus.ColumnNotFoundException
javax.infobus.DuplicateColumnException
public final void setColumnValue(int columnIndex, java.lang.Object obj) throws java.lang.IndexOutOfBoundsException, javax.infobus.RowsetValidationException, java.sql.SQLException
setColumnValue
in interface javax.infobus.RowsetAccess
java.lang.IndexOutOfBoundsException
javax.infobus.RowsetValidationException
java.sql.SQLException
public void setColumnValue(java.lang.String columnName, java.lang.Object obj) throws javax.infobus.ColumnNotFoundException, javax.infobus.DuplicateColumnException, javax.infobus.RowsetValidationException, java.sql.SQLException
setColumnValue
in interface javax.infobus.RowsetAccess
javax.infobus.ColumnNotFoundException
javax.infobus.DuplicateColumnException
javax.infobus.RowsetValidationException
java.sql.SQLException
public void flush() throws java.sql.SQLException, javax.infobus.RowsetValidationException
flush
in interface javax.infobus.RowsetAccess
java.sql.SQLException
javax.infobus.RowsetValidationException
public void lockRow() throws java.sql.SQLException, javax.infobus.RowsetValidationException
lockRow
in interface javax.infobus.RowsetAccess
java.sql.SQLException
javax.infobus.RowsetValidationException
public final boolean canInsert()
canInsert
in interface javax.infobus.RowsetAccess
public final boolean canUpdate()
canUpdate
in interface javax.infobus.RowsetAccess
public boolean canUpdate(java.lang.String columnName) throws javax.infobus.ColumnNotFoundException, javax.infobus.DuplicateColumnException
canUpdate
in interface javax.infobus.RowsetAccess
javax.infobus.ColumnNotFoundException
javax.infobus.DuplicateColumnException
public final boolean canUpdate(int columnIndex) throws java.lang.IndexOutOfBoundsException
canUpdate
in interface javax.infobus.RowsetAccess
java.lang.IndexOutOfBoundsException
public final boolean canDelete()
canDelete
in interface javax.infobus.RowsetAccess
public javax.infobus.DbAccess getDb()
getDb
in interface javax.infobus.RowsetAccess
public javax.infobus.ScrollableRowsetAccess newCursor()
newCursor
in interface javax.infobus.ScrollableRowsetAccess
public final void setBufferSize(int size)
The buffer size is also the upper limit on size of the ArrayAccess returned by getView().
setBufferSize
in interface javax.infobus.ScrollableRowsetAccess
size
- the number of rows to be retrieved at a time. size
must be > 0 or -1; -1 indicates retrieve all rows.#getView()
,
ResultSetInfo.getRangeSize()
,
ResultSetInfo.setRangeSize(int nuRangeSize)
public final int getBufferSize()
The buffer size is also the upper limit on size of the ArrayAccess returned by getView().
getBufferSize
in interface javax.infobus.ScrollableRowsetAccess
#getView()
public final int getRowCount()
getRowCount
in interface javax.infobus.ScrollableRowsetAccess
public final long getEstimatedRowCount()
public final int getRow()
getRow
in interface javax.infobus.ScrollableRowsetAccess
public void validateRowset() throws javax.infobus.RowsetValidationException
validateRowset
in interface javax.infobus.RowsetValidate
javax.infobus.RowsetValidationException
public void validateCurrentRow() throws javax.infobus.RowsetValidationException
validateCurrentRow
in interface javax.infobus.RowsetValidate
javax.infobus.RowsetValidationException
public javax.infobus.ArrayAccess getView(int viewSize)
The the upper limit on size of the ArrayAccess is the buffer size.
getView
in interface javax.infobus.DataItemView
RowsetAccessImpl.getBufferSize()
,
#setBufferSize(ing size)
public final int getViewStart()
getViewStart
in interface javax.infobus.DataItemView
public void setViewStart(int viewStart)
setViewStart
in interface javax.infobus.DataItemView
viewStart
- the row number of the first row in the viewpublic void scrollView(int numRows)
scrollView
in interface javax.infobus.DataItemView
public java.lang.Object[] getColumnLabels()
getColumnLabels
in interface oracle.dacf.dataset.AttributeProperties
public java.lang.Object[] getColumnWidths()
getColumnWidths
in interface oracle.dacf.dataset.AttributeProperties
public java.lang.Object[] getColumnAlignments()
public java.lang.Object[] getReturnItemNames()
getReturnItemNames
in interface oracle.dacf.dataset.AttributeProperties
public java.lang.Object[] getQueryableColumnDataItemNames()
getQueryableColumnDataItemNames
in interface oracle.dacf.dataset.AttributeProperties
public java.lang.Object[] getSortingEnabled()
public void rowInserted(oracle.jbo.InsertEvent e)
oracle.jbo.RowSetListener
rowInserted
in interface oracle.jbo.RowSetListener
e
- a description of the new Row object.public void deferredRowInserted(oracle.jbo.InsertEvent e)
public void rowDeleted(oracle.jbo.DeleteEvent e)
oracle.jbo.RowSetListener
rowDeleted
in interface oracle.jbo.RowSetListener
e
- a description of the deleted Row object.public void deferredRowDeleted(oracle.jbo.DeleteEvent e)
public void navigated(oracle.jbo.NavigationEvent e)
oracle.jbo.RowSetListener
navigated
in interface oracle.jbo.RowSetListener
e
- a description of the new and previous current rows.public void deferredNavigated(oracle.jbo.NavigationEvent e)
public void rangeRefreshed(oracle.jbo.RangeRefreshEvent e)
oracle.jbo.RowSetListener
rangeRefreshed
in interface oracle.jbo.RowSetListener
e
- a description of the new ranges.public void deferredRangeRefreshed(oracle.jbo.RangeRefreshEvent e)
public void rowUpdated(oracle.jbo.UpdateEvent e)
oracle.jbo.RowSetListener
rowUpdated
in interface oracle.jbo.RowSetListener
e
- a description of the modified Row object.public void deferredRowUpdated(oracle.jbo.UpdateEvent e)
public void rangeScrolled(oracle.jbo.ScrollEvent e)
oracle.jbo.RowSetListener
rangeScrolled
in interface oracle.jbo.RowSetListener
e
- a description of the new range.public void deferredRangeScrolled(oracle.jbo.ScrollEvent e)
public int getColumnIndex(java.lang.String columnName) throws javax.infobus.ColumnNotFoundException, javax.infobus.DuplicateColumnException
columnName
- The name of the column for which you need the index.
javax.infobus.ColumnNotFoundException
javax.infobus.DuplicateColumnException
public java.lang.String toString()
toString
in class DataItemImpl
public boolean hasNext()
hasNext
in interface IteratorProperties
public boolean hasPrevious()
hasPrevious
in interface IteratorProperties
public boolean isRangeAtBottom()
isRangeAtBottom
in interface IteratorProperties
public boolean isRangeAtTop()
isRangeAtTop
in interface IteratorProperties
protected void doPreRollback()
Notification that we are going to rollback. Cache the current row (because jbo sets it to -1) and restore it after rollback
doPreRollback
in class DataItemImpl
protected void doPostRollback()
Notification that rollback has happened. Restore the current row.
doPostRollback
in class DataItemImpl
protected void setFromViewAccessor(boolean fromViewAccessor)
public boolean isFromLinkAccessor()
isFromLinkAccessor
in interface RowSetManager
protected boolean isFromViewAccessor()
|
Oracle Data-aware Controls Reference | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 1997, 2003, Oracle. All rights reserved.