uk.ac.sheffield.vtts.ground

Class JavaFactory

java.lang.Object

uk.ac.sheffield.vtts.ground.AbstractFactory

uk.ac.sheffield.vtts.ground.JavaFactory

All Implemented Interfaces:

Factory

public class JavaFactory
extends AbstractFactory

JavaFactory is a factory for creating Java objects in the service run-time. JavaFactory is a utility imported by every kind of Java grounding that needs to synthesise Java values of types other than the basic types from their textual representations. Whereas the Java compiler may reconstruct values of basic types from their literal representation, it Cannot easily reconstruct instances of List, Set, Map and Pair types from their textual representation. In this case, the Java grounding algorithm should create a call to this JavaFactory to synthesise the required object, given the Java printed representation of its value, and its Java type.

Version:

Broker@Cloud 1.0

Author:

Anthony J H Simons

Constructor Summary

Constructors

Constructor and Description
JavaFactory() Creates a JavaFactory.

Method Summary

Methods

Modifier and Type	Method and Description
protected java.lang.Object	createExternalObject(java.lang.String value, java.lang.String type) Creates an instance of an uninterpreted external type, with the given value.
java.lang.Object	createObject(java.lang.String value, java.lang.String type) Creates an instance of any kind of Java Object with the given printed representation and Java type.
protected java.lang.Class<?>	findClassDefinition(java.lang.String type) Finds the Java class definition for an external user-defined type.
void	useSourcePackage(java.lang.String packageInfo) Adds a user-defined source package to the Java package locations known by this JavaFactory.

Methods inherited from class uk.ac.sheffield.vtts.ground.AbstractFactory

create, createDefaultObject, createListObject, createMapObject, createPairObject, createSetObject, createSimpleObject, error, makeEntityId, safeIndexOf, safeSplit

Methods inherited from class java.lang.Object

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

Constructor Detail

JavaFactory

public JavaFactory()

Creates a JavaFactory. Initialises the Map from type names to Java package locations for user-defined classes.

Method Detail

useSourcePackage

public void useSourcePackage(java.lang.String packageInfo)

Adds a user-defined source package to the Java package locations known by this JavaFactory. The package may be searched for the existence of a user-defined type.

Parameters:

packageInfo - a package location in the Java style.

createObject

public java.lang.Object createObject(java.lang.String value,
                            java.lang.String type)

Creates an instance of any kind of Java Object with the given printed representation and Java type. This is the principal factory method for creating object instances. It expects the type to be supplied in the Java format (using angle brackets for generic parameters).

Parameters:

value - the value, as a String.

type - the Java type, as a String.

Returns:

a new instance of the type.

findClassDefinition

protected java.lang.Class<?> findClassDefinition(java.lang.String type)
                                          throws java.lang.ClassNotFoundException

Finds the Java class definition for an external user-defined type. If the class location is already known, returns the Java class; otherwise attempts to find the class in each of the supplied user packages, and eventually the default package.

Parameters:

type - the simple name of the Java class type.

Returns:

the Java class definition of the type.

Throws:

java.lang.ClassNotFoundException - if no class definition is found.

createExternalObject

protected java.lang.Object createExternalObject(java.lang.String value,
                                    java.lang.String type)

Creates an instance of an uninterpreted external type, with the given value. External types are uninterpreted user-defined types used by the Service-Under-Test. Provided the Java package location of this type was previously added to this JavaFactory, creates an instance of the user-defined type, expecting it to have a constructor that accepts a single String argument as some kind of identifier.

Specified by:

createExternalObject in class AbstractFactory

Parameters:

value - the identifier for this object, as a String.

type - the Java type of this object, as a String.

Returns:

the created instance.