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: package com.sun.rave.web.ui.component.util.descriptors;
042:
043: import com.sun.rave.web.ui.util.ResourceFactory;
044:
045: import java.io.IOException;
046: import java.util.ArrayList;
047: import java.util.HashMap;
048: import java.util.Iterator;
049: import java.util.List;
050: import java.util.Map;
051:
052: import javax.faces.context.FacesContext;
053: import javax.faces.context.ResponseWriter;
054: import javax.faces.component.UIColumn;
055: import javax.faces.component.UIComponent;
056: import javax.faces.component.UIData;
057: import javax.faces.component.UIViewRoot;
058: import javax.faces.render.Renderer;
059:
060: /**
061: * <P> This class holds information that describes a Resource. It
062: * provides access to a {@link ResourceFactory} for obtaining the
063: * actual Resource object described by this descriptor. See the
064: * layout.dtd file for more information on how to define a Resource
065: * via XML. The LayoutDefinition will add all defined Resources to
066: * the Request scope for easy access (including via JSF EL).</P>
067: *
068: * @author Ken Paulsen (ken.paulsen@sun.com)
069: */
070: public class Resource implements java.io.Serializable {
071:
072: /**
073: * This is the id for the Resource
074: */
075: private String _id = null;
076:
077: /**
078: * This holds "extraInfo" for the Resource, such as a ResourceBundle
079: * baseName.
080: */
081: private String _extraInfo = null;
082:
083: /**
084: * This is a String className for the Factory.
085: */
086: private String _factoryClass = null;
087:
088: /**
089: * The Factory that produces the desired UIComponent.
090: */
091: private transient ResourceFactory _factory = null;
092:
093: /**
094: * Constructor
095: */
096: public Resource(String id, String extraInfo, String factoryClass) {
097: if (id == null) {
098: throw new NullPointerException("'id' cannot be null!");
099: }
100: if (factoryClass == null) {
101: throw new NullPointerException(
102: "'factoryClass' cannot be null!");
103: }
104: _id = id;
105: _extraInfo = extraInfo;
106: _factoryClass = factoryClass;
107: _factory = createFactory();
108: }
109:
110: /**
111: * Accessor method for ID. This is the key the resource will be stored
112: * under in the Request scope.
113: */
114: public String getId() {
115: return _id;
116: }
117:
118: /**
119: * This holds "extraInfo" for the Resource, such as a ResourceBundle
120: * baseName.
121: */
122: public String getExtraInfo() {
123: return _extraInfo;
124: }
125:
126: /**
127: * This method provides access to the ResourceFactory.
128: *
129: * @return ResourceFactory
130: */
131: public ResourceFactory getFactory() {
132: if (_factory == null) {
133: _factory = createFactory();
134: }
135: return _factory;
136: }
137:
138: /**
139: * This method creates a new factory.
140: *
141: * @return ResourceFactory
142: */
143: protected ResourceFactory createFactory() {
144: try {
145: Class cls = Class.forName(_factoryClass);
146: return (ResourceFactory) cls.newInstance();
147: } catch (ClassNotFoundException ex) {
148: throw new RuntimeException(ex);
149: } catch (InstantiationException ex) {
150: throw new RuntimeException(ex);
151: } catch (IllegalAccessException ex) {
152: throw new RuntimeException(ex);
153: }
154: }
155: }
|