org.apache.commons.nabla.automatic.analysis
Class ClassDifferentiator

java.lang.Object
  org.apache.commons.nabla.automatic.analysis.ClassDifferentiator

All Implemented Interfaces:

org.objectweb.asm.ClassVisitor

public class ClassDifferentiator
extends java.lang.Object
implements org.objectweb.asm.ClassVisitor

Visitor (in asm sense) for differentiating classes.

This visitor visits classes implementing the UnivariateDifferentiable interface and convert them to classes implementing the UnivariateDerivative interface.

The visitor creates a new class as an inner class of the visited class. Instances of the generated class are therefore automatically bound to their primitive instance which is their directly enclosing instance. As such they have access to the current value of all fields.

The visited class bytecode is not changed at all.

Constructor Summary

ClassDifferentiator(java.util.Set<java.lang.String> mathClasses, org.objectweb.asm.ClassVisitor generator)
Simple constructor.

Method Summary

java.lang.String	getDerivativeClassName() Get the name of the derivative class.
void	reportErrors() Report the errors that may have occurred during analysis.
void	visit(int version, int access, java.lang.String name, java.lang.String signature, java.lang.String superName, java.lang.String[] interfaces)
org.objectweb.asm.AnnotationVisitor	visitAnnotation(java.lang.String desc, boolean visible)
void	visitAttribute(org.objectweb.asm.Attribute attr)
void	visitEnd()
org.objectweb.asm.FieldVisitor	visitField(int access, java.lang.String name, java.lang.String desc, java.lang.String signature, java.lang.Object value)
void	visitInnerClass(java.lang.String name, java.lang.String outerName, java.lang.String innerName, int access)
org.objectweb.asm.MethodVisitor	visitMethod(int access, java.lang.String name, java.lang.String desc, java.lang.String signature, java.lang.String[] exceptions)
void	visitOuterClass(java.lang.String owner, java.lang.String name, java.lang.String desc)
void	visitSource(java.lang.String source, java.lang.String debug)

Methods inherited from class java.lang.Object

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

Constructor Detail

ClassDifferentiator

public ClassDifferentiator(java.util.Set<java.lang.String> mathClasses,
                           org.objectweb.asm.ClassVisitor generator)

Simple constructor.

Parameters:

mathClasses - math implementation classes

generator - visitor to which class generation calls will be delegated

Method Detail

getDerivativeClassName

public java.lang.String getDerivativeClassName()

Get the name of the derivative class.

Returns:

name of the (generated) derivative class

visit

public void visit(int version,
                  int access,
                  java.lang.String name,
                  java.lang.String signature,
                  java.lang.String superName,
                  java.lang.String[] interfaces)

Specified by:

visit in interface org.objectweb.asm.ClassVisitor

visitMethod

public org.objectweb.asm.MethodVisitor visitMethod(int access,
                                                   java.lang.String name,
                                                   java.lang.String desc,
                                                   java.lang.String signature,
                                                   java.lang.String[] exceptions)

Specified by:

visitMethod in interface org.objectweb.asm.ClassVisitor

visitField

public org.objectweb.asm.FieldVisitor visitField(int access,
                                                 java.lang.String name,
                                                 java.lang.String desc,
                                                 java.lang.String signature,
                                                 java.lang.Object value)

Specified by:

visitField in interface org.objectweb.asm.ClassVisitor

visitSource

public void visitSource(java.lang.String source,
                        java.lang.String debug)

Specified by:

visitSource in interface org.objectweb.asm.ClassVisitor

visitOuterClass

public void visitOuterClass(java.lang.String owner,
                            java.lang.String name,
                            java.lang.String desc)

Specified by:

visitOuterClass in interface org.objectweb.asm.ClassVisitor

visitAnnotation

public org.objectweb.asm.AnnotationVisitor visitAnnotation(java.lang.String desc,
                                                           boolean visible)

Specified by:

visitAnnotation in interface org.objectweb.asm.ClassVisitor

visitAttribute

public void visitAttribute(org.objectweb.asm.Attribute attr)

Specified by:

visitAttribute in interface org.objectweb.asm.ClassVisitor

visitInnerClass

public void visitInnerClass(java.lang.String name,
                            java.lang.String outerName,
                            java.lang.String innerName,
                            int access)

Specified by:

visitInnerClass in interface org.objectweb.asm.ClassVisitor

visitEnd

public void visitEnd()

Specified by:

visitEnd in interface org.objectweb.asm.ClassVisitor

reportErrors

public void reportErrors()
                  throws DifferentiationException

Report the errors that may have occurred during analysis.

Throws:

DifferentiationException - if the derivative class could not be generated