Oracle ADF Model and Business Components API Reference 10.1.2 B14022-01

oracle.jbo.server
Class ViewLinkImpl

java.lang.Object
  extended byoracle.jbo.common.NamedObjectImpl
      extended byoracle.jbo.server.NamedObjectImpl
          extended byoracle.jbo.server.ComponentObjectImpl
              extended byoracle.jbo.server.ViewLinkImpl
All Implemented Interfaces:
ComponentObject, Properties, ViewLink

public class ViewLinkImpl
extends ComponentObjectImpl
implements ViewLink

Implements the ViewLink interface, the middle-tier class that manages a master-detail relationship between two View Objects.

A View Link models the master-detail relationship between two View Objects. The actual relationship is implemented between a row set iterator derived from the master View Object, and a row set derived from the detail View Object.

The presence of a View Link causes the detail View Object to be refreshed when master View Object's current row designation changes. Whenever the master row set iterator designates a new current row, the detail row set is notified to refresh itself. The RowSetListener objects listening for the detail row set's events will receive the rangeRefreshed() event.

A View Link also affects initialization of the "foreign key" attribute of a detail row. When a new detail row is created its foreign key attribute is taken from the master row set iterator's current row.

A View Link can be defined in three different ways:

Since:
JDeveloper 3.0
See Also:
ViewObject, RowSet, RowSetIterator, RowSetListener

Field Summary
protected  ViewObjectImpl destination
           
protected  boolean mReversedUsage
           
protected  ViewLinkDefImpl qoAssoc
           
protected  ViewObjectImpl source
           
 
Fields inherited from class oracle.jbo.common.NamedObjectImpl
mFullName, mObjName, mParent, mProperties
 
Constructor Summary
ViewLinkImpl()
          Constructs a new View Link.
 
Method Summary
 oracle.jbo.server.DefObject getDef()
          Internal: Applications should not use this method.
 java.lang.String getDefFullName()
          Gets the full name of the View Link definition from which this view link ws created.
 java.lang.String getDefName()
          Gets the name of the View Link definition from which this view link was created.
 ViewObject getDestination()
          Gets the detail (destination side) View Object.
 ViewObject getSource()
          Gets the master (source side) View Object.
 AttributeDef getSourceAccessor()
           
 ViewLinkDefImpl getViewLinkDef()
          Internal: Applications should not use this method.
 boolean isReversedUsage()
           
 void setDestination(ViewObject destination)
          Sets the detail (destination side) View Object.
 void setSource(ViewObject source)
          Sets the master (source side) View Object.
 
Methods inherited from class oracle.jbo.server.ComponentObjectImpl
addListener, create, createRef, getApplicationModule, getCompListeners, getCompListenersList, getProxyClassName, getProxyClassName, getRootApplicationModule, isRegWithPiggyMan, remove, setName, setParent, setProxyClassName
 
Methods inherited from class oracle.jbo.server.NamedObjectImpl
setParent, setPropertiesMap
 
Methods inherited from class oracle.jbo.common.NamedObjectImpl
getFullName, getName, getParent, getProperties, getPropertiesAsStrings, getPropertiesMap, getProperty, refreshProperty, setFullName, setProperty
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface oracle.jbo.ComponentObject
getFullName, getName, remove
 
Methods inherited from interface oracle.jbo.Properties
getProperties, getProperty, refreshProperty
 

Field Detail

qoAssoc

protected ViewLinkDefImpl qoAssoc

source

protected ViewObjectImpl source

destination

protected ViewObjectImpl destination

mReversedUsage

protected boolean mReversedUsage
Constructor Detail

ViewLinkImpl

public ViewLinkImpl()
Constructs a new View Link.

Method Detail

getDef

public oracle.jbo.server.DefObject getDef()
Internal: Applications should not use this method.

Gets the definition object from which this View Link was created.

Returns:
the definition object.

getDefName

public java.lang.String getDefName()
Gets the name of the View Link definition from which this view link was created.

Specified by:
getDefName in interface ComponentObject
Overrides:
getDefName in class ComponentObjectImpl
Returns:
the View Link definition name, without its package name.

getDefFullName

public java.lang.String getDefFullName()
Gets the full name of the View Link definition from which this view link ws created.

The name returned by this method is full qualified, that is, it starts with the package name.

If this View Link is created dynamically, rather than from a View Link definition, the fully qualified definition name does not contain a package name.

Specified by:
getDefFullName in interface ComponentObject
Overrides:
getDefFullName in class ComponentObjectImpl
Returns:
s fully qualified View Link definition name.

getViewLinkDef

public ViewLinkDefImpl getViewLinkDef()
Internal: Applications should not use this method.

Gets the View Link definition object from which this View Link was created.

Returns:
the View Link definition.

getSource

public ViewObject getSource()
Gets the master (source side) View Object.

Specified by:
getSource in interface ViewLink
Returns:
the master View Object.

setSource

public void setSource(ViewObject source)
Sets the master (source side) View Object.

Parameters:
source - the master View Object.
Throws:
InvalidParamException - if the master and detail are the same View Object, or if the View Object Definitions for source and the View Link definition's master do not match.

getDestination

public ViewObject getDestination()
Gets the detail (destination side) View Object.

Specified by:
getDestination in interface ViewLink
Returns:
the detail View Object.

setDestination

public void setDestination(ViewObject destination)
Sets the detail (destination side) View Object.

Parameters:
destination - the detail View Object.
Throws:
InvalidParamException - if the master and detail are the same View Object, or if the View Object Definitions for destination and the View Link definition's detail do not match.

isReversedUsage

public boolean isReversedUsage()

getSourceAccessor

public AttributeDef getSourceAccessor()

Oracle ADF Model and Business Components API Reference 10.1.2 B14022-01

 

Copyright © 1997, 2004, Oracle. All rights reserved.