AndroidRuntime.h revision d195e5ab401432ddac659791640a2927fc668699 
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
32namespace android {
33
34class CursorWindow;
35
36class AndroidRuntime
37{
38public:
39    AndroidRuntime();
40    virtual ~AndroidRuntime();
41
42    /**
43     * Register a set of methods in the specified class.
44     */
45    static int registerNativeMethods(JNIEnv* env,
46        const char* className, const JNINativeMethod* gMethods, int numMethods);
47
48    /**
49     * Call a class's static main method with the given arguments,
50     */
51    status_t callMain(const char* className, jclass clazz, int argc,
52        const char* const argv[]);
53
54    /**
55     * Find a class, with the input either of the form
56     * "package/class" or "package.class".
57     */
58    static jclass findClass(JNIEnv* env, const char* className);
59
60    int addVmArguments(int argc, const char* const argv[]);
61
62    void start(const char *classname, const bool startSystemServer);
63    void start();       // start in android.util.RuntimeInit
64
65    static AndroidRuntime* getRuntime();
66
67    /**
68     * This gets called after the VM has been created, but before we
69     * run any code. Override it to make any FindClass calls that need
70     * to use CLASSPATH.
71     */
72    virtual void onVmCreated(JNIEnv* env);
73
74    /**
75     * This gets called after the JavaVM has initialized.  Override it
76     * with the system's native entry point.
77     */
78    virtual void onStarted() = 0;
79
80    /**
81     * This gets called after the JavaVM has initialized after a Zygote
82     * fork. Override it to initialize threads, etc. Upon return, the
83     * correct static main will be invoked.
84     */
85    virtual void onZygoteInit() {};
86
87
88    /**
89     * Called when the Java application exits.  The default
90     * implementation calls exit(code).
91     */
92    virtual void onExit(int code);
93
94    /** create a new thread that is visible from Java */
95    static android_thread_id_t createJavaThread(const char* name, void (*start)(void *),
96        void* arg);
97
98    /** return a pointer to the VM running in this process */
99    static JavaVM* getJavaVM() { return mJavaVM; }
100
101    /** return a pointer to the JNIEnv pointer for this thread */
102    static JNIEnv* getJNIEnv();
103
104    /** return a new string corresponding to 'className' with all '.'s replaced by '/'s. */
105    static char* toSlashClassName(const char* className);
106
107private:
108    static int startReg(JNIEnv* env);
109    void parseExtraOpts(char* extraOptsBuf);
110    int startVm(JavaVM** pJavaVM, JNIEnv** pEnv);
111
112    Vector<JavaVMOption> mOptions;
113
114    /* JNI JavaVM pointer */
115    static JavaVM* mJavaVM;
116
117    /*
118     * Thread creation helpers.
119     */
120    static int javaCreateThreadEtc(
121                                android_thread_func_t entryFunction,
122                                void* userData,
123                                const char* threadName,
124                                int32_t threadPriority,
125                                size_t threadStackSize,
126                                android_thread_id_t* threadId);
127    static int javaThreadShell(void* args);
128};
129
130extern CursorWindow * get_window_from_object(JNIEnv * env, jobject javaWindow);
131
132}
133
134#endif
135