TPTP 4.6.0 Platform Project
Internal API Specification

org.eclipse.tptp.platform.report.extension.internal
Class DExtensible

java.lang.Object
  extended by org.eclipse.tptp.platform.report.extension.internal.DExtensible
Direct Known Subclasses:
DExtensibleTest1, DLinkResolver, DParser, SWTPainter, SWTViewer.KeyEventHandler, SWTViewer.MouseEventHandler

Deprecated. As of TPTP 4.5.0, use the TPTP Business Intelligence and Reporting Tools (BIRT) reporting infrastructure (org.eclipse.tptp.platform.report.birt).

public class DExtensible
extends java.lang.Object

DExtensible provide runtime-class methods definition and/or override with "rename" feature. Extensible methods must have this prototype : method_name( >Any Class<, IDRuntimeExtends, Object ), first parameter class is used to resolve methods overlay, second parameter is the extensible object calling the method, and the third object is an argument provided by extensible object to "communicate" with called extension. By default extensible methods are named "doMethod", but you can use different name using installDoMethod(Method,Object) or installDoMethod(String,Object).


Nested Class Summary
protected static class DExtensible.InvokeMethod
          Deprecated.  
 
Field Summary
protected  java.util.Hashtable mapMethod
          Deprecated. map of InvokeMethod using class as key
protected  java.lang.Object[] paramTab
          Deprecated. argument used at invokation time
 
Constructor Summary
DExtensible()
          Deprecated. initialise invoke table exploring all currents "doMethod" method with expected prototype.
 
Method Summary
 void doMethod(java.lang.Object i, DExtensible re, java.lang.Object arg)
          Deprecated. Stub to trace without error any undefined/unresolved method.
protected  DExtensible.InvokeMethod getDoMethod(java.lang.Class for_class)
          Deprecated.  
 void installDoMethod(java.lang.reflect.Method m, java.lang.Object callee)
          Deprecated. Add invoke method for class m.arg[0].getClass(), method must have only one parameter.
 void installDoMethods(java.lang.Object callee)
          Deprecated. Parse callee class definition and installs all methods "doMethod( arg )", where arg is any class.
 void installDoMethods(java.lang.String method_name, java.lang.Object callee)
          Deprecated. Parse callee class definition and installs all methods "method_name( arg )", where arg is of any class.
 void invokeDoMethod(java.lang.Object arg, DExtensible ext, java.lang.Object parser_arg)
          Deprecated. resolve best "doMethod" for arg.getClass() known in current extensible object and perform the invokation of this method using same argument.
protected  void invokeSuperDoMethod(java.lang.Object super_of, java.lang.Object arg, DExtensible ext, java.lang.Object parser_arg)
          Deprecated. Resolve best "doMethod" for arg.getClass() known in current extensible object and perform the invokation of this method using same argument.
 void removeDoMethod(java.lang.reflect.Method m, java.lang.Object callee)
          Deprecated. Removes method m, using calle in the invokation table, let previous installed method for same argument.
 void removeDoMethod(java.lang.String method_name, java.lang.Class arg_type, java.lang.Object callee)
          Deprecated. Remove from incokation table method associated with callee that is currently call for given class object.
 void removeDoMethods(java.lang.Object c)
          Deprecated. Parse callee class definition and removes all methods "doMethod( arg )" associated with callee (arg if of any class).
 void removeDoMethods(java.lang.String method_name, java.lang.Object callee)
          Deprecated. Remove from invokation table all methods "method_name(arg)" (arg is of any class), using given callee object.
protected  DExtensible.InvokeMethod resolveDoMethod(java.lang.Object arg, java.lang.Object super_of_this_callee)
          Deprecated.  
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

mapMethod

protected java.util.Hashtable mapMethod
Deprecated. 
map of InvokeMethod using class as key


paramTab

protected java.lang.Object[] paramTab
Deprecated. 
argument used at invokation time

Constructor Detail

DExtensible

public DExtensible()
Deprecated. 
initialise invoke table exploring all currents "doMethod" method with expected prototype. Then extends object using all registered extension @see DExtensionRegistry.

Method Detail

doMethod

public void doMethod(java.lang.Object i,
                     DExtensible re,
                     java.lang.Object arg)
Deprecated. 
Stub to trace without error any undefined/unresolved method.


getDoMethod

protected DExtensible.InvokeMethod getDoMethod(java.lang.Class for_class)
Deprecated. 
Returns:
first InvokeMethod assicated with 'for_class' in map. removes from map all first lost callee references, and return first non null one. return null if no invoke method can be found.
See Also:
#resolveInvokeMethod( Object )

resolveDoMethod

protected DExtensible.InvokeMethod resolveDoMethod(java.lang.Object arg,
                                                   java.lang.Object super_of_this_callee)
Deprecated. 
Parameters:
arg - actual parameter its getClass() is used to resolve doMethod() to invoke.
super_of_this_callee - the 'I want to get previous installed callee' constraint.
Returns:
method to invoke for object's class, or null if method is not found. search in method map for object(), object implemented interface, and do this search for all superclass of object.getClass(), if needed.

invokeDoMethod

public void invokeDoMethod(java.lang.Object arg,
                           DExtensible ext,
                           java.lang.Object parser_arg)
Deprecated. 
resolve best "doMethod" for arg.getClass() known in current extensible object and perform the invokation of this method using same argument.


invokeSuperDoMethod

protected void invokeSuperDoMethod(java.lang.Object super_of,
                                   java.lang.Object arg,
                                   DExtensible ext,
                                   java.lang.Object parser_arg)
Deprecated. 
Resolve best "doMethod" for arg.getClass() known in current extensible object and perform the invokation of this method using same argument. The first parameter is used to invoke the previously installed extension of 'super_of', if it's found no call are performed. Using null as 'super_of' call the lasted installed extension (ie same a invokeDoMethod())


installDoMethod

public final void installDoMethod(java.lang.reflect.Method m,
                                  java.lang.Object callee)
Deprecated. 
Add invoke method for class m.arg[0].getClass(), method must have only one parameter.

Parameters:
m - the method to call, having only one parameter.
callee - is an instance where method is accessible.
Throws:
java.lang.Error - if method haven't parameter of have more than one parameter.

installDoMethods

public final void installDoMethods(java.lang.String method_name,
                                   java.lang.Object callee)
Deprecated. 
Parse callee class definition and installs all methods "method_name( arg )", where arg is of any class.

Parameters:
method_name - method_name to extract invoke methods.
callee - is an instance where method is accessible.
See Also:
installDoMethod(Method,Object)

installDoMethods

public final void installDoMethods(java.lang.Object callee)
Deprecated. 
Parse callee class definition and installs all methods "doMethod( arg )", where arg is any class. Use callee to invoke method.

Parameters:
callee - is an instance where method is accessible.
See Also:
installDoMethods(String,Object)

removeDoMethod

public final void removeDoMethod(java.lang.reflect.Method m,
                                 java.lang.Object callee)
Deprecated. 
Removes method m, using calle in the invokation table, let previous installed method for same argument. If method is the current used method, that means the previous installed is replaced automatically.


removeDoMethod

public final void removeDoMethod(java.lang.String method_name,
                                 java.lang.Class arg_type,
                                 java.lang.Object callee)
Deprecated. 
Remove from incokation table method associated with callee that is currently call for given class object. This remove method is provide for simple access than:

Parameters:
method_name - name used to search in callee's class definition
arg_type - the method arg type used to know wich method to remove (overloading).
callee - object used to access method.
See Also:
removeDoMethod( Method m, Object callee )

removeDoMethods

public final void removeDoMethods(java.lang.String method_name,
                                  java.lang.Object callee)
Deprecated. 
Remove from invokation table all methods "method_name(arg)" (arg is of any class), using given callee object.

Parameters:
method_name - method name used to parse callee class definition.
callee - object used to access method.
See Also:
removeDoMethod(Method,Object)

removeDoMethods

public final void removeDoMethods(java.lang.Object c)
Deprecated. 
Parse callee class definition and removes all methods "doMethod( arg )" associated with callee (arg if of any class).

See Also:
removeDoMethods(String,Object)

TPTP 4.6.0 Platform Project
Internal API Specification