|
Rule Execution Server API | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface IlrTraceDAO
Interface for Decision Warehouse trace DAO. This interface defines the contract of the DAO that is injected into Rule Sessions, RES console, and SSP to write and read traces.
Trace DAOs encapsulate transaction management via the
beginTransaction()
, commit()
and
rollback()
methods.
try { dao.beginTransaction(); dao.xxx(); dao.commit(); } catch(IlrDAOException e) { ... dao.rollback(); ... } finally { dao.close(); }
Method Summary | |
---|---|
void |
beginTransaction()
Begins a transaction. |
void |
close()
Closes the underlying transaction. |
void |
commit()
Commits the underlying transaction. |
IlrTraceQuery |
createQuery()
Creates and returns an IlrTraceQuery object. |
void |
deleteAllTraces()
Deletes all the stored traces. |
void |
deleteTraces(IlrTraceQuery query)
Deletes the traces matching the query criteria. |
IlrTraceIterator |
findAllTraces()
Returns an iterator on all the execution traces stored. |
IlrDWTrace |
findByExecutionId(String executionId)
Returns the trace that matches an execution ID (UUID). |
IlrTraceIterator |
findTraces(IlrTraceQuery query)
Returns a trace iterator that matches the query criteria. |
void |
rollback()
Rollback the underlying transaction. |
void |
saveTrace(IlrDWTrace trace,
IlrSessionRequest request,
IlrSessionResponse response)
Saves a given trace instance after ruleset execution. |
Method Detail |
---|
void beginTransaction() throws IlrTraceDAOException
IlrTraceDAOException
- if an error occurs.void close()
void commit() throws IlrTraceDAOException
IlrTraceDAOException
- if an error occurred while committing.void rollback()
void saveTrace(IlrDWTrace trace, IlrSessionRequest request, IlrSessionResponse response) throws IlrTraceDAOException
IlrTraceDAOException
- if an error occurred while saving
the trace.trace
- The Decision Warehouse trace instance to save.request
- The session request used for the execution.response
- The session response returned by the execution.IlrTraceIterator findAllTraces() throws IlrTraceDAOException
IlrTraceDAOException
- if an error occurred while saving the trace.
void deleteAllTraces() throws IlrTraceDAOException
IlrTraceDAOException
- if an error occurred while deleting traces.void deleteTraces(IlrTraceQuery query) throws IlrTraceDAOException
IlrTraceDAOException
- if an error occurred deleting the traces.query
- The query.IlrTraceQuery createQuery()
IlrTraceQuery
object.
IlrTraceIterator findTraces(IlrTraceQuery query) throws IlrTraceDAOException
IlrTraceDAOException
- if an error occurred while searching for
the trace.query
- A query that specifies the search criteria.
IlrDWTrace findByExecutionId(String executionId) throws IlrTraceDAOException
IlrTraceDAOException
- if an error occurred while searching for
the trace.executionId
- The execution ID to search for.
executionId
. If no matching
trace is found, null
is returned.
|
Rule Execution Server API | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |