3.2 Mapping de IDL a Java

Transcripción

1 3.2 Mapping de IDL a Java

2 Tipos predefinidos (1) Tipo IDL short long long long unsigned short unsigned long unsigned long long float double long double Tipo Java short int long short int long float double De momento, no está soportado El rango de los tipos enteros IDL sin signo es mayor que el de los tipos Java (los enteros sin signo grandes llegan como negativos)

3 Tipos predefinidos (y 2) Tipo IDL char wchar string wstring octet boolean any Tipo Java char char java.lang.string java.lang.string byte boolean (las constantes IDL TRUE y FALSE se mapean a true y false) org.omg.corba.any (abstracta) Se producen excepciones si se violan los rangos de los caracteres o el tamaño de las cadenas de caracteres acotadas

4 typedef En Java no existe una construcción similar a typedef Se usa el tipo original

5 Enumeraciones // IDL enum Color {red, green, blue, yellow, white // Java public class Color implements org.omg.corba.portable.idlentity { public static final int _red = 0; public static final Color red = new Color(_red); public static final int _green = 1; public static final Color green = new Color(_green); //... public int value() {... } public static Color from_int(int value) {... } protected Color(int value) {... } } Dado que cada valor es un singleton, la igualdad entre valores se puede comprobar con equals().

6 Estructuras // IDL struct Date { short year; short month; // 1-12 short day; // 1-31 // Java final public class Date implements org.omg.corba.portable.idlentity { public short year; public short month; public short day; } public Date() {} public Date(short year, short month, short day) {... }

7 Union (1) // IDL union Token switch(color) { case blue: float floatvalue; case red: case green: long longvalue; default: string stringvalue; // Java final public class Token implements org.omg.corba.portable.idlentity { public Token() {... } public Color discriminator() {... }

8 Union (y 2) public float floatvalue() {... } public void floatvalue(float value) {... } public long longvalue() {... } public void longvalue(long value) {... } public void longvalue(color discriminator, long value) {... } public String stringvalue() {... } public void stringvalue(string value) {... } public void stringvalue(color discriminator, String value) {... } } // class

9 Vectores y secuencias (1) Los vectores y secuencias (acotadas y no acotadas) se mapean a vectores Java Se produce una excepción si se violan longitudes (vectores y secuencias acotadas) // IDL typedef Date DateVector[10]; typedef string StringMatrix[10][20]; typedef sequence<color> Colors; typedef sequence<date, 10> Dates10; struct Example { DateVector fdatevector; StringMatrix fstringmatrix; Colors fcolors; Dates10 fdates10;

10 Vectores y secuencias (y 2) // Java final public class Example implements org.omg.corba.portable.idlentity { public Date[] fdatevector; public String[][] fstringmatrix; public Color[] fcolors; public Date[] fdates10; public Example() {} public Example(Date[] fdatevector, String[] fstringmatrix, Color[] fcolors, Date[] fdates10) {... }

11 Módulos Se mapean a paquetes Los tipos definidos dentro del módulo que mapean a clases/interfaces, pertenecerán al correspondiente paquete // IDL module es { module udc { module fbellas { module corba { module clock { module idl { struct TimeOfDay {... // Java package es.udc.fbellas.corba.clock.idl; final public class TimeOfDay implements org.omg.corba.portable.idlentity {... }

12 Interfaces (1) // IDL interface Clock { TimeOfDay gettimeofday(); // Java public interface ClockOperations { TimeOfDay gettimeofday(); } // Este tipo lo utiliza el servidor para implementar // el interfaz public interface Clock extends ClockOperations, org.omg.corba.object, org.omg.corba.portable.idlentity { } // Este tipo lo utiliza el cliente

13 Interfaces (2) También se generan las clases ClockPOA y ClockPOATie Las utiliza el servidor para implementar el interfaz mediante herencia de implementación (ClockPOA) o delegación (ClockPOATie) Se estudian más adelante Object (IDL) se mapea a org.omg.corba.object (Java) nil (IDL) se mapea a null null sólo se puede usar en valores de retorno y parámetros para representar una referencia a objeto remoto o tipo valor (value type) nulos Cada atributo se mapea a dos operaciones con el mismo nombre (una para leer y otra para modificar), excepto si es de tipo readonly (sólo dispone de operación para leer)

14 Interfaces (3) Herencia // IDL interface Thermostat : Thermometer {... // Java public interface ThermometerOperations {... } public interface Thermometer extends ThermometerOperations, org.omg.corba.object, org.omg.corba.portable.idlentity {} public interface ThermostatOperations extends ThermometerOperations {... } public interface Thermostat extends ThermostatOperations, Thermometer, org.omg.corba.portable.idlentity {}

15 Interfaces (y 4) Tipos anidados dentro de interfaces Java no permite anidar clases dentro de interfaces Los tipos IDL (definidos dentro de una interfaz) que mapean a clases se generan en un paquetes especial // IDL module Example { interface Clock { struct TimeOfDay {... TimeOfDay gettimeofday(); // Java package Example.ClockPackage; final public class TimeOfDay implements org.omg.corba.portable.idlentity {... }

16 Constantes (1) Constantes definidas dentro de un interfaz // IDL module Example { interface MyInterface { const float PI = ; // Java package Example; public MyInterfaceOperations {} public interface MyInterface extends MyInterfaceOperations, } org.omg.corba.object, org.omg.corba.portable.idlentity { float PI = ;

17 Constantes (y 2) Constantes definidas fuera de un interfaz // IDL module Example { const float PI = ; // Java package Example; public interface PI { } float value = ;

18 Excepciones (1) Throwable Error Exception RuntimeException org.omg.corba UserException SystemException Excepciones definidas por el usuario en IDL COMM_FAILURE, OBJ_ADAPTER, etc.

19 Excepciones (y 2) Mapping de excepciones definidas por el usuario // IDL typedef short Temperature; exception InvalidTemperature { Temperature selectedtemperature; Temperature minimumpermitedtemperature; Temperature maximumpermitedtemperature; // Java final public class InvalidTemperature extends org.omg.corba.userexception { // Mapping similar al de un struct.

20 Clases Holder (1) Problema: mapear parámetros out e inout a Java // IDL interface Account { void add(in float amount, out float newbalance); //... Paso de parámetros en Java Tipos básicos: por valor Objetos: por referencia Siendo más preciso: todos los parámetros se pasan por valor (cuando se pasan objetos, se pasan referencias por valor) La semántica de paso de parámetros vía out e inout se simula con las clases Holder

21 Clases Holder (2) Mapping a Java public interface AccountOperations { } void add(float amount, //... org.omg.corba.floatholder newbalance); El ORB proporciona clases Holder para los tipos predefinidos package org.omg.corba; final public class FloatHolder } implements org.omg.corba.portable.streamable { public float value; public FloatHolder() {} public FloatHolder(float value) {... } // Otros métodos...

22 Clases Holder (3) Implementación de la operación class AccountImpl extends AccountPOA { private float balance; public void add(float amount, FloatHolder newbalance) { balance = balance + amount; } newbalance.value = balance; //... } Invocación de la operación FloatHolder newbalance = new newbalance(); account.add(10, newbalance); System.out.println(newBalance.value);

23 Clases Holder (4) Para los tipos definidos por el usuario, el compilador de IDL genera clases Holder Mismo nombre que el tipo Java pero con sufijo Holder // IDL struct TimeOfDay { short hour; // 0-23 short minute; // 0-59 short second; // 0-59 interface Clock { void gettimeofday(out TimeOfDay time); Para los tipos definidos con typedef, sólo se generan clases Holder cuando se trata de vectores o secuencias

24 Clases Holder (5) El compilador de IDL genera la clase TimeOfDayHolder final public class TimeOfDayHolder implements org.omg.corba.portable.streamable { public TimeOfDay value; public TimeOfDayHolder() {} public TimeOfDayHolder(TimeOfDay value) {... } // Otros métodos... } Implementación de la operación class ClockImpl extends ClockPOA { public void gettimeofday(timeofdayholder time) { << Obtener hour, minute y second >> TimeOfDay timeofday = new TimeOfDay(hour, minute, second); time.value = timeofday; } //... }

25 Clases Holder (y 6) Invocación de la operación TimeOfDayHolder timeofdayholder = new TimeOfDayHolder(); clock.gettimeofday(timeofdayholder); TimeOfDay timeofday = timeofdayholder.value; Parámetros inout Idem parámetros out, excepto: El llamador debe pasar un valor en el parámetro (excepto que sirva el del constructor por defecto) El llamado puede consultar el valor (value) del Holder, cambiarlo o establecer uno nuevo (holder.value = new... )

26 Concepto Clases Helper (1) Para cada tipo definido por el usuario (inclusive los definidos con typedef) se genera una clase Helper (mismo nombre que el tipo Java pero con sufijo Helper) Permiten hacer downcasting de interfaces remotos Permiten insertar y extraer valores en un Any Ejemplo abstract public class ClockHelper { public static void insert(org.omg.corba.any a, Clock t) {... } public static Clock extract(org.omg.corba.any) {... } public static org.omg.corba.typecode type() {... } } // narrow sólo se genera para Helpers cuyo tipo es un // interfaz remoto public static Clock narrow( org.omg.corba.object obj) {... }

27 Clases Helper (2) El downcasting es un casting de un tipo base (no necesariamente org.omg.corba.object) a un tipo derivado // En el ejemplo Clock... org.omg.corba.object clockobject = orb.string_to_object(stringifiedreference); if (clockobject == null) { } throw new Exception("stringified reference is nil"); Clock clock = ClockHelper.narrow(clockObject); El objeto tiene que ser del tipo derivado (en otro caso se produce una excepción del sistema CORBA) En el ejemplo anterior no sería válido hacer... Clock clock = (Clock)clockObject;... porque puede ser necesario contactar con el servidor (ej.: servidor configurado con arranque automático)

28 Clases Helper (y 3) Inserción y extracción de valores en un Any Inserción RouterEvent routerevent =... org.omg.corba.any event = orb.create_any(); // método factoría RouterEventHelper.insert(any, routerevent); manager.sendevent(event); Extracción public void sendevent(org.omg.corba.any event) { RouterEvent routerevent = RouterEventHelper.extract(event); //... } Si el receptor no sabe cuál es el tipo contenido en el Any, puede utilizar org.omg.corba.any.type() Any proporciona operaciones de inserción y extracción para los tipos predefinidos (insert_float, extract_float, etc.)

29 Paquete org.omg Todos los pseudo-interfaces del ORB y los interfaces de los servicios estándares CORBA pertenecen a subpaquetes de org.omg (ej.: org.omg.corba, org.omg.cosnaming, etc.)