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 mozilla.org code.
00015  *
00016  * The Initial Developer of the Original Code is
00017  * Netscape Communications Corporation.
00018  * Portions created by the Initial Developer are Copyright (C) 1998
00019  * the Initial Developer. All Rights Reserved.
00020  *
00021  * Contributor(s):
00022  *
00023  * Alternatively, the contents of this file may be used under the terms of
00024  * either of the GNU General Public License Version 2 or later (the "GPL"),
00025  * or the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
00026  * in which case the provisions of the GPL or the LGPL are applicable instead
00027  * of those above. If you wish to allow use of your version of this file only
00028  * under the terms of either the GPL or the LGPL, and not to allow others to
00029  * use your version of this file under the terms of the MPL, indicate your
00030  * decision by deleting the provisions above and replace them with the notice
00031  * and other provisions required by the GPL or the LGPL. If you do not delete
00032  * the provisions above, a recipient may use your version of this file under
00033  * the terms of any one of the MPL, the GPL or the LGPL.
00034  *
00035  * ***** END LICENSE BLOCK ***** */
00036 
00037 /*
00038        MRJSession.h
00039 
00040        Encapsulates a session with the MacOS Runtime for Java.
00041        
00042        by Patrick C. Beard.
00043  */
00044 
00045 #pragma once
00046 
00047 #ifndef CALL_NOT_IN_CARBON
00048        #define CALL_NOT_IN_CARBON 1
00049 #endif
00050 
00051 #include "jni.h"
00052 #include "JManager.h"
00053 
00054 class NativeMessage {
00055 public:
00056        NativeMessage() : mNext(NULL) {}
00057        
00058        virtual void execute() = 0;
00059 
00060        void setNext(NativeMessage* next) { mNext = next; }
00061        NativeMessage* getNext() { return mNext; }
00062 
00063 private:
00064        NativeMessage* mNext;
00065 };
00066 
00067 // FIXME:  need an interface for setting security options, etc.
00068 
00069 class MRJContext;
00070 class Monitor;
00071 
00072 class MRJSession {
00073 public:
00074        MRJSession();
00075        virtual ~MRJSession();
00076        
00077        JMSessionRef getSessionRef();
00078        
00079        JNIEnv* getCurrentEnv();
00080        JNIEnv* getMainEnv();
00081        JavaVM* getJavaVM();
00082        
00083        Boolean onMainThread();
00084        
00085        Boolean addToClassPath(const FSSpec& fileSpec);
00086        Boolean addToClassPath(const char* dirPath);
00087        Boolean addURLToClassPath(const char* fileURL);
00088 
00089        char* getProperty(const char* propertyName);
00090        
00091        void setStatus(OSStatus status);
00092        OSStatus getStatus();
00093        
00094        void idle(UInt32 milliseconds = kDefaultJMTime);
00095 
00096        void sendMessage(NativeMessage* message, Boolean async = false);
00097        
00101        void lock();
00102        void unlock();
00103 
00104 private:
00105        void postMessage(NativeMessage* message);
00106        void dispatchMessage();
00107        
00108 private:
00109        JMSessionRef mSession;
00110        OSStatus mStatus;
00111 
00112        JNIEnv* mMainEnv;
00113 
00114        // Message queue.
00115        NativeMessage* mFirst;
00116        NativeMessage* mLast;
00117        Monitor* mMessageMonitor;
00118        
00119        UInt32 mLockCount;
00120 };