public class TXMLObjectAccessorTimeLoggingImpl extends TXMLObjectAccessorImpl
canBeCancelled, clientRequests, requestCounter, SGUAI
Constructor and Description |
---|
TXMLObjectAccessorTimeLoggingImpl(TStreamAccessor streamAccessor,
TResponseBuilder responseBuilder)
Special Constructor.
|
Modifier and Type | Method and Description |
---|---|
TResponse |
delete(TQuery xPath)
Deletes a set of XML documents implicitly given by the specified xpath query.
|
TResponse |
delete(TXMLObject xmlObject)
Deletes the XML document represented by the TXMLObject instance within the Tamino database.
|
TResponse |
insert(TXMLObject xmlObject)
Inserts the XML document represented by the TXMLObject instance into the Tamino database.
|
TResponse |
query(TQuery xPath)
Queries for a specific set of XML documents stored within Tamino.
|
TResponse |
query(TQuery xPath,
int quantity)
Queries for a specific set of XML documents stored within Tamino.
|
TXMLObject |
retrieve(TXMLObject xmlObject)
Retrieves a single XML document from Tamino in the state as it has been inserted.
|
TStreamHeader |
retrieveHeader(TXMLObject xmlObject)
Just retrieves the ´meta´ data of a single document from Tamino.
|
TResponse |
update(TXMLObject xmlObject)
Updates the XML document represented by the TXMLObject instance within the Tamino database.
|
TResponse |
xquery(TXQuery xquery)
Queries Tamino to retrieve a set of XML documents that satisfies
the xquery expression.
|
TResponse |
xquery(TXQuery xquery,
int quantity)
Queries Tamino to retrieve a set of XML documents that satisfies
the xquery expression.
|
cancelRequests, close, getApplicationName, getCanBeCancelled, getMaximumRequestDuration, getScrollType, setAccessLocation, setApplicationName, setCanBeCancelled, setMaximumRequestDuration, setScrollType, xquery, xquery
getAccessCollection, getAccessLocation, getDatabaseUri, getInvocation, getLocale, getLockMode, getLockwaitMode, invalidate, invoke, invoke, invoke, setInvocation, setLockMode, setLockwaitMode
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
getAccessLocation, getLockMode, getLockwaitMode, setLockMode, setLockwaitMode
invalidate
public TXMLObjectAccessorTimeLoggingImpl(TStreamAccessor streamAccessor, TResponseBuilder responseBuilder)
streamAccessor
- responseBuilder
- public TResponse insert(TXMLObject xmlObject) throws TInsertException
!xmlObject.hasDocname() | Insert. |
xmlObject.hasDocname() | Insert, if a document with the given ino:docname is not given yet. |
xmlObject.hasDocname() | Update, if a document with the given ino:docname is already given yet. |
insert
in interface TXMLObjectAccessor
insert
in class TXMLObjectAccessorImpl
xmlObject
- is the representation of the XML document that should be stored within Tamino.TInsertException
- signals an error while attempting the insert operation.public TResponse update(TXMLObject xmlObject) throws TUpdateException
xmlObject.hasId() | Update. |
!xmlObject.hasId() && xmlObject.hasDocname() | Update, if the document with the given docname is existant. |
!xmlObject.hasId() && xmlObject.hasDocname() | Insert, if the document with the given docname is not existant. |
update
in interface TXMLObjectAccessor
update
in class TXMLObjectAccessorImpl
xmlObject
- is the representation of the XML document that should be updated within Tamino.TUpdateException
- due to problems when initiating the update request.public TResponse delete(TXMLObject xmlObject) throws TDeleteException
delete
in interface TXMLObjectAccessor
delete
in class TXMLObjectAccessorImpl
xmlObject
- is the representation of the XML document that should be deleted within Tamino.TDeleteException
- due to any problems during the deletion of the given TXMLObject instance.public TResponse delete(TQuery xPath) throws TDeleteException
delete
in interface TXMLObjectAccessor
delete
in class TXMLObjectAccessorImpl
xpath
- denotes the XPath expresssion which references a set of XML documents that should be deleted.TDeleteException
- due to any problems during the deletion of the query set specified by the query.public TResponse query(TQuery xPath) throws TQueryException
query
in interface TXMLObjectAccessor
query
in class TXMLObjectAccessorImpl
xpath
- denotes the XPath expresssion which references a set of XML documents that should be retrieved.TQueryException
- due to any problems during the query of the implicitly given query set.public TResponse xquery(TXQuery xquery) throws TXQueryException
This feature requires Tamino 4.1
xquery
in interface TXMLObjectAccessor
xquery
in class TXMLObjectAccessorImpl
xquery
- query expression which specifies a set of XML documents to be retrieved.TXQueryException
- signals an error while attempting the query operation.public TResponse query(TQuery xPath, int quantity) throws TQueryException
query
in interface TXMLObjectAccessor
query
in class TXMLObjectAccessorImpl
xpath
- denotes the XPath expresssion which references a set of XML documents that should be retrieved.quantity
- denotes the quantity of documents which will be loaded with a single call from Tamino.
However, the iterator returned from the response object hides this.TQueryException
- due to any problems during the query of the implicitly given query set.public TResponse xquery(TXQuery xquery, int quantity) throws TXQueryException
Please note, this operation can only be used in a local transaction mode. This is due to the fact that it makes use of a Tamino cursor which can only be used in a transactional context. The obtained result set is only available while the current local transaction is open. A commit, rollback or change of the transaction mode will terminate the transaction and invalidate the TXMLObjectIterator.
This feature requires Tamino 3.1
xquery
in interface TXMLObjectAccessor
xquery
in class TXMLObjectAccessorImpl
xquery
- query expression which specifies a set of XML documents to be retrieved.quantity
- the number of documents to be retrieved in each step.TXQueryException
- signals an error while attempting the query operation.public TXMLObject retrieve(TXMLObject xmlObject) throws TRetrieveException
retrieve
in interface TXMLObjectAccessor
retrieve
in class TXMLObjectAccessorImpl
xmlObject
- represents an instance which internal object model shall be updated by a retrieved
document that is specified thru the doctype and id or docname information of the xmlObject.TRetrieveException
- due to any problems during the retrieval of the single document.public TStreamHeader retrieveHeader(TXMLObject xmlObject) throws TRetrieveException
Just retrieves the ´meta´ data of a single document from Tamino. This data is retrieved by its docname or id as set in the TXMLObject instance passed as input parameter and not by a query expression. If both docname and id are present in the TXMLObject instance, the docname is used.
This method behaves like the retrieve()
method except that
it does not retieve the whole document but only its ´meta´ data, which is
contained in the TStreamHeader
.
retrieveHeader
in interface TXMLObjectAccessor
retrieveHeader
in class TXMLObjectAccessorImpl
xmlObject
- a TXMLObject instance specifying by its doctype, id or docname information
which document to retrieve from Tamino.TRetrieveException
- signals an error while attempting the retrieve operation.com.softwareag.tamino.db.api.accessor.TStreamAccessor#retrieve(TXMLObject)
Copyright (c) 2017 Software AG. All Rights Reserved.