org.gvsig.tools.dynobject

Interface DynObjectManager

All Known Implementing Classes:

DefaultDynObjectManager

public interface DynObjectManager

Manager for the DynObject tools library. This is the main entry point to the tools dynobjects API.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DYNCLASS_NAME_SEPARATOR
static int	NULLCODE Null value for method id.

Method Summary

Modifier and Type	Method and Description
void	add(DynClass dynClass) Aņade la dynClass a la lista de clases registradas.
DynClass	add(java.lang.String name) Create and add to the manager a class with the name passed as parameter in the default namespace.
DynClass	add(java.lang.String name, java.lang.String description) Create and add to the manager a class with the name passed as parameter in the default namespace.
void	clear(DynObject obj)
void	consolide() Actualiza todas las DynClasses registradas para reflejar la herencia de forma adecuada.
void	copy(DynObject source, DynObject target)
DynClass	createCopy(DynClass source)
DynClass	createDynClass(java.lang.String name, java.lang.String description) Create a instance of DynClass with the name and description Indicated as parameters.
DynClass	createDynClass(java.lang.String namespace, java.lang.String name, java.lang.String description) Create a instance of DynClass with the name and description Indicated as parameters.
DynClassName	createDynClassName(java.lang.String name) Creates a DynClassName with a DynClass name or fullname
DynClassName	createDynClassName(java.lang.String namespace, java.lang.String name) Creates a DynClassName with a DynClass name and its namespace.
DynField	createDynField(java.lang.String name)
DynObject	createDynObject(DynStruct dynStruct) Create a new DynObject associated to the DynStruct or DynClass passed as parameter.
DynObject	createDynObject(java.lang.String classname) Crea un nuevo objeto asociandole como clase base la indicada que tiene el nombre indicado.
DynObject	createDynObject(java.lang.String namespace, java.lang.String classname) Crea un nuevo objeto asociandole como clase base la indicada que tiene el nombre indicado.
DynObjectPagingHelper	createDynObjectPagingHelper(DynObjectSet set) Creates a new DynObjectPagingHelper to page the data of a DynObjectSet.
DynObjectPagingHelper	createDynObjectPagingHelper(DynObjectSet set, int pageSize) Creates a new DynObjectPagingHelper to page the data of a DynObjectSet.
DynObjectEncoder	createSimpleDynObjectEncoder()
boolean	equals(DynObject obj1, DynObject obj2)
java.lang.String	exportSimpleDynClassDefinitions(DynClass dynClass)
void	exportSimpleDynClassDefinitions(java.io.File out, DynClass dynClass)
void	exportSimpleDynClassDefinitions(java.io.OutputStream out, DynClass dynClass)
DynClass	get(java.lang.String name) Obtiene la clase asociado al nombre indicado.
DynClass	get(java.lang.String namespace, java.lang.String name) Obtiene el la clase asociado al nombre indicado dentro del namespace pedido.
java.lang.Object	getAttributeValue(java.lang.Object obj, java.lang.String name)
int	getCount() Return the count of registered DynClass.
java.lang.Class	getDefaultClassOfType(int type) Deprecated. use DataTypesManager.getDefaultClass
DynMethod	getDynMethod(java.lang.Class theClass, int code)
DynMethod	getDynMethod(DynClass dynClass, int code)
DynMethod	getDynMethod(DynObject dynObject, int code) Obtain the method for the indicated code of the dynObject.
DynMethod	getDynMethod(int code)
DynMethod	getDynMethod(java.lang.Object obj, int code)
DynMethod	getDynMethod(java.lang.String methodName) Retrieve an anonimous method registered in the manager.
java.util.List	getNames() Return the list of names of all registered DynClass.
UnmodifiableBasicMap<java.lang.String,DynField>	getTags()
boolean	has(java.lang.String name) Comprueba si esta registrada una clase.
boolean	has(java.lang.String namespace, java.lang.String name) Comprueba si esta registrada una clase.
int	hashCode(DynObject obj)
java.util.Map	importDynClassDefinitions(java.io.InputStream resource, java.lang.ClassLoader loader) Load the classes defined in the resource.
java.util.Map	importDynClassDefinitions(java.io.InputStream resource, java.lang.ClassLoader loader, java.lang.String defaultNamespace) Load the classes defined in the resource and return a Map with its.
java.util.Map	importDynClassDefinitions(XmlPullParser parser, java.lang.ClassLoader loader, java.lang.String defaultNamespace) Load the classes defined in the resource.
java.lang.Object	invokeDynMethod(java.lang.Object self, int code, DynObject context) Invoke the method of the indicated code for the object self, with parameters in context.
java.util.Iterator	iterator() Return an iterator over all registered DynClass.
java.util.Iterator	iterator(java.lang.String namespace) Return an iterator over all registered DynClass with the same namespace.
int	registerDynMethod(java.lang.Class theClass, DynMethod dynMethod) Register the method in the class.
int	registerDynMethod(DynClass dynClass, DynMethod dynMethod) Register the method in the dynClass.
int	registerDynMethod(DynMethod dynMethod) Register an anonimous method.
DynField	registerTag(java.lang.String name, java.lang.String description)
DynField	registerTag(java.lang.String name, java.lang.String description, DynMethod valuesMethod)
DynField	registerTag(java.lang.String name, java.lang.String description, java.lang.String[] values)
void	remove(DynStruct dynClass)
void	setAttributeValue(java.lang.Object obj, java.lang.String name, java.lang.Object value)
void	validate(DynObject object)

Field Detail

DYNCLASS_NAME_SEPARATOR

static final java.lang.String DYNCLASS_NAME_SEPARATOR

See Also:

Constant Field Values

NULLCODE

static final int NULLCODE

Null value for method id. This value not is a value valid for a code of method.

See Also:

Constant Field Values

Method Detail

createCopy

DynClass createCopy(DynClass source)

createDynClass

DynClass createDynClass(java.lang.String name,
                        java.lang.String description)

Create a instance of DynClass with the name and description Indicated as parameters.

Parameters:

name - , the name used for DynClass name.

description - , the description associated to the new DynClass.

Returns:

the DynClass created.

createSimpleDynObjectEncoder

DynObjectEncoder createSimpleDynObjectEncoder()

createDynClass

DynClass createDynClass(java.lang.String namespace,
                        java.lang.String name,
                        java.lang.String description)

Create a instance of DynClass with the name and description Indicated as parameters.

Parameters:

namespace - , the namespace used for the new DynClass.

name - , the name used for the new DynClass.

description - , the description associated to the new DynClass.

Returns:

the DynClass created.

exportSimpleDynClassDefinitions

java.lang.String exportSimpleDynClassDefinitions(DynClass dynClass)

exportSimpleDynClassDefinitions

void exportSimpleDynClassDefinitions(java.io.File out,
                                     DynClass dynClass)
                              throws java.io.FileNotFoundException

Throws:

java.io.FileNotFoundException

exportSimpleDynClassDefinitions

void exportSimpleDynClassDefinitions(java.io.OutputStream out,
                                     DynClass dynClass)

importDynClassDefinitions

java.util.Map importDynClassDefinitions(java.io.InputStream resource,
                                        java.lang.ClassLoader loader,
                                        java.lang.String defaultNamespace)
                                 throws XmlPullParserException,
                                        java.io.IOException

Load the classes defined in the resource and return a Map with its. The classes do not be registered in the manager.

Parameters:

resource - , XML with the definition of dynamic classes.

loader - , loader used to load classes used in "classOfValue" in the resource.

defaultNamespace - , namespace used in classes that do not specify a namespace in the resource.

Returns:

The Map of loaded dynamic classes

Throws:

XmlPullParserException

java.io.IOException

importDynClassDefinitions

java.util.Map importDynClassDefinitions(java.io.InputStream resource,
                                        java.lang.ClassLoader loader)
                                 throws XmlPullParserException,
                                        java.io.IOException

Load the classes defined in the resource. When the class do not specify a namespace this is set to null. The classes do not be registered in the manager.

Parameters:

resource - , XML with the definition of dynamic classes.

loader - , loader used to load classes used in "classOfValue" in the resource.

Returns:

The Map of loaded dynamic classes

Throws:

XmlPullParserException

java.io.IOException

importDynClassDefinitions

java.util.Map importDynClassDefinitions(XmlPullParser parser,
                                        java.lang.ClassLoader loader,
                                        java.lang.String defaultNamespace)
                                 throws XmlPullParserException,
                                        java.io.IOException

Load the classes defined in the resource. When the class do not specify a namespace this is set to null. The classes do not be registered in the manager.

Parameters:

parser - , XML parser used in the definition of dynamic classes.

loader - , loader used to load classes used in "classOfValue" in the resource.

defaultNamespace - , namespace used in classes that do not specify a namespace in the resource.

Returns:

The Map of loaded dynamic classes

Throws:

XmlPullParserException

java.io.IOException

add

void add(DynClass dynClass)
  throws DuplicateDynClassException

Aņade la dynClass a la lista de clases registradas. Falla lanzando una excepcion si ya existe una clase registrada con ese nombre en ese namespace.

Parameters:

dynClass -

Throws:

DuplicateDynClassException

add

DynClass add(java.lang.String name,
             java.lang.String description)

Create and add to the manager a class with the name passed as parameter in the default namespace.

Parameters:

name -

description -

Returns:

the new class created.

add

DynClass add(java.lang.String name)

Create and add to the manager a class with the name passed as parameter in the default namespace.

Parameters:

name -

description -

Returns:

the new class created.

remove

void remove(DynStruct dynClass)

get

DynClass get(java.lang.String name)

Obtiene la clase asociado al nombre indicado. Si se indica un nombre con namespace la buscara en ese namespace. if not se usara el namespace por defecto.

Parameters:

name - , nombre de la clase que queremos obtener.

Returns:

la clase requerida.

get

DynClass get(java.lang.String namespace,
             java.lang.String name)

Obtiene el la clase asociado al nombre indicado dentro del namespace pedido.

Parameters:

name - , nombre de la clase que queremos obtener.

Returns:

la clase requerida.

has

boolean has(java.lang.String name)

Comprueba si esta registrada una clase.

Returns:

true si la clase "name" esta registrada, false si no.

has

boolean has(java.lang.String namespace,
            java.lang.String name)

Comprueba si esta registrada una clase.

Returns:

true si la clase "name" esta registrada, false si no.

getCount

int getCount()

Return the count of registered DynClass.

Returns:

count of DynClass

iterator

java.util.Iterator iterator()

Return an iterator over all registered DynClass.

Returns:

the iterator.

iterator

java.util.Iterator iterator(java.lang.String namespace)

Return an iterator over all registered DynClass with the same namespace.

Returns:

the iterator.

getNames

java.util.List getNames()

Return the list of names of all registered DynClass.

Returns:

list of DynClass names.

createDynObject

DynObject createDynObject(DynStruct dynStruct)

Create a new DynObject associated to the DynStruct or DynClass passed as parameter.

Parameters:

dynStruct - or dynClass to use for create the dynObject

Returns:

the new DynObject

createDynObject

DynObject createDynObject(java.lang.String classname)

Crea un nuevo objeto asociandole como clase base la indicada que tiene el nombre indicado.

Parameters:

dynClassName -

Returns:

el nuevo DynObject

createDynObject

DynObject createDynObject(java.lang.String namespace,
                          java.lang.String classname)

Crea un nuevo objeto asociandole como clase base la indicada que tiene el nombre indicado.

Parameters:

dynClassName -

Returns:

el nuevo DynObject

consolide

void consolide()

Actualiza todas las DynClasses registradas para reflejar la herencia de forma adecuada.

registerDynMethod

int registerDynMethod(DynClass dynClass,
                      DynMethod dynMethod)

Register the method in the dynClass.

Parameters:

dynClass - class over the method is registred

dynMethod - method to registry

Returns:

unique code of method

registerDynMethod

int registerDynMethod(java.lang.Class theClass,
                      DynMethod dynMethod)

Register the method in the class.

Parameters:

theClass - class over the method is registred

dynMethod - method to registry

Returns:

unique code of method

registerDynMethod

int registerDynMethod(DynMethod dynMethod)

Register an anonimous method.

Parameters:

dynMethod - method to registry

Returns:

unique code of method

getDynMethod

DynMethod getDynMethod(DynObject dynObject,
                       int code)
                throws DynMethodException

Obtain the method for the indicated code of the dynObject.

Parameters:

dynObject -

code - code of the requeted method

Returns:

the required DynMethod

Throws:

DynMethodException

getDynMethod

DynMethod getDynMethod(DynClass dynClass,
                       int code)
                throws DynMethodException

Throws:

DynMethodException

getDynMethod

DynMethod getDynMethod(java.lang.Object obj,
                       int code)
                throws DynMethodException

Throws:

DynMethodException

getDynMethod

DynMethod getDynMethod(java.lang.Class theClass,
                       int code)
                throws DynMethodException

Throws:

DynMethodException

getDynMethod

DynMethod getDynMethod(int code)
                throws DynMethodException

Throws:

DynMethodException

getDynMethod

DynMethod getDynMethod(java.lang.String methodName)
                throws DynMethodException

Retrieve an anonimous method registered in the manager.

Parameters:

methodName - name of the requeted method

Returns:

the required DynMethod

Throws:

DynMethodException

invokeDynMethod

java.lang.Object invokeDynMethod(java.lang.Object self,
                                 int code,
                                 DynObject context)
                          throws DynMethodException

Invoke the method of the indicated code for the object self, with parameters in context.

Parameters:

self - object over the method is invoked

code - code for the method to invoke

context - paramters of method

Returns:

return value for the method

Throws:

DynMethodException

validate

void validate(DynObject object)
       throws DynObjectValidateException

Throws:

DynObjectValidateException

getDefaultClassOfType

java.lang.Class getDefaultClassOfType(int type)

Deprecated. use DataTypesManager.getDefaultClass

createDynObjectPagingHelper

DynObjectPagingHelper createDynObjectPagingHelper(DynObjectSet set)
                                           throws BaseException

Creates a new DynObjectPagingHelper to page the data of a DynObjectSet.

Parameters:

set - to page the data of

Returns:

a DynObjectPagingHelper

Throws:

BaseException - if there is an error creating the paging helper, usually because of an error getting the data of the DynObjectSet

createDynObjectPagingHelper

DynObjectPagingHelper createDynObjectPagingHelper(DynObjectSet set,
                                                  int pageSize)
                                           throws BaseException

Creates a new DynObjectPagingHelper to page the data of a DynObjectSet.

Parameters:

set - to page the data of

pageSize - the size of the page to load using the helper

Returns:

a DynObjectPagingHelper

Throws:

BaseException - if there is an error creating the paging helper, usually because of an error getting the data of the DynObjectSet

createDynClassName

DynClassName createDynClassName(java.lang.String namespace,
                                java.lang.String name)

Creates a DynClassName with a DynClass name and its namespace.

Parameters:

namespace - where the DynClass belongs to

name - of the DynClass

Returns:

a new DynClassName

createDynClassName

DynClassName createDynClassName(java.lang.String name)

Creates a DynClassName with a DynClass name or fullname

Parameters:

name - of the DynClass. It might be a simple name or a composed full name (namespace and name)

Returns:

a new DynClassName

getAttributeValue

java.lang.Object getAttributeValue(java.lang.Object obj,
                                   java.lang.String name)

setAttributeValue

void setAttributeValue(java.lang.Object obj,
                       java.lang.String name,
                       java.lang.Object value)

copy

void copy(DynObject source,
          DynObject target)

equals

boolean equals(DynObject obj1,
               DynObject obj2)

hashCode

int hashCode(DynObject obj)

clear

void clear(DynObject obj)

createDynField

DynField createDynField(java.lang.String name)

registerTag

DynField registerTag(java.lang.String name,
                     java.lang.String description)

registerTag

DynField registerTag(java.lang.String name,
                     java.lang.String description,
                     java.lang.String[] values)

registerTag

DynField registerTag(java.lang.String name,
                     java.lang.String description,
                     DynMethod valuesMethod)

getTags

UnmodifiableBasicMap<java.lang.String,DynField> getTags()