Back to index

lightning-sunbird  0.9+nobinonly
MRJSession.h
Go to the documentation of this file.
00001 /* ***** BEGIN LICENSE BLOCK *****
00002  * Version: MPL 1.1/GPL 2.0/LGPL 2.1
00003  *
00004  * The contents of this file are subject to the Mozilla Public License Version
00005  * 1.1 (the "License"); you may not use this file except in compliance with
00006  * the License. You may obtain a copy of the License at
00007  * http://www.mozilla.org/MPL/
00008  *
00009  * Software distributed under the License is distributed on an "AS IS" basis,
00010  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
00011  * for the specific language governing rights and limitations under the
00012  * License.
00013  *
00014  * The Original Code is the MRJ Carbon OJI Plugin.
00015  *
00016  * The Initial Developer of the Original Code is
00017  * Netscape Communications Corp.
00018  * Portions created by the Initial Developer are Copyright (C) 2001
00019  * the Initial Developer. All Rights Reserved.
00020  *
00021  * Contributor(s):
00022  *   Patrick C. Beard <beard@netscape.com>
00023  *
00024  * Alternatively, the contents of this file may be used under the terms of
00025  * either of the GNU General Public License Version 2 or later (the "GPL"),
00026  * or the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
00027  * in which case the provisions of the GPL or the LGPL are applicable instead
00028  * of those above. If you wish to allow use of your version of this file only
00029  * under the terms of either the GPL or the LGPL, and not to allow others to
00030  * use your version of this file under the terms of the MPL, indicate your
00031  * decision by deleting the provisions above and replace them with the notice
00032  * and other provisions required by the GPL or the LGPL. If you do not delete
00033  * the provisions above, a recipient may use your version of this file under
00034  * the terms of any one of the MPL, the GPL or the LGPL.
00035  *
00036  * ***** END LICENSE BLOCK ***** */
00037 
00038 /*
00039        MRJSession.h
00040 
00041        Encapsulates a session with the MacOS Runtime for Java.
00042        
00043        by Patrick C. Beard.
00044  */
00045 
00046 #pragma once
00047 
00048 #include <MacTypes.h>
00049 
00050 #include <jni.h>
00051 
00052 #include <vector>
00053 #include <string>
00054 
00055 using std::vector;
00056 using std::string;
00057 
00058 class NativeMessage {
00059 public:
00060        NativeMessage() : mNext(NULL) {}
00061        virtual ~NativeMessage() {}
00062        
00063        virtual void execute() = 0;
00064 
00065        void setNext(NativeMessage* next) { mNext = next; }
00066        NativeMessage* getNext() { return mNext; }
00067 
00068 private:
00069        NativeMessage* mNext;
00070 };
00071 
00072 // FIXME:  need an interface for setting security options, etc.
00073 
00074 class MRJContext;
00075 class Monitor;
00076 
00077 class MRJSession {
00078 public:
00079        MRJSession();
00080        virtual ~MRJSession();
00081        
00082        OSStatus open(const char* consolePath);
00083        OSStatus close();
00084        
00085        JNIEnv* getCurrentEnv();
00086        JNIEnv* getMainEnv();
00087        JavaVM* getJavaVM();
00088        
00089        Boolean onMainThread();
00090        
00091        Boolean addToClassPath(const FSSpec& fileSpec);
00092        Boolean addToClassPath(const char* dirPath);
00093        Boolean addURLToClassPath(const char* fileURL);
00094 
00095        char* getProperty(const char* propertyName);
00096        
00097        void setStatus(OSStatus status);
00098        OSStatus getStatus();
00099        
00100        void idle(UInt32 milliseconds = 0x00000400);
00101 
00102        void sendMessage(NativeMessage* message, Boolean async = false);
00103        
00107        void lock();
00108        void unlock();
00109 
00110 private:
00111        void postMessage(NativeMessage* message);
00112        void dispatchMessage();
00113        
00114        string getClassPath();
00115        string getPluginHome();
00116        
00117 private:
00118        OSStatus mStatus;
00119        
00120        typedef vector<FSRef> MRJClassPath;
00121        MRJClassPath mClassPath;
00122        
00123        JNIEnv* mMainEnv;
00124        JavaVM* mJavaVM;
00125        jclass mSession;
00126 
00127        // Message queue.
00128        NativeMessage* mFirst;
00129        NativeMessage* mLast;
00130        Monitor* mMessageMonitor;
00131        
00132        UInt32 mLockCount;
00133 };