Package cz.cvut.kbss.jopa.model

Class ResultSetMappingQuery

java.lang.Object

cz.cvut.kbss.jopa.model.QueryImpl

cz.cvut.kbss.jopa.model.ResultSetMappingQuery

All Implemented Interfaces:

Query

public class ResultSetMappingQuery
extends QueryImpl

Implementation of query using result set mapping configuration.

Constructor Summary

Constructors

Constructor	Description
ResultSetMappingQuery(QueryHolder query, ConnectionWrapper connection, SparqlResultMapper mapper, UnitOfWork uow)

Method Summary

Modifier and Type	Method	Description
void	executeUpdate()	Execute an update or delete statement.
int	getFirstResult()	The position of the first result the query object was set to retrieve.
Map<String,Object>	getHints()	Gets the hints and associated values that are in effect for this query instance.
int	getMaxResults()	The maximum number of results the query object was set to retrieve.
Parameter<?>	getParameter(int position)	Gets the parameter object corresponding to the declared positional parameter with the given position.
Parameter<?>	getParameter(String name)	Gets the parameter object corresponding to the declared parameter of the given name.
Set<Parameter<?>>	getParameters()	Gets the parameter objects corresponding to the declared parameters of the query.
Object	getParameterValue(int position)	Returns the input value bound to the positional parameter.
<T> T	getParameterValue(Parameter<T> parameter)	Returns the input value bound to the parameter.
Object	getParameterValue(String name)	Returns the input value bound to the named parameter.
boolean	hasParameter(int position)
boolean	hasParameter(String name)
boolean	isBound(Parameter<?> parameter)	Returns a boolean indicating whether a value has been bound to the parameter.
Query	setHint(String hintName, Object value)	Sets a query hint.
Query	setParameter(int position, Object value)	Binds an argument value to a positional parameter.
Query	setParameter(int position, String value, String language)	Binds a String argument value to a positional parameter.
Query	setParameter(Parameter<String> parameter, String value, String language)	Binds the value of a String Parameter.
<T> Query	setParameter(Parameter<T> parameter, T value)	Binds the value of a Parameter object.
Query	setParameter(String name, Object value)	Binds an argument value to a named parameter.
Query	setParameter(String name, String value, String language)	Binds a String argument value to a named parameter.
Query	setUntypedParameter(int position, Object value)	Binds an argument value to a positional parameter.
<T> Query	setUntypedParameter(Parameter<T> parameter, T value)	Binds the value of a Parameter object.
Query	setUntypedParameter(String name, Object value)	Binds an argument value to a named parameter.

Methods inherited from class cz.cvut.kbss.jopa.model.QueryImpl

getResultList, getResultStream, getSingleResult, setFirstResult, setMaxResults

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface cz.cvut.kbss.jopa.model.query.Query

executeUpdate, getFirstResult, getHints, getMaxResults, getParameter, getParameter, getParameters, getParameterValue, getParameterValue, getParameterValue, isBound, setHint, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setUntypedParameter, setUntypedParameter, setUntypedParameter

Constructor Details

ResultSetMappingQuery

public ResultSetMappingQuery(QueryHolder query,
 ConnectionWrapper connection,
 SparqlResultMapper mapper,
 UnitOfWork uow)

Method Details

executeUpdate

public void executeUpdate()

Description copied from interface: Query

Execute an update or delete statement.

Specified by:

executeUpdate in interface Query

hasParameter

public boolean hasParameter(String name)

hasParameter

public boolean hasParameter(int position)

getParameter

public Parameter<?> getParameter(int position)

Description copied from interface: Query

Gets the parameter object corresponding to the declared positional parameter with the given position. This method is not required to be supported for native queries.

Specified by:

getParameter in interface Query

Parameters:

position - position

Returns:

parameter object

getParameter

public Parameter<?> getParameter(String name)

Description copied from interface: Query

Gets the parameter object corresponding to the declared parameter of the given name. This method is not required to be supported for native queries.

Specified by:

getParameter in interface Query

Parameters:

name - Parameter name

Returns:

parameter object

getParameters

public Set<Parameter<?>> getParameters()

Description copied from interface: Query

Gets the parameter objects corresponding to the declared parameters of the query. Returns empty set if the query has no parameters. This method is not required to be supported for native queries.

Specified by:

getParameters in interface Query

Returns:

set of parameter objects

isBound

public boolean isBound(Parameter<?> parameter)

Description copied from interface: Query

Returns a boolean indicating whether a value has been bound to the parameter.

Specified by:

isBound in interface Query

Parameters:

parameter - parameter object

Returns:

boolean indicating whether parameter has been bound

getParameterValue

public Object getParameterValue(String name)

Description copied from interface: Query

Returns the input value bound to the named parameter.

Specified by:

getParameterValue in interface Query

Parameters:

name - parameter name

Returns:

parameter value

getParameterValue

public Object getParameterValue(int position)

Description copied from interface: Query

Returns the input value bound to the positional parameter.

Specified by:

getParameterValue in interface Query

Parameters:

position - position

Returns:

parameter value

getParameterValue

public <T> T getParameterValue(Parameter<T> parameter)

Description copied from interface: Query

Returns the input value bound to the parameter.

Specified by:

getParameterValue in interface Query

Parameters:

parameter - parameter object

Returns:

parameter value

setParameter

public Query setParameter(int position,
 Object value)

Description copied from interface: Query

Binds an argument value to a positional parameter.

This version exploits the type of the parameter value and maps it to the corresponding XSD datatype (if it exists).

Specified by:

setParameter in interface Query

Parameters:

position - position

value - parameter value

Returns:

this query instance

See Also:

• Query.setUntypedParameter(int, Object)

setParameter

public Query setParameter(int position,
 String value,
 String language)

Description copied from interface: Query

Binds a String argument value to a positional parameter.

Specified by:

setParameter in interface Query

Parameters:

position - position

value - parameter value

language - language tag for the parameter value

Returns:

this query instance

setParameter

public Query setParameter(String name,
 Object value)

Description copied from interface: Query

Binds an argument value to a named parameter.

This version exploits the type of the parameter value and maps it to the corresponding XSD datatype (if it exists).

Specified by:

setParameter in interface Query

Parameters:

name - parameter name

value - parameter value

Returns:

this query instance

See Also:

• Query.setUntypedParameter(String, Object)

setParameter

public Query setParameter(String name,
 String value,
 String language)

Description copied from interface: Query

Binds a String argument value to a named parameter.

Specified by:

setParameter in interface Query

Parameters:

name - parameter name

value - parameter value

language - language tag for the parameter value

Returns:

this query instance

setUntypedParameter

public Query setUntypedParameter(int position,
 Object value)

Description copied from interface: Query

Binds an argument value to a positional parameter.

This version does not express the type of the value in the query. Instead, it inserts the value directly into the query string. It can be useful, e.g., for specifying values in filters.

Do not use this method to set query limit and offset, use the Query.setFirstResult(int) and Query.setMaxResults(int) methods instead.

Specified by:

setUntypedParameter in interface Query

Parameters:

position - position

value - parameter value

Returns:

this query instance

setUntypedParameter

public Query setUntypedParameter(String name,
 Object value)

Description copied from interface: Query

Binds an argument value to a named parameter.

This version does not express the type of the value in the query. Instead, it inserts the value directly into the query string. It can be useful, e.g., for specifying values in filters.

Do not use this method to set query limit and offset, use the Query.setFirstResult(int) and Query.setMaxResults(int) methods instead.

Specified by:

setUntypedParameter in interface Query

Parameters:

name - parameter name

value - parameter value

Returns:

this query instance

getMaxResults

public int getMaxResults()

Description copied from interface: Query

The maximum number of results the query object was set to retrieve.

Returns Integer.MAX_VALUE if Query.setMaxResults(int) was not applied to the query object.

Specified by:

getMaxResults in interface Query

Returns:

maximum number of results

getFirstResult

public int getFirstResult()

Description copied from interface: Query

The position of the first result the query object was set to retrieve.

Returns 0 if setFirstResult was not applied to the query object.

Specified by:

getFirstResult in interface Query

Returns:

position of the first result

setParameter

public <T> Query setParameter(Parameter<T> parameter,
 T value)

Description copied from interface: Query

Binds the value of a Parameter object.

This version exploits the type of the parameter value and maps it to the corresponding XSD datatype (if it exists).

Specified by:

setParameter in interface Query

Parameters:

parameter - parameter object

value - parameter value

Returns:

this query instance

See Also:

• Query.setUntypedParameter(Parameter, Object)

setParameter

public Query setParameter(Parameter<String> parameter,
 String value,
 String language)

Description copied from interface: Query

Binds the value of a String Parameter.

Specified by:

setParameter in interface Query

Parameters:

parameter - parameter object

value - parameter value

language - language tag for the parameter value

Returns:

this query instance

setUntypedParameter

public <T> Query setUntypedParameter(Parameter<T> parameter,
 T value)

Description copied from interface: Query

Binds the value of a Parameter object.

This version does not express the type of the value in the query. Instead, it inserts the value directly into the query string. It can be useful, e.g., for specifying values in filters.

Do not use this method to set query limit and offset, use the Query.setFirstResult(int) and Query.setMaxResults(int) methods instead.

Specified by:

setUntypedParameter in interface Query

Parameters:

parameter - parameter object

value - parameter value

Returns:

this query instance

setHint

public Query setHint(String hintName,
 Object value)

Description copied from interface: Query

Sets a query hint.

The hint elements may be used to specify query properties and hints. Vendor-specific hints that are not recognized by a provider are silently ignored.

Specified by:

setHint in interface Query

Parameters:

hintName - Name of the query hint

value - Value of the query hint

Returns:

this query instance

getHints

public Map<String,Object> getHints()

Description copied from interface: Query

Gets the hints and associated values that are in effect for this query instance.

Specified by:

getHints in interface Query

Returns:

Map of query hints with values