AdaptationHome (TIBCO EBX® Version 5.9.26 Java API)

java.lang.Object
- com.onwbp.adaptation.AdaptationHome

```
public final class AdaptationHome
extends Object
```
Represents a dataspace or a snapshot in a repository.
Note: In previous versions, a dataspace was known as a branch, and a snapshot was known as a version.

See Also:

Repository

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`Adaptation`	`findAdaptationOrNull(AdaptationName aName)` Returns the specified dataset or record based on its `AdaptationName`.
`List<Adaptation>`	`findAllChildren(Adaptation aDataSetOrRecord)` Returns a list of all datasets or records that are direct children of the one specified.
`List<Adaptation>`	`findAllDescendants(Adaptation aDataSetOrRecord)` Returns a list of all the datasets and records that inherit from the one specified, either as direct children or as descendants (recursive).
`List<Adaptation>`	`findAllRoots()` Returns all the dataset roots of this `AdaptationHome`.
`Adaptation`	`findParent(Adaptation aDataSetOrRecord)` Deprecated. Replaced by `Adaptation.getParent()`.
`List<AdaptationHome>`	`getBranchChildren()` Returns the dataspaces which have been created from this `AdaptationHome`.
`Date`	`getCreationDate()` Returns the creation date of this dataspace or snapshot.
`Profile`	`getCreator()` Returns the creator profile of this dataspace or snapshot in the current repository.
`UserMessage`	`getDescription()` Returns the internationalized description of this dataspace or snapshot.
`String`	`getDescription(Locale aLocale)` Returns the description of this dataspace or snapshot for a given locale.
`HomeKey`	`getKey()` Returns the key that identifies this dataspace or snapshot in the current repository.
`UserMessage`	`getLabel()` Returns the internationalized label of this dataspace or snapshot.
`String`	`getLabel(Locale aLocale)` Returns the label of this dataspace or snapshot for a given locale.
`String`	`getLabelOrName(Locale aLocale)` Returns the label of this dataspace or snapshot for a given locale.
`UserMessage`	`getLabelOrNameAsUserMessage()` Returns the internationalized label of this dataspace or snapshot.
`Profile`	`getOwner()` Returns the owner profile of this dataspace or snapshot in the current repository.
`AdaptationHome`	`getParent()` Returns the parent dataspace of this `AdaptationHome`.
`AdaptationHome`	`getParentBranch()` Returns the parent dataspace or snapshot of this `AdaptationHome`.
`Repository`	`getRepository()` Returns the repository that contains this `AdaptationHome`.
`Date`	`getTerminationDate()` Returns the date this dataspace or snapshot was closed, if it is closed.
`Map<AdaptationName,ValidationReport>`	`getValidationReportsMap(Severity minimalSeverity)` Returns a map of all validation reports of datasets in this `AdaptationHome` that have at least one validation item of the specified severity or higher.
`List<AdaptationHome>`	`getVersionChildren()` Returns the snapshots which have been created from this `AdaptationHome`.
`boolean`	`isAncestorOf(AdaptationHome anotherHome)` Returns `true` if this `AdaptationHome` is an ancestor of the specified `AdaptationHome` (the `AdaptationHome` itself is excluded).
`boolean`	`isBranch()` Returns `true` if this `AdaptationHome` is a dataspace.
`boolean`	`isBranchReference()` Returns `true` if this `AdaptationHome` is the `reference dataspace`.
`boolean`	`isInitialVersion()` Returns `true` if this `AdaptationHome` is an initial snapshot of a dataspace.
`boolean`	`isLockedBranch()` Returns `true` if this `AdaptationHome` is a locked dataspace.
`boolean`	`isMarkedForHistoryPurge()` Returns `true` if this `AdaptationHome` is marked for history purge.
`boolean`	`isMarkedForPurge()` Deprecated.
`boolean`	`isOpen()` Returns `true` if this `AdaptationHome` is either an open snapshot or an open dataspace.
`boolean`	`isOpenBranch()` Returns `true` if this `AdaptationHome` is an open dataspace.
`boolean`	`isOpenVersion()` Returns `true` if this `AdaptationHome` is an open snapshot.
`boolean`	`isTechnicalBranch()` Returns `true` if this `AdaptationHome` is a technical dataspace.
`boolean`	`isTechnicalVersion()` Returns `true` if this `AdaptationHome` is a technical snapshot.
`boolean`	`isVersion()` Returns `true` if this `AdaptationHome` is a snapshot.
`void`	`resetValidationReports()` Resets the validation reports of the datasets contained in this dataspace.
`String`	`toDisplayString(Locale aLocale)` Returns a user-friendly string that specifies the type of this object, for example, "Dataspace <key>" or "Snapshot <key>".
`String`	`toString()`

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

- Method Detail
  - findAdaptationOrNull
```
public Adaptation findAdaptationOrNull(AdaptationName aName)
```
    Returns the specified dataset or record based on its AdaptationName. Returns null if it cannot be found.
    
    See Also:
    
    AdaptationName
  - findParent
```
public Adaptation findParent(Adaptation aDataSetOrRecord)
```
    Deprecated. Replaced by Adaptation.getParent().
  - findAllChildren
```
public List<Adaptation> findAllChildren(Adaptation aDataSetOrRecord)
```
    Returns a list of all datasets or records that are direct children of the one specified.
  - findAllDescendants
```
public List<Adaptation> findAllDescendants(Adaptation aDataSetOrRecord)
```
    Returns a list of all the datasets and records that inherit from the one specified, either as direct children or as descendants (recursive).
  - findAllRoots
```
public List<Adaptation> findAllRoots()
```
    Returns all the dataset roots of this AdaptationHome.
    
    See Also:
    
    Adaptation.isRootAdaptation()
  - getKey
```
public HomeKey getKey()
```
    Returns the key that identifies this dataspace or snapshot in the current repository.
  - getOwner
```
public Profile getOwner()
```
    Returns the owner profile of this dataspace or snapshot in the current repository.
  - getCreator
```
public Profile getCreator()
```
    Returns the creator profile of this dataspace or snapshot in the current repository.
    Returns null if no creator is defined. For example, technical reserved branches are created by the 'System User'.
  - getLabel
```
public UserMessage getLabel()
```
    Returns the internationalized label of this dataspace or snapshot.
    Returns null if no labels are defined in any language.
  - getLabel
```
public String getLabel(Locale aLocale)
```
    Returns the label of this dataspace or snapshot for a given locale. Returns null if no label is defined for the locale provided.
  - getLabelOrName
```
public String getLabelOrName(Locale aLocale)
```
    Returns the label of this dataspace or snapshot for a given locale. Returns the key name if no label is defined for the locale provided.
  - getLabelOrNameAsUserMessage
```
public UserMessage getLabelOrNameAsUserMessage()
```
    Returns the internationalized label of this dataspace or snapshot. Returns the key name if no labels are defined in any locale.
  - getDescription
```
public UserMessage getDescription()
```
    Returns the internationalized description of this dataspace or snapshot.
    Returns null if no descriptions are defined in any language.
  - getDescription
```
public String getDescription(Locale aLocale)
```
    Returns the description of this dataspace or snapshot for a given locale. Returns null if no description is defined for the locale provided.
  - getCreationDate
```
public Date getCreationDate()
```
    Returns the creation date of this dataspace or snapshot.
  - getTerminationDate
```
public Date getTerminationDate()
```
    Returns the date this dataspace or snapshot was closed, if it is closed.
    Returns null if the dataspace or snapshot is open.
  - getParent
```
public AdaptationHome getParent()
```
    Returns the parent dataspace of this AdaptationHome. Returns null if this is the reference dataspace.
    For a dataspace, its parent is always its initial snapshot. For a snapshot, its parent is always its parent dataspace.
  - getParentBranch
```
public AdaptationHome getParentBranch()
```
    Returns the parent dataspace or snapshot of this AdaptationHome. Returns null if this AdaptationHome is the reference dataspace.
    Note: For a dataspace, its direct parent is its initial snapshot, hence its parent dataspace is the parent of this initial snapshot. For a snapshot, its parent dataspace is its direct parent.
    
    See Also:
    
    getBranchChildren(), getVersionChildren()
  - getBranchChildren
```
public List<AdaptationHome> getBranchChildren()
```
    Returns the dataspaces which have been created from this AdaptationHome.
    Note: A dataspace has no direct dataspace children; when a dataspace is created from another dataspace, first an initial snapshot is created, then the new dataspace is created from this initial snapshot.
    
    See Also:
    
    getVersionChildren()
  - getVersionChildren
```
public List<AdaptationHome> getVersionChildren()
```
    Returns the snapshots which have been created from this AdaptationHome.
    A snapshot is always created from a dataspace.
    
    See Also:
    
    getBranchChildren()
  - getRepository
```
public Repository getRepository()
```
    Returns the repository that contains this AdaptationHome.
  - isBranch
```
public boolean isBranch()
```
    Returns true if this AdaptationHome is a dataspace.
  - isBranchReference
```
public boolean isBranchReference()
```
    Returns true if this AdaptationHome is the reference dataspace.
  - isOpenBranch
```
public boolean isOpenBranch()
```
    Returns true if this AdaptationHome is an open dataspace.
  - isOpenVersion
```
public boolean isOpenVersion()
```
    Returns true if this AdaptationHome is an open snapshot.
  - isOpen
```
public boolean isOpen()
```
    Returns true if this AdaptationHome is either an open snapshot or an open dataspace.
  - isLockedBranch
```
public boolean isLockedBranch()
```
    Returns true if this AdaptationHome is a locked dataspace.
    
    See Also:
    
    LockSpec
  - isMarkedForPurge
```
public boolean isMarkedForPurge()
```
    Deprecated.
    
    Always returns false.
    
    See Also:
    
    Repository.deleteHome(AdaptationHome, Session)
  - isMarkedForHistoryPurge
```
public boolean isMarkedForHistoryPurge()
```
    Returns true if this AdaptationHome is marked for history purge.
    
    See Also:
    
    RepositoryPurge.markHomeForHistoryPurge(AdaptationHome, Session)
  - isAncestorOf
```
public boolean isAncestorOf(AdaptationHome anotherHome)
```
    Returns true if this AdaptationHome is an ancestor of the specified AdaptationHome (the AdaptationHome itself is excluded).
  - isVersion
```
public boolean isVersion()
```
    Returns true if this AdaptationHome is a snapshot.
  - isInitialVersion
```
public boolean isInitialVersion()
```
    Returns true if this AdaptationHome is an initial snapshot of a dataspace.
    When a dataspace is created from another dataspace, first an initial snapshot is created, then the new dataspace is created from this initial snapshot.
    
    See Also:
    
    Repository
  - toDisplayString
```
public final String toDisplayString(Locale aLocale)
```
    Returns a user-friendly string that specifies the type of this object, for example, "Dataspace <key>" or "Snapshot <key>".
    
    See Also:
    
    getKey()
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - getValidationReportsMap
```
public Map<AdaptationName,ValidationReport> getValidationReportsMap(Severity minimalSeverity)
```
    Returns a map of all validation reports of datasets in this AdaptationHome that have at least one validation item of the specified severity or higher.
    Since this method calls Adaptation.getValidationReport(false) on each dataset, it does not require the datasets to be activated.
    
    The rules for ensuring that data in EBX® remains valid, with respect to potential concurrent updates, are explained in section Consistency and validation.
    
    Returns:
    
    a map whose keys are AdaptationNames and values ValidationReports
    
    See Also:
    
    ValidationReport.hasItemsOfSeverityOrMore(Severity)
  - resetValidationReports
```
public final void resetValidationReports()
```
    Resets the validation reports of the datasets contained in this dataspace.
    
    Since:
    
    5.9.0
    
    See Also:
    
    Adaptation.resetValidationReport(boolean), getValidationReportsMap(Severity)
  - isTechnicalBranch
```
public final boolean isTechnicalBranch()
```
    Returns true if this AdaptationHome is a technical dataspace. A technical dataspace is used internally used by EBX®, and cannot be closed or merged.
  - isTechnicalVersion
```
public final boolean isTechnicalVersion()
```
    Returns true if this AdaptationHome is a technical snapshot. A snapshot is technical if it is a snapshot of a technical dataspace.
    
    See Also:
    
    isTechnicalBranch()

TIBCO EBX® Version 5.9.26. Copyright Cloud Software Group, Inc. 2001-2024. All rights reserved.

All third party product and company names and third party marks mentioned in this document are the property of their respective owners and are mentioned for identification.

Class AdaptationHome

Method Summary

Methods inherited from class java.lang.Object

Method Detail

findAdaptationOrNull

findParent

findAllChildren

findAllDescendants

findAllRoots

getKey

getOwner

getCreator

getLabel

getLabel

getLabelOrName

getLabelOrNameAsUserMessage

getDescription

getDescription

getCreationDate

getTerminationDate

getParent

getParentBranch

getBranchChildren

getVersionChildren

getRepository

isBranch

isBranchReference

isOpenBranch

isOpenVersion

isOpen

isLockedBranch

isMarkedForPurge

isMarkedForHistoryPurge

isAncestorOf

isVersion

isInitialVersion

toDisplayString

toString

getValidationReportsMap

resetValidationReports

isTechnicalBranch

isTechnicalVersion