xmog_jboolean Class Reference

A wrapper type for boolean proxies. More...

#include <xmog_java_field.h>

Inheritance diagram for xmog_jboolean:

[legend]Collaboration diagram for xmog_jboolean:

[legend]List of all members.

Public Member Functions
jboolean	get (xmog_localenv *env=NULL, bool readThrough=false) const
	Returns the value of a bool proxy instance.
jboolean	operator * () const
	The dereference operator converts to the jboolean type.
	operator jboolean () const
	A conversion operator to the JNI jboolean type.
xmog_jboolean &	operator= (jboolean)
	An assignment operator from the JNI jboolean type.
void	set (jboolean b, xmog_localenv *env=NULL, bool writeThrough=false)
	Sets the value of a bool proxy.
	xmog_jboolean (xmog_java_ref *_clazz_ref_array, xmog_java_dynamic *_dynamic, xmog_flags _flags=0)
	Creates an instance that acts as a proxy for an indirect element of boolean type.
	xmog_jboolean (xmog_java_array *_ref, jint _index)
	Creates an instance that acts as a proxy for an element of a boolean array.

---

Detailed Description

A wrapper type for boolean proxies.

This type wraps the Java boolean type in a proxy type that uses the JNI type jboolean to represent the Java type. Conversion operators allow convenient usage while the get/set methods take an optional xmog_localenv argument for better performance (by saving at least a threadlocal memory access). The set(jboolean,xmog_localenv*,bool) method also takes an optional bool argument that governs whether the change should be written through to the Java side unconditionally, ignoring a possibly set CACHE_LAZY_WRITE flag.

Primitive proxy types only exist in two flavors: as array elements and as fields (static and instance). There are two contructors to support those two flavors.

---

Constructor & Destructor Documentation

xmog_jboolean::xmog_jboolean (  xmog_java_array *  _ref, jint  _index )

Creates an instance that acts as a proxy for an element of a boolean array. Parameters: _ref  a pointer to an array proxy element. _index  the index of the element.

xmog_jboolean::xmog_jboolean (  xmog_java_ref *  _clazz_ref_array, xmog_java_dynamic *  _dynamic, xmog_flags  _flags = 0 )

Creates an instance that acts as a proxy for an indirect element of boolean type. Parameters: _clazz_ref_array  a pointer to the owner of the primitive value. _dynamic  the algorithm to access the value. _flags  additional processing arguments.

---

Member Function Documentation

jboolean xmog_jboolean::get (  xmog_localenv *  env = NULL, bool  readThrough = false )  const

Returns the value of a bool proxy instance. This method takes two optional arguments that can be used to improve overall performance or force a read from the Java side even if a cached value is available. Parameters: env  a local environment pointer. May be NULL. readThrough  true if the value should be read from the Java side unconditionally, false if a cached value should be used if available. This flag is ignored if the instance does not use caching or if it does not yet have a cached value.

jboolean xmog_jboolean::operator * (   )  const

The dereference operator converts to the jboolean type. This operator is declared to support array iterators.

xmog_jboolean::operator jboolean (   )  const

A conversion operator to the JNI jboolean type. This operator allows the use of proxy instances of this type in any place where the compiler expects a primitive jboolean rhs-value. You can achieve better performance by using the get(xmog_localenv*,bool) method with the proper arguments.

xmog_jboolean& xmog_jboolean::operator= (  jboolean   )

An assignment operator from the JNI jboolean type. This operator allows the use of proxy instances of this type in any place where the compiler expects a primitive jboolean lhs-value. You can achieve better performance by using the set(jboolean,xmog_localenv*,bool) method with the proper arguments.

void xmog_jboolean::set (  jboolean  b, xmog_localenv *  env = NULL, bool  writeThrough = false )

Sets the value of a bool proxy. This method takes two optional arguments that can be used to improve overall performance or force a write to the Java side even if the CACHE_LAZY_WRITE policy is in effect for this instance. Parameters: b  the new value. env  a local environment pointer. May be NULL. writeThrough  true if the value should be written to the Java side unconditionally, false if only the cached value should be updated. This flag is ignored if the instance does not use caching.

---

The documentation for this class was generated from the following file:

• xmog_java_field.h

---