Package org.openscience.cdk.debug

Class DebugChemObjectBuilder

java.lang.Object

org.openscience.cdk.debug.DebugChemObjectBuilder

All Implemented Interfaces:

IChemObjectBuilder

public class DebugChemObjectBuilder
extends Object
implements IChemObjectBuilder

A helper class to instantiate a IChemObject for the original CDK implementation. The factory create debug objects which will log their behaviour when used.

     IChemObjectBuilder builder = DebugChemObjectBuilder.getInstance();

     IAtom a = builder.newInstance(IAtom.class);
     IAtom c12 = builder.newInstance(IAtom.class, "C");
     IAtom c13 = builder.newInstance(IAtom.class,
                                     builder.newInstance(IIsotope.class,
                                                         "C", 13));
 

Author:

egonw, john may

Source code:

main

Belongs to CDK module:

datadebug

Constructor Summary

Constructors

Constructor	Description
DebugChemObjectBuilder()

Method Summary

Modifier and Type	Method	Description
static IChemObjectBuilder	getInstance()	Access the singleton instance of this DebugChemObjectBuilder.
IAtom	newAtom()	Create a new atom using the default constructor.
IAtomContainer	newAtomContainer()	Create a new atom container using the default constructor.
IBond	newBond()	Create a new bond using the default constructor.
<T extends ICDKObject> T	newInstance(Class<T> clazz, Object... params)	Creates a new instance of an ICDKObject, using the constructor defined by the given parameters.
IReaction	newReaction()	Create a new reaction using the default constructor.

Methods inherited from class java.lang.Object

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

Constructor Detail

DebugChemObjectBuilder

public DebugChemObjectBuilder()

Method Detail

getInstance

public static IChemObjectBuilder getInstance()

Access the singleton instance of this DebugChemObjectBuilder.

 // get the builder instance
 IChemObjectBuilder builder = DebugChemObjectBuilder.getInstance();

 // using the builder...
 // create an IAtom using the default constructor
 IAtom atom = builder.newInstance(IAtom.class);

 // create a carbon atom
 IAtom c1 = builder.newInstance(IAtom.class, "C");
 

Returns:

a DebugChemObjectBuilder instance

newInstance

public <T extends ICDKObject> T newInstance(Class<T> clazz,
                                            Object... params)
                                     throws IllegalArgumentException

Creates a new instance of an ICDKObject, using the constructor defined by the given parameters.

Specified by:

newInstance in interface IChemObjectBuilder

Type Parameters:

T - Class of an interface extending ICDKObject or ICDKObject itself.

Parameters:

clazz - Interface class to instantiate an instance for.

params - Parameters passed to the constructor of the created instance.

Returns:

Instance created.

Throws:

IllegalArgumentException - Exception thrown when the IChemObjectBuilder builder cannot instantiate the clazz with the given parameters.

newAtom

public IAtom newAtom()

Create a new atom using the default constructor. This method is considerably faster than the dynamic dispatch of newInstance(IAtom.class) and should be used for high throughput applications (e.g. IO).

Specified by:

newAtom in interface IChemObjectBuilder

Returns:

new atom

newBond

public IBond newBond()

Create a new bond using the default constructor. This method is considerably faster than the dynamic dispatch of newInstance(IBond.class) and should be used for high throughput applications (e.g. IO).

Specified by:

newBond in interface IChemObjectBuilder

Returns:

new bond

newAtomContainer

public IAtomContainer newAtomContainer()

Create a new atom container using the default constructor. This method is considerably faster than the dynamic dispatch of newInstance(IAtomContainer.class) and should be used for high throughput applications (e.g. IO).

Specified by:

newAtomContainer in interface IChemObjectBuilder

Returns:

the new atom container

newReaction

public IReaction newReaction()

Create a new reaction using the default constructor. This method is considerably faster than the dynamic dispatch of newInstance(IReaction.class) and should be used for high throughput applications (e.g. IO).

Specified by:

newReaction in interface IChemObjectBuilder

Returns:

the new reaction