com.sun.tv.XletContextImpl Maven / Gradle / Ivy
/*
* @(#)XletContextImpl.java 1.6 99/07/08
*
* Copyright 2000 by Sun Microsystems, Inc.,
* 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
* All rights reserved.
*
* This software is the confidential and proprietary information
* of Sun Microsystems, Inc. ("Confidential Information"). You
* shall not disclose such Confidential Information and shall use
* it only in accordance with the terms of the license agreement
* you entered into with Sun.
*
* SUN MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF THE
* SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
* IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
* PURPOSE, OR NON-INFRINGEMENT. SUN SHALL NOT BE LIABLE FOR ANY DAMAGES
* SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR DISTRIBUTING
* THIS SOFTWARE OR ITS DERIVATIVES.
*/
package com.sun.tv;
import javax.tv.xlet.*;
import javax.tv.service.selection.*;
import java.util.*;
/**
* XletContext is used for xlet to communicate back to XletManager.
* We save a reference to xletManager as a means to get properties, and
* notify XletManager when calls are made to the lifecycle functions
*
* @version 99/07/08 @(#)XletContextImpl.java 1.6
*/
public class XletContextImpl implements XletContext {
public static final String CONTAINER = "javax.tv.xlet.container";
public static final String SERVICE_CONTEXT = "javax.tv.xlet.service_context";
public static final String ROOT_CONTAINER = "javax.tv.xlet.root_container";
private XletManager xletManager = null;
private XletContainer xletContainer = null;
private Xlet xlet = null;
private String[] args = null;
private ServiceContext context = null;
public XletContextImpl(XletManager xletMgr, Xlet xlet, ServiceContext context, String args[]) {
this.xletManager = xletMgr;
this.xlet = xlet;
this.args = args;
this.context = context;
}
/*
* Accessor methods to populate properties database
*/
private DisplayManager getDisplayMgr() {
return DisplayManager.createInstance();
}
/**
* Provides an Xlet with a mechanism to retrieve named
* properties from the XletContext.
*
* @parameter key The name of the property
* @return A reference to an object representing the property.
* null is returned if no value is available for key.
*/
public Object getXletProperty(String prop) {
if (prop == null) {
throw new NullPointerException("String is null");
}
if (ARGS.equals(prop)) {
return args;
} else if (CONTAINER.equals(prop)) {
if (xlet != null && xletManager != null) {
XletState state = xletManager.getXletState(xlet);
if (state.getState() == XletState.DESTROYED)
return null;
}
if (xletContainer == null) {
xletContainer = getDisplayMgr().createXletContainer();
}
return xletContainer;
} else if (ROOT_CONTAINER.equals(prop)) {
return getDisplayMgr().getRootFrame();
} else if (SERVICE_CONTEXT.equals(prop)) {
if (xlet != null && xletManager != null) {
XletState state = xletManager.getXletState(xlet);
if (state.getState() == XletState.DESTROYED)
return null;
}
return context;
}
return null;
}
/**
* Notifies the manager that the Xlet does not want to be active and has
* entered the Paused state. Invoking this method will
* have no effect if the Xlet is destroyed, or if it has not
* yet been started.
*
* If an Xlet calls notifyPaused(), in the
* future it may receive an Xlet.startXlet() call to request
* it to become active, or an Xlet.destroyXlet() call to request
* it to destroy itself.
*
*/
public void notifyPaused(){
xletManager.changeXletState(xlet,XletState.PAUSED);
}
/**
* Provides the Xlet with a mechanism to indicate that it is
* interested in entering the Active state. Calls to
* this method can be used by an application manager to determine which
* Xlets to move to Active state.
*/
public void resumeRequest(){
xletManager.changeXletState(xlet,XletState.ACTIVE);
}
/**
*
* Used by an application to notify its manager that it
* has entered into the
* Destroyed state. The application manager will not
* call the Xlet's destroy method, and all resources
* held by the Xlet will be considered eligible for reclamation.
* Before calling this method,
* the Xlet must have performed the same operations
* (clean up, releasing of resources etc.) it would have if the
* Xlet.destroyXlet() had been called.
*/
public void notifyDestroyed(){
xletManager.changeXletState(xlet, XletState.DESTROYED);
getDisplayMgr().destroyXletContainer(xletContainer);
try {
if (context != null) {
context.destroy();
}
} catch (Exception e) {
;
}
context = null;
}
}