Package wt.occurrence

Interface OccurrenceService

All Known Implementing Classes:

StandardOccurrenceService

@RemoteInterface
public interface OccurrenceService

This service interface defines the API for managing UsesOccurrences, PathOccurrences, CombinedPathOccurrences, UsesOccurrenceData, PathOccurrenceData and CombinedPathOccurrenceData in the context of OccurrenceableLinks, PathOccurrenceContexts and CombinedPathOccurrenceContexts

• Cookie: None
• Helper: OccurrenceHelper has helper methods
• Service implementation: StandardOccurrenceService has listeners
• ServiceEvent: OccurrenceEvent
• ServiceException: OccurrenceException

Supported API: true

Extendable: false

Method Summary

Modifier and Type	Method	Description
CombinedPathOccurrenceData	deleteCombinedPathOccurrenceData(CombinedPathOccurrenceData combinedPathOccurrenceData)	This method should always be used to delete a CombinedPathOccurrenceData.
PathOccurrenceData	deletePathOccurrenceData(PathOccurrenceData pathOccurrenceData)	This method should always be used to delete a PathOccurrenceData.
CombinedPathOccurrence	getCombinedPathOccurrence(PathOccurrence parentOccurrence, PathParentableOccurrence childOccurrence)	Returns a CombinedPathOccurrence with the given parent PathOccurrence and child PathParentableOccurrence.
QueryResult	getCombinedPathOccurrenceData(CombinedPathOccurrence occurrence, PathOccurrenceContext context, Class target)	Returns an array of CombinedPathOccurrenceData objects of the given Class that are associated with the given CombinedPathOccurrence and PathOccurrenceContext.
QueryResult	getCombinedPathOccurrenceData(CombinedPathOccurrence occurrence, PathOccurrenceContext context, Vector targets)	Returns an array of CombinedPathOccurrenceData objects of any of the Classes in the targets Vector associated with the given CombinedPathOccurrence and PathOccurrenceContext.
QueryResult	getCombinedPathOccurrenceData(PathOccurrenceContext context)	Returns an array of CombinedPathOccurrenceData objects associated with the given PathOccurrenceContext.
QueryResult	getCombinedPathOccurrences(PathOccurrenceMasterContext context)	Returns a QueryResult of CombinedPathOccurrences having the given context.
QueryResult	getCombinedPathOccurrencesForChild(PathParentableOccurrence childPathOccurrence)	Returns a QueryResult of CombinedPathOccurrences where the given PathOccurrence plays the 'child' role.
QueryResult	getCombinedPathOccurrencesForParent(PathOccurrence parentPathOccurrence)	Returns a QueryResult of CombinedPathOccurrences where the given PathOccurrence plays the 'parent' role.
QueryResult	getOccurrences(Vector occurrenceableLinks)	Returns a QueryResult of arrays where each array has one of the given OccurrenceableLinks in position 0, an associated UsesOccurrence in position 1 and an associated PathOccurrence (that has no subPath) in position 2; the PathOccurrence could be null.
QueryResult	getOccurrences(Vector occurrenceableLinks, PathOccurrence subPathOccurrence)	Returns a QueryResult of arrays where each array has one of the given OccurrenceableLink in position 0, an associated UsesOccurrence in position 1 and an associated PathOccurrence (having the given subPath) in position 2; the PathOccurrence could be null.
WTKeyedMap	getPathOccurrenceData(WTCollection pathOccurrences, WTCollection pathContexts, Collection<Class<? extends PathOccurrenceData>> types)	Returns the specified types of PathOccurrenceData for the specified PathOccurrences and PathOccurrenceContexts.
QueryResult	getPathOccurrenceData(PathOccurrenceContext context)	Returns an array of PathOccurrenceData objects associated with the given PathOccurrenceContext.
QueryResult	getPathOccurrenceData(PathOccurrence occurrence, PathOccurrenceContext context, Class target)	Returns an array of PathOccurrenceData objects associated with the given PathOccurrence and PathOccurrenceContext.
QueryResult	getPathOccurrenceData(PathOccurrence occurrence, PathOccurrenceContext context, Vector targets)	Returns an array of PathOccurrenceData objects associated with the given PathOccurrence and PathOccurrenceContext.
Persistable[][][]	getPathOccurrenceDataPopulatedUsages(Persistable[][][] usages, PathOccurrenceContext occurrenceContext, Class occurrenceDataClass)	Updates the PathOccurrences in the usages array by adding PathOccurrenceData of the specified type for the specified PathOccurrenceContext.
Persistable[][][]	getPathOccurrencePopulatedUsages(Persistable[][][] usages, List pathOccurrences)	Updates the OccurrenceableLinks in the usages array by setting their usesOccurrenceVector with UsesOccurrences and setting PathOccurrences on the UsesOccurrences.
QueryResult	getPathOccurrences(PathOccurrenceMasterContext context)	Returns a QueryResult of PathOccurrences having the given context.
QueryResult	getPathOccurrences(UsesOccurrence uses)	Returns a QueryResult PathOccurrences related to the given UsesOccurrence.
Vector	getPopulatedOccurrenceableLinks(Vector occurrenceableLinks)	Returns a Vector of OccurrenceableLinks with their usesOccurrenceVector populated with their UsesOccurrences; note that the UsesOccurrences also have their pathOccurrence populated.
Vector	getPopulatedOccurrenceableLinks(Vector occurrenceableLinks, PathOccurrence subPathOccurrence)	Returns a Vector of OccurrenceableLinks with their usesOccurrenceVector populated with their UsesOccurrences; note that the UsesOccurrences also have their pathOccurrence populated.
WTKeyedMap	getUsesOccurrenceData(WTCollection occs)	Takes a WTCollection of UsesOccurrence objects and returns a WTKeyedMap where the keys are the UsesOccurrences passed in and the values are WTCollections of the UsesOccurrenceData that correspond to the keys.
QueryResult	getUsesOccurrenceData(UsesOccurrence occurrence)	Deprecated.
QueryResult	getUsesOccurrenceData(UsesOccurrence occurrence, Vector classes)	Returns an array of UsesOccurrenceData objects of the given classes and associated with the given UsesOccurrence object.
QueryResult	getUsesOccurrences(Vector occurrenceableLinks)	Returns a QueryResult of arrays where each array has an OccurrenceableLink in position 0 and a UsesOccurrence in position 1.
WTKeyedMap	getUsesOccurrences(WTCollection links)	Returns a WTKeyedMap where the keys are the input collection of OccurrenceableLinks and the values are WTCollections of the corresponding UsesOccurrence objects.
QueryResult	getUsesOccurrences(OccurrenceableLink link)	Returns a QueryResult of UsesOccurrence objects.
QueryResult	getUsesOccurrences(PathOccurrence path)	Returns the UsesOccurrences associated with the given PathOccurrence.
QueryResult	getUsesOccurrences(UsesOccurrenceContext context)	Returns a QueryResult of UsesOccurrence objects having the given context.
CombinedPathOccurrenceData	saveCombinedPathOccurrenceData(CombinedPathOccurrenceData combinedPathOccurrenceData)	This method should always be used to insert or store a CombinedPathOccurrenceData.
PathOccurrenceData	savePathOccurrenceData(PathOccurrenceData pathOccurrenceData)	This method should always be used to insert or store a .
WTCollection	saveUsesOccurrenceAndData(WTKeyedMap occDataMap)	This method should always be used to insert or store an Occurrence and/or OccurrenceData objects since they need special identifiers that must be obtained in a special way.
WTCollection	saveUsesOccurrenceAndData(WTKeyedMap occDataMap, WTKeyedMap occDataToDeleteMap)	This method should always be used to insert or store an Occurrence and/or OccurrenceData objects since they need special identifiers that must be obtained in a special way.
QueryResult	saveUsesOccurrenceAndData(UsesOccurrence occurrence, Vector occurrenceData)	Deprecated.
QueryResult	saveUsesOccurrenceAndData(UsesOccurrence occurrence, Vector occurrenceData, Vector occurrenceDataToDelete)	Deprecated.

Method Details

deleteCombinedPathOccurrenceData

CombinedPathOccurrenceData deleteCombinedPathOccurrenceData(CombinedPathOccurrenceData combinedPathOccurrenceData)
                                                     throws WTException

This method should always be used to delete a CombinedPathOccurrenceData.

Supported API: true

Parameters:

combinedPathOccurrenceData -

Returns:

CombinedPathOccurrenceData

Throws:

WTException

deletePathOccurrenceData

PathOccurrenceData deletePathOccurrenceData(PathOccurrenceData pathOccurrenceData)
                                     throws WTException

This method should always be used to delete a PathOccurrenceData.

Supported API: true

Parameters:

pathOccurrenceData -

Returns:

PathOccurrenceData

Throws:

WTException

getCombinedPathOccurrenceData

QueryResult getCombinedPathOccurrenceData(CombinedPathOccurrence occurrence,
 PathOccurrenceContext context,
 Class target)
                                   throws WTException

Returns an array of CombinedPathOccurrenceData objects of the given Class that are associated with the given CombinedPathOccurrence and PathOccurrenceContext.

Supported API: true

Parameters:

occurrence -

context -

target -

Returns:

QueryResult

Throws:

WTException

getCombinedPathOccurrenceData

QueryResult getCombinedPathOccurrenceData(CombinedPathOccurrence occurrence,
 PathOccurrenceContext context,
 Vector targets)
                                   throws WTException

Returns an array of CombinedPathOccurrenceData objects of any of the Classes in the targets Vector associated with the given CombinedPathOccurrence and PathOccurrenceContext.

Supported API: true

Parameters:

occurrence -

context -

targets -

Returns:

QueryResult

Throws:

WTException

getCombinedPathOccurrenceData

QueryResult getCombinedPathOccurrenceData(PathOccurrenceContext context)
                                   throws WTException

Returns an array of CombinedPathOccurrenceData objects associated with the given PathOccurrenceContext.

Supported API: true

Parameters:

context -

Returns:

QueryResult

Throws:

WTException

getCombinedPathOccurrence

CombinedPathOccurrence getCombinedPathOccurrence(PathOccurrence parentOccurrence,
 PathParentableOccurrence childOccurrence)
                                          throws WTException

Returns a CombinedPathOccurrence with the given parent PathOccurrence and child PathParentableOccurrence.

Supported API: true

Parameters:

parentOccurrence -

childOccurrence - This Vector of OccurrenceableLinks should be used to find the associated UsesOccurrence objects.

Returns:

CombinedPathOccurrence

Throws:

WTException

getCombinedPathOccurrences

QueryResult getCombinedPathOccurrences(PathOccurrenceMasterContext context)
                                throws WTException

Returns a QueryResult of CombinedPathOccurrences having the given context.

Supported API: true

Parameters:

context - This Vector of OccurrenceableLinks should be used to find the associated UsesOccurrence objects.

Returns:

QueryResult

Throws:

WTException

getCombinedPathOccurrencesForChild

QueryResult getCombinedPathOccurrencesForChild(PathParentableOccurrence childPathOccurrence)
                                        throws WTException

Returns a QueryResult of CombinedPathOccurrences where the given PathOccurrence plays the 'child' role.

Supported API: true

Parameters:

childPathOccurrence - This Vector of OccurrenceableLinks should be used to find the associated UsesOccurrence objects.

Returns:

QueryResult

Throws:

WTException

getCombinedPathOccurrencesForParent

QueryResult getCombinedPathOccurrencesForParent(PathOccurrence parentPathOccurrence)
                                         throws WTException

Returns a QueryResult of CombinedPathOccurrences where the given PathOccurrence plays the 'parent' role.

Supported API: true

Parameters:

parentPathOccurrence - This Vector of OccurrenceableLinks should be used to find the associated UsesOccurrence objects.

Returns:

QueryResult

Throws:

WTException

getOccurrences

QueryResult getOccurrences(Vector occurrenceableLinks)
                    throws WTException

Returns a QueryResult of arrays where each array has one of the given OccurrenceableLinks in position 0, an associated UsesOccurrence in position 1 and an associated PathOccurrence (that has no subPath) in position 2; the PathOccurrence could be null.

If there is no UsesOccurrence, then no QueryResult entry is returned.

Supported API: true

Parameters:

occurrenceableLinks - This Vector of OccurrenceableLinks should be used to find the associated UsesOccurrence objects.

Returns:

QueryResult

Throws:

WTException

getOccurrences

QueryResult getOccurrences(Vector occurrenceableLinks,
 PathOccurrence subPathOccurrence)
                    throws WTException

Returns a QueryResult of arrays where each array has one of the given OccurrenceableLink in position 0, an associated UsesOccurrence in position 1 and an associated PathOccurrence (having the given subPath) in position 2; the PathOccurrence could be null.

If there is no UsesOccurrence, then no QueryResult entry is returned.

Supported API: true

Parameters:

occurrenceableLinks - This Vector of OccurrenceableLinks should be used to find the associated UsesOccurrence objects.

subPathOccurrence - This Vector of PathOccurrences should be used to find the associated PathOccurrence objects which play the superPath role. In other words we want to find the PathOccurrence objects that are one UsesOccurrence longer than the PathOccurrence objects contained in this Vector.

Returns:

QueryResult

Throws:

WTException

getPathOccurrenceData

WTKeyedMap getPathOccurrenceData(WTCollection pathOccurrences,
 WTCollection pathContexts,
 Collection<Class<? extends PathOccurrenceData>> types)
                          throws WTException

Returns the specified types of PathOccurrenceData for the specified PathOccurrences and PathOccurrenceContexts. The keys in the returned map are the PathOccurrences passed in and the values are WTCollections of the related PathOccurrenceData fetched from the database. If a path does not have any PathOccurrenceData that matches the passed parameters, then there is no entry in the map for that path.

Supported API: true

Parameters:

pathOccurrences - A collection of PathOccurrences whose path occurrence data is desired.

pathContexts - A collection of PathOccurrenceContexts whose path occurrence data is desired.

types - A collection of sub-types of PathOccurrenceData which are the types of path occurrence data that is desired.

Returns:

A Map where the keys are PathOccurrences and values are WTCollections of the related PathOccurrenceData or null.

Throws:

WTException - On error.

getPathOccurrenceData

QueryResult getPathOccurrenceData(PathOccurrence occurrence,
 PathOccurrenceContext context,
 Class target)
                           throws WTException

Returns an array of PathOccurrenceData objects associated with the given PathOccurrence and PathOccurrenceContext.

Supported API: true

Parameters:

occurrence -

context -

target -

Returns:

QueryResult

Throws:

WTException

getPathOccurrenceData

QueryResult getPathOccurrenceData(PathOccurrence occurrence,
 PathOccurrenceContext context,
 Vector targets)
                           throws WTException

Returns an array of PathOccurrenceData objects associated with the given PathOccurrence and PathOccurrenceContext.

Supported API: true

Parameters:

occurrence -

context -

targets -

Returns:

QueryResult

Throws:

WTException

getPathOccurrenceData

QueryResult getPathOccurrenceData(PathOccurrenceContext context)
                           throws WTException

Returns an array of PathOccurrenceData objects associated with the given PathOccurrenceContext.

Supported API: true

Parameters:

context -

Returns:

QueryResult

Throws:

WTException

getPathOccurrencePopulatedUsages

Persistable[][][] getPathOccurrencePopulatedUsages(Persistable[][][] usages,
 List pathOccurrences)
                                            throws WTException

Updates the OccurrenceableLinks in the usages array by setting their usesOccurrenceVector with UsesOccurrences and setting PathOccurrences on the UsesOccurrences.

Supported API: true

Parameters:

usages - The three-dimensional array of Persistable returned from navigating many used-by objects at once.

pathOccurrences - List of path PathOccurrences that match the order of the first dimension of the usages array.

Returns:

The usages array passed in, with UsesOccurrences and PathOccurrences populated.

Throws:

WTException

getPathOccurrenceDataPopulatedUsages

Persistable[][][] getPathOccurrenceDataPopulatedUsages(Persistable[][][] usages,
 PathOccurrenceContext occurrenceContext,
 Class occurrenceDataClass)
                                                throws WTException

Updates the PathOccurrences in the usages array by adding PathOccurrenceData of the specified type for the specified PathOccurrenceContext.

Supported API: true

Parameters:

usages - The three-dimensional array of Persistable returned from navigating many used-by objects at once.

occurrenceContext - The context of the path occurrence data to add to the PathOccurrences.

occurrenceDataClass - The class PathOccurrenceData or one of its sub-types specifying the type of path occurrence data to fetch.

Returns:

The usages array passed in, with the path occurrence data added.

Throws:

WTException

getPathOccurrences

QueryResult getPathOccurrences(UsesOccurrence uses)
                        throws WTException

Returns a QueryResult PathOccurrences related to the given UsesOccurrence.

Supported API: true

Parameters:

uses - This Vector of PathOccurrences should be used to find the associated PathOccurrence objects which play the superPath role. In other words we want to find the PathOccurrence objects that are one UsesOccurrence longer than the PathOccurrence objects contained in this Vector.

Returns:

QueryResult

Throws:

WTException

getPathOccurrences

QueryResult getPathOccurrences(PathOccurrenceMasterContext context)
                        throws WTException

Returns a QueryResult of PathOccurrences having the given context.

Supported API: true

Parameters:

context - This Vector of PathOccurrences should be used to find the associated PathOccurrence objects which play the superPath role. In other words we want to find the PathOccurrence objects that are one UsesOccurrence longer than the PathOccurrence objects contained in this Vector.

Returns:

QueryResult

Throws:

WTException

getPopulatedOccurrenceableLinks

Vector getPopulatedOccurrenceableLinks(Vector occurrenceableLinks,
 PathOccurrence subPathOccurrence)
                                throws WTException

Returns a Vector of OccurrenceableLinks with their usesOccurrenceVector populated with their UsesOccurrences; note that the UsesOccurrences also have their pathOccurrence populated.

Supported API: true

Parameters:

occurrenceableLinks - This Vector of OccurrenceableLinks should be used to find the associated UsesOccurrence objects.

subPathOccurrence - This Vector of PathOccurrences should be used to find the associated PathOccurrence objects which play the superPath role. In other words we want to find the PathOccurrence objects that are one UsesOccurrence longer than the PathOccurrence objects contained in this Vector.

Returns:

Vector

Throws:

WTException

getPopulatedOccurrenceableLinks

Vector getPopulatedOccurrenceableLinks(Vector occurrenceableLinks)
                                throws WTException

Returns a Vector of OccurrenceableLinks with their usesOccurrenceVector populated with their UsesOccurrences; note that the UsesOccurrences also have their pathOccurrence populated.

Supported API: true

Parameters:

occurrenceableLinks - This Vector of OccurrenceableLinks should be used to find the associated UsesOccurrence objects.

Returns:

Vector

Throws:

WTException

getUsesOccurrences

QueryResult getUsesOccurrences(PathOccurrence path)
                        throws OccurrenceException,
WTException

Returns the UsesOccurrences associated with the given PathOccurrence.

Supported API: true

Parameters:

path -

Returns:

QueryResult

Throws:

OccurrenceException

WTException

getUsesOccurrenceData

WTKeyedMap getUsesOccurrenceData(WTCollection occs)
                          throws WTException

Takes a WTCollection of UsesOccurrence objects and returns a WTKeyedMap where the keys are the UsesOccurrences passed in and the values are WTCollections of the UsesOccurrenceData that correspond to the keys.

Supported API: true

Parameters:

occs -

Returns:

WTKeyedMap

Throws:

WTException

getUsesOccurrenceData

QueryResult getUsesOccurrenceData(UsesOccurrence occurrence)
                           throws WTException

Deprecated.

Returns an array of UsesOccurrenceData objects associated with the given UsesOccurrence object.

Supported API: true

Parameters:

occurrence -

Returns:

QueryResult

Throws:

WTException

getUsesOccurrenceData

QueryResult getUsesOccurrenceData(UsesOccurrence occurrence,
 Vector classes)
                           throws WTException

Returns an array of UsesOccurrenceData objects of the given classes and associated with the given UsesOccurrence object.

Supported API: true

Parameters:

occurrence -

classes -

Returns:

QueryResult

Throws:

WTException

getUsesOccurrences

QueryResult getUsesOccurrences(Vector occurrenceableLinks)
                        throws WTException

Returns a QueryResult of arrays where each array has an OccurrenceableLink in position 0 and a UsesOccurrence in position 1.

If there is no UsesOccurrence, then no QueryResult entry is returned.

Supported API: true

Parameters:

occurrenceableLinks -

Returns:

QueryResult

Throws:

WTException

getUsesOccurrences

QueryResult getUsesOccurrences(OccurrenceableLink link)
                        throws WTException

Returns a QueryResult of UsesOccurrence objects.

Supported API: true

Parameters:

link -

Returns:

QueryResult

Throws:

WTException

getUsesOccurrences

QueryResult getUsesOccurrences(UsesOccurrenceContext context)
                        throws WTException

Returns a QueryResult of UsesOccurrence objects having the given context.

Supported API: true

Parameters:

context -

Returns:

QueryResult

Throws:

WTException

getUsesOccurrences

WTKeyedMap getUsesOccurrences(WTCollection links)
                       throws WTException

Returns a WTKeyedMap where the keys are the input collection of OccurrenceableLinks and the values are WTCollections of the corresponding UsesOccurrence objects.

Supported API: true

Parameters:

links -

Returns:

WTKeyedMap

Throws:

WTException

saveCombinedPathOccurrenceData

CombinedPathOccurrenceData saveCombinedPathOccurrenceData(CombinedPathOccurrenceData combinedPathOccurrenceData)
                                                   throws WTException

This method should always be used to insert or store a CombinedPathOccurrenceData.

Supported API: true

Parameters:

combinedPathOccurrenceData -

Returns:

CombinedPathOccurrenceData

Throws:

WTException

savePathOccurrenceData

PathOccurrenceData savePathOccurrenceData(PathOccurrenceData pathOccurrenceData)
                                   throws WTException

This method should always be used to insert or store a .

Supported API: true

Parameters:

pathOccurrenceData -

Returns:

PathOccurrenceData

Throws:

WTException

saveUsesOccurrenceAndData

QueryResult saveUsesOccurrenceAndData(UsesOccurrence occurrence,
 Vector occurrenceData)
                               throws WTException

Deprecated.

This method should always be used to insert or store an Occurrence and/or OccurrenceData objects since they need special identifiers that must be obtained in a special way.

Returns a QueryResult of the Occurrence and the OccurrenceDatas that have been inserted or updated. Note that some other OccurrenceDatas may have been updated, too, but since the user of this method did not have them in their list they will not be returned.

If the Occurrence has a unique Occurrence#occurrenceDataIdentifier (no other Occurrence shares that occurrenceDataIdentifier), then save the OccurrenceData associated to the occurrence, but otherwise, copy the Occurrence to get one with a new dataIdentifier and copy all the associated OccurrenceData objects and then save the occurrenceData associated to the newly copied Occurrence.

Supported API: true

Parameters:

occurrence -

occurrenceData -

Returns:

QueryResult

Throws:

WTException

saveUsesOccurrenceAndData

QueryResult saveUsesOccurrenceAndData(UsesOccurrence occurrence,
 Vector occurrenceData,
 Vector occurrenceDataToDelete)
                               throws WTException

Deprecated.

This method should always be used to insert or store an Occurrence and/or OccurrenceData objects since they need special identifiers that must be obtained in a special way.

Returns a QueryResult of the Occurrence and the OccurrenceDatas that have been inserted or updated. Note that some other OccurrenceDatas may have been updated, too, but since the user of this method did not have them in their list they will not be returned.

If the Occurrence has a unique Occurrence#occurrenceDataIdentifier (no other Occurrence shares that occurrenceDataIdentifier), then save the OccurrenceData associated to the occurrence, but otherwise, copy the Occurrence to get one with a new dataIdentifier and copy all the associated OccurrenceData objects and then save the occurrenceData associated to the newly copied Occurrence.

Supported API: true

Parameters:

occurrence -

occurrenceData -

occurrenceDataToDelete -

Returns:

QueryResult

Throws:

WTException

saveUsesOccurrenceAndData

WTCollection saveUsesOccurrenceAndData(WTKeyedMap occDataMap)
                                throws WTException

This method should always be used to insert or store an Occurrence and/or OccurrenceData objects since they need special identifiers that must be obtained in a special way.

Takes a WTKeyedMap where the keys are the UsesOccurrences and the values are a WTCollection of UsesOccurrenceData that correspond to the key.

Returns a WTCollection of the UsesOccurrence and the UsesOccurrenceDatas that have been inserted or updated. Note that some other UsesOccurrenceDatas may have been updated, too, but since the user of this method did not have them in their list they will not be returned.

If the Occurrence has a unique Occurrence#occurrenceDataIdentifier (no other Occurrence shares that occurrenceDataIdentifier), then save the OccurrenceData associated to the occurrence, but otherwise, copy the Occurrence to get one with a new dataIdentifier and copy all the associated OccurrenceData objects and then save the occurrenceData associated to the newly copied Occurrence.

Supported API: true

Parameters:

occDataMap -

Returns:

WTCollection

Throws:

WTException

saveUsesOccurrenceAndData

WTCollection saveUsesOccurrenceAndData(WTKeyedMap occDataMap,
 WTKeyedMap occDataToDeleteMap)
                                throws WTException

This method should always be used to insert or store an Occurrence and/or OccurrenceData objects since they need special identifiers that must be obtained in a special way.

Takes two WTKeyedMaps where the keys are the UsesOccurrences and the values are a WTCollection of UsesOccurrenceData that correspond to the key. The second map identifies the UsesOccurrenceData to be deleted.

Returns a WTCollection of the UsesOccurrence and the UsesOccurrenceDatas that have been inserted or updated. Note that some other UsesOccurrenceDatas may have been updated, too, but since the user of this method did not have them in their list they will not be returned.

If the Occurrence has a unique Occurrence#occurrenceDataIdentifier (no other Occurrence shares that occurrenceDataIdentifier), then save the OccurrenceData associated to the occurrence, but otherwise, copy the Occurrence to get one with a new dataIdentifier and copy all the associated OccurrenceData objects and then save the occurrenceData associated to the newly copied Occurrence.

Supported API: true

Parameters:

occDataMap -

occDataToDeleteMap -

Returns:

WTCollection

Throws:

WTException