Descripción

Ejecuta métodos estáticos de clases Java que acepten como parámetros y devuelvan principalmente tipos primitivos.

Las clases accesibles inicialmente son: java.lang.StrictMath, java.lang.Math, java.lang.Byte, java.lang.Short, java.lang.Integer, java.lang.Long, java.lang.Float, java.lang.Double, java.lang.Boolean, java.lang.Character, y jme.JMEMath

El uso de esta función requiere de algún conocimiento previo de Java.

Esta función puede sufrir modificaciones en futuras versiones

Para desarrolladores

■ Las clases permitidas se encuentran dentro de un conjunto accesible mediante el método jme.funciones.Java#getClassSet.
Se pueden añadir o eliminar clases accesibles modificando este conjunto, pero se debe tener precaución en que clases y métodos son accesibles por el usuario, por ejemplo:
    JME → java('java.lang.System.exit(i)',-1) (el usuario provocaría la finalización de la aplicación desde JME sin ninguna forma de control como la salvaguarda de datos)
    JME → java('MiPaquete.MiClase.borrarDatosServidor') (el usuario borraría los datos del servidor suponiendo que hubiera un método así en la aplicación)

Ejemplo de llamada:

jme.funciones.Java.getClassSet().add( String.class );

■ También pueden añadirse métodos estáticos accesibles sin incluir toda la clase mediante el método jme.funciones.Java#getMethodSet.

Ejemplo:

static class Test
{
	// Método a llamar desde JME dentro de una clase estática
	/**
	* Devuelve la longitud de las cadenas en un array
	*/
	static int[] longitudes( String[] array )
	{
		int[] r = new int[ array.length ];
		for ( int i = 0; i < array.length; i++ )
			r[i] = array[i].length();
		return r;
	}
}

// autorizar método
try
{
  	jme.funciones.Java.getMethodSet().add( ejemplos.Ejemplos.Test.class.getDeclaredMethod( "longitudes", new Class<?>[] { String[].class } ) );
}
catch ( NoSuchMethodException e ) { /*...*/ }

La llamada se puede simplificar usando funciones definidas por el usuario:

Expresion.nuevaFuncion( "longitudes(cadenas):=java('ejemplos.Ejemplos$Test.longitudes(S)',cadenas)" );

■ El método estático jme.funciones.Java#setSeguro permite utilizar los métodos estáticos de cualquier clase independientemente del conjunto de clases y métodos estableciendo el valor de true (por defecto) a false.

Ejemplo de llamada:

jme.funciones.Java.setSeguro(false);

■ Los métodos llamados deben incluir el nombre completo (paquetes/subpaquetes/clases externas/...) excepto una clase por defecto que inicialmente es la clase StrictMath. Solo es necesario usar el nombre del método en la llamada:

El método estático jme.funciones.Java#setDefaultClass permite modificar la clase por defecto.

Ejemplo de llamada:

jme.funciones.Java.setDefaultClass( Math.class );

Cadena de entrada

java

Cadena de salida

JAVA

Uso

java(<declaración>[,<param>]*)

Valor devuelto

• Si el método devuelve un terminal JME, el valor devuelto será ese objeto terminal.
• Si el método devuelve 'double','float','byte' o 'short', el valor devuelto será RealDoble.
• Si el método devuelve 'long' o 'BigInteger', el valor devuelto será EnteroGrande.
• Si el método devuelve 'BigDecimal', el valor devuelto será RealGrande.
• Si el método devuelve 'boolean', el valor devuelto será Booleano.
• Si el método devuelve 'char','String' o un objeto genérico, el valor devuelto será String.
• Si el método devuelve 'void' o null, el valor devuelto es el conjunto vacio [].
• Si el método devuelve un array, el valor devuelto es un VectorEvaluado con las anteriores conversiones.
• Si el método devuelve un mapa, el valor devuelto es un Diccionario con las anteriores conversiones.

Ejemplos

public static BigInteger lcm( BigInteger... nums )

public static double mod( double... vx )

/* ... */
jme.funciones.Java.getClassSet().add( MiClase.class );
/* ... */

// intercambiar parte real e imaginaria
static Complejo swapComplejo( Complejo z )
{
    return new Complejo( z.im(), z.re() );
}

Desde / Última modificación

v0.4.3

v0.4.6

Véase también…

jconst