001: /*
002: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
003: *
004: * Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.
005: *
006: * The contents of this file are subject to the terms of either the GNU
007: * General Public License Version 2 only ("GPL") or the Common
008: * Development and Distribution License("CDDL") (collectively, the
009: * "License"). You may not use this file except in compliance with the
010: * License. You can obtain a copy of the License at
011: * http://www.netbeans.org/cddl-gplv2.html
012: * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
013: * specific language governing permissions and limitations under the
014: * License. When distributing the software, include this License Header
015: * Notice in each file and include the License file at
016: * nbbuild/licenses/CDDL-GPL-2-CP. Sun designates this
017: * particular file as subject to the "Classpath" exception as provided
018: * by Sun in the GPL Version 2 section of the License file that
019: * accompanied this code. If applicable, add the following below the
020: * License Header, with the fields enclosed by brackets [] replaced by
021: * your own identifying information:
022: * "Portions Copyrighted [year] [name of copyright owner]"
023: *
024: * Contributor(s):
025: *
026: * The Original Software is NetBeans. The Initial Developer of the Original
027: * Software is Sun Microsystems, Inc. Portions Copyright 1997-2007 Sun
028: * Microsystems, Inc. All Rights Reserved.
029: *
030: * If you wish your version of this file to be governed by only the CDDL
031: * or only the GPL Version 2, indicate your decision by adding
032: * "[Contributor] elects to include this software in this distribution
033: * under the [CDDL or GPL Version 2] license." If you do not indicate a
034: * single choice of license, a recipient has the option to distribute
035: * your version of this file under either the CDDL, the GPL Version 2 or
036: * to extend the choice of license to its licensees as provided above.
037: * However, if you add GPL Version 2 code and therefore, elected the GPL
038: * Version 2 license, then the option applies only if the new code is
039: * made subject to such option by the copyright holder.
040: */
041:
042: package com.sun.rave.designtime.faces;
043:
044: import com.sun.rave.designtime.DesignProject;
045: import com.sun.rave.designtime.DesignContext;
046: import java.beans.PropertyChangeListener;
047:
048: /**
049: * <p>A FacesDesignProject is a top-level container for DesignContexts
050: * at design-time for projects that support JSF. The DesignProject
051: * represents the project in the Creator IDE. This interface extends
052: * the the DesignProject by providing APIs to find the DesignContexts
053: * by name and find DesignContexts by scope.</p>
054: *
055: * <P><B>IMPLEMENTED BY CREATOR</B> - This interface is implemented by Creator for use by the
056: * component (bean) author.</P>
057: *
058: * @version 1.0
059: * @see DesignProject
060: * @see DesignContext#getProject()
061: */
062: public interface FacesDesignProject extends DesignProject {
063:
064: /**
065: * Constant for property (for firing change event) Context Class Loader
066: */
067: public static final String CONTEXT_CLASS_LOADER = "context_class_loader";
068:
069: /**
070: * Finds <code>DesignContext</code> of specified name.
071: */
072: public DesignContext findDesignContext(String variableName);
073:
074: /**
075: * <p>Finds <code>DesignContext</code>s of specified scopes. The
076: * scopes can have value of "request", "session", "application"
077: * and "none".</p>
078: */
079: public DesignContext[] findDesignContexts(String[] scopes);
080:
081: /**
082: * Get the project common Context Class loader so that it could use used by
083: * component authors who create the design time for component.
084: */
085:
086: public ClassLoader getContextClassLoader();
087:
088: /**
089: * Add a property change listener to the design project so that it could fire
090: * events such as classloader changed.
091: */
092: public void addPropertyChangeListener(
093: PropertyChangeListener propChangeListener);
094:
095: /**
096: * Remove property change listener.
097: */
098: public void removePropertyChangeListener(
099: PropertyChangeListener propChangeListener);
100:
101: }
|