Using the JDM API - Java Data Mining: Strategy, Standard, and Practice - page 197

are categorized as core and non-core. Users of the JDM API need
to be familiar with the core methods. Core methods are subdivided
into object management, task execution, and other core methods.
Non-core methods are subdivided among supports capability,
metadata, object listing, and load methods. All of the core and
most of the non-core methods are required to be supported by the
JDM implementations. In this section, we discuss the use of the
core methods. For more details about these methods, refer to
the Java API document provided by the JDM 1.1 specification
[JDM11 2006].

Table 9-4 javax.datamining.resource.ConnectionFactory interface

Core Object Management Methods Description

getFactory(className):Factory Used to create the object factory for the specified object types.

saveObject(objName, MiningObject,
replaceFlag)

Used to save mining objects in the DME with the specified
name. The replaceFlag indicates whether the existing object
with the same name should be replaced.

setDescription(objName,
NamedObject, desc)

Used to set the description of the object with the specified name
and type. The mining object type is specified using the Named-
Object enumeration of all named JDM objects.

getDescription(objName,
NamedObject):String

Used to retrieve the description of the mining object by its
name and type.

removeObject(objName,
NamedObject):String

Used to remove the mining objects from the DME by its name
and type.

retrieveObject(objName,
NamedObject):MiningObject

Used to retrieve the mining objects from the DME by its name
and type.

doesObjectExist(objName,
NamedObject):boolean

Returns true when the specified mining object exists in the
DME.

renameObject(oldObjName,
newObjName, NamedObject)

Renames the mining object with the specified name.

Core Task Execution Methods Description

execute(Task, Long timeOut):
ExecutionStatus

Executes the task synchronously and returns after task
completion. This method returns the status of the execution
using the javax.datamining.ExecutionStatus object. If the task
does not complete by the specified timeOut in seconds, it will be
terminated and the method returns with the terminated
ExecutionStatus.