FileDocCategorySizeDatePackage
Platform.javaAPI DocGlassfish v2 API8115Tue May 22 16:54:22 BST 2007oracle.toplink.essentials.internal.databaseaccess

Platform

public interface Platform implements Serializable, Cloneable
Platform is private to TopLink. It encapsulates behavior specific to a datasource platform (eg. Oracle, Sybase, DB2, Attunity, MQSeries), and provides the interface for TopLink to access this behavior.
see
DatasourcePlatform
see
DatabasePlatform
see
oracle.toplink.essentials.eis.EISPlatform
see
oracle.toplink.essentials.xml.XMLPlatform
see
oracle.toplink.essentials.sdk.SDKPlatform
since
OracleAS TopLink 10g (10.0.3)

Fields Summary
Constructors Summary
Methods Summary
public voidaddSequence(oracle.toplink.essentials.sequencing.Sequence sequence)
Add sequence. The sequence should have a unique name that shouldn't be altered after the sequence has been added - don't do: getSequence(name).setName(newName))

public voidappendParameter(oracle.toplink.essentials.queryframework.Call call, java.io.Writer writer, java.lang.Object parameter)
Add the parameter. Convert the parameter to a string and write it.

public java.lang.Objectclone()

public java.lang.ObjectconvertObject(java.lang.Object sourceObject, java.lang.Class javaClass)
Convert the object to the appropriate type by invoking the appropriate ConversionManager method

param
object - the object that must be converted
param
javaClass - the class that the object must be converted to
exception
- ConversionException, all exceptions will be thrown as this type.
return
- the newly converted object

public voidcopyInto(oracle.toplink.essentials.internal.databaseaccess.Platform platform)
Copy the state into the new platform.

public oracle.toplink.essentials.internal.helper.ConversionManagergetConversionManager()
The platform hold its own instance of conversion manager to allow customization.

public java.lang.ObjectgetCustomModifyValueForCall(oracle.toplink.essentials.queryframework.Call call, java.lang.Object value, oracle.toplink.essentials.internal.helper.DatabaseField field, boolean shouldBind)
Allow for the platform to handle the representation of parameters specially.

public oracle.toplink.essentials.sequencing.SequencegetDefaultSequence()
Get default sequence. Sequence name shouldn't be altered - don't do: getDefaultSequence().setName(newName).

public oracle.toplink.essentials.sequencing.SequencegetDefaultSequenceToWrite()
INTERNAL: Used only for writing into XML or Java.

public oracle.toplink.essentials.sequencing.SequencegetSequence(java.lang.String seqName)
Get sequence corresponding to the name. The name shouldn't be altered - don't do: getSequence(name).setName(newName)

public java.util.MapgetSequences()
INTERNAL: Returns a map of sequence names to Sequences (may be null).

public java.util.MapgetSequencesToWrite()
INTERNAL: Used only for writing into XML or Java.

public java.lang.StringgetTableQualifier()
Return the qualifier for the table. Required by some databases such as Oracle and DB2

public java.sql.TimestampgetTimestampFromServer(oracle.toplink.essentials.internal.sessions.AbstractSession session, java.lang.String sessionName)
Answer the timestamp from the server.

public oracle.toplink.essentials.queryframework.ValueReadQuerygetTimestampQuery()
This method can be overridden by subclasses to return a query that will return the timestamp from the server. return null if the time should be the local time.

public booleanisAccess()

public booleanisAttunity()

public booleanisCloudscape()

public booleanisDB2()

public booleanisDBase()

public booleanisDerby()

public booleanisHSQL()

public booleanisInformix()

public booleanisMySQL()

public booleanisODBC()

public booleanisOracle()

public booleanisPointBase()

public booleanisPostgreSQL()

public booleanisSQLAnywhere()

public booleanisSQLServer()

public booleanisSybase()

public booleanisTimesTen()

public voidplatformSpecificSequencingInitialization(oracle.toplink.essentials.sessions.DatabaseSession session)
INTERNAL: Platform specific sequencing initialization. This internal method should only be called by SequencingManager.

public voidremoveAllSequences()
Remove all sequences that were added throud addSequence method.

public oracle.toplink.essentials.sequencing.SequenceremoveSequence(java.lang.String seqName)
Remove sequence corresponding to the name (the sequence was added through addSequence method)

public voidsetConversionManager(oracle.toplink.essentials.internal.helper.ConversionManager conversionManager)
The platform hold its own instance of conversion manager to allow customization.

public voidsetDefaultSequence(oracle.toplink.essentials.sequencing.Sequence sequence)
Set default sequence. The sequence should have a unique name that shouldn't be altered after the sequence has been set: don't do: getDefaultSequence().setName(newName)). Default constructors for Sequence subclasses set name to "SEQ".

public voidsetSequences(java.util.Map sequences)
INTERNAL: Used only for reading from XML.

public voidsetTableQualifier(java.lang.String qualifier)
Set the qualifier for the table. Required by some databases such as Oracle and DB2

public voidsetTimestampQuery(oracle.toplink.essentials.queryframework.ValueReadQuery tsQuery)
Can override the default query for returning a timestamp from the server. See: getTimestampFromServer

public booleanshouldUseCustomModifyForCall(oracle.toplink.essentials.internal.helper.DatabaseField field)
Allow for the platform to handle the representation of parameters specially.

public booleanusesPlatformDefaultSequence()
INTERNAL: Indicates whether defaultSequence is the same as platform default sequence.