com.openxc.interfaces

Class VehicleInterfaceFactory

java.lang.Object

com.openxc.interfaces.VehicleInterfaceFactory

public class VehicleInterfaceFactory
extends java.lang.Object

A factory that uses reflection to create instance of VehicleInterface implementations.

Method Summary

Modifier and Type	Method and Description
static VehicleInterface	build(java.lang.Class<? extends VehicleInterface> interfaceType, android.content.Context context, java.lang.String resource) Retrieve the Class for a given name and construct an instance of it.
static VehicleInterface	build(java.lang.String interfaceName, android.content.Context context, java.lang.String resource) Retrieve the Class for a given name and construct an instance of it.
static java.lang.Class<? extends VehicleInterface>	findClass(java.lang.String interfaceName) Obtain the Class object for a given VehicleInterface class name.

Methods inherited from class java.lang.Object

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

Method Detail

findClass

public static java.lang.Class<? extends VehicleInterface> findClass(java.lang.String interfaceName)
                                                             throws VehicleInterfaceException

Obtain the Class object for a given VehicleInterface class name. The class must be in the classpath of the process' context, or an exception will be thrown.

Parameters:

interfaceName - the canonical name of class implementing VehicleInterface

Returns:

the Class object, if found.

Throws:

VehicleInterfaceException - if the named class could not be found or loaded.

build

public static VehicleInterface build(java.lang.String interfaceName,
                                     android.content.Context context,
                                     java.lang.String resource)
                              throws VehicleInterfaceException

Retrieve the Class for a given name and construct an instance of it.

Throws:

VehicleInterfaceException - If the named interfaced could not be found or if its constructor threw an exception.

See Also:

build(Class, Context, String)

build

public static VehicleInterface build(java.lang.Class<? extends VehicleInterface> interfaceType,
                                     android.content.Context context,
                                     java.lang.String resource)
                              throws VehicleInterfaceException

Retrieve the Class for a given name and construct an instance of it.

Parameters:

interfaceType - the desired class to load and instantiate.

context - The Android application or service context to be passed to the new instance of the VehicleInterface.

resource - A reference to a resource the new instance should use - see the specific implementation of VehicleInterface for its requirements.

Returns:

A new instance of the class given in interfaceType.

Throws:

VehicleInterfaceException - If the class' constructor threw an exception.