org.stjs.javascript.stjs

Class STJS

java.lang.Object

org.stjs.javascript.stjs.STJS

public final class STJS
extends Object

this is a wrapper around some of the stjs functions provided in the stjs.js javascript.

Author:

acraciun

Field Summary

Fields

Modifier and Type	Field and Description
Function2<Object,String,Object>	getFieldHandler this handler will be called any time a field annotated with the template "gsetter" is get.
Function3<Object,String,Object,Boolean>	setFieldHandler this handler will be called any time a field annotated with the template "gsetter" is set.

Constructor Summary

Constructors

Constructor and Description
STJS()

Method Summary

Methods

Modifier and Type	Method and Description
<T extends CallbackOrFunction> T	bind(Object object, CallbackOrFunction func) this functions is used to be able to atach lambdas to an object
<T extends CallbackOrFunction> T	bind(Object object, CallbackOrFunction func, int THISParamPosition) this functions is used to be able to atach lambdas to an object
<T extends CallbackOrFunction> T	bind(Object object, String methodName) this functions is used to be able to send method references as callbacks
Exception	exception(Object ex) throw an exception of any type in Javascript.
Map<String,Map<String,Map<String,Object>>>	getAnnotations(Class<?> clazz) return the annotations of the given type in the format:
Map<String,Object>	getMemberAnnotation(Class<?> clazz, String memberName, String annTypeName)
Map<String,Object>	getParameterAnnotation(Class<?> clazz, String methodName, int idx, String annTypeName)
Map<String,Object>	getTypeAnnotation(Class<?> clazz, String annTypeName)
boolean	isEnum(Object obj)
<T> T	parseJSON(String json, Class<T> clazz) parse the given json String and build the object hierarchy in a typed-manner: i.e it builds the objects using their corresponding constructors.
<T> Map<String,? extends Object>	stringify(T obj, Class<T> cls) using the type description it converts the fields of the object in strings or other primitve types to be able to send the object via AJAX for example.You need to include stjs-ext.js
<T> Array<T>	typefy(Array<Object> obj, Class<T> cls) using the type description, it converts an array of POJOs (i.e arrived as JSON in your client) to an object of the given type, transforming recursively the fields.You need to include stjs-ext.js
<T> T	typefy(Map<String,? extends Object> obj, Class<T> cls) using the type description, it converts a POJO (i.e arrived as JSON in your client) to an object of the given type, transforming recursively the fields.
<T> T	typefy(T obj, Class<T> cls) using the type description, it converts a POJO (i.e arrived as JSON in your client) to an object of the given type, transforming recursively the fields.

Methods inherited from class java.lang.Object

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

Field Detail

setFieldHandler

public Function3<Object,String,Object,Boolean> setFieldHandler

this handler will be called any time a field annotated with the template "gsetter" is set. For a statement like this:
object.field = value;
The last parameter is true if the function should return the previous value, false/null to return the new value.
the call will be setFieldHandler-$invoke(object, field, value, value) For example for object.field++
the call will be setFieldHandler-$invoke(object, field, object.field+1, false)

getFieldHandler

public Function2<Object,String,Object> getFieldHandler

this handler will be called any time a field annotated with the template "gsetter" is get. For a statement like this:
object.field
the call will be getFieldHandler-$invoke(object, field)

Constructor Detail

STJS

public STJS()

Method Detail

isEnum

public boolean isEnum(Object obj)

Parameters:

obj -

Returns:

true if the given object is an STJS enum entry

exception

public Exception exception(Object ex)

throw an exception of any type in Javascript. Java allowes and Throwable derived classes to be thrown, but Javascript allows any other type.

Parameters:

ex -

parseJSON

public <T> T parseJSON(String json,
              Class<T> clazz)

parse the given json String and build the object hierarchy in a typed-manner: i.e it builds the objects using their corresponding constructors. If the intermediary classes don't have an empty constructor, it will be called with null values for all the parameters.

Parameters:

json -

clazz -

Returns:

typefy

public <T> T typefy(T obj,
           Class<T> cls)

using the type description, it converts a POJO (i.e arrived as JSON in your client) to an object of the given type, transforming recursively the fields. You need to include stjs-ext.js

Parameters:

obj -

cls -

Returns:

typefy

public <T> T typefy(Map<String,? extends Object> obj,
           Class<T> cls)

using the type description, it converts a POJO (i.e arrived as JSON in your client) to an object of the given type, transforming recursively the fields. You need to include stjs-ext.js

Parameters:

obj -

cls -

Returns:

typefy

public <T> Array<T> typefy(Array<Object> obj,
                  Class<T> cls)

using the type description, it converts an array of POJOs (i.e arrived as JSON in your client) to an object of the given type, transforming recursively the fields.You need to include stjs-ext.js

Parameters:

obj -

cls -

Returns:

stringify

public <T> Map<String,? extends Object> stringify(T obj,
                                         Class<T> cls)

using the type description it converts the fields of the object in strings or other primitve types to be able to send the object via AJAX for example.You need to include stjs-ext.js

Parameters:

obj -

cls -

Returns:

getAnnotations

public Map<String,Map<String,Map<String,Object>>> getAnnotations(Class<?> clazz)

return the annotations of the given type in the format:

  $annotations : {
 _: {....}
 field1: {...}
 method1: {...}
 method1$0:  {...}
 method1$1:  {...}...
 }
 

for each annotation list you have:

 {
 "annotationType1": {value:"v1", value2: "v2"},
 "annotationType2": {}
 }
 

Parameters:

clazz -

Returns:

getTypeAnnotation

public Map<String,Object> getTypeAnnotation(Class<?> clazz,
                                   String annTypeName)

getMemberAnnotation

public Map<String,Object> getMemberAnnotation(Class<?> clazz,
                                     String memberName,
                                     String annTypeName)

getParameterAnnotation

public Map<String,Object> getParameterAnnotation(Class<?> clazz,
                                        String methodName,
                                        int idx,
                                        String annTypeName)

bind

public <T extends CallbackOrFunction> T bind(Object object,
                                    String methodName)

this functions is used to be able to send method references as callbacks

bind

public <T extends CallbackOrFunction> T bind(Object object,
                                    CallbackOrFunction func)

this functions is used to be able to atach lambdas to an object

bind

public <T extends CallbackOrFunction> T bind(Object object,
                                    CallbackOrFunction func,
                                    int THISParamPosition)

this functions is used to be able to atach lambdas to an object