org.dmd.dmr.server.ldap.util

Class HierarchyParserOld

java.lang.Object

org.dmd.dmr.server.ldap.util.HierarchyParserOld

All Implemented Interfaces:

DmcNameResolverIF, DmcUncheckedOIFHandlerIF

public class HierarchyParserOld
extends Object
implements DmcUncheckedOIFHandlerIF, DmcNameResolverIF

The HierarchyParser reads a collection of HierarchicObjects and assembles them into a hierarchy of objects.

Constructor Summary

Constructors

Constructor and Description
HierarchyParserOld(SchemaManager sm)

Method Summary

Modifier and Type	Method and Description
DmcObject	findNamedDMO(DmcObjectName name) Finds a DMO based on its name.
DmcNamedObjectIF	findNamedObject(DmcObjectName name) Finds a named object based on its name.
DmcNamedObjectIF	findNamedObject(DmcObjectName name, int attributeID) Finds a named object based on its name and indicates the attribute via which the reference is being made.
DmcNamedObjectIF	findNamedObject(String name)
void	handleObject(DmcUncheckedObject uco, String infile, int lineNumber) Process the object as required.
void	readHierarchicFile(TreeMap<DmcHierarchicObjectName,HierarchicObject> byFQN, String fn) This method can be used to load multiple hierarchic structures into the same keymap.
HierarchicObject	readHierarchy(String fn)
HierarchicObject	readHierarchyBelowRoot(HierarchicObject existingRoot, String fn) This method allows you to read a set of objects below a pre-existing root object.

Methods inherited from class java.lang.Object

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

Constructor Detail

HierarchyParserOld

public HierarchyParserOld(SchemaManager sm)

Method Detail

readHierarchy

public HierarchicObject readHierarchy(String fn)
                               throws ResultException,
                                      DmcValueException,
                                      DmcRuleExceptionSet,
                                      DmcNameClashException

Throws:

ResultException

DmcValueException

DmcRuleExceptionSet

DmcNameClashException

readHierarchicFile

public void readHierarchicFile(TreeMap<DmcHierarchicObjectName,HierarchicObject> byFQN,
                               String fn)
                        throws ResultException,
                               DmcValueException,
                               DmcRuleExceptionSet,
                               DmcNameClashException

This method can be used to load multiple hierarchic structures into the same keymap. All of the hierarchies should share a common root object (which is NOT stored in the file with the object being loaded). However, you must have access to the root object and place its FQN in the byFQN map before you call this method.

Parameters:

byFQN - The mapping of objects by FQN. This must contain an entry for your root object if you're using a common root.

fn - The name of the file to be parsed.

Throws:

ResultException

DmcValueException

DmcRuleExceptionSet

DmcNameClashException

readHierarchyBelowRoot

public HierarchicObject readHierarchyBelowRoot(HierarchicObject existingRoot,
                                               String fn)
                                        throws ResultException,
                                               DmcValueException,
                                               DmcRuleExceptionSet,
                                               DmcNameClashException

This method allows you to read a set of objects below a pre-existing root object.

Parameters:

existingRoot -

fn -

Returns:

The root of the hierarchy.

Throws:

ResultException

DmcValueException

DmcRuleExceptionSet

DmcNameClashException

handleObject

public void handleObject(DmcUncheckedObject uco,
                         String infile,
                         int lineNumber)
                  throws ResultException,
                         DmcValueException,
                         DmcNameClashException

Description copied from interface: DmcUncheckedOIFHandlerIF

Process the object as required.

Specified by:

handleObject in interface DmcUncheckedOIFHandlerIF

Parameters:

uco - The object to be handled.

infile - Name of the file from which the object was loaded.

lineNumber - The line in the file where the object ended.

Throws:

ResultException - if problems occur

DmcValueException - if values are incorrect

DmcNameClashException - if names clash

findNamedObject

public DmcNamedObjectIF findNamedObject(String name)

findNamedObject

public DmcNamedObjectIF findNamedObject(DmcObjectName name)

Description copied from interface: DmcNameResolverIF

Finds a named object based on its name.

Specified by:

findNamedObject in interface DmcNameResolverIF

Returns:

the named object.

findNamedDMO

public DmcObject findNamedDMO(DmcObjectName name)

Description copied from interface: DmcNameResolverIF

Finds a DMO based on its name.

Specified by:

findNamedDMO in interface DmcNameResolverIF

Parameters:

name - the name of the object

Returns:

A Dark Matter Object.

findNamedObject

public DmcNamedObjectIF findNamedObject(DmcObjectName name,
                                        int attributeID)

Description copied from interface: DmcNameResolverIF

Finds a named object based on its name and indicates the attribute via which the reference is being made. This method is used via the DmcObject and is primarily intended to handle the situation where we must resolve internal type definitions as opposed to class definitions. This is due to the fact that we create internal type definitions for classes that have the same name as the associated classes.

Specified by:

findNamedObject in interface DmcNameResolverIF

Parameters:

name - the name of an object

attributeID - the attribute by which it is named

Returns:

the named object