JavaContext.h++

Go to the documentation of this file.

/* ---------------------------------------------------------------------------
   commonc++ - A C++ Common Class Library
   Copyright (C) 2005-2009  Mark A Lindner

   This file is part of commonc++.

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public
   License as published by the Free Software Foundation; either
   version 2 of the License, or (at your option) any later version.

   This library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Library General Public License for more details.

   You should have received a copy of the GNU Library General Public
   License along with this library; if not, write to the Free
   Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
   ---------------------------------------------------------------------------
*/

#ifndef __ccxx_JavaContext_h
#define __ccxx_JavaContext_h

#include <commonc++/Common.h++>
#include <commonc++/Exception.h++>
#include <commonc++/String.h++>
#include <commonc++/JavaException.h++>

#include <jni.h>
#include <cstdarg>

namespace ccxx {

class JavaVirtualMachine; // fwd decl

struct JavaNativeMethod
{
  String signature;

  void *function;
};

class COMMONCPPJVM_API JavaContext
{
  friend class JavaVirtualMachine;

  public:

  JavaContext(JNIEnv *env);

  ~JavaContext();

  static String encodeType(const String &type);

  static bool parseSignature(const String &signature, String& method,
                             String& descriptor, bool &isStatic);

  jclass findClass(const String &name) throw(JavaException);

  jmethodID findMethod(jclass clazz, const String &signature)
    throw(JavaException);

  jobject createObject(jclass clazz, jmethodID constructor, ...)
    throw(JavaException);

  jobject createObjectVA(jclass clazz, jmethodID constructor, va_list args)
    throw(JavaException);

  void callVoidMethod(jobject object, jmethodID method, ...)
    throw(JavaException);

  jobject callObjectMethod(jobject object, jmethodID method, ...)
    throw(JavaException);

  String callStringMethod(jobject object, jmethodID method, ...)
    throw(JavaException);

  WString callWStringMethod(jobject object, jmethodID method, ...)
    throw(JavaException);

  jboolean callBooleanMethod(jobject object, jmethodID method, ...)
    throw(JavaException);

  jbyte callByteMethod(jobject object, jmethodID method, ...)
    throw(JavaException);

  jchar callCharMethod(jobject object, jmethodID method, ...)
    throw(JavaException);

  jshort callShortMethod(jobject object, jmethodID method, ...)
    throw(JavaException);

  jint callIntMethod(jobject object, jmethodID method, ...)
    throw(JavaException);

  jlong callLongMethod(jobject object, jmethodID method, ...)
    throw(JavaException);

  jfloat callFloatMethod(jobject object, jmethodID method, ...)
    throw(JavaException);

  jdouble callDoubleMethod(jobject object, jmethodID method, ...)
    throw(JavaException);

  void callNonvirtualVoidMethod(jobject object, jclass clazz,
                                jmethodID method, ...)
    throw(JavaException);

  jobject callNonvirtualObjectMethod(jobject object, jclass clazz,
                                     jmethodID method, ...)
    throw(JavaException);

  jboolean callNonvirtualBooleanMethod(jobject object, jclass clazz,
                                       jmethodID method, ...)
    throw(JavaException);

  jbyte callNonvirtualByteMethod(jobject object, jclass clazz,
                                 jmethodID method, ...)
    throw(JavaException);

  jchar callNonvirtualCharMethod(jobject object, jclass clazz,
                                 jmethodID method, ...)
    throw(JavaException);

  jshort callNonvirtualShortMethod(jobject object, jclass clazz,
                                   jmethodID method, ...)
    throw(JavaException);

  jint callNonvirtualIntMethod(jobject object, jclass clazz,
                               jmethodID method, ...)
    throw(JavaException);

  jlong callNonvirtualLongMethod(jobject object, jclass clazz,
                                 jmethodID method, ...)
    throw(JavaException);

  jfloat callNonvirtualFloatMethod(jobject object, jclass clazz,
                                   jmethodID method, ...)
    throw(JavaException);

  jdouble callNonvirtualDoubleMethod(jobject object, jclass clazz,
                                     jmethodID method, ...)
    throw(JavaException);

  void callStaticVoidMethod(jclass clazz, jmethodID method, ...)
    throw(JavaException);

  jobject callStaticObjectMethod(jclass clazz, jmethodID method, ...)
    throw(JavaException);

  String callStaticStringMethod(jclass clazz, jmethodID method, ...)
    throw(JavaException);

  WString callStaticWStringMethod(jclass clazz, jmethodID method, ...)
    throw(JavaException);

  jboolean callStaticBooleanMethod(jclass clazz, jmethodID method, ...)
    throw(JavaException);

  jbyte callStaticByteMethod(jclass clazz, jmethodID method, ...)
    throw(JavaException);

  jchar callStaticCharMethod(jclass clazz, jmethodID method, ...)
    throw(JavaException);

  jshort callStaticShortMethod(jclass clazz, jmethodID method, ...)
    throw(JavaException);

  jint callStaticIntMethod(jclass clazz, jmethodID method, ...)
    throw(JavaException);

  jlong callStaticLongMethod(jclass clazz, jmethodID method, ...)
    throw(JavaException);

  jfloat callStaticFloatMethod(jclass clazz, jmethodID method, ...)
    throw(JavaException);

  jdouble callStaticDoubleMethod(jclass clazz, jmethodID method, ...)
    throw(JavaException);

  bool checkException(bool verbose = false);

  void clearException() throw();

  jthrowable getException() throw();

  bool throwException(jclass exception, const String &message);

  jfieldID findField(jclass clazz, const String &signature)
    throw(JavaException);

  jobject getObjectField(jobject object, jfieldID field) throw(JavaException);

  jboolean getBooleanField(jobject object, jfieldID field)
    throw(JavaException);

  jbyte getByteField(jobject object, jfieldID field) throw(JavaException);

  jchar getCharField(jobject object, jfieldID field) throw(JavaException);

  jshort getShortField(jobject object, jfieldID field) throw(JavaException);

  jint getIntField(jobject object, jfieldID field) throw(JavaException);

  jlong getLongField(jobject object, jfieldID field) throw(JavaException);

  jfloat getFloatField(jobject object, jfieldID field) throw(JavaException);

  jdouble getDoubleField(jobject object, jfieldID field) throw(JavaException);

  String getStringField(jobject object, jfieldID field) throw(JavaException);

  WString getWStringField(jobject object, jfieldID field) throw(JavaException);

  jobject getStaticObjectField(jclass clazz, jfieldID field)
    throw(JavaException);

  jboolean getStaticBooleanField(jclass clazz, jfieldID field)
    throw(JavaException);

  jbyte getStaticByteField(jclass clazz, jfieldID field) throw(JavaException);

  jchar getStaticCharField(jclass clazz, jfieldID field) throw(JavaException);

  jshort getStaticShortField(jclass clazz, jfieldID field)
    throw(JavaException);

  jint getStaticIntField(jclass clazz, jfieldID field) throw(JavaException);

  jlong getStaticLongField(jclass clazz, jfieldID field) throw(JavaException);

  jfloat getStaticFloatField(jclass clazz, jfieldID field)
    throw(JavaException);

  jdouble getStaticDoubleField(jclass clazz, jfieldID field)
    throw(JavaException);

  String getStaticStringField(jclass clazz, jfieldID field)
    throw(JavaException);

  WString getStaticWStringField(jclass clazz, jfieldID field)
    throw(JavaException);

  void setObjectField(jobject object, jfieldID field, jobject value)
    throw(JavaException);

  void setBooleanField(jobject object, jfieldID field, jboolean value)
    throw(JavaException);

  void setByteField(jobject object, jfieldID field, jbyte value)
    throw(JavaException);

  void setCharField(jobject object, jfieldID field, jchar value)
    throw(JavaException);

  void setShortField(jobject object, jfieldID field, jshort value)
    throw(JavaException);

  void setIntField(jobject object, jfieldID field, jint value)
    throw(JavaException);

  void setLongField(jobject object, jfieldID field, jlong value)
    throw(JavaException);

  void setFloatField(jobject object, jfieldID field, jfloat value)
    throw(JavaException);

  void setDoubleField(jobject object, jfieldID field, jdouble value)
    throw(JavaException);

  void setStringField(jobject object, jfieldID field, const String &value)
    throw(JavaException);

  void setWStringField(jobject object, jfieldID field, const WString &value)
    throw(JavaException);

  void setStaticObjectField(jclass clazz, jfieldID field, jobject value)
    throw(JavaException);

  void setStaticBooleanField(jclass clazz, jfieldID field, jboolean value)
    throw(JavaException);

  void setStaticByteField(jclass clazz, jfieldID field, jbyte value)
    throw(JavaException);

  void setStaticCharField(jclass clazz, jfieldID field, jchar value)
    throw(JavaException);

  void setStaticShortField(jclass clazz, jfieldID field, jshort value)
    throw(JavaException);

  void setStaticIntField(jclass clazz, jfieldID field, jint value)
    throw(JavaException);

  void setStaticLongField(jclass clazz, jfieldID field, jlong value)
    throw(JavaException);

  void setStaticFloatField(jclass clazz, jfieldID field, jfloat value)
    throw(JavaException);

  void setStaticDoubleField(jclass clazz, jfieldID field, jdouble value)
    throw(JavaException);

  jbyteArray createByteArray(uint_t length)
    throw(JavaException);

  void setObjectArrayElement(jobjectArray array, uint_t index, jobject value)
    throw(JavaException);

  jobject getObjectArrayElement(jobjectArray array, uint_t index)
    throw(JavaException);

  uint_t getArrayLength(jarray array) throw(JavaException);

  jobject createDirectByteBuffer(byte_t *buf, size_t size)
    throw(JavaException);

  void *getDirectBufferRegion(jobject buf, uint64_t &size);

  jobject createLocalRef(jobject object) throw(JavaException);

  void deleteLocalRef(jobject ref);

  void ensureLocalCapacity(size_t capacity) throw(JavaException);

  jobject createGlobalRef(jobject object) throw(JavaException);

  void deleteGlobalRef(jobject ref);

  String decodeString(jstring str) throw(JavaException);

  WString decodeWString(jstring str) throw(JavaException);

  jstring encodeString(const String &str) throw(JavaException);

  jstring encodeWString(const WString &str) throw(JavaException);

  size_t getStringLength(jstring str);

  void *getArrayData(jarray array, size_t &length, bool *isCopy = NULL)
    throw(JavaException);

  void releaseArrayData(jarray array, void *data);

  jbyteArray createByteArray(const byte_t *data, size_t length)
    throw(JavaException);

  jarray createObjectArray(jclass type, size_t length,
                           jobject initialValue = NULL)
    throw(JavaException);

  bool isSameObject(jobject object1, jobject object2);

  bool isInstanceOf(jobject object, jclass clazz);

  bool isAssignableFrom(jclass clazz1, jclass clazz2);

  jclass getClassForObject(jobject object);

  jclass getSuperclass(jclass clazz);

  void enterMonitor(jobject object) throw(JavaException);

  void exitMonitor(jobject object) throw(JavaException);

  void registerNativeMethods(jclass clazz, const JavaNativeMethod methods[])
    throw(JavaException);

  void unregisterNativeMethods(jclass clazz);

  void pushLocalFrame(uint_t capacity = 8) throw(JavaException);

  void popLocalFrame();

  inline bool isVerbose() const throw()
  { return(_verbose); }

  private:

  void setVerbose(bool verbose) throw()
  { _verbose = verbose; }

  void setJVM(JavaVirtualMachine *jvm) throw()
  { _jvm = jvm; }

  JNIEnv *_env;
  JavaVirtualMachine *_jvm;
  bool _verbose;
};

}; // namespace ccxx

#endif // __ccxx_JavaContext_hxx

/* end of header file */