store()

La función de sistema JavaLib.store invoca un método y coloca el objeto devuelto (o nulo) en el espacio de objetos Java de EGL, junto con un identificador especificado. Si el identificador ya se encuentra en el espacio de objetos, la acción es equivalente a los siguientes pasos:

Si el método devuelve un primitivo Java en lugar de un objeto, EGL almacena un objeto que representa el primitivo; por ejemplo, si el método devuelve un int, EGL almacena un objeto de tipo java.lang.Integer.

La función JavaLib.store es una de las diversas funciones de acceso Java.

  JavaLib.store(
    idAlmacén javaObjId in,
    identificadorOClase javaObjId in,
    método STRING in
    {, argumento anyEglPrimitive in})
idAlmacén
El identificador que debe almacenarse con el objeto devuelto.

Este argumento es un literal de serie o una variable de tipo CHAR, DBCHAR, MBCHAR, STRING o UNICODE. El identificador debe haberse convertido temporalmente a objID, como en el ejemplo que figura más adelante. EGL elimina blancos de un solo byte y de doble byte del principio y el final del valor del argumento, que es sensible a mayúsculas y minúsculas.

identificadorOClase
Este argumento es una de las siguientes entidades:
  • Un identificador que hace referencia a un objeto del espacio de objetos; o
  • El nombre totalmente calificado de una clase Java.

Este argumento es un literal de serie o un elemento de tipo CHAR, DBCHAR, MBCHAR, STRING o UNICODE. Si especifica un identificador de un objeto, el identificador debe haberse convertido temporalmente a objID, como en el ejemplo que figura más adelante. EGL elimina blancos de un solo byte y de doble byte del principio y el final del valor del argumento, que es sensible a mayúsculas y minúsculas.

método
El método que debe invocarse.

Este argumento es un literal de serie o una variable de tipo CHAR, DBCHAR, MBCHAR, STRING o UNICODE. Si especifica un identificador de un objeto, el identificador debe haberse convertido temporalmente a objID, como en el ejemplo que figura más adelante. EGL elimina blancos de un solo byte y de doble byte del principio y el final del valor del argumento, que es sensible a mayúsculas y minúsculas.

argumento
Un valor pasado al método.

Puede ser necesaria una conversión temporal, como se especifica en el apartado Acceso Java (palabras del sistema).

Se aplican las normas de conversión de tipos Java. Por ejemplo, no se produce ningún error si se pasa un tipo short a un parámetro de método declarado como int.

Para evitar perder precisión, utilice un elemento float EGL para un double Java y un elemento smallfloat EGL para un float Java. Si utiliza otro de los tipos EGL, probablemente se redondeará un valor.

El área de memoria del programa invocante no cambia, independientemente de la acción realizada por el método.

A continuación se ofrece un ejemplo:
  JavaLib.store( (objId)"storeId", (objId)"myId", 
    "myMethod", 36 );

Un error producido durante el proceso de JavaLib.store puede establecer sysVar.errorCode en uno de los valores que figuran en la tabla siguiente.

Valor de sysVar.errorCode Descripción
00001000 Un método invocado ha lanzado una excepción o como resultado de una inicialización de clase.
00001001 El objeto era nulo o el identificador especificado no estaba en el espacio de objetos
00001002 No existe o no puede cargarse un método, campo o clase públicos con el nombre especificado
00001003 El tipo primitivo EGL no coincide con el tipo esperado en Java
00001006 No ha podido cargarse la clase de una conversión temporal de argumento a nulo
00001007 Se ha lanzado una excepción de tipo SecurityException o IllegalAccessException durante un intento de obtener información acerca de un método o campo; o se ha intentado establecer el valor de un campo declarado como final
00001009 Debe especificarse un identificador en lugar de un nombre de clase; el método o campo no es estático

Conceptos relacionados
Diagrama de sintaxis para funciones EGL

Consulta relacionada
Biblioteca JavaLib de EGL
getField()
invoke()
isNull()
isObjID()
qualifiedTypeName()
remove()
removeAll()
setField()
storeCopy()
storeField()
storeNew()

Condiciones de uso | Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.