01: /*
02: * Copyright 1990-2006 Sun Microsystems, Inc. All Rights Reserved.
03: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER
04: *
05: * This program is free software; you can redistribute it and/or
06: * modify it under the terms of the GNU General Public License version
07: * 2 only, as published by the Free Software Foundation.
08: *
09: * This program is distributed in the hope that it will be useful, but
10: * WITHOUT ANY WARRANTY; without even the implied warranty of
11: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12: * General Public License version 2 for more details (a copy is
13: * included at /legal/license.txt).
14: *
15: * You should have received a copy of the GNU General Public License
16: * version 2 along with this work; if not, write to the Free Software
17: * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
18: * 02110-1301 USA
19: *
20: * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
21: * Clara, CA 95054 or visit www.sun.com if you need additional
22: * information or have any questions.
23: */
24:
25: package com.sun.jump.executive;
26:
27: import com.sun.jump.common.JUMPApplication;
28: import com.sun.jump.common.JUMPIsolate;
29: import com.sun.jump.common.JUMPWindow;
30: import com.sun.jump.message.JUMPMessageSender;
31:
32: /**
33: * <code>JUMPIsolateProxy</code> encapsulates the state of the running isolate
34: * within the executive.
35: * Operations performed on the <code>JUMPIsolateProxy</code>
36: * gets sent to the isolate instance (For example :- In the case of
37: * process based isolate,
38: * to <code>com.sun.jump.isolate.jvmprocess.JUMPIsolateProcess</code>
39: * <p>
40: * It implements the {@link com.sun.jump.message.JUMPMessageSender}
41: * interface so that messages can be sent to the <code>JUMPIsolate</code>
42: * that this class is proxying for.
43: * <p>
44: * The <Code>JUMPLifecycleModule</code> is responsible for creation and
45: * management of <Code>JUMPIsolateProxy</code> objects.
46: */
47: public interface JUMPIsolateProxy extends JUMPIsolate,
48: JUMPMessageSender {
49:
50: /**
51: * Start the application specified. The method returns
52: * after the application has started successfully. If for some reason
53: * the application cannot be started exceptions are thrown.
54: *
55: * @return JUMPApplicationProxy the proxy to the started application on the Isolate.
56: */
57: public JUMPApplicationProxy startApp(JUMPApplication app,
58: String[] args);
59:
60: /**
61: * Get all application proxies
62: */
63: public JUMPApplicationProxy[] getApps();
64:
65: /**
66: * Get all <code>JUMPWindow</code>-s running in the <code>JUMPIsolateProxy</code>.
67: */
68: public JUMPWindow[] getWindows();
69: }
|