net.mdatools.modelant.core.operation.element

Class NavigateObjectPath<R>

java.lang.Object

net.mdatools.modelant.core.operation.element.NavigateObjectPath<R>

All Implemented Interfaces:

Function<javax.jmi.reflect.RefFeatured,R>

Direct Known Subclasses:

Add, Clear, Get, Set

public abstract class NavigateObjectPath<R>
extends Object
implements Function<javax.jmi.reflect.RefFeatured,R>

Starting from an object navigate a path of associations do some processing at the end of the path

 Format:
    empty
 |  asssociationToOneName{.asssociationToOneName}
 | [asssociationToOneName{.asssociationToOneName}.](associationToMany | attributeName)

  associationToOneName = name
                         | METAOBJECT
                         | METACLASSNAME
                         | IPACKAGE
                         | OPACKAGE

  associationToManyName = name

  attributeName = name
                  | MOFID
 where:
   name is the name of an association in *-to-one multiplicity. In the case when there is no attribute name,
     the last used name can be an association *-to-many
   MOFID refers the MOF ID of the object to process
   METAOBJECT retrieves the meta-object of the object to process. This allows reflective navigation.
   METACLASSNAME retrieves the qualified (in the meta-model) name of the meta-class for the processed object.
   IPACKAGE retrieves the immediate package in the meta-model the processed object is in
   OPACKAGE retrieves the outer-most package (the extent) where object processed is in

 

Author:

Rusi Popov (popovr@mdatools.net)

Field Summary

Fields inherited from interface net.mdatools.modelant.core.api.Function

IDENTITY

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	NavigateObjectPath(String path)
protected	NavigateObjectPath(String[] path)

Method Summary

Modifier and Type	Method and Description
R	execute(javax.jmi.reflect.RefFeatured start)
protected abstract R	processEmptyPath(javax.jmi.reflect.RefFeatured start) Processing an EMPTY navigation path
protected abstract R	processLast(javax.jmi.reflect.RefFeatured start, javax.jmi.reflect.RefFeatured current, String itemName, Object value) Processing of the final attribute or association *-to-MANY in the path
protected abstract R	processLast(javax.jmi.reflect.RefFeatured start, javax.jmi.reflect.RefFeatured current, String itemName, javax.jmi.reflect.RefFeatured associated) Processing of the final association *-to-ONE in the path

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface net.mdatools.modelant.core.api.Function

toString

Constructor Detail

NavigateObjectPath

protected NavigateObjectPath(String path)

Parameters:

path - a non-null path following *-to-one associations and ending optionally with attribute or *-to-many association

NavigateObjectPath

protected NavigateObjectPath(String[] path)

Parameters:

path - a non-null path following *-to-one associations and ending optionally with attribute or *-to-many association

Method Detail

execute

public final R execute(javax.jmi.reflect.RefFeatured start)
                throws RuntimeException,
                       IllegalArgumentException

Specified by:

execute in interface Function<javax.jmi.reflect.RefFeatured,R>

Parameters:

start - non-null object to start naviagtion from

Returns:

the object processed

Throws:

RuntimeException

IllegalArgumentException

See Also:

Function.execute(java.lang.Object)

processEmptyPath

protected abstract R processEmptyPath(javax.jmi.reflect.RefFeatured start)

Processing an EMPTY navigation path

Parameters:

start - not null object the navigation started from

Returns:

operation result

processLast

protected abstract R processLast(javax.jmi.reflect.RefFeatured start,
                                 javax.jmi.reflect.RefFeatured current,
                                 String itemName,
                                 javax.jmi.reflect.RefFeatured associated)

Processing of the final association *-to-ONE in the path

Parameters:

start - not null object the navigation started from

current - not null object reached down the path EXCEPT the last name in that path

itemName - the non-null, non-empty last name in the path, which is an association *-to-ONE, already validated as accessible through Navigator.getReflectiveValue(Object, String)

associated - the reached last associated to current model element in the association itemName

Returns:

operation result

processLast

protected abstract R processLast(javax.jmi.reflect.RefFeatured start,
                                 javax.jmi.reflect.RefFeatured current,
                                 String itemName,
                                 Object value)

Processing of the final attribute or association *-to-MANY in the path

Parameters:

start - not null object the navigation started from

value - the attribute value or association *-to-MANY reached at the end of the path

itemName - the non-null, non-empty last name in the path, which is an association *-to-MANY or attribute name, already validated as accessible through Navigator.getReflectiveValue(Object, String)

Returns:

operation result