one.radio
Class Emcee

java.lang.Object
  |
  +--one.world.core.Component
        |
        +--one.gui.Application
              |
              +--one.radio.Emcee

All Implemented Interfaces:

ActionListener, EventListener, FetcherProtocol, Serializable

public final class Emcee

extends Application

implements FetcherProtocol, ActionListener

Implementation of the one.radio emcee. Emcee provides a simple user interface for managing users and their applications. It supports pushing or pulling all of a user's applications to/from some machine, managing a user's local applications, and exchanging applications between users. Emcee's per-user functionality is accessed by activating a user's popup menu (typically, by right-clicking on the user's name). Applications are moved or copied between users by (copy) dragging an application's flag icon () and dropping it onto a user's name.

Emcee relies on the following layout of the environment hierarchy. The emcee application itself must run in the "/User" environment. Each child environment of the user environment is treated as a user's root environment, with the user having the same name as that environment. For example, "/User/rgrimm" is the root environment for user rgrimm. Each user application, in turn, runs in a direct child environment of the user's root environment. For example, "/User/rgrimm/Chat" may contain rgrimm's chat application.

The "/User/local" environment is treated differently in that it hosts local applications, which are shared between users. The local environment is shown as "<Local>" in emcee's window and cannot be moved between machines.

Imported and Exported Event Handlers

Exported event handlers:

main

Handles environment events, linked to an environment's main imported event handler.

Imported event handlers:

request

Handles environment events and REP requests, linked to an environment's request exported event handler.

Version:

$Revision: 1.8 $

See Also:

Serialized Form

Inner classes inherited from class one.gui.Application

Application.Window

Inner classes inherited from class one.world.core.Component

Component.HandlerReference, Component.Importer

Inner classes inherited from class one.radio.FetcherProtocol

FetcherProtocol.UserDescriptor

Fields inherited from class one.gui.Application

ACTIVATING, ACTIVE, appName, height, INACTIVE, locationX, locationY, lock, main, mainWindow, operation, request, status, timer, width

Fields inherited from interface one.radio.FetcherProtocol

ADDRESS, MSG, MSG_CHALLENGE, MSG_COME, MSG_COMING, MSG_RESPONSE, PAYLOAD

Constructor Summary

Emcee(Environment env)
Create a new instance of Emcee.

Method Summary

void	acquire() Acquire the resources needed by the emcee application.
void	actionPerformed(ActionEvent e) Handle the specified action event.
Application.Window	createMainWindow() Create the emcee's main window.
static void	init(Environment env, Object closure) Initialize the one.radio emcee.
void	release() Release the resources used by the emcee application.

Methods inherited from class one.gui.Application

createMainHandler, getDescriptor, signalError, start, stop

Methods inherited from class one.world.core.Component

declareExported, declareImported, equals, eventHandlers, getDescriptor, getEnvironment, getLinkedHandlers, getLinkedNumber, getTimer, hasEventHandler, hashCode, isFullyLinked, isLinked, isSealed, link, link, run, seal, unbox, undeclare, unlink, wrap

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Emcee

public Emcee(Environment env)

Create a new instance of Emcee.

Parameters:

env - The environment for the new instance.

Method Detail

acquire

public void acquire()

Acquire the resources needed by the emcee application.

Overrides:

acquire in class Application

release

public void release()

Release the resources used by the emcee application.

Overrides:

release in class Application

createMainWindow

public Application.Window createMainWindow()

Create the emcee's main window.

Overrides:

createMainWindow in class Application

Following copied from class: one.gui.Application

Returns:

The application's main window, or null if the application does not have a main window.

actionPerformed

public void actionPerformed(ActionEvent e)

Handle the specified action event.

Specified by:

actionPerformed in interface ActionListener

Parameters:

e - The action event.

init

public static void init(Environment env,
                        Object closure)

Initialize the one.radio emcee.

Parameters:

env - The environment.

closure - The closure, which is ignored.