org.mases.jcobridge

Class JCType

java.lang.Object

org.mases.jcobridge.JCHandler

org.mases.jcobridge.JCType

public final class JCType
extends JCHandler

JVM-side handle for a CLR System.Type.

JCType wraps a native reference to a CLR type and exposes operations on that type: instantiation (NewObject(java.lang.Object...)), static method invocation (Invoke(java.lang.String, java.lang.Object...)), and static property/field access (Get(java.lang.String), GetField(java.lang.String), Set(java.lang.String, java.lang.Object), SetField(java.lang.String, java.lang.Object)). It mirrors the instance-level API of JCObject but targets the type itself rather than an object instance.

Return values follow the same mapping as JCObject: CLR primitives become Java primitives or String; all other CLR types are returned as JCObject.

Instances are obtained via JCOBridge.GetType(String) or JCAssembly.GetType(String) and must not be constructed directly.

See also: JCOReflector for usage examples.

Since:

1.0.0.0

Author:

MASES S.R.L.

Method Summary

Modifier and Type	Method and Description
Object	Get(String propertyName) Retrieves a static property value from the CLR type represented by this handle.
Object	GetField(String field) Retrieves a static field value from the CLR type represented by this handle.
Object	GetOnType(String propertyName) Retrieves a property from the CLR type using type-level dispatch.
int	hashCode() Returns the hash code of the underlying CLR type by delegating to the CLR GetHashCode method.
Object	Invoke(String method, Object... params) Invokes a static method on the CLR type represented by this handle.
Object	InvokeOnType(String method, Object... params) Invokes a method on the CLR type using type-level (non-static) dispatch.
Object	NewObject(Object... params) Creates a new instance of the CLR type represented by this handle, passing optional constructor arguments.
JCType	Set(String propertyName, Object value) Sets a static property on the CLR type represented by this handle.
JCType	SetField(String field, Object value) Sets a static field on the CLR type represented by this handle.
String	toString() Returns the string representation of the underlying CLR type by delegating to the CLR ToString method.

Methods inherited from class org.mases.jcobridge.JCHandler

getReference

Methods inherited from class java.lang.Object

equals, getClass, notify, notifyAll, wait, wait, wait

Method Detail

hashCode

public int hashCode()

Returns the hash code of the underlying CLR type by delegating to the CLR GetHashCode method.

Overrides:

hashCode in class Object

Returns:

the CLR hash code.

toString

public String toString()

Returns the string representation of the underlying CLR type by delegating to the CLR ToString method. Typically returns the fully qualified type name.

Overrides:

toString in class Object

Returns:

the CLR string representation.

NewObject

public Object NewObject(Object... params)
                 throws JCNativeException

Creates a new instance of the CLR type represented by this handle, passing optional constructor arguments.

Parameters:

params - optional constructor arguments.

Returns:

the new CLR object, as a Java primitive or JCObject.

Throws:

JCNativeException - if the constructor cannot be found or fails, or if a CLR exception is thrown.

Invoke

public Object Invoke(String method,
                     Object... params)
              throws JCNativeException

Invokes a static method on the CLR type represented by this handle.

Parameters:

method - the name of the CLR static method to invoke.

params - optional arguments to pass to the method.

Returns:

the method return value, as a Java primitive or JCObject.

Throws:

JCNativeException - if the method cannot be found, the invocation fails, or a CLR exception is thrown.

Get

public Object Get(String propertyName)
           throws JCNativeException

Retrieves a static property value from the CLR type represented by this handle.

Parameters:

propertyName - the name of the CLR static property to read.

Returns:

the property value, as a Java primitive or JCObject.

Throws:

JCNativeException - if the property cannot be found or the read fails.

GetField

public Object GetField(String field)
                throws JCNativeException

Retrieves a static field value from the CLR type represented by this handle.

Parameters:

field - the name of the CLR static field to read.

Returns:

the field value, as a Java primitive or JCObject.

Throws:

JCNativeException - if the field cannot be found or the read fails.

Set

public JCType Set(String propertyName,
                  Object value)
           throws JCNativeException

Sets a static property on the CLR type represented by this handle.

Parameters:

propertyName - the name of the CLR static property to write.

value - the value to assign.

Returns:

this JCType instance, for call chaining.

Throws:

JCNativeException - if the property cannot be found or the write fails.

SetField

public JCType SetField(String field,
                       Object value)
                throws JCNativeException

Sets a static field on the CLR type represented by this handle.

Parameters:

field - the name of the CLR static field to write.

value - the value to assign.

Returns:

this JCType instance, for call chaining.

Throws:

JCNativeException - if the field cannot be found or the write fails.

InvokeOnType

public Object InvokeOnType(String method,
                           Object... params)
                    throws JCNativeException

Invokes a method on the CLR type using type-level (non-static) dispatch. Equivalent to Invoke(String, Object...) but with onType = true to select the type-level overload resolution path.

Parameters:

method - the name of the CLR method to invoke on the type.

params - optional arguments to pass to the method.

Returns:

the method return value, as a Java primitive or JCObject.

Throws:

JCNativeException - if the method cannot be found, the invocation fails, or a CLR exception is thrown.

GetOnType

public Object GetOnType(String propertyName)
                 throws JCNativeException

Retrieves a property from the CLR type using type-level dispatch.

Parameters:

propertyName - the name of the CLR property to read from the type.

Returns:

the property value, as a Java primitive or JCObject.

Throws:

JCNativeException - if the property cannot be found or the read fails.