OADataSource (OA Java Code Documentation)

java.lang.Object
- com.viaoa.ds.OADataSource

All Implemented Interfaces:

OADataSourceInterface

Direct Known Subclasses:

OADataSourceAuto, OADataSourceClient, OADataSourceJDBC
```
public abstract class OADataSource
extends Object
implements OADataSourceInterface
```
Abstract class used for defining sources for Object storage.
A dataSource can be anything, including Relational Databases, XML data, legacy database, persistent data storage, etc.
There are methods defined for updating, deleting, and using Queries to retrieve Objects. Queries are based on the structure of Objects and not on the structure of the physical dataSource, and support property paths base on the object model.
The OAObject and Hub Collections have methods to automatically and naturally work with dataSources, without requiring any direct access to dataSource methods.
OADataSource has static methods that are used to manage all created OADataSources. Subclasses of OADataSource register themselves with the static OADataSource so that they can be found and used by Objects based on the Object Class, without requiring direct access to the OADataSource object.

For more information about this package, see documentation.

See Also:

getDataSource(Class), OASelect

Field Summary

Fields
Modifier and Type	Field and Description
`protected boolean`	`bAssignNumberOnCreate`
`protected boolean`	`bEnable`
`protected boolean`	`bLast`
`protected static int`	`dataSourceChangeCnter`
`protected String`	`guid`
`protected String`	`name`

Constructor Summary

Constructors
Constructor and Description

OADataSource()
Default constructor that will add this DataSource to list of DataSources

OADataSource(boolean bRegister)

Constructors
Constructor and Description
`OADataSource()` Default constructor that will add this DataSource to list of DataSources
`OADataSource(boolean bRegister)`

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`abstract void`	`assignId(OAObject obj)` Called by OAObject to initialize a new Object.
`void`	`close()` Close this DataSource.
`static void`	`closeAll()` Static method to close all registered DataSources.
`int`	`count(Class selectClass, OAObject whereObject, String propertyNameFromWhereObject)`
`int`	`count(Class selectClass, OAObject whereObject, String propertyNameFromWhereObject, int max)`
`int`	`count(Class selectClass, OAObject whereObject, String extraWhere, Object[] params, String propertyNameFromWhereObject)`
`int`	`count(Class selectClass, OAObject whereObject, String extraWhere, Object[] params, String propertyNameFromWhereObject, int max)`
`int`	`count(Class selectClass, String queryWhere)`
`int`	`count(Class selectClass, String queryWhere, int max)`
`int`	`count(Class selectClass, String queryWhere, Object param)`
`int`	`count(Class selectClass, String queryWhere, Object[] params)`
`int`	`count(Class selectClass, String queryWhere, Object[] params, int max)`
`abstract int`	`count(Class selectClass, String queryWhere, Object[] params, OAObject whereObject, String propertyFromWhereObject, String extraWhere, int max)` Perform a count on the DataSource using a query.
`int`	`count(Class selectClass, String queryWhere, Object param, int max)`
`abstract int`	`countPassthru(Class selectClass, String queryWhere, int max)` Performs a count using native query language for DataSource.
`int`	`countPassthru(String queryWhere)`
`int`	`countPassthru(String queryWhere, int max)`
`abstract void`	`delete(OAObject obj)` Remove an Object from a DataSource.
`abstract Object`	`execute(String command)` Execute a command on the dataSource.
`protected void`	`finalize()`
`boolean`	`getAllowIdChange()` Defaults to return true, allowing object Id properties to be changed.
`boolean`	`getAssignIdOnCreate()` Used to know if autonumber properties should be assigned on create or on save.
`static int`	`getChangeCounter()`
`static OADataSource`	`getDataSource(Class clazz)` Find the dataSource that supports a given Class
`static OADataSource`	`getDataSource(Class clazz, OAFilter filter)`
`static OADataSource[]`	`getDataSources()` Get all registered/loaded DataSources.
`boolean`	`getEnabled()`
`String`	`getGuid()` Seed value to use when creating GUID for seq assigned object keys.
`static Vector`	`getInfo()` Returns a Vector of Strings listing all registered OADataSources and status.
`void`	`getInfo(Vector vec)` Adds Strings to Vector, listing information about DataSource.
`int`	`getMaxLength(Class c, String propertyName)` Returns max length allowed for a property.
`String`	`getName()` Name of this dataSource
`static Object`	`getObject(Class clazz, int id)` Used to retreive a single object from DataSource.
`static Object`	`getObject(Class clazz, long id)` Used to retrieve a single object from DataSource.
`static Object`	`getObject(Class clazz, OAObjectKey key)` Used to retreive a single object from DataSource.
`static Object`	`getObject(Class clazz, Object id)` Used to retreive a single object from DataSource.
`static Object`	`getObject(Class clazz, String id)` Used to retrieve a single object from DataSource.
`Object`	`getObject(OAObjectInfo oi, Class clazz, OAObjectKey key, boolean bDirty)`
`int`	`getPosition()` Returns the position of this OADataSource within the list of registered datasources.
`abstract byte[]`	`getPropertyBlobValue(OAObject obj, String propertyName)` Select BLOB (large byte[]) property
`boolean`	`getSupportsPreCount()` Can this datasource get a count of the objects that will be selected.
`abstract void`	`insert(OAObject obj)` Add/Insert a new Object into DataSource.
`abstract void`	`insertWithoutReferences(OAObject obj)` Add/Insert a new Object into DataSource, without references (fkeys).
`boolean`	`isAvailable()` Used to know is datasoure is currently available.
`boolean`	`isClassSupported(Class clazz)`
`abstract boolean`	`isClassSupported(Class clazz, OAFilter filter)` Used by static OADataSource to know if a registered OADataSource subclass supports a specific Class.
`void`	`removeFromList()`
`void`	`reopen(int pos)` This can be called after a close has been done to make the datasoruce available again.
`void`	`save(OAObject obj)` Used to save an object to DataSource.
`OADataSourceIterator`	`select(Class selectClass)`
`OADataSourceIterator`	`select(Class selectClass, OAObject whereObject, String extraWhere, Object[] args, String propertyNameFromWhereObject, String queryOrder, boolean bDirty)`
`OADataSourceIterator`	`select(Class selectClass, OAObject whereObject, String extraWhere, Object[] args, String propertyNameFromWhereObject, String queryOrder, int max, boolean bDirty)`
`OADataSourceIterator`	`select(Class selectClass, OAObject whereObject, String extraWhere, Object[] args, String propertyNameFromWhereObject, String queryOrder, int max, OAFilter filter, boolean bDirty)`
`OADataSourceIterator`	`select(Class selectClass, OAObject whereObject, String propertyNameFromWhereObject, String queryOrder, boolean bDirty)`
`OADataSourceIterator`	`select(Class selectClass, OAObject whereObject, String propertyNameFromWhereObject, String queryOrder, int max, boolean bDirty)`
`OADataSourceIterator`	`select(Class selectClass, OAObject whereObject, String propertyNameFromWhereObject, String queryOrder, int max, OAFilter filter, boolean bDirty)`
`OADataSourceIterator`	`select(Class selectClass, String queryWhere)`
`OADataSourceIterator`	`select(Class selectClass, String queryWhere, Object[] params, String queryOrder, boolean bDirty)`
`OADataSourceIterator`	`select(Class selectClass, String queryWhere, Object[] params, String queryOrder, int max, boolean bDirty)`
`OADataSourceIterator`	`select(Class selectClass, String queryWhere, Object[] params, String queryOrder, int max, OAFilter filter, boolean bDirty)`
`abstract OADataSourceIterator`	`select(Class selectClass, String queryWhere, Object[] params, String queryOrder, OAObject whereObject, String propertyFromWhereObject, String extraWhere, int max, OAFilter filter, boolean bDirty)` Perform a query to retrieve objects from DataSource.
`OADataSourceIterator`	`select(Class selectClass, String queryWhere, Object param, String queryOrder, boolean bDirty)`
`OADataSourceIterator`	`select(Class selectClass, String queryWhere, Object param, String queryOrder, int max, boolean bDirty)`
`OADataSourceIterator`	`select(Class selectClass, String queryWhere, Object param, String queryOrder, int max, OAFilter filter, boolean bDirty)`
`OADataSourceIterator`	`select(Class selectClass, String queryWhere, String orderBy)`
`OADataSourceIterator`	`select(Class selectClass, String queryWhere, String queryOrder, boolean bDirty)`
`OADataSourceIterator`	`select(Class selectClass, String queryWhere, String queryOrder, int max, boolean bDirty)`
`OADataSourceIterator`	`select(Class selectClass, String queryWhere, String queryOrder, int max, OAFilter filter, boolean bDirty)`
`OADataSourceIterator`	`selectPassthru(Class selectClass, String query, boolean bDirty)`
`OADataSourceIterator`	`selectPassthru(Class selectClass, String query, int max, boolean bDirty)`
`OADataSourceIterator`	`selectPassthru(Class selectClass, String query, int max, OAFilter filter, boolean bDirty)`
`OADataSourceIterator`	`selectPassthru(Class selectClass, String query, String queryOrder, boolean bDirty)`
`OADataSourceIterator`	`selectPassthru(Class selectClass, String query, String queryOrder, int max, boolean bDirty)`
`abstract OADataSourceIterator`	`selectPassthru(Class selectClass, String queryWhere, String queryOrder, int max, OAFilter filter, boolean bDirty)` Performs a select using native query language for DataSource.
`void`	`setAssignIdOnCreate(boolean b)` Used to know if autonumber properties should be assigned on create or on save.
`void`	`setEnabled(boolean b)` Used to turn on/off a DataSource.
`void`	`setGuid(String gid)` Seed value to use when creating GUID for seq assigned object keys.
`void`	`setLast(boolean b)` Used to have a DataSource search last when finding a DataSource.
`void`	`setName(String name)` Name of this dataSource
`void`	`setPosition(int pos)` Sets the position of this OADataSource within the list of datasources.
`abstract boolean`	`supportsStorage()` Returns true if this dataSource supports selecting/storing/deleting.
`String`	`toString()` Returns the Name of this dataSource.
`void`	`update(OAObject obj)`
`abstract void`	`update(OAObject obj, String[] includeProperties, String[] excludeProperties)` Update an existing Object to DataSource.
`abstract void`	`updateMany2ManyLinks(OAObject masterObject, OAObject[] adds, OAObject[] removes, String propFromMaster)` Used by dataSources to update special requirements for handling Many2Many relationships (ex:Link Table).
`boolean`	`willCreatePropertyValue(OAObject object, String propertyName)` Returns true if the dataSource will set the property value before saving.

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

name
```
protected String name
```

bLast
```
protected boolean bLast
```

bAssignNumberOnCreate

protected boolean bAssignNumberOnCreate

guid
```
protected String guid
```

bEnable
```
protected boolean bEnable
```

dataSourceChangeCnter

protected static int dataSourceChangeCnter

Constructor Detail
- OADataSource
```
public OADataSource()
```
  Default constructor that will add this DataSource to list of DataSources
  
  See Also:
  
  getDataSources()
- OADataSource
```
public OADataSource(boolean bRegister)
```

Method Detail

getDataSources
```
public static OADataSource[] getDataSources()
```
Get all registered/loaded DataSources.

getDataSource
```
public static OADataSource getDataSource(Class clazz)
```
Find the dataSource that supports a given Class

See Also:

setEnabled(boolean)

getDataSource

public static OADataSource getDataSource(Class clazz,
                                         OAFilter filter)

setGuid
```
public void setGuid(String gid)
```
Seed value to use when creating GUID for seq assigned object keys. Autonumber properties will prefix new values with the value plus a "-" to separator.

getGuid
```
public String getGuid()
```
Seed value to use when creating GUID for seq assigned object keys. Autonumber properties will prefix new values with the value plus a "-" to separator.

setEnabled
```
public void setEnabled(boolean b)
```
Used to turn on/off a DataSource. If false, then requests to OADataSource.getDataSource will not return a disabled dataSource.

Specified by:

setEnabled in interface OADataSourceInterface

getEnabled
```
public boolean getEnabled()
```
Specified by:

getEnabled in interface OADataSourceInterface

getObject

public static Object getObject(Class clazz,
                               String id)

Used to retrieve a single object from DataSource.

Parameters:: id - is the property key value for the object.

getObject
```
public static Object getObject(Class clazz,
                               int id)
```
Used to retreive a single object from DataSource.

Parameters:

id - is the property key value for the object.

getObject
```
public static Object getObject(Class clazz,
                               long id)
```
Used to retrieve a single object from DataSource.

Parameters:

id - is the property key value for the object.

getObject

public static Object getObject(Class clazz,
                               Object id)

Used to retreive a single object from DataSource.

Parameters:: id - is the property key value for the object.

getObject

public static Object getObject(Class clazz,
                               OAObjectKey key)

Used to retreive a single object from DataSource.

Parameters:: key - is the object key for the object.

getObject

public Object getObject(OAObjectInfo oi,
                        Class clazz,
                        OAObjectKey key,
                        boolean bDirty)

Specified by:: getObject in interface OADataSourceInterface

setAssignIdOnCreate
```
public void setAssignIdOnCreate(boolean b)
```
Used to know if autonumber properties should be assigned on create or on save.

Specified by:

setAssignIdOnCreate in interface OADataSourceInterface

Parameters:

b - if true, assign autonumber property when object is created, else assign when object is saved.

getAssignIdOnCreate
```
public boolean getAssignIdOnCreate()
```
Used to know if autonumber properties should be assigned on create or on save.

Specified by:

getAssignIdOnCreate in interface OADataSourceInterface

isAvailable
```
public boolean isAvailable()
```
Used to know is datasoure is currently available.

Specified by:

isAvailable in interface OADataSourceInterface

getInfo
```
public static Vector getInfo()
```
Returns a Vector of Strings listing all registered OADataSources and status.

getInfo
```
public void getInfo(Vector vec)
```
Adds Strings to Vector, listing information about DataSource.

getMaxLength
```
public int getMaxLength(Class c,
                        String propertyName)
```
Returns max length allowed for a property. returns "-1" for any length.

Specified by:

getMaxLength in interface OADataSourceInterface

getChangeCounter
```
public static int getChangeCounter()
```

finalize

protected void finalize()
                 throws Throwable

Overrides:: finalize in class Object
Throws:: Throwable

closeAll
```
public static void closeAll()
```
Static method to close all registered DataSources.

close
```
public void close()
```
Close this DataSource.

Specified by:

close in interface OADataSourceInterface

removeFromList
```
public void removeFromList()
```

reopen
```
public void reopen(int pos)
```
This can be called after a close has been done to make the datasoruce available again.

Specified by:

reopen in interface OADataSourceInterface

Parameters:

pos - search location in list of datasources.

setLast
```
public void setLast(boolean b)
```
Used to have a DataSource search last when finding a DataSource. This is used when you want to create a catch all DataSource.

Parameters:

b - If true, then this dataSource will be used last in list of DataSources

setPosition
```
public void setPosition(int pos)
```
Sets the position of this OADataSource within the list of datasources. (0 based).

getPosition
```
public int getPosition()
```
Returns the position of this OADataSource within the list of registered datasources.

Returns:

-1 if not found, else position (0 based)

setName
```
public void setName(String name)
```
Name of this dataSource

getName
```
public String getName()
```
Name of this dataSource

toString
```
public String toString()
```
Returns the Name of this dataSource.

Overrides:

toString in class Object

isClassSupported
```
public abstract boolean isClassSupported(Class clazz,
                                         OAFilter filter)
```
Used by static OADataSource to know if a registered OADataSource subclass supports a specific Class.

Specified by:

isClassSupported in interface OADataSourceInterface

Parameters:

clazz - class

filter - used to query the datasource

isClassSupported
```
public boolean isClassSupported(Class clazz)
```
Specified by:

isClassSupported in interface OADataSourceInterface

updateMany2ManyLinks

public abstract void updateMany2ManyLinks(OAObject masterObject,
                                          OAObject[] adds,
                                          OAObject[] removes,
                                          String propFromMaster)

Used by dataSources to update special requirements for handling Many2Many relationships (ex:Link Table).

Uses the hub.masterObject, Hub.getRemovedObjects(), Hub.getAddedObjects() to find out which objects were added or removed.
This is called by OAObject.cascadeSave/Delete methods

Specified by:: updateMany2ManyLinks in interface OADataSourceInterface

insert
```
public abstract void insert(OAObject obj)
```
Add/Insert a new Object into DataSource.
Called directly by OAObject.save()

Specified by:

insert in interface OADataSourceInterface

insertWithoutReferences
```
public abstract void insertWithoutReferences(OAObject obj)
```
Add/Insert a new Object into DataSource, without references (fkeys).
Called directly by OAObject.saveWithoutReferences() to save a reference while saving another Object.

Specified by:

insertWithoutReferences in interface OADataSourceInterface

See Also:

OAObject.save()

update

public abstract void update(OAObject obj,
                            String[] includeProperties,
                            String[] excludeProperties)

Update an existing Object to DataSource.

Called directly by OAObject.save()

Specified by:: update in interface OADataSourceInterface

update
```
public void update(OAObject obj)
```
Specified by:

update in interface OADataSourceInterface

delete
```
public abstract void delete(OAObject obj)
```
Remove an Object from a DataSource.

Specified by:

delete in interface OADataSourceInterface

save
```
public void save(OAObject obj)
```
Used to save an object to DataSource.
If object is an OAObject, then update() or insert() will be called, else nothing is done.

Specified by:

save in interface OADataSourceInterface

count

public abstract int count(Class selectClass,
                          String queryWhere,
                          Object[] params,
                          OAObject whereObject,
                          String propertyFromWhereObject,
                          String extraWhere,
                          int max)

Perform a count on the DataSource using a query.

Specified by:: count in interface OADataSourceInterface
Parameters:: selectClass - Class to perform query on; queryWhere - query using property paths based on Object structure.
See Also:: OASelect

count

public int count(Class selectClass,
                 String queryWhere,
                 int max)

count

public int count(Class selectClass,
                 String queryWhere)

count

public int count(Class selectClass,
                 String queryWhere,
                 Object[] params,
                 int max)

count

public int count(Class selectClass,
                 String queryWhere,
                 Object param,
                 int max)

count

public int count(Class selectClass,
                 String queryWhere,
                 Object[] params)

count

public int count(Class selectClass,
                 String queryWhere,
                 Object param)

count

public int count(Class selectClass,
                 OAObject whereObject,
                 String propertyNameFromWhereObject,
                 int max)

count

public int count(Class selectClass,
                 OAObject whereObject,
                 String propertyNameFromWhereObject)

count

public int count(Class selectClass,
                 OAObject whereObject,
                 String extraWhere,
                 Object[] params,
                 String propertyNameFromWhereObject,
                 int max)

count

public int count(Class selectClass,
                 OAObject whereObject,
                 String extraWhere,
                 Object[] params,
                 String propertyNameFromWhereObject)

countPassthru
```
public abstract int countPassthru(Class selectClass,
                                  String queryWhere,
                                  int max)
```
Performs a count using native query language for DataSource.

Specified by:

countPassthru in interface OADataSourceInterface

Parameters:

queryWhere - query based on DataSource structure.

See Also:

OASelect

countPassthru

public int countPassthru(String queryWhere,
                         int max)

countPassthru

public int countPassthru(String queryWhere)

supportsStorage
```
public abstract boolean supportsStorage()
```
Returns true if this dataSource supports selecting/storing/deleting.

Specified by:

supportsStorage in interface OADataSourceInterface

select

public abstract OADataSourceIterator select(Class selectClass,
                                            String queryWhere,
                                            Object[] params,
                                            String queryOrder,
                                            OAObject whereObject,
                                            String propertyFromWhereObject,
                                            String extraWhere,
                                            int max,
                                            OAFilter filter,
                                            boolean bDirty)

Perform a query to retrieve objects from DataSource.

See OASelect for complete description on selects/queriess.

Specified by:: select in interface OADataSourceInterface
Parameters:: selectClass - Class of object to create and return; queryWhere - query String using property paths based on Object structure. DataSource; params - list of values to replace '?' in queryWhere clause.; filter - the datasource filter, used if the ds does not support queries (ex: sql) will convert query to native query language of the datasoure.; queryOrder - sort order; whereObject - master object to select from.; extraWhere - added to the query.; bDirty - true if objects should be fully populated, even if they are already loaded (in cache, etc).
Returns:: OADataSourceIterator that is used to return objects of type selectClass
See Also:: OASelect

select

public OADataSourceIterator select(Class selectClass)

select

public OADataSourceIterator select(Class selectClass,
                                   String queryWhere)

select

public OADataSourceIterator select(Class selectClass,
                                   String queryWhere,
                                   String orderBy)

select

public OADataSourceIterator select(Class selectClass,
                                   String queryWhere,
                                   String queryOrder,
                                   int max,
                                   OAFilter filter,
                                   boolean bDirty)

select

public OADataSourceIterator select(Class selectClass,
                                   String queryWhere,
                                   String queryOrder,
                                   int max,
                                   boolean bDirty)

select

public OADataSourceIterator select(Class selectClass,
                                   String queryWhere,
                                   String queryOrder,
                                   boolean bDirty)

select

public OADataSourceIterator select(Class selectClass,
                                   String queryWhere,
                                   Object[] params,
                                   String queryOrder,
                                   int max,
                                   boolean bDirty)

select

public OADataSourceIterator select(Class selectClass,
                                   String queryWhere,
                                   Object[] params,
                                   String queryOrder,
                                   boolean bDirty)

select

public OADataSourceIterator select(Class selectClass,
                                   String queryWhere,
                                   Object[] params,
                                   String queryOrder,
                                   int max,
                                   OAFilter filter,
                                   boolean bDirty)

select

public OADataSourceIterator select(Class selectClass,
                                   String queryWhere,
                                   Object param,
                                   String queryOrder,
                                   int max,
                                   OAFilter filter,
                                   boolean bDirty)

select

public OADataSourceIterator select(Class selectClass,
                                   String queryWhere,
                                   Object param,
                                   String queryOrder,
                                   int max,
                                   boolean bDirty)

select

public OADataSourceIterator select(Class selectClass,
                                   String queryWhere,
                                   Object param,
                                   String queryOrder,
                                   boolean bDirty)

select

public OADataSourceIterator select(Class selectClass,
                                   OAObject whereObject,
                                   String extraWhere,
                                   Object[] args,
                                   String propertyNameFromWhereObject,
                                   String queryOrder,
                                   int max,
                                   OAFilter filter,
                                   boolean bDirty)

select

public OADataSourceIterator select(Class selectClass,
                                   OAObject whereObject,
                                   String extraWhere,
                                   Object[] args,
                                   String propertyNameFromWhereObject,
                                   String queryOrder,
                                   int max,
                                   boolean bDirty)

select

public OADataSourceIterator select(Class selectClass,
                                   OAObject whereObject,
                                   String extraWhere,
                                   Object[] args,
                                   String propertyNameFromWhereObject,
                                   String queryOrder,
                                   boolean bDirty)

select

public OADataSourceIterator select(Class selectClass,
                                   OAObject whereObject,
                                   String propertyNameFromWhereObject,
                                   String queryOrder,
                                   int max,
                                   OAFilter filter,
                                   boolean bDirty)

select

public OADataSourceIterator select(Class selectClass,
                                   OAObject whereObject,
                                   String propertyNameFromWhereObject,
                                   String queryOrder,
                                   int max,
                                   boolean bDirty)

select

public OADataSourceIterator select(Class selectClass,
                                   OAObject whereObject,
                                   String propertyNameFromWhereObject,
                                   String queryOrder,
                                   boolean bDirty)

selectPassthru

public abstract OADataSourceIterator selectPassthru(Class selectClass,
                                                    String queryWhere,
                                                    String queryOrder,
                                                    int max,
                                                    OAFilter filter,
                                                    boolean bDirty)

Performs a select using native query language for DataSource.

Specified by:: selectPassthru in interface OADataSourceInterface
Parameters:: selectClass - Class of object to create and return; queryWhere - query based on DataSource structure.
Returns:: OADataSourceIterator that is used to return objects of type selectClass
See Also:: OASelect

selectPassthru

public OADataSourceIterator selectPassthru(Class selectClass,
                                           String query,
                                           int max,
                                           OAFilter filter,
                                           boolean bDirty)

selectPassthru

public OADataSourceIterator selectPassthru(Class selectClass,
                                           String query,
                                           int max,
                                           boolean bDirty)

selectPassthru

public OADataSourceIterator selectPassthru(Class selectClass,
                                           String query,
                                           boolean bDirty)

selectPassthru

public OADataSourceIterator selectPassthru(Class selectClass,
                                           String query,
                                           String queryOrder,
                                           int max,
                                           boolean bDirty)

selectPassthru

public OADataSourceIterator selectPassthru(Class selectClass,
                                           String query,
                                           String queryOrder,
                                           boolean bDirty)

execute
```
public abstract Object execute(String command)
```
Execute a command on the dataSource.

Specified by:

execute in interface OADataSourceInterface

Parameters:

command - DataSource native command.

assignId
```
public abstract void assignId(OAObject obj)
```
Called by OAObject to initialize a new Object.

Specified by:

assignId in interface OADataSourceInterface

willCreatePropertyValue
```
public boolean willCreatePropertyValue(OAObject object,
                                       String propertyName)
```
Returns true if the dataSource will set the property value before saving.

Specified by:

willCreatePropertyValue in interface OADataSourceInterface

getAllowIdChange
```
public boolean getAllowIdChange()
```
Defaults to return true, allowing object Id properties to be changed. Most DataSources that use foreign keys for references will not allow the object id to be changed after the object has been saved.

Specified by:

getAllowIdChange in interface OADataSourceInterface

getPropertyBlobValue

public abstract byte[] getPropertyBlobValue(OAObject obj,
                                            String propertyName)

Select BLOB (large byte[]) property

Specified by:: getPropertyBlobValue in interface OADataSourceInterface

getSupportsPreCount
```
public boolean getSupportsPreCount()
```
Can this datasource get a count of the objects that will be selected.

Specified by:

getSupportsPreCount in interface OADataSourceInterface

Class OADataSource

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

name

bLast

bAssignNumberOnCreate

guid

bEnable

dataSourceChangeCnter

Constructor Detail

OADataSource

OADataSource

Method Detail

getDataSources

getDataSource

getDataSource

setGuid

getGuid

setEnabled

getEnabled

getObject

getObject

getObject

getObject

getObject

getObject

setAssignIdOnCreate

getAssignIdOnCreate

isAvailable

getInfo

getInfo

getMaxLength

getChangeCounter

finalize

closeAll

close

removeFromList

reopen

setLast

setPosition

getPosition

setName

getName

toString

isClassSupported

isClassSupported

updateMany2ManyLinks

insert

insertWithoutReferences

update

update

delete

save

count

count

count

count

count

count

count

count

count

count

count

countPassthru

countPassthru

countPassthru

supportsStorage

select

select

select

select

select

select

select

select

select