|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface OlapStatement
Object used for statically executing an MDX statement and returning a
CellSet
.
An OlapStatement
is generally created using
OlapConnection.createStatement()
.
PreparedOlapStatement
Field Summary |
---|
Fields inherited from interface java.sql.Statement |
---|
CLOSE_ALL_RESULTS, CLOSE_CURRENT_RESULT, EXECUTE_FAILED, KEEP_CURRENT_RESULT, NO_GENERATED_KEYS, RETURN_GENERATED_KEYS, SUCCESS_NO_INFO |
Method Summary | |
---|---|
void |
addListener(CellSetListener.Granularity granularity,
CellSetListener listener)
Adds a listener to be notified of events to CellSet s created by
this statement. |
CellSet |
executeOlapQuery(SelectNode selectNode)
Executes an OLAP statement expressed as a parse tree. |
CellSet |
executeOlapQuery(String mdx)
Executes an OLAP statement. |
OlapConnection |
getConnection()
Retrieves the OlapConnection object
that produced this OlapStatement object. |
Methods inherited from interface java.sql.Wrapper |
---|
isWrapperFor, unwrap |
Methods inherited from interface org.olap4j.OlapWrapper |
---|
isWrapperFor, unwrap |
Method Detail |
---|
OlapConnection getConnection() throws SQLException
OlapConnection
object
that produced this OlapStatement
object.
getConnection
in interface Statement
SQLException
CellSet executeOlapQuery(String mdx) throws OlapException
mdx
- MDX SELECT
statement
OlapException
- if a database access error occurs,
this method is called on a closed OlapStatement
,
the query times out (see Statement.setQueryTimeout(int)
)
or another thread cancels the statement (see Statement.cancel()
)CellSet executeOlapQuery(SelectNode selectNode) throws OlapException
Validates the parse tree before executing it.
selectNode
- Parse tree of MDX SELECT
statement
OlapException
- if a database access error occurs,
this method is called on a closed OlapStatement
,
the query times out (see Statement.setQueryTimeout(int)
)
or another thread cancels the statement (see Statement.cancel()
)void addListener(CellSetListener.Granularity granularity, CellSetListener listener) throws OlapException
CellSet
s created by
this statement.
NOTE: You may wonder why this method belongs to the
OlapStatement
class and not CellSet
. If the method
belonged to CellSet
there would be a window between creation and
registering a listener during which events might be lost, whereas
registering the listener with the statement ensures that the listener is
attached immediately that the cell set is opened. It follows that
registering a listener does not affect the cell set currently
open (if any), and that no events will be received if the statement
has no open cell sets.
granularity
- Granularity of cell set events to listen forlistener
- Listener to be notified of changes
OlapException
- if granularity is not one supported by this server,
per the
OlapDatabaseMetaData.getSupportedCellSetListenerGranularities()
method
|
|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |