org.apache.openjpa.meta

Class QueryMetaData

java.lang.Object

org.apache.openjpa.meta.QueryMetaData

All Implemented Interfaces:

Serializable, SourceTracker, Commentable, MetaDataModes

public class QueryMetaData
extends Object
implements MetaDataModes, SourceTracker, Commentable, Serializable

Holds metadata about named queries. Information stored in this instance gets transfered to new Query instances.

Author:

Steve Kim

See Also:

Serialized Form

Field Summary

Fields inherited from interface org.apache.openjpa.meta.MetaDataModes

MODE_ALL, MODE_ANN_MAPPING, MODE_MAPPING, MODE_MAPPING_INIT, MODE_META, MODE_NONE, MODE_QUERY

Fields inherited from interface org.apache.openjpa.lib.meta.SourceTracker

SRC_ANNOTATIONS, SRC_OTHER, SRC_XML

Fields inherited from interface org.apache.openjpa.lib.xml.Commentable

EMPTY_COMMENTS

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	QueryMetaData(String name, boolean convertPositionalParametersToNamed) Construct with the given name.

Method Summary

Methods

Modifier and Type	Method and Description
void	addHint(String key, Object value) Add a query hint.
Class	getCandidateType() The query candidate class, or null if none.
int	getColNumber()
String[]	getComments()
Class	getDefiningType() The class that defines this query, or null if none.
String[]	getHintKeys() Query hints.
Object[]	getHintValues() Query hints.
String	getLanguage() Return the query language.
int	getLineNumber()
String	getName() Return the name for this query.
OrderedMap<Object,Class<?>>	getParamTypes()
String	getQueryString() The full query string, or null if none.
String	getResourceName()
String	getResultSetMappingName()
Class	getResultType() The query result class, or null if none.
File	getSourceFile()
int	getSourceMode() The source mode of this query.
String	getSourceName()
Object	getSourceScope()
int	getSourceType()
boolean	isReadOnly() Whether the query has been marked read-only.
void	setCandidateType(Class cls) The query result class, or null if none.
void	setColNumber(int colNum)
void	setComments(String[] comments)
void	setDefiningType(Class cls) The class that defines this query, or null if none.
void	setFrom(Query query) Initialize this instance from the values held in the specified Query.
void	setInto(Query query) Set query template information into the given concrete query instance.
void	setLanguage(String language) Set the language for this query.
void	setLineNumber(int lineNum)
void	setParamTypes(OrderedMap<Object,Class<?>> paramTypes)
void	setQueryString(String query) The full query string, or null if none.
void	setReadOnly(boolean readOnly) Whether the query has been marked read-only.
void	setResultSetMappingName(String setMappingName)
void	setResultType(Class cls) The query result class, or null if none.
void	setSource(File file, Object scope, int srcType, String srcName)
void	setSourceMode(int mode) The source mode of this query.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

QueryMetaData

protected QueryMetaData(String name,
             boolean convertPositionalParametersToNamed)

Construct with the given name.

Method Detail

getName

public String getName()

Return the name for this query.

getDefiningType

public Class getDefiningType()

The class that defines this query, or null if none.

setDefiningType

public void setDefiningType(Class cls)

The class that defines this query, or null if none.

isReadOnly

public boolean isReadOnly()

Whether the query has been marked read-only.

setReadOnly

public void setReadOnly(boolean readOnly)

Whether the query has been marked read-only.

getCandidateType

public Class getCandidateType()

The query candidate class, or null if none.

setCandidateType

public void setCandidateType(Class cls)

The query result class, or null if none.

getResultType

public Class getResultType()

The query result class, or null if none.

setResultType

public void setResultType(Class cls)

The query result class, or null if none.

getLanguage

public String getLanguage()

Return the query language.

setLanguage

public void setLanguage(String language)

Set the language for this query.

getQueryString

public String getQueryString()

The full query string, or null if none.

setQueryString

public void setQueryString(String query)

The full query string, or null if none.

getHintKeys

public String[] getHintKeys()

Query hints.

getHintValues

public Object[] getHintValues()

Query hints.

addHint

public void addHint(String key,
           Object value)

Add a query hint.

getResultSetMappingName

public String getResultSetMappingName()

setResultSetMappingName

public void setResultSetMappingName(String setMappingName)

setInto

public void setInto(Query query)

Set query template information into the given concrete query instance. However, the language, query string, and candidate class are assumed to be declared in the query instantiation, and hints are not transferred.

setFrom

public void setFrom(Query query)

Initialize this instance from the values held in the specified Query.

getSourceMode

public int getSourceMode()

The source mode of this query.

setSourceMode

public void setSourceMode(int mode)

The source mode of this query.

toString

public String toString()

Overrides:

toString in class Object

getComments

public String[] getComments()

Specified by:

getComments in interface Commentable

setComments

public void setComments(String[] comments)

Specified by:

setComments in interface Commentable

getSourceFile

public File getSourceFile()

Specified by:

getSourceFile in interface SourceTracker

getSourceScope

public Object getSourceScope()

Specified by:

getSourceScope in interface SourceTracker

getSourceType

public int getSourceType()

Specified by:

getSourceType in interface SourceTracker

setSource

public void setSource(File file,
             Object scope,
             int srcType,
             String srcName)

getResourceName

public String getResourceName()

Specified by:

getResourceName in interface SourceTracker

getLineNumber

public int getLineNumber()

Specified by:

getLineNumber in interface SourceTracker

setLineNumber

public void setLineNumber(int lineNum)

getColNumber

public int getColNumber()

Specified by:

getColNumber in interface SourceTracker

setColNumber

public void setColNumber(int colNum)

getSourceName

public String getSourceName()

setParamTypes

public void setParamTypes(OrderedMap<Object,Class<?>> paramTypes)

getParamTypes

public OrderedMap<Object,Class<?>> getParamTypes()

Returns:

a map of parameter name to type for this named query or null if this data hasn't been set.