frameworks/base/include/android_runtime/AndroidRuntime.h

   1 /*
   2  * Copyright (C) 2005 The Android Open Source Project
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *      http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 //
  18
  19 #ifndef _RUNTIME_ANDROID_RUNTIME_H
  20 #define _RUNTIME_ANDROID_RUNTIME_H
  21
  22 #include <utils/Errors.h>
  23 #include <binder/IBinder.h>
  24 #include <utils/String8.h>
  25 #include <utils/String16.h>
  26 #include <utils/Vector.h>
  27 #include <utils/threads.h>
  28 #include <pthread.h>
  29 #include <nativehelper/jni.h>
  30
  31
  32 namespace android {
  33
  34 class AndroidRuntime
  35 {
  36 public:
  37     AndroidRuntime();
  38     virtual ~AndroidRuntime();
  39
  40     /**
  41      * Register a set of methods in the specified class.
  42      */
  43     static int registerNativeMethods(JNIEnv* env,
  44         const char* className, const JNINativeMethod* gMethods, int numMethods);
  45
  46     /**
  47      * Call a static Java function that takes no arguments and returns void.
  48      */
  49     status_t callStatic(const char* className, const char* methodName);
  50
  51     /**
  52      * Call a class's static main method with the given arguments,
  53      */
  54     status_t callMain(const char* className, int argc, const char* const argv[]);
  55
  56     /**
  57      * Find a class, with the input either of the form
  58      * "package/class" or "package.class".
  59      */
  60     static jclass findClass(JNIEnv* env, const char* className);
  61
  62     int addVmArguments(int argc, const char* const argv[]);
  63
  64     void start(const char *classname, const bool startSystemServer);
  65     void start();       // start in android.util.RuntimeInit
  66
  67     static AndroidRuntime* getRuntime();
  68
  69     /**
  70      * This gets called after the JavaVM has initialized.  Override it
  71      * with the system's native entry point.
  72      */
  73     virtual void onStarted() = 0;
  74
  75     /**
  76      * This gets called after the JavaVM has initialized after a Zygote
  77      * fork. Override it to initialize threads, etc. Upon return, the
  78      * correct static main will be invoked.
  79      */
  80     virtual void onZygoteInit() {};
  81
  82
  83     /**
  84      * Called when the Java application exits.  The default
  85      * implementation calls exit(code).
  86      */
  87     virtual void onExit(int code);
  88
  89     /** create a new thread that is visible from Java */
  90     static android_thread_id_t createJavaThread(const char* name, void (*start)(void *),
  91         void* arg);
  92
  93     /** return a pointer to the VM running in this process */
  94     static JavaVM* getJavaVM() { return mJavaVM; }
  95
  96     /** return a pointer to the JNIEnv pointer for this thread */
  97     static JNIEnv* getJNIEnv();
  98
  99 private:
 100     static int startReg(JNIEnv* env);
 101     void parseExtraOpts(char* extraOptsBuf);
 102     int startVm(JavaVM** pJavaVM, JNIEnv** pEnv);
 103
 104     Vector<JavaVMOption> mOptions;
 105
 106     /* JNI JavaVM pointer */
 107     static JavaVM* mJavaVM;
 108
 109     /*
 110      * Thread creation helpers.
 111      */
 112     static int javaCreateThreadEtc(
 113                                 android_thread_func_t entryFunction,
 114                                 void* userData,
 115                                 const char* threadName,
 116                                 int32_t threadPriority,
 117                                 size_t threadStackSize,
 118                                 android_thread_id_t* threadId);
 119     static int javaThreadShell(void* args);
 120 };
 121
 122 // Returns the Unix file descriptor for a ParcelFileDescriptor object
 123 extern int getParcelFileDescriptorFD(JNIEnv* env, jobject object);
 124
 125 }
 126
 127 #endif