org.mases.jcobridge

Class JCNull

java.lang.Object

org.mases.jcobridge.JCNull

public final class JCNull
extends Object

Typed null placeholder for CLR reference type parameters.

When a CLR method or constructor expects a typed null argument (e.g. null for a parameter of type System.IO.Stream), passing a Java null directly is ambiguous — the bridge cannot determine the CLR type to use for overload resolution. JCNull solves this by carrying the CLR type information alongside the null value.

The CLR type can be provided either as a fully qualified name string (JCNull(String)) or as a pre-resolved JCType handle (JCNull(JCType)).

Example — calling a CLR method that accepts a nullable Stream:

 // null typed as System.IO.Stream
 jcObject.Invoke("MethodThatAcceptsStream", new JCNull("System.IO.Stream"));
 

Since:

1.0.0.0

Author:

MASES S.R.L.

Constructor Summary

Constructors

Constructor and Description
JCNull(JCType type) Constructs a typed null from a pre-resolved JCType handle.
JCNull(String typeName) Constructs a typed null for a CLR type identified by its fully qualified name.

Method Summary

Modifier and Type	Method and Description
JCType	getType() Returns the pre-resolved CLR type handle, or null if this instance was constructed with a type name string.
String	getTypeName() Returns the fully qualified CLR type name, or null if this instance was constructed with a JCType handle.

Methods inherited from class java.lang.Object

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

Constructor Detail

JCNull

public JCNull(String typeName)

Constructs a typed null for a CLR type identified by its fully qualified name.

Parameters:

typeName - the fully qualified CLR type name, e.g. "System.IO.Stream".

JCNull

public JCNull(JCType type)

Constructs a typed null from a pre-resolved JCType handle. Use this overload when the type has already been resolved via JCOBridge.GetType(String) to avoid redundant lookups.

Parameters:

type - the pre-resolved CLR type handle.

Method Detail

getTypeName

public String getTypeName()

Returns the fully qualified CLR type name, or null if this instance was constructed with a JCType handle.

Returns:

the CLR type name.

getType

public JCType getType()

Returns the pre-resolved CLR type handle, or null if this instance was constructed with a type name string.

Returns:

the JCType handle.