This class contains methods that perform common utility-type + * functionality.
+ * + * @author Ken Paulsen (kenapaulsen@gmail.com) + */ +@ApplicationScoped +@ManagedBean(name="jsft") +public class JSFTCommands { + + /** + *Default Constructor.
+ */ + public JSFTCommands() { + } + + /** + *This command conditionally executes its child commands.
+ */ + public void _if(boolean condition) { + Command command = (Command) FacesContext.getCurrentInstance(). + getExternalContext().getRequestMap().get(Command.COMMAND_KEY); + if (condition) { + command.invokeChildCommands(); + } else { + command = command.getElseCommand(); + if (command != null) { + command.invoke(); + } + } + } + + /** + * This command iterates over the given List and sets given
+ */
+ public void foreach(String var, List list) {
+ // Get the Request Map
+ Map This command sets a requestScope attribute with the given
+ * This command writes output using This command writes using
+ * This command marks the response complete. This means that no
+ * additional response will be sent. This is useful if you've
+ * provided a response already and you don't want JSF to do it again
+ * (it may cause problems to do it 2x). This command indicates to JSF that the request should proceed
+ * immediately to the render response phase. It will be ignored if
+ * rendering has already begun. This is useful if you want to stop
+ * processing and jump to the response. This is often the case when
+ * an error ocurrs or validation fails. Typically the page the user
+ * is on will be reshown (although if navigation has already
+ * occurred, the new page will be shown. This command provides a way to see the call stack by printing a
+ * stack trace. The output will go to stderr and will also be
+ * returned in the output value "stackTrace". An optional message
+ * may be provided to be included in the trace. Returns the nano seconds since some point in time. This is only
+ * useful for relative measurments. This is application scoped, so it is not safe to change. Use
+ * caution. This class contains methods that perform common utility-type
+ * functionality. Default Constructor. This command prints out the contents of the given
+ * This method returns an key and value.System.out.println.
+ * It requires value to be supplied.FacesContext.getResponseWriter().UIComponent's attribute map.Iterator for the given
+ * List. The List input value key is:
+ * "list". The output value key for the Iterator is:
+ * "iterator".
HandlerContext
+ @Handler(id="mapPut",
+ input={
+ @HandlerInput(name="map", type=Map.class, required=true),
+ @HandlerInput(name="key", type=Object.class, required=true),
+ @HandlerInput(name="value", type=Object.class, required=true)}
+ )
+ public static void mapPut(HandlerContext context) {
+ Map map = (Map) context.getInputValue("map");
+ Object key = context.getInputValue("key");
+ Object value = context.getInputValue("value");
+ map.put(key, value);
+ }
+ */
+
+ /**
+ * This command url-encodes the given String. It will return null if
+ * null is given and it will use a default encoding of "UTF-8" if no
+ * encoding is specified.
+ *
+ * @param context The HandlerContext.
+ @Handler(id="urlencode",
+ input={
+ @HandlerInput(name="value", type=String.class, required=true),
+ @HandlerInput(name="encoding", type=String.class)
+ },
+ output={
+ @HandlerOutput(name="result", type=String.class)})
+ public static void urlencode(HandlerContext context) {
+ String value = (String) context.getInputValue("value");
+ String encoding = (String) context.getInputValue("encoding");
+ if (encoding == null) {
+ encoding = "UTF-8";
+ }
+ // The value could be null if an EL expression maps to null
+ if (value != null) {
+ try {
+ value = java.net.URLEncoder.encode(value, encoding);
+ } catch (java.io.UnsupportedEncodingException ex) {
+ throw new IllegalArgumentException(ex);
+ }
+ }
+ context.setOutputValue("result", value);
+ }
+ */
+
+ /**
+ * This command gets the current system time in milliseconds. It may
+ * be used to time things.
+ @Handler(id="getDate",
+ output={
+ @HandlerOutput(name="time", type=Long.class)
+ })
+ public static void getDate(HandlerContext context) {
+ context.setOutputValue("time", new java.util.Date().getTime());
+ }
+ */
+
+ /**
+ * This method converts '<' and '>' characters into "<"
+ * and ">" in an effort to avoid HTML from being processed.
+ * This can be used to avoid <script> tags, or to show code
+ * examples which might include HTML characters. '&' characters
+ * will also be converted to "&".
+ @Handler(id="htmlEscape",
+ input={
+ @HandlerInput(name="value", type=String.class, required=true)
+ },
+ output={
+ @HandlerOutput(name="result", type=String.class)})
+ public static void htmlEscape(HandlerContext context) {
+ String value = (String) context.getInputValue("value");
+ value = com.sun.jsft.util.Util.htmlEscape(value);
+ context.setOutputValue("result", value);
+ }
+ */
+
+ /**
+ * A utility command that resembles the for() method in Java. Commands
+ * inside the for loop will be executed in a loop. The starting index
+ * is specified by start. The index will increase
+ * sequentially untill it is equal to end.
+ * var will be a request attribute that is set to the
+ * current index value as the loop iterates.
+ * For example:
+ *
+ * forLoop(start="1" end="3" var="foo") {...}
+ *
+ * The commands inside the {...} will be executed 2 times
+ * (with foo=1 and foo=2).
+ *
+ * start -- type: Integer Starting
+ * index, defaults to zero if not specified.end -- type: Integer; Ending index.
+ * Required.var -- type: String; Request
+ * attribute to be set in the for loop to the value of the
+ * index.
+ public static boolean forLoop(int start, int end, String var) {
+ List<> commands =
+ handlerCtx.getHandler().getChildHandlers();
+ if (commands.size() > 0) {
+ // We have child commands in the loop... execute while we iterate
+ Map requestMap = FacesContext.getCurrentInstance().
+ getExternalContext().getRequestMap();
+ for (int idx=start; idx < end; idx++) {
+ requestMap.put(var, idx);
+ // Ignore what is returned by the commands... we need to return
+ // false anyway to prevent children from being executed again
+ elt.dispatchHandlers(commands);
+ }
+ }
+
+ // This will prevent the child commands from executing again
+ return false;
+ }
+ */
+}
diff --git a/jsft/src/main/java/com/sun/jsft/component/DeferredFragment.java b/jsft/src/main/java/com/sun/jsft/component/DeferredFragment.java
new file mode 100644
index 0000000..1ad70ce
--- /dev/null
+++ b/jsft/src/main/java/com/sun/jsft/component/DeferredFragment.java
@@ -0,0 +1,343 @@
+/*
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
+ *
+ * Copyright (c) 2011 Oracle and/or its affiliates. All rights reserved.
+ * Portions Copyright (c) 2011 Ken Paulsen
+ *
+ * The contents of this file are subject to the terms of either the GNU
+ * General Public License Version 2 only ("GPL") or the Common Development
+ * and Distribution License("CDDL") (collectively, the "License"). You
+ * may not use this file except in compliance with the License. You can
+ * obtain a copy of the License at
+ * https://glassfish.dev.java.net/public/CDDL+GPL_1_1.html
+ * or packager/legal/LICENSE.txt. See the License for the specific
+ * language governing permissions and limitations under the License.
+ *
+ * When distributing the software, include this License Header Notice in each
+ * file and include the License file at packager/legal/LICENSE.txt.
+ *
+ * GPL Classpath Exception:
+ * Oracle designates this particular file as subject to the "Classpath"
+ * exception as provided by Oracle in the GPL Version 2 section of the License
+ * file that accompanied this code.
+ *
+ * Modifications:
+ * If applicable, add the following below the License Header, with the fields
+ * enclosed by brackets [] replaced by your own identifying information:
+ * "Portions Copyright [year] [name of copyright owner]"
+ *
+ * Contributor(s):
+ * If you wish your version of this file to be governed by only the CDDL or
+ * only the GPL Version 2, indicate your decision by adding "[Contributor]
+ * elects to include this software in this distribution under the [CDDL or GPL
+ * Version 2] license." If you don't indicate a single choice of license, a
+ * recipient has the option to distribute your version of this file under
+ * either the CDDL, the GPL Version 2 or to extend the choice of license to
+ * its licensees as provided above. However, if you add GPL Version 2 code
+ * and therefore, elected the GPL Version 2 license, then the option applies
+ * only if the new code is made subject to such option by the copyright
+ * holder.
+ */
+
+package com.sun.jsft.component;
+
+import com.sun.jsft.tasks.Task;
+import com.sun.jsft.tasks.TaskEvent;
+import com.sun.jsft.tasks.TaskManager;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+import java.util.StringTokenizer;
+import javax.faces.component.UIComponent;
+import javax.faces.component.UIComponentBase;
+import javax.faces.component.UIOutput;
+import javax.faces.component.UIViewRoot;
+import javax.faces.context.FacesContext;
+import javax.faces.event.AbortProcessingException;
+import javax.faces.event.ComponentSystemEvent;
+import javax.faces.event.ComponentSystemEventListener;
+import javax.faces.event.PostAddToViewEvent;
+import javax.faces.event.SystemEvent;
+import javax.faces.event.SystemEventListener;
+
+
+/**
+ *
+ */
+public class DeferredFragment extends UIComponentBase {
+
+ /**
+ * Default constructor.
+ */
+ public DeferredFragment() {
+ subscribeToEvent(
+ PostAddToViewEvent.class,
+ new DeferredFragment.AfterCreateListener());
+ }
+
+ /**
+ *
+ */
+ public String getFamily() {
+ return FAMILY;
+ }
+
+ /**
+ *
+ */
+ public boolean getRendersChildren() {
+ return true;
+ }
+
+ public void encodeBegin(FacesContext context) throws IOException {
+ System.out.println("Encode Begin ("+getId()+")...");
+ }
+
+ public void encodeEnd(FacesContext context) throws IOException {
+ System.out.println("Encode End ("+getId()+")...");
+ }
+
+ /**
+ * This method returns true when all tasks this deferred
+ * fragment depends on are complete. This method is not intended to
+ * be used to poll this task for completion, you should instead
+ * register for the ready event that it fires.
+ */
+ private boolean isReady() {
+ return (taskCount == 0);
+ }
+
+ /**
+ * This method gets the id of the "place-holder" component for this
+ * DeferredFragment.
+ */
+ public String getPlaceHolderId() {
+ return placeHolderId;
+ }
+
+ /**
+ * This method sets the id of the "place-holder" component for this
+ * DeferredFragment.
+ */
+ public void setPlaceHolderId(String id) {
+ placeHolderId = id;
+ }
+
+ /**
+ * This method returns the number of tasks this DeferredFragment is
+ * waiting for.
+ */
+ public int getTaskCount() {
+ return taskCount;
+ }
+
+ /**
+ * This method sets the number of tasks this
+ * DeferredFragment must wait for.
+ */
+ public void setTaskCount(int count) {
+ taskCount = count;
+ }
+
+ /**
+ * This method registers the given
+ * ComponentSystemEventListener that should be notified
+ * when this DeferredFragment is ready to be
+ * rendered.
+ */
+ public void addReadyListener(ComponentSystemEventListener listener) {
+ listeners.add(listener);
+ }
+
+ /**
+ * This method is responsible for firing the {@link FragmentReadyEvent}
+ * to signal to listeners that the {@link Task}s needed by this
+ * DeferredFragment have completed and it is now ready to
+ * be processed.
+ */
+ protected void fireFragmentReadyEvent() {
+ ComponentSystemEvent event = new FragmentReadyEvent(this);
+System.out.println("listeners" + listeners);
+ for (ComponentSystemEventListener listener : listeners) {
+ listener.processEvent(event);
+ }
+ }
+
+
+ /**
+ * Listener used to handle TaskEvents.
+ */
+ public static class DeferredFragmentTaskListener implements SystemEventListener {
+
+ /**
+ * Default Constructor.
+ */
+ public DeferredFragmentTaskListener(DeferredFragment df) {
+ super();
+ this.df = df;
+ }
+
+ /**
+ * The event passed in will be a {@link TaskEvent}.
+ */
+ public void processEvent(SystemEvent event) throws AbortProcessingException {
+System.out.println("DeferredFragmentTaskListener.processEvent()!");
+ Task task = (Task) event.getSource();
+ String eventType = ((TaskEvent) event).getType();
+ int count = 0;
+ synchronized (df) {
+ // Synch to ensure we don't change it during this time.
+ count = df.getTaskCount() - 1;
+ df.setTaskCount(count);
+ }
+ if (count == 0) {
+ // We're done!
+ df.fireFragmentReadyEvent();
+ }
+ }
+
+ public boolean isListenerForSource(Object source) {
+ // We only dispatch this correctly... this method is not needed.
+ return true;
+ }
+
+ // A reference to the DeferredFragment
+ private DeferredFragment df = null;
+ }
+
+ /**
+ * Listener used to relocate the children to a facet on the
+ * UIViewRoot.
+ */
+ public static class AfterCreateListener implements ComponentSystemEventListener {
+ AfterCreateListener() {
+ }
+
+ /**
+ * This method is responsible for setting up this
+ * DeferredFragment. This includes the following
+ * steps:
+ *
+ * - Put a "place-holder" component at the location of the
+ * fragment so it can be swapped out by the client at a later
+ * time.
+ * - Move this component to a facet in the UIViewRoot.
+ * - Register any tasks that need to be executed, add a listener
+ * for each task or the specified event within the task.
+ * - Ensure a FragmentRenderer component exists at the end of the page.
+ */
+ public void processEvent(ComponentSystemEvent event) throws AbortProcessingException {
+ // Ensure we only do this once... NOTE: I tried to unsubscribe from
+ // the event, but ran into a ConcurrentModificationException... the
+ // list of listeners is probably still being looped through while I
+ // am attempting to remove this Listener. So I'll do this instead:
+ if (done) {
+ return;
+ }
+ done = true;
+
+ // Get the component
+ DeferredFragment comp = (DeferredFragment) event.getComponent();
+
+ // Get the UIViewRoot Facet Map
+ FacesContext ctx = FacesContext.getCurrentInstance();
+ UIViewRoot viewRoot = ctx.getViewRoot();
+ Map facetMap = viewRoot.getFacets();
+
+ // Create a place holder...
+ String key = "jsft_" + comp.getClientId(ctx);
+ UIComponent placeHolder = new UIOutput();
+ placeHolder.getAttributes().put(
+ "value", "");
+
+ // Swap comp with the placeHolder...
+ List peers = comp.getParent().getChildren();
+ int index = peers.indexOf(comp);
+ peers.set(index, placeHolder);
+ comp.setPlaceHolderId(placeHolder.getClientId(ctx));
+
+ // Move this component to the FacetMap
+ facetMap.put(key, comp);
+
+ // Register task(s)
+ String task = (String) comp.getAttributes().get("task");
+ StringTokenizer tok = new StringTokenizer(task, ";");
+ TaskManager tm = TaskManager.getInstance();
+ int taskCount = 0;
+ while (tok.hasMoreTokens()) {
+ task = tok.nextToken().trim();
+
+ // Check to see if we have task:listenerType
+ int idx = task.indexOf(":");
+ String type = null;
+ if (idx != -1) {
+ type = task.substring(idx + 1);
+ task = task.substring(0, idx);
+ }
+
+ // Register the Task...
+ tm.addTask(task, type, new DeferredFragmentTaskListener(comp));
+
+ // Count the tasks we depend on...
+ taskCount++;
+ }
+
+ // Store the task count...
+ comp.setTaskCount(taskCount);
+
+ // Ensure we have a FragmentRenderer component...
+ Map requestScope =
+ ctx.getExternalContext().getRequestMap();
+ FragmentRenderer fragmentRenderer =
+ (FragmentRenderer) requestScope.get(FRAGMENT_RENDERER);
+ if (fragmentRenderer == null) {
+ // Create one...
+ fragmentRenderer = new FragmentRenderer();
+ fragmentRenderer.setId(FRAGMENT_RENDERER);
+
+ // Store FragmentRenderer in request scope as well as the last
+ // component in the UIViewRoot. (request scope for fast access)
+ viewRoot.getChildren().add(fragmentRenderer);
+ requestScope.put(FRAGMENT_RENDERER, fragmentRenderer);
+ }
+
+ // Increment fragment count on FragmentRenderer component...
+ fragmentRenderer.addDeferredFragment(comp);
+ comp.addReadyListener(fragmentRenderer);
+ }
+
+ private boolean done = false;
+ private static final String FRAGMENT_RENDERER = "jsft-FR";
+ }
+
+ /**
+ * The component family.
+ */
+ public static final String FAMILY = DeferredFragment.class.getName();
+
+
+ /**
+ * The number of tasks that need to be complete before this
+ * DeferredFragment can be rendered. It is initialized
+ * to a postiive value (1) so that {@link #isReady()} will return
+ * false -- important since the tasks have not yet been
+ * counted.
+ */
+ private int taskCount = 1;
+
+ /**
+ * The id of the placeholder for this component so we can find it
+ * later.
+ */
+ private transient String placeHolderId = "";
+
+ /**
+ * This List will hold the list of listeners interested
+ * in being notified with this DeferredFragment is ready
+ * to be rendered.
+ */
+ private List listeners =
+ new ArrayList(2);
+}
diff --git a/jsft/src/main/java/com/sun/jsft/component/FragmentReadyEvent.java b/jsft/src/main/java/com/sun/jsft/component/FragmentReadyEvent.java
new file mode 100644
index 0000000..018d19b
--- /dev/null
+++ b/jsft/src/main/java/com/sun/jsft/component/FragmentReadyEvent.java
@@ -0,0 +1,58 @@
+/*
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
+ *
+ * Copyright (c) 2011 Oracle and/or its affiliates. All rights reserved.
+ * Portions Copyright (c) 2011 Ken Paulsen
+ *
+ * The contents of this file are subject to the terms of either the GNU
+ * General Public License Version 2 only ("GPL") or the Common Development
+ * and Distribution License("CDDL") (collectively, the "License"). You
+ * may not use this file except in compliance with the License. You can
+ * obtain a copy of the License at
+ * https://glassfish.dev.java.net/public/CDDL+GPL_1_1.html
+ * or packager/legal/LICENSE.txt. See the License for the specific
+ * language governing permissions and limitations under the License.
+ *
+ * When distributing the software, include this License Header Notice in each
+ * file and include the License file at packager/legal/LICENSE.txt.
+ *
+ * GPL Classpath Exception:
+ * Oracle designates this particular file as subject to the "Classpath"
+ * exception as provided by Oracle in the GPL Version 2 section of the License
+ * file that accompanied this code.
+ *
+ * Modifications:
+ * If applicable, add the following below the License Header, with the fields
+ * enclosed by brackets [] replaced by your own identifying information:
+ * "Portions Copyright [year] [name of copyright owner]"
+ *
+ * Contributor(s):
+ * If you wish your version of this file to be governed by only the CDDL or
+ * only the GPL Version 2, indicate your decision by adding "[Contributor]
+ * elects to include this software in this distribution under the [CDDL or GPL
+ * Version 2] license." If you don't indicate a single choice of license, a
+ * recipient has the option to distribute your version of this file under
+ * either the CDDL, the GPL Version 2 or to extend the choice of license to
+ * its licensees as provided above. However, if you add GPL Version 2 code
+ * and therefore, elected the GPL Version 2 license, then the option applies
+ * only if the new code is made subject to such option by the copyright
+ * holder.
+ */
+
+package com.sun.jsft.component;
+
+import javax.faces.event.ComponentSystemEvent;
+
+
+/**
+ * This event is used for dispatching {@link Task} related events.
+ */
+public class FragmentReadyEvent extends ComponentSystemEvent {
+
+ /**
+ * Constructor.
+ */
+ public FragmentReadyEvent(DeferredFragment source) {
+ super(source);
+ }
+}
diff --git a/jsft/src/main/java/com/sun/jsft/component/FragmentRenderer.java b/jsft/src/main/java/com/sun/jsft/component/FragmentRenderer.java
new file mode 100644
index 0000000..06c6d26
--- /dev/null
+++ b/jsft/src/main/java/com/sun/jsft/component/FragmentRenderer.java
@@ -0,0 +1,198 @@
+/*
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
+ *
+ * Copyright (c) 2011 Oracle and/or its affiliates. All rights reserved.
+ * Portions Copyright (c) 2011 Ken Paulsen
+ *
+ * The contents of this file are subject to the terms of either the GNU
+ * General Public License Version 2 only ("GPL") or the Common Development
+ * and Distribution License("CDDL") (collectively, the "License"). You
+ * may not use this file except in compliance with the License. You can
+ * obtain a copy of the License at
+ * https://glassfish.dev.java.net/public/CDDL+GPL_1_1.html
+ * or packager/legal/LICENSE.txt. See the License for the specific
+ * language governing permissions and limitations under the License.
+ *
+ * When distributing the software, include this License Header Notice in each
+ * file and include the License file at packager/legal/LICENSE.txt.
+ *
+ * GPL Classpath Exception:
+ * Oracle designates this particular file as subject to the "Classpath"
+ * exception as provided by Oracle in the GPL Version 2 section of the License
+ * file that accompanied this code.
+ *
+ * Modifications:
+ * If applicable, add the following below the License Header, with the fields
+ * enclosed by brackets [] replaced by your own identifying information:
+ * "Portions Copyright [year] [name of copyright owner]"
+ *
+ * Contributor(s):
+ * If you wish your version of this file to be governed by only the CDDL or
+ * only the GPL Version 2, indicate your decision by adding "[Contributor]
+ * elects to include this software in this distribution under the [CDDL or GPL
+ * Version 2] license." If you don't indicate a single choice of license, a
+ * recipient has the option to distribute your version of this file under
+ * either the CDDL, the GPL Version 2 or to extend the choice of license to
+ * its licensees as provided above. However, if you add GPL Version 2 code
+ * and therefore, elected the GPL Version 2 license, then the option applies
+ * only if the new code is made subject to such option by the copyright
+ * holder.
+ */
+
+package com.sun.jsft.component;
+
+import com.sun.jsft.tasks.TaskManager;
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+import java.util.Queue;
+import java.util.StringTokenizer;
+import java.util.concurrent.ConcurrentLinkedQueue;
+import javax.faces.component.UIComponent;
+import javax.faces.component.UIComponentBase;
+import javax.faces.component.UIOutput;
+import javax.faces.component.UIViewRoot;
+import javax.faces.context.FacesContext;
+import javax.faces.event.AbortProcessingException;
+import javax.faces.event.ComponentSystemEvent;
+import javax.faces.event.ComponentSystemEventListener;
+import javax.faces.event.ListenerFor;
+import javax.faces.event.PostAddToViewEvent;
+
+
+/**
+ *
+ */
+public class FragmentRenderer extends UIComponentBase implements ComponentSystemEventListener {
+
+ /**
+ * Default constructor.
+ */
+ public FragmentRenderer() {
+ }
+
+ /**
+ *
+ */
+ public String getFamily() {
+ return FAMILY;
+ }
+
+ /**
+ *
+ */
+ public boolean getRendersChildren() {
+ return true;
+ }
+
+ public void encodeBegin(FacesContext context) throws IOException {
+ System.out.println("Starting FragmentRenderer...");
+ // Start processing the Tasks...
+ TaskManager.getInstance().start();
+ }
+
+ public void encodeChildren(FacesContext context) throws IOException {
+ // It should have no children... do nothing...
+ }
+
+ public void encodeEnd(FacesContext context) throws IOException {
+ // Render fragments as they become ready.
+ fragsToRender = getFragmentCount();
+ DeferredFragment comp = null;
+ while (fragsToRender > 0) {
+ synchronized (renderQueue) {
+ if (renderQueue.isEmpty()) {
+ try {
+ // Wait at most 30 seconds...
+ renderQueue.wait(30 * 1000);
+ if (renderQueue.isEmpty()) {
+ System.out.println("EMPTY QUEUE!");
+ return;
+ }
+ } catch (InterruptedException ex) {
+ System.out.println("Interrupted!");
+ return;
+ }
+ }
+ comp = renderQueue.poll();
+ }
+ if (comp != null) {
+ fragsToRender--;
+ try {
+System.out.println("Encoding: " + comp.getId());
+ comp.encodeAll(FacesContext.getCurrentInstance());
+ } catch (Exception ex) {
+ // FIXME: cleanup
+ ex.printStackTrace();
+ }
+ }
+ }
+
+ System.out.println("Ending FragmentRenderer..." + fragsToRender);
+ }
+
+ /**
+ * This method returns the number of tasks this DeferredFragment is
+ * waiting for.
+ */
+ public int getFragmentCount() {
+ return fragments.size();
+ }
+
+ /**
+ * This method adds the given {@link DeferredFragment} to the
+ * List of fragments that are to be processed by this
+ * FragmentRenderer.
+ */
+ public void addDeferredFragment(DeferredFragment fragment) {
+ fragments.add(fragment);
+ }
+
+
+ /**
+ * This method gets invoked whenever a DeferredFragment associated
+ * with this component becomes ready to be rendered.
+ */
+ public void processEvent(ComponentSystemEvent event) throws AbortProcessingException {
+ // Get the component
+ processDeferredFragment((DeferredFragment) event.getComponent());
+ }
+
+ /**
+ *
+ */
+ private void processDeferredFragment(DeferredFragment comp) {
+ // Find the "place-holder" component...
+ String key = ":" + comp.getPlaceHolderId();
+ UIComponent placeHolder = comp.findComponent(key);
+ if (placeHolder != null) {
+ // This "should" always be the case... swap it back.
+ List peers = placeHolder.getParent().getChildren();
+ int index = peers.indexOf(placeHolder);
+ peers.set(index, comp);
+ }
+
+ // Queue it up...
+ synchronized (renderQueue) {
+ renderQueue.add(comp);
+ renderQueue.notifyAll();
+ }
+ }
+
+
+ /**
+ * A count of remaining fragments to render.
+ */
+ private transient int fragsToRender = 1;
+
+ private transient List fragments =
+ new ArrayList();
+
+ private transient Queue renderQueue = new ConcurrentLinkedQueue();
+
+ /**
+ * The component family.
+ */
+ public static final String FAMILY = FragmentRenderer.class.getName();
+}
diff --git a/jsft/src/main/java/com/sun/jsft/event/Command.java b/jsft/src/main/java/com/sun/jsft/event/Command.java
new file mode 100644
index 0000000..915b3c9
--- /dev/null
+++ b/jsft/src/main/java/com/sun/jsft/event/Command.java
@@ -0,0 +1,154 @@
+/*
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
+ *
+ * Copyright (c) 2011 Oracle and/or its affiliates. All rights reserved.
+ * Portions Copyright (c) 2011 Ken Paulsen
+ *
+ * The contents of this file are subject to the terms of either the GNU
+ * General Public License Version 2 only ("GPL") or the Common Development
+ * and Distribution License("CDDL") (collectively, the "License"). You
+ * may not use this file except in compliance with the License. You can
+ * obtain a copy of the License at
+ * https://glassfish.dev.java.net/public/CDDL+GPL_1_1.html
+ * or packager/legal/LICENSE.txt. See the License for the specific
+ * language governing permissions and limitations under the License.
+ *
+ * When distributing the software, include this License Header Notice in each
+ * file and include the License file at packager/legal/LICENSE.txt.
+ *
+ * GPL Classpath Exception:
+ * Oracle designates this particular file as subject to the "Classpath"
+ * exception as provided by Oracle in the GPL Version 2 section of the License
+ * file that accompanied this code.
+ *
+ * Modifications:
+ * If applicable, add the following below the License Header, with the fields
+ * enclosed by brackets [] replaced by your own identifying information:
+ * "Portions Copyright [year] [name of copyright owner]"
+ *
+ * Contributor(s):
+ * If you wish your version of this file to be governed by only the CDDL or
+ * only the GPL Version 2, indicate your decision by adding "[Contributor]
+ * elects to include this software in this distribution under the [CDDL or GPL
+ * Version 2] license." If you don't indicate a single choice of license, a
+ * recipient has the option to distribute your version of this file under
+ * either the CDDL, the GPL Version 2 or to extend the choice of license to
+ * its licensees as provided above. However, if you add GPL Version 2 code
+ * and therefore, elected the GPL Version 2 license, then the option applies
+ * only if the new code is made subject to such option by the copyright
+ * holder.
+ */
+
+package com.sun.jsft.event;
+
+import java.io.Serializable;
+import java.util.Iterator;
+import java.util.List;
+
+import javax.faces.event.AbortProcessingException;
+
+
+/**
+ * This class represents a Command.
+ *
+ * Created March 31, 2011
+ * @author Ken Paulsen kenapaulsen@gmail.com
+ */
+public abstract class Command implements Serializable {
+
+ /**
+ * Default constructor needed for serialization.
+ */
+ public Command() {
+ }
+
+ /**
+ * Constructor which sets the child commands.
+ */
+ public Command(List children, Command elseCommand) {
+ setChildCommands(children);
+ setElseCommand(elseCommand);
+ }
+
+ /**
+ * This is the method responsible for performing the action. It is
+ * also responsible for invoking any of its child commands.
+ */
+ public abstract Object invoke() throws AbortProcessingException;
+
+ /**
+ * This getter method retrieves the command to be invoked if this
+ * command has an "else" clause. In most cases this will return
+ * null.
+ */
+ public Command getElseCommand() {
+ return this.elseCommand;
+ }
+
+ /**
+ * Returns a reference to list of child commands. Note, there is
+ * nothing to stop you from modifying this list... however, it is
+ * strongly discouraged and may lead to problems.
+ */
+ public List getChildCommands() {
+ return childCommands;
+ }
+
+ /**
+ * This method is a useful helper utility for invoking the child
+ * {@link Command}s.
+ */
+ public void invokeChildCommands() {
+ if (this.childCommands != null) {
+ for (Command childCommand : this.childCommands) {
+ childCommand.invoke();
+ }
+ }
+ }
+
+ /**
+ * Print out the ELCommand.
+ */
+ @Override
+ public String toString() {
+ StringBuilder buf = new StringBuilder("");
+ if (childCommands != null) {
+ buf.append("{\n");
+ Iterator it = childCommands.iterator();
+ while (it.hasNext()) {
+ buf.append(it.next().toString());
+ }
+ buf.append("}\n");
+ } else {
+ buf.append(";\n");
+ }
+ return buf.toString();
+ }
+
+ /**
+ *
+ */
+ private void setChildCommands(List commands) {
+ this.childCommands = commands;
+ }
+
+ /**
+ * This setter method stores the command to be invoked if this
+ * command has an "else" clause.
+ */
+ private void setElseCommand(Command command) {
+ this.elseCommand = command;
+ }
+
+
+ /**
+ * This is the request scoped key which will store the child
+ * {@link Command} for the currently executing {@link Command}.
+ */
+ public static final String COMMAND_KEY = "jsftCommand";
+
+ private static final long serialVersionUID = 6945415932011238909L;
+
+ private List childCommands = null;
+ private Command elseCommand = null;
+}
diff --git a/jsft/src/main/java/com/sun/jsft/event/CommandEventListener.java b/jsft/src/main/java/com/sun/jsft/event/CommandEventListener.java
new file mode 100644
index 0000000..7f7a019
--- /dev/null
+++ b/jsft/src/main/java/com/sun/jsft/event/CommandEventListener.java
@@ -0,0 +1,140 @@
+/*
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
+ *
+ * Copyright (c) 2011 Oracle and/or its affiliates. All rights reserved.
+ * Portions Copyright (c) 2011 Ken Paulsen
+ *
+ * The contents of this file are subject to the terms of either the GNU
+ * General Public License Version 2 only ("GPL") or the Common Development
+ * and Distribution License("CDDL") (collectively, the "License"). You
+ * may not use this file except in compliance with the License. You can
+ * obtain a copy of the License at
+ * https://glassfish.dev.java.net/public/CDDL+GPL_1_1.html
+ * or packager/legal/LICENSE.txt. See the License for the specific
+ * language governing permissions and limitations under the License.
+ *
+ * When distributing the software, include this License Header Notice in each
+ * file and include the License file at packager/legal/LICENSE.txt.
+ *
+ * GPL Classpath Exception:
+ * Oracle designates this particular file as subject to the "Classpath"
+ * exception as provided by Oracle in the GPL Version 2 section of the License
+ * file that accompanied this code.
+ *
+ * Modifications:
+ * If applicable, add the following below the License Header, with the fields
+ * enclosed by brackets [] replaced by your own identifying information:
+ * "Portions Copyright [year] [name of copyright owner]"
+ *
+ * Contributor(s):
+ * If you wish your version of this file to be governed by only the CDDL or
+ * only the GPL Version 2, indicate your decision by adding "[Contributor]
+ * elects to include this software in this distribution under the [CDDL or GPL
+ * Version 2] license." If you don't indicate a single choice of license, a
+ * recipient has the option to distribute your version of this file under
+ * either the CDDL, the GPL Version 2 or to extend the choice of license to
+ * its licensees as provided above. However, if you add GPL Version 2 code
+ * and therefore, elected the GPL Version 2 license, then the option applies
+ * only if the new code is made subject to such option by the copyright
+ * holder.
+ */
+
+package com.sun.jsft.event;
+
+import java.util.List;
+import javax.faces.context.FacesContext;
+import javax.faces.event.AbortProcessingException;
+import javax.faces.event.ComponentSystemEvent;
+import javax.faces.event.ComponentSystemEventListener;
+
+
+/**
+ * This class handles the dispatching of events to commands. Currently
+ * Commands delegate execution to EL. In the future, other Command types
+ * may be supported.
+ *
+ * Created March 29, 2011
+ * @author Ken Paulsen (kenapaulsen@gmail.com)
+ */
+public class CommandEventListener extends Command implements ComponentSystemEventListener {
+
+ /**
+ * Default constructor needed for serialization.
+ */
+ public CommandEventListener() {
+ }
+
+ /**
+ * Primary constructor used. It is neeeded in order to supply a list
+ * of commands.
+ */
+ public CommandEventListener(List commands) {
+ super(commands, null);
+ }
+
+ /**
+ * This method is responsible for dispatching the event to the various
+ * EL expressions that are listening to this event. It also stores
+ * the Event object in request scope under the key "theEvent" so that
+ * it can be accessed easiliy via EL. For example:
+ * util.println(theEvent);
+ */
+ public void processEvent(ComponentSystemEvent event) throws AbortProcessingException {
+
+ // Store the event under the key "theEvent" in case we want to access
+ // it for some reason.
+ FacesContext.getCurrentInstance().getExternalContext().getRequestMap().
+ put("theEvent", event);
+
+ // Execute the child commands
+ invoke();
+ }
+
+ /**
+ * This is the method responsible for performing the action. It is
+ * also responsible for invoking any of its child commands.
+ */
+ public Object invoke() throws AbortProcessingException {
+ // Invoke the child commands...
+ invokeChildCommands();
+
+ return null;
+ }
+
+ @Override
+ public boolean equals(Object obj) {
+ if (this == obj) {
+ return true;
+ }
+ if ((obj == null) || (getClass() != obj.getClass())) {
+ return false;
+ }
+
+ CommandEventListener that = (CommandEventListener) obj;
+
+ if (hashCode() != that.hashCode()) {
+ return false;
+ }
+
+ return true;
+ }
+
+ @Override
+ public int hashCode() {
+ if (hash == -1) {
+ StringBuilder builder = new StringBuilder("");
+ List commands = getChildCommands();
+ if (commands != null) {
+ for (Command command : commands) {
+ builder.append(command.toString());
+ }
+ }
+ hash = builder.toString().hashCode();
+ }
+ return hash;
+ }
+
+
+ private transient int hash = -1;
+ private static final long serialVersionUID = 6945415935164238909L;
+}
diff --git a/jsft/src/main/java/com/sun/jsft/event/ELCommand.java b/jsft/src/main/java/com/sun/jsft/event/ELCommand.java
new file mode 100644
index 0000000..3ded561
--- /dev/null
+++ b/jsft/src/main/java/com/sun/jsft/event/ELCommand.java
@@ -0,0 +1,169 @@
+/*
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
+ *
+ * Copyright (c) 2011 Oracle and/or its affiliates. All rights reserved.
+ * Portions Copyright (c) 2011 Ken Paulsen
+ *
+ * The contents of this file are subject to the terms of either the GNU
+ * General Public License Version 2 only ("GPL") or the Common Development
+ * and Distribution License("CDDL") (collectively, the "License"). You
+ * may not use this file except in compliance with the License. You can
+ * obtain a copy of the License at
+ * https://glassfish.dev.java.net/public/CDDL+GPL_1_1.html
+ * or packager/legal/LICENSE.txt. See the License for the specific
+ * language governing permissions and limitations under the License.
+ *
+ * When distributing the software, include this License Header Notice in each
+ * file and include the License file at packager/legal/LICENSE.txt.
+ *
+ * GPL Classpath Exception:
+ * Oracle designates this particular file as subject to the "Classpath"
+ * exception as provided by Oracle in the GPL Version 2 section of the License
+ * file that accompanied this code.
+ *
+ * Modifications:
+ * If applicable, add the following below the License Header, with the fields
+ * enclosed by brackets [] replaced by your own identifying information:
+ * "Portions Copyright [year] [name of copyright owner]"
+ *
+ * Contributor(s):
+ * If you wish your version of this file to be governed by only the CDDL or
+ * only the GPL Version 2, indicate your decision by adding "[Contributor]
+ * elects to include this software in this distribution under the [CDDL or GPL
+ * Version 2] license." If you don't indicate a single choice of license, a
+ * recipient has the option to distribute your version of this file under
+ * either the CDDL, the GPL Version 2 or to extend the choice of license to
+ * its licensees as provided above. However, if you add GPL Version 2 code
+ * and therefore, elected the GPL Version 2 license, then the option applies
+ * only if the new code is made subject to such option by the copyright
+ * holder.
+ */
+
+package com.sun.jsft.event;
+
+import com.sun.jsft.util.Util;
+
+import java.util.List;
+import javax.el.ELContext;
+import javax.el.ExpressionFactory;
+import javax.el.ValueExpression;
+import javax.faces.context.FacesContext;
+import javax.faces.event.AbortProcessingException;
+
+
+/**
+ * This class represents a Command that is processed via Unified EL.
+ *
+ * Created March 31, 2011
+ * @author Ken Paulsen (kenapaulsen@gmail.com)
+ */
+public class ELCommand extends Command {
+
+ /**
+ * Default constructor needed for serialization.
+ */
+ public ELCommand() {
+ }
+
+ /**
+ * This constructor should be used to create a new
+ * ELCommand instance. It expects to be passed an
+ * expression, and optionally a List<Command> that represent
+ * child commands.
+ *
+ * FIXME: Add more documentation on how this works...
+ */
+ public ELCommand(String resultVar, String el, List childCommands, Command elseCommand) {
+ super(childCommands, elseCommand);
+ this.resultVar = resultVar;
+ this.el = el;
+ }
+
+ /**
+ * This method is responsible for dispatching the event to the various
+ * EL expressions that are listening to this event. It also stores
+ * the Event object in request scope under the key "theEvent" so that
+ * it can be accessed easiliy via EL. For example:
+ * util.println(theEvent);
+ */
+ public Object invoke() throws AbortProcessingException {
+ FacesContext ctx = FacesContext.getCurrentInstance();
+ ELContext elCtx = ctx.getELContext();
+
+ // Store the Command for access inside the expression.
+ // This is useful for loops or other commands which need access to
+ // their child Commands.
+ ctx.getExternalContext().getRequestMap().put(COMMAND_KEY, this);
+
+ // Create expression
+ ExpressionFactory fact = ctx.getApplication().getExpressionFactory();
+ ValueExpression ve = null;
+ Object result = null;
+ if (this.el.length() > 0) {
+ ve = fact.createValueExpression(
+ elCtx, "#{" + this.el + "}", Object.class);
+ // Execute expression
+ result = ve.getValue(elCtx);
+
+ // If we should store the result... do it.
+ if (this.resultVar != null) {
+ ve = fact.createValueExpression(
+ elCtx, "#{" + this.resultVar + "}", Object.class);
+ ve.setValue(elCtx, result);
+ }
+ } else {
+ // Do this since we have no command to execute (which is normally
+ // responsible for doing this)
+ invokeChildCommands();
+ }
+ return result;
+ }
+
+ /**
+ * Print out the ELCommand.
+ */
+ @Override
+ public String toString() {
+ StringBuilder buf = new StringBuilder(el);
+ buf.append(super.toString());
+ return buf.toString();
+ }
+
+ @Override
+ public boolean equals(Object obj) {
+ if (this == obj) {
+ return true;
+ }
+ if ((obj == null) || (getClass() != obj.getClass())) {
+ return false;
+ }
+
+ ELCommand that = (ELCommand) obj;
+
+ if (hashCode() == that.hashCode()) {
+ return true;
+ }
+
+ return false;
+ }
+
+ @Override
+ public int hashCode() {
+ if (hash == -1) {
+ StringBuilder builder = new StringBuilder(el);
+ List children = getChildCommands();
+ if (children != null) {
+ for (Command command : children) {
+ builder.append(command.toString());
+ }
+ }
+ hash = builder.toString().hashCode();
+ }
+ return hash;
+ }
+
+ private String resultVar = null;
+ private String el = null;
+ private transient int hash = -1;
+ private static final long serialVersionUID = 6201115935174238909L;
+}
diff --git a/jsft/src/main/java/com/sun/jsft/facelets/CommandParser.java b/jsft/src/main/java/com/sun/jsft/facelets/CommandParser.java
new file mode 100644
index 0000000..ccc5c02
--- /dev/null
+++ b/jsft/src/main/java/com/sun/jsft/facelets/CommandParser.java
@@ -0,0 +1,482 @@
+/*
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
+ *
+ * Copyright (c) 2011 Oracle and/or its affiliates. All rights reserved.
+ * Portions Copyright (c) 2011 Ken Paulsen
+ *
+ * The contents of this file are subject to the terms of either the GNU
+ * General Public License Version 2 only ("GPL") or the Common Development
+ * and Distribution License("CDDL") (collectively, the "License"). You
+ * may not use this file except in compliance with the License. You can
+ * obtain a copy of the License at
+ * https://glassfish.dev.java.net/public/CDDL+GPL_1_1.html
+ * or packager/legal/LICENSE.txt. See the License for the specific
+ * language governing permissions and limitations under the License.
+ *
+ * When distributing the software, include this License Header Notice in each
+ * file and include the License file at packager/legal/LICENSE.txt.
+ *
+ * GPL Classpath Exception:
+ * Oracle designates this particular file as subject to the "Classpath"
+ * exception as provided by Oracle in the GPL Version 2 section of the License
+ * file that accompanied this code.
+ *
+ * Modifications:
+ * If applicable, add the following below the License Header, with the fields
+ * enclosed by brackets [] replaced by your own identifying information:
+ * "Portions Copyright [year] [name of copyright owner]"
+ *
+ * Contributor(s):
+ * If you wish your version of this file to be governed by only the CDDL or
+ * only the GPL Version 2, indicate your decision by adding "[Contributor]
+ * elects to include this software in this distribution under the [CDDL or GPL
+ * Version 2] license." If you don't indicate a single choice of license, a
+ * recipient has the option to distribute your version of this file under
+ * either the CDDL, the GPL Version 2 or to extend the choice of license to
+ * its licensees as provided above. However, if you add GPL Version 2 code
+ * and therefore, elected the GPL Version 2 license, then the option applies
+ * only if the new code is made subject to such option by the copyright
+ * holder.
+ */
+
+package com.sun.jsft.facelets;
+
+import java.io.BufferedInputStream;
+import java.io.BufferedReader;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.InputStreamReader;
+import java.util.Stack;
+
+import com.sun.jsft.util.LogUtil;
+
+
+/**
+ * This class is responsible for the actual parsing of a template.
+ *
+ * This class is intended to read the template one time. Often it may be
+ * useful to cache the result as it would be inefficient to reread a
+ * template multiple times. Templates that are generated from this class
+ * are intended to be static and safe to share. However, this class
+ * itself is not thread safe.
+ *
+ * @author Ken Paulsen (kenapaulsen@gmail.com)
+ */
+public class CommandParser {
+
+ /**
+ * Constructor which accepts a InputStream.
+ *
+ * @param stream InputStream for the template.
+ */
+ public CommandParser(InputStream stream) {
+ _inputStream = stream;
+ }
+
+ /**
+ * Accessor for the InputStream. This comes from
+ * the supplied InputStream.
+ */
+ public InputStream getInputStream() throws IOException {
+ return _inputStream;
+ }
+
+ /**
+ * Creates the Reader Object.
+ *
+ * @throws IOException
+ */
+ public void open() throws IOException {
+ if (_reader != null) {
+ // Generally this should not happen, but just in case... start over
+ close();
+ }
+
+// FIXME: It is possible while evaluating the file an #include may need to log a message to the screen! Provide a callback mechanism to do this in a Template-specific way
+ // Create the reader from the stream
+ _reader = new BufferedReader(
+ new InputStreamReader(
+ new BufferedInputStream(getInputStream())));
+
+ // Initialize the queue we will use to push values back
+ _stack = new Stack();
+ }
+
+ /**
+ * This method closes the stream if it is open. It doesn't throw an
+ * exception, instead it logs any exceptions at the CONFIG level.
+ */
+ public void close() {
+ try {
+ if (_reader != null) {
+ _reader.close();
+ }
+ } catch (Exception ex) {
+ if (LogUtil.configEnabled(this)) {
+ LogUtil.config("Exception while closing stream.", ex);
+ }
+ }
+ }
+
+ /**
+ * This method returns the next character.
+ */
+ public int nextChar() throws IOException {
+ if (!_stack.empty()) {
+ // We have values in the queue
+ return _stack.pop().charValue();
+ }
+ return _reader.read();
+ }
+
+ /**
+ * This method pushes a character on the read queue so that it will
+ * be read next.
+ */
+ public void unread(int ch) {
+ _stack.push(new Character((char) ch));
+ }
+
+ /**
+ * This method returns a String of characters from the
+ * current position in the file until the given character (or end of
+ * file) is encountered. It will leave the given character in the
+ * buffer, so the next character to be read will be the
+ * endingChar or -1.
+ *
+ * @param endingChar The character to read up to, but not including
+ * @param skipComments true to strip comments.
+ */
+ public String readUntil(int endingChar, boolean skipComments) throws IOException {
+ return readUntil(new int[] {endingChar}, skipComments);
+ }
+
+ /**
+ *
+ */
+ public String readUntil(int[] endingChars, boolean skipComments) throws IOException {
+ if (skipComments) {
+ // In case we start on a comment and should skip it...
+ skipCommentsAndWhiteSpace("");
+ }
+ int tmpch;
+ int next = nextChar();
+ StringBuffer buf = new StringBuffer();
+ while (!isInArray(endingChars, next) && (next != -1)) {
+ switch (next) {
+ case '\'' :
+ case '\"' :
+ if (skipComments) {
+ // In this case, we want to make sure no comments are
+ // skipped when inside a quote
+ //
+ // NOTE: Also means endingChars will not be found in
+ // a quote.
+ buf.append((char) next);
+ buf.append(readUntil(next, false));
+ buf.append((char) next);
+ nextChar(); // Throw away the last char read...
+ } else {
+ buf.append((char) next);
+ }
+ break;
+ case '#' :
+ case '/' :
+ case '<' :
+ // When reading we want to ignore comments, don't skip
+ // whitespace, though...
+ if (skipComments) {
+ unread(next);
+ skipCommentsAndWhiteSpace("");
+ // If same char, read next to prevent infinite loop
+ // We don't have to go through switch again b/c its
+ // not the ending char and its not escaped -- so it is
+ // safe to add.
+ tmpch = nextChar();
+ if (next == tmpch) {
+ buf.append((char) next);
+ } else {
+ // We're somewhere different, unread
+ unread(tmpch);
+ }
+ } else {
+ buf.append((char) next);
+ }
+ break;
+ case '\\' :
+ // Escape Character...
+ next = nextChar();
+ if (next == 'n') {
+ // Special case, insert a '\n' character.
+ buf.append('\n');
+ } else if (next == 't') {
+ // Special case, insert a '\t' character.
+ buf.append('\t');
+ } else if (next != '\n') {
+ // add the next char unless it's a return char
+ buf.append((char) next);
+ }
+ break;
+ default:
+ buf.append((char) next);
+ break;
+ }
+ next = nextChar();
+ }
+ if (next != -1) {
+ unread(next);
+ }
+
+ // Return the result
+ return buf.toString();
+ }
+
+ /**
+ * This method returns a String of characters from the
+ * current position in the file until the given String (or end of
+ * file) is encountered. It will not leave the given String in the
+ * buffer, so the next character to be read will be the character
+ * following the given character.
+ *
+ * @param endingStr The terminating String.
+ * @param skipComments true to ignore comments.
+ */
+ public String readUntil(String endingStr, boolean skipComments) throws IOException {
+ // Sanity Check
+ if ((endingStr == null) || (endingStr.length() == 0)) {
+ return "";
+ }
+
+ // Break String into characters
+ char arr[] = endingStr.toCharArray();
+ int arrlen = arr.length;
+
+ StringBuffer buf = new StringBuffer("");
+ int ch = nextChar(); // Read a char to unread
+ int idx = 1;
+ do {
+ // We didn't find the end, push read values back on queue
+ unread(ch);
+ for (int cnt = idx-1; cnt > 0; cnt--) {
+ unread(arr[cnt]);
+ }
+
+ // Read until the beginning of the end (maybe)
+ buf.append(readUntil(arr[0], skipComments));
+ //buf.append(arr[0]); // readUntil reads but doesn't return this char
+
+ // Check to see if we are at the end
+ for (idx = 1; idx < arrlen; idx++) {
+ ch = nextChar();
+ if (ch != arr[idx]) {
+ // This is not the end!
+ break;
+ }
+ }
+ } while ((ch != -1) && (idx < arrlen));
+
+ // Append the remaining characters (use idx in case we hit eof)...
+ for (int cnt = 1; cnt < idx; cnt++) {
+ buf.append(arr[cnt]);
+ }
+
+ if (arrlen != idx) {
+ // Didn't find it!
+ throw new IllegalStateException("Unable to find: '" + endingStr
+ + "'. Read to EOF and gave up. Read: \n" + buf.toString());
+ }
+
+ // Return the result
+ return buf.toString();
+ }
+
+ /**
+ * This method skips the given String of characters (usually used to
+ * skip white space. The contents of the String that is skipped is
+ * lost. Often you may wish to skip comments as well, use
+ * {@link CommandParser#skipCommentsAndWhiteSpace(String)} in this
+ * case.
+ *
+ * @param skipChars The white space characters to skip.
+ *
+ * @see CommandParser#skipCommentsAndWhiteSpace(String)
+ */
+ public void skipWhiteSpace(String skipChars) throws IOException {
+ int next = nextChar();
+ while ((next != -1) && (skipChars.indexOf(next) != -1)) {
+ // Skip...
+ next = nextChar();
+ }
+
+ // This will skip one too many
+ unread(next);
+ }
+
+ /**
+ * Normally you don't just want to skip white space, you also want to
+ * skip comments. This method allows you to do that. It skips
+ * comments of the following types:
+ *
+ *
+ * - // - Comment extends to the rest of the line.
+ * - # - Comment extends to the rest of the line.
+ * - /* - Comment extends until closing '*' and '/'.
+ * - <!-- - Comment extends until closing -->.
+ *
+ *
+ * @param skipChars The white space characters to skip
+ *
+ * @see CommandParser#skipWhiteSpace(String)
+ */
+ public void skipCommentsAndWhiteSpace(String skipChars) throws IOException {
+ int ch = 0;
+ while (ch != -1) {
+ ch = nextChar();
+ switch (ch) {
+ case '#' :
+ // Skip rest of line
+ readLine();
+ break;
+ case '/' :
+ ch = nextChar();
+ if (ch == '/') {
+ // Skip rest of line
+ readLine();
+ } else if (ch == '*') {
+ // Throw away everything until '*' & '/'.
+ readUntil("*/", false);
+ nextChar(); // Throw away the last char read...
+ } else {
+ // Not a comment, don't read
+ unread(ch);
+ unread('/');
+ ch = -1; // Exit loop
+ }
+ break;
+ case '<' :
+ ch = nextChar(); // !
+ if (ch == '!') {
+ ch = nextChar(); // -
+ if (ch == '-') {
+ ch = nextChar(); // -
+ if (ch == '-') {
+ // Ignore HTML-style comment
+ readUntil("-->", false);
+ nextChar(); // Throw away the last char read...
+ } else {
+ // Not a comment, probably a mistake... lets
+ // throw an exception
+ unread(ch);
+ unread('-');
+ unread('!');
+ unread('<');
+ throw new IllegalArgumentException("Invalid "
+ + "comment! Expected comment to begin "
+ + "with \"
+
+
+
+
+
+ http://jsftemplating.java.net/jsft
+
+
+ event
+ com.sun.jsft.facelets.EventHandler
+
+ Name of the event for which to install a listener. The
+ following table lists the valid values for this attribute,
+ and the corresponding event type for which the listener
+ action is registered.
+
+
+ value for "type" tag attribute
+ Type of event sent to listener method preRenderComponent
+ javax.faces.event.PreRenderComponentEvent postAddToView
+ javax.faces.event.PostAddToViewEvent preValidate
+ javax.faces.event.PreValidateEvent postValidate
+ javax.faces.event.PostValidateEvent
+
+ In addition to these values, the fully qualified class
+ name of any java class that extends
+ javax.faces.event.ComponentSystemEvent may be
+ used as the value of the "type" attribute.
+
+ The listener that is registered will dipatch to the
+ expressions specified in the body of this element. Each
+ expression must be separated by a semicolon and need not
+ be enclosed in #{}.
+ ]]>
+ type
+ true
+ java.lang.String
+
+
+
+
+ deferredFragment
+
+ com.sun.jsft.component.fragment.DeferredFragment
+
+
+
+
diff --git a/jsftemplating-dt/pom.xml b/jsftemplating-dt/pom.xml
new file mode 100644
index 0000000..50f1c1f
--- /dev/null
+++ b/jsftemplating-dt/pom.xml
@@ -0,0 +1,77 @@
+
+
+
+
+ 4.0.0
+
+ com.sun.jsftemplating
+ jsftemplating-parent
+ 2.1.1-SNAPSHOT
+
+ jsftemplating-dt
+
+
+
+
+ org.apache.maven.plugins
+ maven-compiler-plugin
+
+ none
+
+
+
+ org.apache.felix
+ maven-bundle-plugin
+
+
+ bundle-manifest
+ process-classes
+
+ manifest
+
+
+
+
+
+
+
diff --git a/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/FormatDefinition.java b/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/FormatDefinition.java
new file mode 100644
index 0000000..f4b3576
--- /dev/null
+++ b/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/FormatDefinition.java
@@ -0,0 +1,44 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2007 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.annotation;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+
+/**
+ * This is the FormatDefinition Annotation. It is
+ * expected to exist on each
+ * {@link com.sun.jsftemplating.component.factory.ComponentFactory}.
+ * It must specify an identifier for the ComponentFactory
+ * so that it may be referenced when defining UIComponents
+ * in your template or code.
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@Retention(RetentionPolicy.SOURCE)
+@Target(ElementType.TYPE)
+public @interface FormatDefinition {
+}
diff --git a/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/FormatDefinitionAP.java b/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/FormatDefinitionAP.java
new file mode 100644
index 0000000..3191568
--- /dev/null
+++ b/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/FormatDefinitionAP.java
@@ -0,0 +1,129 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2007-2014 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.annotation;
+
+import java.io.File;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.PrintWriter;
+import java.io.StringWriter;
+import java.net.URL;
+import java.util.Enumeration;
+import java.util.Set;
+import javax.annotation.processing.AbstractProcessor;
+import javax.annotation.processing.RoundEnvironment;
+import javax.annotation.processing.SupportedAnnotationTypes;
+import javax.annotation.processing.SupportedSourceVersion;
+import javax.lang.model.SourceVersion;
+import javax.lang.model.element.AnnotationMirror;
+import javax.lang.model.element.Element;
+import javax.lang.model.element.TypeElement;
+import javax.tools.Diagnostic;
+import javax.tools.FileObject;
+import javax.tools.StandardLocation;
+
+/**
+ * A JSR 169 compliant annotation processor for FormatDefinition annotation
+ * This is required for JDK8+, since APT has been deprecated.
+ * @author Romain Grecourt
+ */
+@SupportedAnnotationTypes(value = {"com.sun.jsftemplating.annotation.FormatDefinition"})
+@SupportedSourceVersion(SourceVersion.RELEASE_6)
+public class FormatDefinitionAP extends AbstractProcessor {
+
+ public static final String FACTORY_FILE = "META-INF/jsftemplating/FormatDefinition.map";
+ private PrintWriter writer = null;
+ private boolean _setup = false;
+
+ private boolean setup() {
+ if (_setup) {
+ // Don't do setup more than once
+ return true;
+ }
+ try {
+ // Create factory mapping file
+ writer = getMapWriter();
+ } catch (IOException ex) {
+ StringWriter buf = new StringWriter();
+ ex.printStackTrace(new PrintWriter(buf));
+ processingEnv.getMessager().printMessage(
+ Diagnostic.Kind.ERROR,
+ String.format("Unable to write %s file while processing @FormatDefinition annotation %s",
+ FACTORY_FILE,
+ buf.toString()));
+ return false;
+ }
+ _setup = true;
+ return _setup;
+ }
+
+ private PrintWriter getMapWriter() throws IOException {
+ PrintWriter _writer = null;
+ ClassLoader cl = this.getClass().getClassLoader();
+ URL url;
+ for (Enumeration urls = cl.getResources(FACTORY_FILE);
+ urls.hasMoreElements() && (_writer == null);) {
+ url = urls.nextElement();
+ if ((url != null) && new File(url.getFile()).canRead()) {
+ // Append to the existing file...
+ _writer = new PrintWriter(new FileOutputStream(url.getFile(), true));
+ }
+ }
+ if (_writer == null) {
+ // File not found, create a new one...
+ FileObject fo = processingEnv.getFiler().createResource(
+ StandardLocation.CLASS_OUTPUT,
+ "",
+ FACTORY_FILE);
+ _writer = new PrintWriter(fo.openWriter());
+ return _writer;
+ }
+ return _writer;
+ }
+
+ @Override
+ public SourceVersion getSupportedSourceVersion() {
+ if (SourceVersion.latest().compareTo(SourceVersion.RELEASE_6) > 0) {
+ return SourceVersion.valueOf("RELEASE_7");
+ } else {
+ return SourceVersion.RELEASE_6;
+ }
+ }
+
+ @Override
+ public boolean process(Set annotations, RoundEnvironment roundEnv) {
+
+ setup();
+
+ for (Element decl : roundEnv.getElementsAnnotatedWith(FormatDefinition.class)) {
+ for (AnnotationMirror an : decl.getAnnotationMirrors()) {
+ writer.println(decl.toString());
+ }
+ }
+
+ if(_setup){
+ writer.close();
+ }
+ return roundEnv.processingOver();
+ }
+}
diff --git a/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/Handler.java b/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/Handler.java
new file mode 100644
index 0000000..1c8fd4a
--- /dev/null
+++ b/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/Handler.java
@@ -0,0 +1,51 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.annotation;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+
+/**
+ * This is the Handler Annotation. It is
+ * expected to exist on each
+ * {@link com.sun.jsftemplating.component.factory.ComponentFactory}.
+ * It must specify an identifier for the ComponentFactory
+ * so that it may be referenced when defining UIComponents
+ * in your template or code.
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@Retention(RetentionPolicy.SOURCE)
+@Target(ElementType.METHOD)
+public @interface Handler {
+ public String id();
+ public HandlerInput[] input() default {};
+ public HandlerOutput[] output() default {};
+
+ public static final String ID = "id";
+ public static final String INPUT = "input";
+ public static final String OUTPUT = "output";
+}
diff --git a/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/HandlerAP.java b/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/HandlerAP.java
new file mode 100644
index 0000000..0c459b2
--- /dev/null
+++ b/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/HandlerAP.java
@@ -0,0 +1,396 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006-2014 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.annotation;
+
+import java.io.File;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.PrintWriter;
+import java.io.StringWriter;
+import java.net.URL;
+import java.util.Enumeration;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import javax.annotation.processing.AbstractProcessor;
+import javax.annotation.processing.RoundEnvironment;
+import javax.annotation.processing.SupportedAnnotationTypes;
+import javax.annotation.processing.SupportedOptions;
+import javax.annotation.processing.SupportedSourceVersion;
+import javax.lang.model.SourceVersion;
+import javax.lang.model.element.AnnotationMirror;
+import javax.lang.model.element.AnnotationValue;
+import javax.lang.model.element.Element;
+import javax.lang.model.element.ExecutableElement;
+import javax.lang.model.element.Modifier;
+import javax.lang.model.element.TypeElement;
+import javax.lang.model.element.VariableElement;
+import javax.lang.model.util.SimpleElementVisitor6;
+import javax.tools.Diagnostic;
+import javax.tools.Diagnostic.Kind;
+import javax.tools.FileObject;
+import javax.tools.StandardLocation;
+
+/**
+ * A JSR 169 compliant annotation processor for Handler annotation
+ * This is required for JDK8+, since APT has been deprecated.
+ * @author Romain Grecourt
+ */
+@SupportedAnnotationTypes(value = {
+ "com.sun.jsftemplating.annotation.Handler",
+ "com.sun.jsftemplating.annotation.HandlerInput",
+ "com.sun.jsftemplating.annotation.HandlerOutput"})
+@SupportedSourceVersion(SourceVersion.RELEASE_6)
+@SupportedOptions(value = {
+ "AnnotationVerifier.Annotations",
+ "AnnotationVerifier.Baseclasses",
+ "AnnotationVerifier.ClassAnnotation.Mappings"})
+public class HandlerAP extends AbstractProcessor {
+
+// public static final String HANDLER_FILE = "Handler.map";
+ public static final String HANDLER_FILE = "META-INF/jsftemplating/Handler.map";
+ private PrintWriter writer = null;
+ private boolean _setup = false;
+ private Map handlers = new HashMap();
+
+ private boolean setup() {
+ if (_setup) {
+ // Don't do setup more than once
+ return true;
+ }
+ try {
+ // Create factory mapping file
+ writer = getMapWriter();
+ } catch (IOException ex) {
+ StringWriter buf = new StringWriter();
+ ex.printStackTrace(new PrintWriter(buf));
+ processingEnv.getMessager().printMessage(
+ Diagnostic.Kind.ERROR,
+ String.format("Unable to write %s file while processing @FormatDefinition annotation %s",
+ HANDLER_FILE,
+ buf.toString()));
+ return false;
+ }
+ _setup = true;
+ return _setup;
+ }
+
+ private PrintWriter getMapWriter() throws IOException {
+ PrintWriter _writer = null;
+ ClassLoader cl = this.getClass().getClassLoader();
+ URL url;
+ for (Enumeration urls = cl.getResources(HANDLER_FILE);
+ urls.hasMoreElements() && (_writer == null);) {
+ url = urls.nextElement();
+ if ((url != null) && new File(url.getFile()).canRead()) {
+ // Append to the existing file...
+ _writer = new PrintWriter(new FileOutputStream(url.getFile(), true));
+ }
+ }
+ if (_writer == null) {
+ // File not found, create a new one...
+ FileObject fo = processingEnv.getFiler().createResource(
+ StandardLocation.CLASS_OUTPUT,
+ "",
+ HANDLER_FILE);
+ _writer = new PrintWriter(fo.openWriter());
+ return _writer;
+ }
+ return _writer;
+ }
+
+ private static final class ElementVisitor extends SimpleElementVisitor6 {
+
+ @Override
+ public TypeElement visitType(TypeElement e, Void p) {
+ return e;
+ }
+ }
+
+ private static final class ExecutableElementVisitor extends SimpleElementVisitor6 {
+
+ @Override
+ public ExecutableElement visitExecutable(ExecutableElement e, Void p) {
+ return e;
+ }
+ }
+
+ private static TypeElement getTypeElement(Element elt) {
+ return elt.accept(new ElementVisitor(), null);
+ }
+
+ private static TypeElement getDeclaringTypeElement(Element elt) {
+ return getTypeElement(elt.getEnclosingElement());
+ }
+
+ private String getJavadocComments(Element elt) {
+ return processingEnv.getElementUtils().getDocComment(elt);
+ }
+
+ /**
+ *
+ * This is a helper method that writes out property lines to represent
+ * either a HandlerInput or a HandlerOutput. The type
+ * that is passed in is expected to be either input or
+ * output.
+ */
+ private void writeIOProperties(String id, String type, List ioList) {
+ int cnt = 0;
+ for (AnnotationValue ioVal : ioList) {
+ // Process each @HandlerInput annotation...
+ for (Map.Entry prop
+ : ((AnnotationMirror) ioVal.getValue()).getElementValues().entrySet()) {
+ // Look at each "param": @Handlerput(param=)
+ writer.println(id + "." + type + "[" + cnt + "]."
+ + prop.getKey().getSimpleName() + "="
+ + convertClassName(prop.getValue().getValue().toString()));
+ }
+ cnt++;
+ }
+ }
+
+ /**
+ *
+ * This method attempts to convert the given clsName to
+ * a valid class name. The issue is that arrays appear something like
+ * "java.lang.String[]" where they should appear
+ * "[Ljava.lang.String;".
+ */
+ private String convertClassName(String str) {
+ int idx = str.indexOf("[]");
+ if (idx == -1) {
+ // For not only worry about Strings that contain array brackets
+ return str;
+ }
+
+ // Count []'s
+ int count = 0;
+ while (idx != -1) {
+ str = str.replaceFirst("\\[]", "");
+ idx = str.indexOf("[]");
+ count++;
+ }
+
+ // Generate new String
+ String brackets = "";
+ for (idx = 0; idx < count; idx++) {
+ brackets += "[";
+ }
+ // Return something of the format: [Ljava.lang.String;
+ return brackets + "L" + str + ";";
+ }
+
+ /**
+ *
+ * This method strips off HTML tags, converts "<" and ">",
+ * inserts '#' characters in front of each line, and ensures there
+ * are no trailing returns.
+ */
+ private String formatComment(String javadoc) {
+ if (javadoc == null) {
+ // No JavaDoc, return
+ return "";
+ }
+
+ // First trim off extra stuff
+ int idx = javadoc.indexOf("@param");
+ if (idx > -1) {
+ // Ignore @param stuff
+ javadoc = javadoc.substring(0, idx);
+ }
+ javadoc = javadoc.trim();
+
+ // Now process the String
+ StringBuilder buf = new StringBuilder("\n# ");
+ int len = javadoc.length();
+ char ch;
+ idx = 0;
+ while (idx < len) {
+ ch = javadoc.charAt(idx);
+ switch (ch) {
+ case '&':
+ if ((idx + 3) < len) {
+ if ((javadoc.charAt(idx + 2) == 't')
+ && (javadoc.charAt(idx + 3) == ';')) {
+ if (javadoc.charAt(idx + 1) == 'g') {
+ buf.append('>');
+ idx += 3;
+ } else if (javadoc.charAt(idx + 1) == 'l') {
+ buf.append('<');
+ idx += 3;
+ }
+ }
+ }
+ break;
+ case '<':
+ idx++;
+ while ((idx < len) && (javadoc.charAt(idx) != '>')) {
+ idx++;
+ }
+ break;
+ case '>':
+ idx++;
+ while ((idx < len) && (javadoc.charAt(idx) != '<')) {
+ idx++;
+ }
+ break;
+ case '\n':
+ case '\r':
+ if (((idx + 1) > len)
+ && ((javadoc.charAt(idx + 1) == '\n')
+ || (javadoc.charAt(idx + 1) == '\r'))) {
+ idx++;
+ }
+ buf.append("\n# ");
+ break;
+ default:
+ buf.append(ch);
+ }
+ idx++;
+ }
+
+ // Return the stripped javadoc
+ return buf.toString();
+ }
+
+ @Override
+ public SourceVersion getSupportedSourceVersion() {
+ if (SourceVersion.latest().compareTo(SourceVersion.RELEASE_6) > 0) {
+ return SourceVersion.valueOf("RELEASE_7");
+ } else {
+ return SourceVersion.RELEASE_6;
+ }
+ }
+
+ @Override
+ public boolean process(Set annotations, RoundEnvironment roundEnv) {
+ String key;
+ Object value;
+ String id;
+ List input;
+ List output;
+
+ setup();
+
+ for (Element decl : roundEnv.getElementsAnnotatedWith(Handler.class)) {
+ for (AnnotationMirror an : decl.getAnnotationMirrors()) {
+ // Loop through the NVPs contained in the annotation
+ id = null;
+ input = null;
+ output = null;
+ for (Map.Entry entry
+ : an.getElementValues().entrySet()) {
+ // At this point I'm processing a "Handler" annotation
+ // it may contain "id", "input", "output"
+ key = entry.getKey().getSimpleName().toString();
+ value = entry.getValue().getValue();
+ if (key.equals(Handler.ID)) {
+ // Found 'id', save it
+ id = value.toString();
+ } else if (key.equals(Handler.INPUT)) {
+ // Found inputs
+ input = (List) value;
+ } else if (key.equals(Handler.OUTPUT)) {
+ // Found outputs
+ output = (List) value;
+ }
+ }
+
+ TypeElement te = getTypeElement(decl);
+ TypeElement teDecl = getDeclaringTypeElement(decl);
+
+ // Sanity Check
+ if (id == null) {
+ processingEnv.getMessager().printMessage(
+ Kind.ERROR,
+ String.format("'id' is not specified for annotation of method: %s.%s",
+ te.getQualifiedName().toString(),
+ te.getSimpleName().toString()),
+ decl);
+ }
+
+ // Check for duplicate handler definitions
+ if (handlers.get(id) != null) {
+ processingEnv.getMessager().printMessage(Kind.WARNING,
+ String.format(
+ "Handler with 'id' of '%s' is declared more than once!'",
+ id),
+ decl);
+ }
+ handlers.put(id, id);
+
+ // Record class / method names (and javadoc comment)
+ writer.println(formatComment(getJavadocComments(decl)));
+ writer.println(String.format("%s.class=%s", id, teDecl.getQualifiedName()));
+ writer.println(String.format("%s.method=%s",id,decl.getSimpleName()));
+
+ // Now record inputs for this handler...
+ if (input != null) {
+ writeIOProperties(id, "input", input);
+ }
+
+ // Now record outputs for this handler...
+ if (output != null) {
+ writeIOProperties(id, "output", output);
+ }
+
+ // Method signature checks...
+ // Make sure method is accessible (public)
+ if (!decl.getModifiers().contains(Modifier.PUBLIC)) {
+ processingEnv.getMessager().printMessage(Kind.ERROR,
+ String.format("Annotated method: %s.%s should be declared public",
+ teDecl.getQualifiedName().toString(),
+ decl.getSimpleName().toString()),
+ decl);
+ }
+
+ // Make sure correct args are specified
+ ExecutableElement exe = decl.accept(new ExecutableElementVisitor(), null);
+ List params = exe.getParameters();
+ String pdec = params.iterator().next().asType().toString();
+ if ((params.size() != 1)
+ || !pdec.equals("com.sun.jsftemplating.layout.descriptors.handler.HandlerContext")) {
+
+ processingEnv.getMessager().printMessage(Kind.ERROR,
+ String.format("Annotated method: %s.%s must contain a single parameter of type 'com.sun.jsftemplating.layout.descriptors.handler.HandlerContext', instead type: %s was found",
+ teDecl.getQualifiedName(),
+ decl.getSimpleName(),
+ pdec),
+ decl);
+ }
+
+// FIXME: Consider an alternate method declaration that annotates a pojo method
+// @Handler(id="foo")
+// public String method(String a, String b, String c)
+// annotates a handler "foo" with 3 inputs (a:String, b:String, c:String) and 1 output "result:String"
+// Will need a special way to invoke this.
+ }
+ }
+
+ if(_setup){
+ writer.close();
+ }
+ return roundEnv.processingOver();
+ }
+}
diff --git a/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/HandlerInput.java b/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/HandlerInput.java
new file mode 100644
index 0000000..2ae737d
--- /dev/null
+++ b/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/HandlerInput.java
@@ -0,0 +1,59 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.annotation;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+
+/**
+ * This is the HandlerInput Annotation. It is
+ * expected to exist on each
+ * {@link com.sun.jsftemplating.component.factory.ComponentFactory}.
+ * It must specify an identifier for the ComponentFactory
+ * so that it may be referenced when defining UIComponents
+ * in your template or code.
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@Retention(RetentionPolicy.SOURCE)
+@Target(ElementType.METHOD)
+public @interface HandlerInput {
+
+ public String name();
+ public Class type() default Object.class;
+ public boolean required() default DEFAULT_REQUIRED;
+ // Annotations don't allow Object, use String
+ // Annotations don't allow null, use special String
+ public String defaultValue() default DEFAULT_DEFAULT_VALUE;
+
+ public static final String NAME = "name";
+ public static final String DEFAULT = "defaultValue";
+ public static final String TYPE = "type";
+ public static final String REQUIRED = "required";
+
+ public static final boolean DEFAULT_REQUIRED = false;
+ public static final String DEFAULT_DEFAULT_VALUE = "jsfTempNULLString";
+}
diff --git a/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/HandlerOutput.java b/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/HandlerOutput.java
new file mode 100644
index 0000000..64bfde3
--- /dev/null
+++ b/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/HandlerOutput.java
@@ -0,0 +1,49 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.annotation;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+
+/**
+ * This is the HandlerOutput Annotation. It is
+ * expected to exist on each
+ * {@link com.sun.jsftemplating.component.factory.ComponentFactory}.
+ * It must specify an identifier for the ComponentFactory
+ * so that it may be referenced when defining UIComponents
+ * in your template or code.
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@Retention(RetentionPolicy.SOURCE)
+@Target(ElementType.METHOD)
+public @interface HandlerOutput {
+ public String name();
+ public Class type() default Object.class;
+
+ public static final String NAME = "name";
+ public static final String TYPE = "type";
+}
diff --git a/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/UIComponentFactory.java b/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/UIComponentFactory.java
new file mode 100644
index 0000000..77190e5
--- /dev/null
+++ b/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/UIComponentFactory.java
@@ -0,0 +1,47 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.annotation;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+
+/**
+ * This is the UIComponentFactory Annotation. It is
+ * expected to exist on each
+ * {@link com.sun.jsftemplating.component.factory.ComponentFactory}.
+ * It must specify an identifier for the ComponentFactory
+ * so that it may be referenced when defining UIComponents
+ * in your template or code.
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@Retention(RetentionPolicy.SOURCE)
+@Target(ElementType.TYPE)
+public @interface UIComponentFactory {
+ public String value();
+
+ public static final String FACTORY_ID = "value";
+}
diff --git a/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/UIComponentFactoryAP.java b/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/UIComponentFactoryAP.java
new file mode 100644
index 0000000..082abaa
--- /dev/null
+++ b/jsftemplating-dt/src/main/java/com/sun/jsftemplating/annotation/UIComponentFactoryAP.java
@@ -0,0 +1,156 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006-2014 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.annotation;
+
+import java.io.File;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.PrintWriter;
+import java.io.StringWriter;
+import java.net.URL;
+import java.util.Enumeration;
+import java.util.Map;
+import java.util.Set;
+import javax.annotation.processing.AbstractProcessor;
+import javax.annotation.processing.RoundEnvironment;
+import javax.annotation.processing.SupportedAnnotationTypes;
+import javax.annotation.processing.SupportedSourceVersion;
+import javax.lang.model.SourceVersion;
+import javax.lang.model.element.AnnotationMirror;
+import javax.lang.model.element.AnnotationValue;
+import javax.lang.model.element.Element;
+import javax.lang.model.element.ExecutableElement;
+import javax.lang.model.element.TypeElement;
+import javax.tools.Diagnostic.Kind;
+import javax.tools.FileObject;
+import javax.tools.StandardLocation;
+
+/**
+ * A JSR 169 compliant annotation processor for UIComponentFactory annotation
+ * This is required for JDK8+, since APT has been deprecated.
+ * @author Romain Grecourt
+ */
+@SupportedAnnotationTypes(value = {"com.sun.jsftemplating.annotation.UIComponentFactory"})
+@SupportedSourceVersion(SourceVersion.RELEASE_6)
+public class UIComponentFactoryAP extends AbstractProcessor {
+
+ public static final String FACTORY_FILE = "META-INF/jsftemplating/UIComponentFactory.map";
+ private boolean _setup = false;
+ private PrintWriter writer = null;
+
+ private boolean setup() {
+ if (_setup) {
+ // Don't do setup more than once
+ return true;
+ }
+ try {
+ // Create factory mapping file
+ writer = getMapWriter();
+ } catch (IOException ex) {
+ StringWriter buf = new StringWriter();
+ ex.printStackTrace(new PrintWriter(buf));
+ processingEnv.getMessager().printMessage(
+ Kind.ERROR,
+ String.format("Unable to write %s file while processing @UIComponentFactory annotation %s",
+ FACTORY_FILE,
+ buf.toString()));
+ return false;
+ }
+ _setup = true;
+ return _setup;
+ }
+
+ private PrintWriter getMapWriter() throws IOException {
+ PrintWriter _writer = null;
+ ClassLoader cl = this.getClass().getClassLoader();
+ URL url;
+ for (Enumeration urls = cl.getResources(FACTORY_FILE);
+ urls.hasMoreElements() && (_writer == null);) {
+ url = urls.nextElement();
+ if ((url != null) && new File(url.getFile()).canRead()) {
+ // Append to the existing file...
+ _writer = new PrintWriter(new FileOutputStream(url.getFile(), true));
+ }
+ }
+ if (_writer == null) {
+ // File not found, create a new one...
+ FileObject fo = processingEnv.getFiler().createResource(
+ StandardLocation.CLASS_OUTPUT,
+ "",
+ FACTORY_FILE);
+ _writer = new PrintWriter(fo.openWriter());
+ return _writer;
+ }
+ return _writer;
+ }
+
+ private static String escape(String str) {
+ if (str == null) {
+ return "";
+ }
+ StringBuilder buf = new StringBuilder("");
+ for (char ch : str.trim().toCharArray()) {
+ switch (ch) {
+ case ':':
+ case '=':
+ buf.append('\\').append(ch);
+ break;
+ default:
+ buf.append(ch);
+ }
+ }
+ return buf.toString();
+ }
+
+ @Override
+ public SourceVersion getSupportedSourceVersion() {
+ if (SourceVersion.latest().compareTo(SourceVersion.RELEASE_6) > 0) {
+ return SourceVersion.valueOf("RELEASE_7");
+ } else {
+ return SourceVersion.RELEASE_6;
+ }
+ }
+
+ @Override
+ public boolean process(Set annotations, RoundEnvironment roundEnv) {
+ setup();
+ for (Element decl : roundEnv.getElementsAnnotatedWith(UIComponentFactory.class)) {
+ for (AnnotationMirror an : decl.getAnnotationMirrors()) {
+ for(Map.Entry entry
+ : an.getElementValues().entrySet()){
+ if (entry.getKey().getSimpleName().contentEquals(
+ UIComponentFactory.FACTORY_ID)) {
+ // Write NVP using the PrintWriter
+ writer.println(
+ escape(entry.getValue().getValue().toString())
+ + "=" + decl.toString());
+ }
+ }
+ }
+ }
+ if(_setup){
+ writer.close();
+ }
+ return roundEnv.processingOver();
+ }
+}
diff --git a/jsftemplating-dt/src/main/resources/META-INF/services/javax.annotation.processing.Processor b/jsftemplating-dt/src/main/resources/META-INF/services/javax.annotation.processing.Processor
new file mode 100644
index 0000000..b4c7ea5
--- /dev/null
+++ b/jsftemplating-dt/src/main/resources/META-INF/services/javax.annotation.processing.Processor
@@ -0,0 +1,3 @@
+com.sun.jsftemplating.annotation.HandlerAP
+com.sun.jsftemplating.annotation.FormatDefinitionAP
+com.sun.jsftemplating.annotation.UIComponentFactoryAP
\ No newline at end of file
diff --git a/jsftemplating/faces-config.NavData b/jsftemplating/faces-config.NavData
new file mode 100644
index 0000000..298bfc5
--- /dev/null
+++ b/jsftemplating/faces-config.NavData
@@ -0,0 +1,6 @@
+
+
+
diff --git a/jsftemplating/pom.xml b/jsftemplating/pom.xml
new file mode 100644
index 0000000..84bc4a0
--- /dev/null
+++ b/jsftemplating/pom.xml
@@ -0,0 +1,147 @@
+
+
+
+
+ 4.0.0
+
+ com.sun.jsftemplating
+ jsftemplating-parent
+ 2.1.1-SNAPSHOT
+
+ jsftemplating
+
+
+
+
+ org.apache.maven.plugins
+ maven-dependency-plugin
+
+
+ bundle-jsft
+ process-resources
+
+ unpack-dependencies
+
+
+ true
+ jsft
+ ${project.build.outputDirectory}
+ META-INF/MANIFEST.MF
+
+
+
+
+
+ org.apache.felix
+ maven-bundle-plugin
+
+
+ bundle-manifest
+ process-classes
+
+ manifest
+
+
+
+ com.sun.jsftemplating
+ javax.faces
+ com.sun.data.provider.*;resolution:=optional;password=GlassFish,!com.sun.jsftemplating.annotation.*,*
+ !com.sun.jsftemplating.annotation.*,!com.sun.data.*,com.sun.jsftemplating.*;version=${project.osgi.version}
+
+
+
+
+
+
+
+
+
+
+ javax.servlet
+ javax.servlet-api
+
+
+ org.glassfish
+ javax.faces
+ test
+
+
+ javax.faces
+ javax.faces-api
+
+
+ javax.el
+ el-api
+
+
+ com.sun.woodstock.dependlibs
+ dataprovider
+
+
+ com.sun.jsftemplating
+ jsft
+ ${project.version}
+
+ true
+
+
+ com.sun.jsftemplating
+ jsftemplating-dt
+ ${project.version}
+
+
+ junit
+ junit
+ test
+
+
+ org.mockito
+ mockito-all
+ 1.9.5
+ test
+
+
+
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/TemplatingException.java b/jsftemplating/src/main/java/com/sun/jsftemplating/TemplatingException.java
new file mode 100644
index 0000000..6319fc0
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/TemplatingException.java
@@ -0,0 +1,145 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating;
+
+import javax.faces.component.UIComponent;
+
+import com.sun.jsftemplating.layout.descriptors.LayoutElement;
+
+
+/**
+ * This is the base exception class for other exception types that may be
+ * used in this project. It provides a means for setting / obtaining the
+ * responsible {@link LayoutElement} and / or UIComponent
+ * associated with the Exception. This information is
+ * optional and may be null.
+ */
+public class TemplatingException extends RuntimeException {
+ private static final long serialVersionUID = 1L;
+
+ /**
+ * This is the preferred constructor.
+ */
+ public TemplatingException(String msg, Throwable ex, LayoutElement elt, UIComponent comp) {
+ super(msg, ex);
+
+ // Setup the rest
+ setResponsibleLayoutElement(elt);
+ setResponsibleUIComponent(comp);
+ }
+
+ /**
+ *
+ */
+ public TemplatingException() {
+ super();
+ }
+
+ /**
+ *
+ */
+ public TemplatingException(LayoutElement elt, UIComponent comp) {
+ super();
+
+ // Setup the rest
+ setResponsibleLayoutElement(elt);
+ setResponsibleUIComponent(comp);
+ }
+
+ /**
+ *
+ */
+ public TemplatingException(Throwable ex) {
+ super(ex);
+ }
+
+ /**
+ *
+ */
+ public TemplatingException(Throwable ex, LayoutElement elt, UIComponent comp) {
+ super(ex);
+
+ // Setup the rest
+ setResponsibleLayoutElement(elt);
+ setResponsibleUIComponent(comp);
+ }
+
+ /**
+ *
+ */
+ public TemplatingException(String msg) {
+ super(msg);
+ }
+
+ /**
+ * This is the preferred constructor if there is no root cause.
+ */
+ public TemplatingException(String msg, LayoutElement elt, UIComponent comp) {
+ super(msg);
+
+ // Setup the rest
+ setResponsibleLayoutElement(elt);
+ setResponsibleUIComponent(comp);
+ }
+
+ /**
+ *
+ */
+ public TemplatingException(String msg, Throwable ex) {
+ super(msg, ex);
+ }
+
+ /**
+ * Allow the Exception to hold the responsible UIComponent
+ */
+ public void setResponsibleUIComponent(UIComponent comp) {
+ _comp = comp;
+ }
+
+ /**
+ * Allow the Exception to hold the responsible UIComponent
+ */
+ public UIComponent getResponsibleUIComponent() {
+ return _comp;
+ }
+
+ /**
+ * Allow the Exception to hold the responsible LayoutElement
+ */
+ public void setResponsibleLayoutElement(LayoutElement elt) {
+ _elt = elt;
+ }
+
+ /**
+ * Allow the responsible LayoutElement to be obtained.
+ *
+ * @return The responsible LayoutElement (null if not specified)
+ */
+ public LayoutElement getResponsibleLayoutElement() {
+ return _elt;
+ }
+
+
+ private UIComponent _comp = null;
+ private LayoutElement _elt = null;
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/AjaxRequest.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/AjaxRequest.java
new file mode 100644
index 0000000..61d6195
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/AjaxRequest.java
@@ -0,0 +1,57 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component;
+
+
+/**
+ * This UIComponent exists to facilitate Ajax requests.
+ * Since these requests send information via the XMLHttpRequest Object, a
+ * standard href or form submit will not work. Further it is cumbersome
+ * to override the JavaScript in the available set of components to
+ * expect the developer to do this for each request.
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+public class AjaxRequest extends TemplateComponentBase {
+ /**
+ * Constructor for AjaxRequest.
+ */
+ public AjaxRequest() {
+ super();
+ setRendererType("com.sun.jsftemplating.AjaxRequest");
+ setLayoutDefinitionKey(LAYOUT_KEY);
+ }
+
+ /**
+ * Return the family for this component.
+ */
+ public String getFamily() {
+ return "com.sun.jsftemplating.AjaxRequest";
+ }
+
+ /**
+ * This is the location of the XML file that declares the layout for
+ * the AjaxRequest. (/jsftemplating/ajaxRequest.xml)
+ */
+ public static final String LAYOUT_KEY = "/jsftemplating/ajaxRequest.xml";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/ChildManager.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/ChildManager.java
new file mode 100644
index 0000000..ca4f207
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/ChildManager.java
@@ -0,0 +1,55 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This interface defines a method to find or create a child
+ * UIComponent. It is designed to be used in conjunction
+ * with UIComponent implementations.
+ *
+ * @see TemplateComponent
+ * @see com.sun.jsftemplating.component.ComponentUtil
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+public interface ChildManager {
+
+ /**
+ * This method will find the request child UIComponent by id (the id
+ * is obtained from the given {@link LayoutComponent}). If it is not
+ * found, it will attempt to create it from the supplied
+ * {@link LayoutComponent}.
+ *
+ * @param context FacesContext
+ * @param descriptor {@link LayoutComponent} describing the UIComponent
+ *
+ * @return Requested UIComponent
+ */
+ public UIComponent getChild(FacesContext context, LayoutComponent descriptor);
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/ComponentUtil.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/ComponentUtil.java
new file mode 100644
index 0000000..f0e5bab
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/ComponentUtil.java
@@ -0,0 +1,664 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component;
+
+import java.lang.reflect.Method;
+import java.util.HashMap;
+import java.util.Iterator;
+import java.util.List;
+import java.util.Map;
+import java.util.Properties;
+
+import javax.el.ELContext;
+import javax.el.ValueExpression;
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+import javax.faces.el.EvaluationException;
+
+import com.sun.jsftemplating.el.VariableResolver;
+import com.sun.jsftemplating.layout.descriptors.ComponentType;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+import com.sun.jsftemplating.layout.descriptors.LayoutElement;
+import com.sun.jsftemplating.util.LogUtil;
+import com.sun.jsftemplating.util.TypeConverter;
+
+
+/**
+ * Utility class that contains helper methods for components.
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+public class ComponentUtil {
+
+ /**
+ * Default Constructor.
+ */
+ private ComponentUtil() {
+ }
+
+ /**
+ * Method to get access to the ComponentUtil instance for the current
+ * application.
+ */
+ public static ComponentUtil getInstance(FacesContext ctx) {
+ ComponentUtil cu = null;
+ if (ctx != null) {
+ Map appMap =
+ ctx.getExternalContext().getApplicationMap();
+ cu = (ComponentUtil) appMap.get(COMPONENT_UTIL_KEY);
+ if (cu == null) {
+ cu = new ComponentUtil();
+ // Perhaps a SoftReference would be a good idea here?
+ appMap.put(COMPONENT_UTIL_KEY, cu);
+ }
+ } else {
+ // Not JSF env, create every time...
+ cu = new ComponentUtil();
+ }
+ return cu;
+ }
+
+ /**
+ * Return a child with the specified component id from the specified
+ * component. If not found, return null.
+ *
+ * This method will NOT create a new UIComponent.
+ *
+ * @param parent UIComponent to be searched
+ * @param id Component id (or facet name) to search for
+ *
+ * @return The child UIComponent if it exists, null otherwise.
+ */
+ public UIComponent getChild(UIComponent parent, String id) {
+ return findChild(parent, id, id);
+ }
+
+ /**
+ * Return a child with the specified component id (or facetName) from
+ * the specified component. If not found, return null.
+ * facetName or id may be null to avoid
+ * searching the facet Map or the parent's children.
+ *
+ * This method will NOT create a new UIComponent.
+ *
+ * @param parent UIComponent to be searched
+ * @param id id to search for
+ * @param facetName Facet name to search for
+ *
+ * @return The child UIComponent if it exists, null otherwise.
+ */
+ public UIComponent findChild(UIComponent parent, String id, String facetName) {
+ // Sanity Check
+ if (parent == null) {
+ return null;
+ }
+
+ // First search for facet
+ UIComponent child = null;
+ if (facetName != null) {
+ child = parent.getFacets().get(facetName);
+ if (child != null) {
+ return child;
+ }
+ }
+
+ // Search for component by id
+ if (id != null) {
+ Iterator it = parent.getChildren().iterator();
+ while (it.hasNext()) {
+ child = it.next();
+ if (id.equals(child.getId())) {
+ return (child);
+ }
+ }
+ }
+
+ // Not found, return null
+ return null;
+ }
+
+ /**
+ * This method finds or creates a child UIComponent
+ * identified by the given id. If the child is not found, it will
+ * attempt to create it using the provided
+ * {@link com.sun.jsftemplating.component.factory.ComponentFactory}
+ * (factoryClass).
+ *
+ * If there are Properties to be set on the UIComponent,
+ * this method should generally be avoided. It is preferable to use
+ * the {@link #getChild(UIComponent, String, String, Properties)}
+ * form of getChild.
+ *
+ *
+ * // Example (no properties):
+ * UIComponent child = Util.getChild(component, "jklLabel", "com.sun.jsftemplating.component.factory.basic.LabelFactory");
+ * ((Label)child).setText("JKL Label:");
+ * ((Label)child).setFor("jkl");
+ *
+ * {@link LayoutComponent#encodeChild(FacesContext, UIComponent) LayoutComponent.encodeChild}(context, child);
+ *
+ *
+ * @param parent Parent UIComponent
+ * @param id Identifier for child UIComponent
+ * @param factoryClass Full {@link com.sun.jsftemplating.component.factory.ComponentFactory} class name
+ *
+ * @return The child UIComponent that was found or created.
+ *
+ * @see #getChild(UIComponent, String, String, Properties)
+ */
+ public UIComponent getChild(UIComponent parent, String id, String factoryClass) {
+ return getChild(parent, id, factoryClass, id);
+ }
+
+ /**
+ * Same as {@link #getChild(UIComponent, String, String)} except that
+ * it allows you to specify a facetName different than the id. If
+ * null is supplied, it won't save the component as a facet.
+ *
+ * @param parent Parent UIComponent
+ * @param id Identifier for the child UIComponent
+ * @param factoryClass Full {@link com.sun.jsftemplating.component.factory.ComponentFactory} class name
+ * @param facetName The facet name (null means don't store it)
+ *
+ * @return The child UIComponent that was found or created.
+ *
+ * @see #getChild(UIComponent, String, String)
+ */
+ public UIComponent getChild(UIComponent parent, String id, String factoryClass, String facetName) {
+ return getChild(parent, id, getComponentType(factoryClass),
+ null, facetName);
+ }
+
+ /**
+ * This method finds or creates a child UIComponent
+ * identified by the given id. If the child is not found, it will
+ * attempt to create it using the provided
+ * {@link com.sun.jsftemplating.component.factory.ComponentFactory}
+ * (factoryClass). It will also initialize the
+ * UIComponent using the provided set of
+ * Properties.
+ *
+ *
+ * // Example (with properties):
+ * Properties props = new Properties();
+ * props.setProperty("text", "ABC Label:");
+ * props.setProperty("for", "abc");
+ * UIComponent child = Util.getChild(component, "abcLabel", "com.sun.jsftemplating.component.factory.basic.LabelFactory", props);
+ *
+ * {@link LayoutComponent#encodeChild(FacesContext, UIComponent) LayoutComponent.encodeChild}(context, child);
+ *
+ *
+ * @param parent Parent UIComponent
+ * @param id Identifier for the child UIComponent
+ * @param factoryClass Full {@link com.sun.jsftemplating.component.factory.ComponentFactory} class name
+ * @param properties java.util.Properties needed to
+ * create and/or initialize the
+ * UIComponent
+ *
+ * @return The child UIComponent that was found or created.
+ */
+ public UIComponent getChild(UIComponent parent, String id, String factoryClass, Properties properties) {
+ return getChild(parent, id, factoryClass, properties, id);
+ }
+
+ /**
+ * Same as {@link #getChild(UIComponent, String, String, Properties)}
+ * except that it allows you to specify a facetName different than the
+ * id. If null is supplied, it won't save the component as a
+ * facet.
+ *
+ * @param parent Parent UIComponent
+ * @param id Identifier for the child UIComponent
+ * @param factoryClass Full {@link com.sun.jsftemplating.component.factory.ComponentFactory} class name
+ * @param properties java.util.Properties needed to
+ * create and/or initialize the
+ * UIComponent
+ * @param facetName The facet name (null means don't store it)
+ *
+ * @return The child UIComponent that was found or created.
+ */
+ public UIComponent getChild(UIComponent parent, String id, String factoryClass, Properties properties, String facetName) {
+ return getChild(parent, id, getComponentType(factoryClass),
+ properties, facetName);
+ }
+
+ /**
+ * This method finds or creates a child UIComponent
+ * identified by the given id. If the child is not found, it will
+ * attempt to create it using the provided {@link ComponentType}
+ * (type). It will also initialize the
+ * UIComponent using the provided set of
+ * properties.
+ *
+ * @param parent Parent UIComponent
+ * @param id Identifier for the child
+ * UIComponent
+ * @param type The ComponentType class name
+ * @param properties Properties needed to create and/or initialize
+ * the UIComponent
+ * @param facetName The facet name (null means don't store it)
+ *
+ * @return The child UIComponent that was found or created.
+ */
+ private UIComponent getChild(UIComponent parent, String id, ComponentType type, Properties properties, String facetName) {
+ LayoutComponent desc = new LayoutComponent(null, id, type);
+ if (properties != null) {
+ //Remove Generics for now. Check with Ken to change thisinto HashMap.
+ desc.setOptions((Map) properties);
+ }
+ if (facetName != null) {
+ // Add the facetName to use
+// FIXME: Decide if this should have its own method
+ desc.addOption(LayoutComponent.FACET_NAME, facetName);
+ }
+
+ return getChild(parent, desc);
+ }
+
+ /**
+ * This method creates a {@link ComponentType} instance from the given
+ * factoryClass. It will first check its cache to see if
+ * one has already been created. If not, it will create one and add
+ * to the cache for future use.
+ *
+ * This method sets factoryClass for the
+ * {@link ComponentType} id.
+ *
+ * @param facatoryClass The full classname of the
+ * {@link com.sun.jsftemplating.component.factory.ComponentFactory}.
+ *
+ * @return A ComponentType instance for factoryClass.
+ */
+ private ComponentType getComponentType(String factoryClass) {
+ // Check the cache
+ ComponentType type = (ComponentType) _types.get(factoryClass);
+ if (type == null) {
+ // Not in the cache... add it...
+ type = new ComponentType(factoryClass, factoryClass);
+ Map newMap =
+ new HashMap(_types);
+ newMap.put(factoryClass, type);
+ _types = newMap;
+ }
+
+ // Return the ComponentType
+ return type;
+ }
+
+ /**
+ * This method finds or creates a child UIComponent
+ * identified by the given id. If the child is not found, it will
+ * attempt to create it using the provided {@link LayoutComponent}
+ * (descriptor). It will also initialize the
+ * UIComponent using the options set on the
+ * {@link LayoutComponent}.
+ *
+ * If parent implements {@link ChildManager}, then the
+ * responsibility of finding and creating the child will be delegated
+ * to the {@link ChildManager} UIComponent.
+ *
+ * If you are constructing and populating a LayoutComponent before
+ * calling this method, there are a few features that should be noted.
+ * Besides id and type which can be set in
+ * the LayoutComponent constructor, you can also set
+ * options, and
+ * {@link com.sun.jsftemplating.layout.descriptors.handler.Handler}'s.
+ *
+ * Options may be set via
+ * {@link LayoutComponent#setOptions(Map)}. These options will be
+ * applied to the UIComponent and may also be used by the
+ * {@link com.sun.jsftemplating.component.factory.ComponentFactory}
+ * while instantiating the UIComponent.
+ *
+ * {@link com.sun.jsftemplating.layout.descriptors.handler.Handler}'s
+ * can be supplied by calling
+ * {@link LayoutComponent#setHandlers(String, List)}. The
+ * type must match the event name which invokes the
+ * List of handlers you provide. The
+ * Renderer for this UIComponent is
+ * responsible for declaring and dispatching events.
+ * {@link com.sun.jsftemplating.renderer.TemplateRenderer}
+ * will invoke beforeCreate and afterCreate
+ * events for each child it creates (such as the one being requested
+ * here).
+ *
+ *
+ * // Example (with LayoutComponent):
+ * {@link ComponentType} type = new {@link ComponentType#ComponentType(String, String) ComponentType}("LabelFactory", "com.sun.jsftemplating.component.factory.basic.LabelFactory");
+ * {@link LayoutComponent} descriptor = new {@link LayoutComponent#LayoutComponent(LayoutElement, String, ComponentType) LayoutComponent}(null, "abcLabel", type);
+ * {@link LayoutComponent#addOption(String, Object) descriptor.addOption}("text", "ABC Label:");
+ * {@link LayoutComponent#addOption(String, Object) descriptor.addOption}("for", "abc");
+ * UIComponent child = Util.getChild(component, descriptor);
+ *
+ * {@link LayoutComponent#encodeChild(FacesContext, UIComponent) LayoutComponent.encodeChild}(context, child);
+ *
+ *
+ * @param parent Parent UIComponent
+ * @param descriptor The {@link LayoutComponent} describing the
+ * UIComponent
+ *
+ * @return The child UIComponent that was found or created.
+ */
+ public UIComponent getChild(UIComponent parent, LayoutComponent descriptor) {
+ FacesContext context = FacesContext.getCurrentInstance();
+ // First check to see if the UIComponent can create its own children
+ if (parent instanceof ChildManager) {
+ return ((ChildManager) parent).getChild(
+ context, descriptor);
+ }
+
+ // Make sure it doesn't already exist
+ String childId = descriptor.getId(context, parent);
+ UIComponent childComponent = findChild(parent, childId,
+ (String) descriptor.getEvaluatedOption(
+ context, LayoutComponent.FACET_NAME, null));
+ if (childComponent != null) {
+ return childComponent;
+ }
+
+ // Not found, create a new UIComponent
+ return createChildComponent(context, descriptor, parent);
+ }
+
+ /**
+ * This method creates a child UIComponent by using the
+ * provided {@link LayoutComponent} (descriptor). It
+ * will associate the parent and the newly created
+ * UIComponent.
+ *
+ * It is recommended that this method NOT be called from a Renderer.
+ * It should not be called if you have not yet checked to see if a
+ * child UIComponent with the requested ID already exists.
+ *
+ * @param context The FacesContext object.
+ * @param descriptor The {@link LayoutComponent} describing the
+ * UIComponent to be created.
+ * @param parent Parent UIComponent.
+ *
+ * @return A new UIComponent based on the provided
+ * {@link LayoutComponent}.
+ *
+ * @throws IllegalArgumentException Thrown if descriptor equals null.
+ *
+ * @see #getChild(UIComponent, LayoutComponent)
+ * @see #getChild(UIComponent, String, String, Properties)
+ * @see LayoutComponent#getType()
+ * @see ComponentType#getFactory()
+ * @see com.sun.jsftemplating.component.factory.ComponentFactory#create(FacesContext, LayoutComponent, UIComponent)
+ */
+ public UIComponent createChildComponent(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Make sure a LayoutComponent was provided.
+ if (descriptor == null) {
+ throw new IllegalArgumentException("'descriptor' cannot be null!");
+ }
+
+ // Create & return the child UIComponent
+ return descriptor.getType().getFactory().create(
+ context, descriptor, parent);
+ }
+
+ /**
+ * This util method will set the given key/value on the
+ * UIComponent. It will resolve all $...{...}
+ * expressions, and convert the String into a
+ * ValueExpression if a valid expression is detected.
+ * The return value will be a ValueExpression or the
+ * value.
+ *
+ * @param context FacesContext
+ * @param key The Property name to set
+ * @param value The Property value to set
+ * @param desc The {@link LayoutElement} associated with the
+ * UIComponent
+ * @param comp The UIComponent
+ *
+ * @return A ValueExpression, or the "$...{...}" evaulated
+ * value (if no ValueExpression is present).
+ */
+ public Object setOption(FacesContext context, String key, Object value, LayoutElement desc, UIComponent comp) {
+ // Invoke our own EL. This is needed b/c JSF's EL is designed for
+ // context-insensitive EL. Resolve our variables now because we
+ // cannot depend on the individual components to do this later. We
+ // need to find a way to make this work as a regular ValueExpression...
+ // for now, we'll continue to use it...
+ value = VariableResolver.resolveVariables(context, desc, comp, value);
+
+ // Next check to see if the value is/contains a JSF ValueExpression
+ if (value instanceof ValueExpression) {
+ if (comp != null) {
+ comp.setValueExpression(key, (ValueExpression) value);
+ }
+ } else if ((value instanceof String) && isValueReference((String) value)) {
+ ValueExpression ve =
+ context.getApplication().getExpressionFactory().
+ createValueExpression(
+ context.getELContext(), (String) value, Object.class);
+ if (comp != null) {
+ comp.setValueExpression(key, ve);
+ }
+ value = ve;
+ } else if (comp != null) {
+ // In JSF, you must directly modify the attribute Map
+ Map attributes = comp.getAttributes();
+ if (value == null) {
+ // Setting null, assume they want to remove the value
+ try {
+ attributes.remove(key);
+ } catch (Exception ex) { // Switched from IAE to E b/c of MyFaces incompatibility
+ // JSF is mesed up... it throws an exception if it has a
+ // property descriptor and you call remove(...). It also
+ // throws an exception if you attempt to call put w/ null
+ // and there is no property descriptor. Either way you
+ // MUST catch something and then handle the other case.
+ try {
+ attributes.put(key, (Object) null);
+ } catch (Exception iae) { // Switched from IAE to E b/c of MyFaces incompatibility
+ // We'll make this non-fatal, but log a message
+ if (LogUtil.infoEnabled()) {
+ LogUtil.info("JSFT0006", new Object[] {
+ key, comp.getId(), comp.getClass().getName()});
+ if (LogUtil.fineEnabled()) {
+ LogUtil.fine("Unable to set (" + key + ").", iae);
+ }
+ }
+ }
+ }
+ } else {
+ try {
+ // Attempt to set the value as given...
+ attributes.put(key, value);
+ } catch (Exception ex) { // Switched from IAE to E b/c of MyFaces incompatibility
+ // Ok, try a little harder...
+ Class type = findPropertyType(comp, key);
+ if (type != null) {
+ try {
+ attributes.put(key, TypeConverter.asType(type, value));
+ } catch (Exception ex2) { // Switched from IAE to E b/c of MyFaces incompatibility
+ throw new IllegalArgumentException(
+ "Failed to set property (" + key + ") with "
+ + "value (" + value + "), which is of type ("
+ + value.getClass().getName() + "). Expected "
+ + "type (" + type.getName() + "). This "
+ + "occured on the component named ("
+ + comp.getId() + ") of type ("
+ + comp.getClass().getName() + ").", ex2);
+ }
+ } else {
+ throw new IllegalArgumentException(
+ "Failed to set property (" + key + ") with value ("
+ + value + "), which is of type ("
+ + value.getClass().getName() + "). This occured "
+ + "on the component named (" + comp.getId()
+ + ") of type (" + comp.getClass().getName()
+ + ").", ex);
+ }
+ }
+ }
+ }
+
+ // Return the value (which may be a ValueExpression)
+ return value;
+ }
+
+ /**
+ * This method attempts to resolve the expected type for the given
+ * property key and UIComponent.
+ */
+ private Class findPropertyType(UIComponent comp, String key) {
+ // First check to see if we've done this before...
+ Class compClass = comp.getClass();
+ String cacheKey = compClass.getName() + ';' + key;
+ if (_typeCache.containsKey(cacheKey)) {
+ // May return null if method previously executed unsuccessfully
+ return _typeCache.get(cacheKey);
+ }
+
+ // Search a little...
+ Class val = null;
+ Method meth = null;
+ String methodName = getGetterName(key);
+ try {
+ meth = compClass.getMethod(methodName);
+ } catch (NoSuchMethodException ex) {
+ // May fail if we have a boolean property that has an "is" getter.
+ try {
+ // Try again, replace "get" with "is"
+ meth = compClass.getMethod(
+ "is" + methodName.substring(3));
+ } catch (NoSuchMethodException ex2) {
+ // Still not found, must not have getter / setter
+ ex2.printStackTrace();
+ }
+ }
+ if (meth != null) {
+ val = meth.getReturnType();
+ } else {
+ Object obj = comp.getAttributes().get("key");
+ if (val != null) {
+ val = obj.getClass();
+ }
+ }
+
+ // Save the value for future calls for the same information
+ // NOTE: We do it this way to avoid modifying a shared Map
+ Map newTypeCache =
+ new HashMap(_typeCache);
+ newTypeCache.put(cacheKey, val);
+ _typeCache = newTypeCache;
+
+ // Return the result
+ return val;
+ }
+
+ /**
+ * This method converts the given name to a bean getter
+ * method name. In other words, it capitalizes the first letter and
+ * prepends "get".
+ */
+ public String getGetterName(String name) {
+ return "get" + ((char) (name.charAt(0) & 0xFFDF)) + name.substring(1);
+ }
+
+
+ /**
+ * This method will attempt to resolve the given EL string.
+ *
+ * @param context The FacesContext.
+ * @param elt The LayoutElement associated w/ the expression.
+ * @param parent The parent UIComponent. This is used
+ * because the current UIComponent is typically
+ * unknown (or not even created yet).
+ * @param value The String (or List / Array) to resolve.
+ *
+ * @return The evaluated value (may be null).
+ */
+ public Object resolveValue(FacesContext context, LayoutElement elt, UIComponent parent, Object value) {
+ // Invoke our own EL. This is needed b/c JSF's EL is designed for
+ // Bean getters only. It does not get CONSTANTS or pull data from
+ // other sources without adding a custom VariableResolver and/or
+ // PropertyResolver. Eventually we may want to find a good way to
+ // make this work as a regular ValueExpression expression... but for
+ // now, we'll just resolve it this way.
+ Object result = VariableResolver.resolveVariables(
+ context, elt, parent, value);
+
+ // Next check to see if the result contains a JSF ValueExpression
+ if ((result != null) && (result instanceof String) && isValueReference((String) result)) {
+ ELContext elctx = context.getELContext();
+ ValueExpression ve =
+ context.getApplication().getExpressionFactory().
+ createValueExpression(elctx, (String) result, Object.class);
+ result = ve.getValue(elctx);
+/*
+1.1+
+ // JSF 1.1 VB:
+ try {
+ ValueBinding vb =
+ context.getApplication().createValueBinding((String) result);
+ result = vb.getValue(context);
+ } catch (EvaluationException ex) {
+ if (LogUtil.infoEnabled()) {
+ LogUtil.info("JSFT0007", new Object[] {value});
+ }
+ throw ex;
+ }
+*/
+ }
+
+ // Return the result
+ return result;
+ }
+
+ /**
+ * Returns true if this expression looks like an EL expression.
+ */
+ public boolean isValueReference(String value) {
+ if (value == null) {
+ return false;
+ }
+// FIXME: Consider adding logic to look for "matching" {}'s
+ int start = value.indexOf("#{");
+ if ((start != -1) && (start < value.indexOf('}', start))) {
+ return true;
+ }
+ return false;
+ }
+
+
+ // While this is static, the information seems reasonable to share across
+ // applications as it is very unlikely to be different... leaving for now
+ private static Map _typeCache =
+ new HashMap();
+
+ /**
+ * This Map caches ComponentTypes by their factoryClass name.
+ */
+ private Map _types =
+ new HashMap();
+
+ /**
+ * Application scope key for an instance of
+ * ComponentUtil.
+ */
+ public static final String COMPONENT_UTIL_KEY = "_jsft_COMP_UTIL";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/EventComponent.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/EventComponent.java
new file mode 100644
index 0000000..a5ede2c
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/EventComponent.java
@@ -0,0 +1,74 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component;
+
+
+/**
+ * This UIComponent exists so that custom events may be
+ * queued and triggered at appropriate times. This will allow
+ * "beforeEncode", "afterEncode", and even "command" events to be
+ * associated with components by wrapping 1 or more components with
+ * this component.
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+public class EventComponent extends TemplateComponentBase {
+ /**
+ * Constructor for EventComponent.
+ */
+ public EventComponent() {
+ super();
+ setRendererType("com.sun.jsftemplating.EventComponent");
+ setLayoutDefinitionKey(LAYOUT_KEY);
+ }
+
+ /**
+ * Return the family for this component.
+ */
+ public String getFamily() {
+ return "com.sun.jsftemplating.EventComponent";
+ }
+
+ /**
+ * Restore the state of this component.
+ public void restoreState(FacesContext _context,Object _state) {
+ Object _values[] = (Object[]) _state;
+ super.restoreState(_context, _values[0]);
+ }
+ */
+
+ /**
+ * Save the state of this component.
+ public Object saveState(FacesContext _context) {
+ Object _values[] = new Object[1];
+ _values[0] = super.saveState(_context);
+ return _values;
+ }
+ */
+
+ /**
+ * This is the location of the XML file that declares the layout for
+ * the EventComponent. (/jsftemplating/event.xml)
+ */
+ public static final String LAYOUT_KEY = "/jsftemplating/event.xml";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/ForEach.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/ForEach.java
new file mode 100644
index 0000000..62df038
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/ForEach.java
@@ -0,0 +1,54 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component;
+
+
+/**
+ * This UIComponent exists so "foreach" conditions can be
+ * processed during rendering.
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+public class ForEach extends TemplateComponentBase {
+ /**
+ * Constructor for ForEach.
+ */
+ public ForEach() {
+ super();
+ setRendererType("com.sun.jsftemplating.ForEach");
+ setLayoutDefinitionKey(LAYOUT_KEY);
+ }
+
+ /**
+ * Return the family for this component.
+ */
+ public String getFamily() {
+ return "com.sun.jsftemplating.ForEach";
+ }
+
+ /**
+ * This is the location of the XML file that declares the layout for
+ * the ForEach. (/jsftemplating/foreach.xml)
+ */
+ public static final String LAYOUT_KEY = "/jsftemplating/foreach.xml";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/If.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/If.java
new file mode 100644
index 0000000..f0ad4ff
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/If.java
@@ -0,0 +1,54 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component;
+
+
+/**
+ * This UIComponent exists so "if" conditions can be
+ * processed during rendering.
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+public class If extends TemplateComponentBase {
+ /**
+ * Constructor for If.
+ */
+ public If() {
+ super();
+ setRendererType("com.sun.jsftemplating.If");
+ setLayoutDefinitionKey(LAYOUT_KEY);
+ }
+
+ /**
+ * Return the family for this component.
+ */
+ public String getFamily() {
+ return "com.sun.jsftemplating.If";
+ }
+
+ /**
+ * This is the location of the XML file that declares the layout for
+ * the If. (/jsftemplating/if.xml)
+ */
+ public static final String LAYOUT_KEY = "/jsftemplating/if.xml";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/StaticText.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/StaticText.java
new file mode 100644
index 0000000..9229ae3
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/StaticText.java
@@ -0,0 +1,53 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component;
+
+
+/**
+ * This UIComponent produces static text output.
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+public class StaticText extends TemplateComponentBase {
+ /**
+ * Constructor for StaticText.
+ */
+ public StaticText() {
+ super();
+ setRendererType("com.sun.jsftemplating.StaticText");
+ setLayoutDefinitionKey(LAYOUT_KEY);
+ }
+
+ /**
+ * Return the family for this component.
+ */
+ public String getFamily() {
+ return "com.sun.jsftemplating.StaticText";
+ }
+
+ /**
+ * This is the location of the XML file that declares the layout for
+ * the StaticText. (/jsftemplating/staticText.xml)
+ */
+ public static final String LAYOUT_KEY = "/jsftemplating/staticText.xml";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/TemplateComponent.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/TemplateComponent.java
new file mode 100644
index 0000000..7f791f4
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/TemplateComponent.java
@@ -0,0 +1,97 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.layout.descriptors.LayoutDefinition;
+
+
+/**
+ * This interface defines additional methods in addition to those defined
+ * by UIComponent that are needed to work with a TemplateRenderer.
+ *
+ * JSF did not define an interface for UIComponent, so I cannot extend an
+ * interface here. This means that casting is needed to use UIComponent
+ * features from a TemplateComponent.
+ *
+ * If you need to have a NamingContainer, do not forget to
+ * implement that interface in addition to this interface.
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+public interface TemplateComponent extends ChildManager {
+
+ /**
+ * This method will find the request child UIComponent by id. If it is
+ * not found, it will attempt to create it if it can find a LayoutElement
+ * describing it.
+ *
+ * @param context The FacesContext
+ * @param id The UIComponent id to search for
+ *
+ * @return The requested UIComponent
+ */
+ public UIComponent getChild(FacesContext context, String id);
+
+ /**
+ * This method returns the LayoutDefinition associated with this component.
+ *
+ * @param context The FacesContext
+ *
+ * @return LayoutDefinition associated with this component.
+ */
+ public LayoutDefinition getLayoutDefinition(FacesContext context);
+
+ /**
+ * This method returns the LayoutDefinitionKey for this component.
+ *
+ * @return key The key to use in the LayoutDefinitionManager
+ */
+ public String getLayoutDefinitionKey();
+
+ /**
+ * This method sets the LayoutDefinition key for this component.
+ *
+ * @param key The key to use in the LayoutDefinitionManager
+ */
+ public void setLayoutDefinitionKey(String key);
+
+ /**
+ * This method returns the value of the requested field. It should
+ * first check the value of field passed in, it should
+ * return that value if set. Next, it should check to see if there
+ * is a ValueExpression matching
+ * attributeName and return that value, if it exists.
+ * If neither of the first 2 cases yielded a result,
+ * defaultValue is returned.
+ *
+ * @param field The field which may contain the value.
+ * @param attributeName The ValueExpression name.
+ * @param defaultValue The default value.
+ *
+ * @return The value of the property.
+ */
+ public V getPropertyValue(V field, String attributeName, V defaultValue);
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/TemplateComponentBase.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/TemplateComponentBase.java
new file mode 100644
index 0000000..6934754
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/TemplateComponentBase.java
@@ -0,0 +1,165 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2007 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component;
+
+import javax.faces.component.UIComponent;
+import javax.faces.component.UIComponentBase;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.layout.LayoutDefinitionException;
+import com.sun.jsftemplating.layout.LayoutDefinitionManager;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+import com.sun.jsftemplating.layout.descriptors.LayoutDefinition;
+import com.sun.jsftemplating.layout.descriptors.LayoutElement;
+
+
+/**
+ * This abstract class provides base functionality for components that
+ * work in conjunction with the
+ * {@link com.sun.jsftemplating.renderer.TemplateRenderer} that do not
+ * need any "special" component features (such as provided by
+ * UIInput, or an ActionSource implementation).
+ * This class is a suitable class for "container" types of components, or
+ * components that simply agregate other components together. It
+ * provides a default implementation of the
+ * {@link com.sun.jsftemplating.component.TemplateComponent}
+ * interface.
+ *
+ * @see com.sun.jsftemplating.renderer.TemplateRenderer
+ * @see com.sun.jsftemplating.component.TemplateComponent
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+public abstract class TemplateComponentBase extends UIComponentBase implements TemplateComponent {
+
+ /**
+ * This method will find the request child UIComponent
+ * by id. If it is not found, it will attempt to create it if it can
+ * find a {@link LayoutElement} describing it.
+ *
+ * @param context The FacesContext.
+ * @param id The UIComponent id to find.
+ *
+ * @return The requested UIComponent.
+ */
+ public UIComponent getChild(FacesContext context, String id) {
+ return getHelper().getChild(this, context, id);
+ }
+
+
+ /**
+ * This method will find the request child UIComponent
+ * by id. If it is not found, it will use the given
+ * {@link LayoutComponent} to create it.
+ *
+ * @param context The FacesContext.
+ * @param descriptor The UIComponent id to find.
+ *
+ * @return The requested UIComponent.
+ */
+ public UIComponent getChild(FacesContext context, LayoutComponent descriptor) {
+ return getHelper().getChild(this, context, descriptor);
+ }
+
+ /**
+ * This method returns the {@link LayoutDefinition} associated with
+ * this component.
+ *
+ * @param context The FacesContext.
+ *
+ * @return {@link LayoutDefinition} associated with this component.
+ */
+ public LayoutDefinition getLayoutDefinition(FacesContext context) {
+ return getHelper().getLayoutDefinition(context);
+ }
+
+ /**
+ * This method saves the state for this component. It relies on the
+ * superclass to save its own sate, this method will invoke
+ * super.saveState().
+ *
+ * @param context The FacesContext.
+ *
+ * @return The serialized state.
+ */
+ public Object saveState(FacesContext context) {
+ return getHelper().saveState(context, super.saveState(context));
+ }
+
+ /**
+ * This method restores the state for this component. It will invoke
+ * the superclass to restore its state.
+ *
+ * @param context The FacesContext.
+ * @param state The serialized state.
+ */
+ public void restoreState(FacesContext context, Object state) {
+ super.restoreState(context, getHelper().restoreState(context, state));
+ }
+
+ /**
+ * This method returns the {@link LayoutDefinition} key for this
+ * component.
+ *
+ * @return The key to use in the {@link LayoutDefinitionManager}.
+ */
+ public String getLayoutDefinitionKey() {
+ return getHelper().getLayoutDefinitionKey();
+ }
+
+
+ /**
+ * This method sets the {@link LayoutDefinition} key for this
+ * component.
+ *
+ * @param key The key to use in the {@link LayoutDefinitionManager}.
+ */
+ public void setLayoutDefinitionKey(String key) {
+ getHelper().setLayoutDefinitionKey(key);
+ }
+
+ public V getPropertyValue(V field, String attributeName, V defaultValue) {
+ return getHelper().getAttributeValue(this, field, attributeName, defaultValue);
+ }
+
+ /**
+ * This method retrieves the {@link TemplateComponentHelper} used by
+ * this class to help implement the {@link TemplateComponent}
+ * interface.
+ *
+ * @return The {@link TemplateComponentHelper} for this component.
+ */
+ protected TemplateComponentHelper getHelper() {
+ if (_helper == null) {
+ _helper = new TemplateComponentHelper();
+ }
+ return _helper;
+ }
+
+ /**
+ * Our TemplateComponentHelper. We initialize it on
+ * access b/c we want to ensure it exists, if it is serialized it
+ * won't exist if we init it here or in the constructor.
+ */
+ private transient TemplateComponentHelper _helper = null;
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/TemplateComponentHelper.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/TemplateComponentHelper.java
new file mode 100644
index 0000000..052c407
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/TemplateComponentHelper.java
@@ -0,0 +1,264 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2007 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component;
+
+import javax.faces.component.UIComponent;
+import javax.faces.component.UIComponentBase;
+import javax.faces.context.FacesContext;
+import javax.el.ValueExpression;
+
+import com.sun.jsftemplating.layout.LayoutDefinitionException;
+import com.sun.jsftemplating.layout.LayoutDefinitionManager;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+import com.sun.jsftemplating.layout.descriptors.LayoutDefinition;
+import com.sun.jsftemplating.layout.descriptors.LayoutElement;
+
+
+/**
+ * This class provides base functionality for components that
+ * work in conjunction with the
+ * {@link com.sun.jsftemplating.renderer.TemplateRenderer}. It
+ * provides the bulk of the default implementation of the
+ * {@link TemplateComponent} interface.
+ *
+ * This class is meant to be used inside a UIComponent class
+ * that implements TemplateComponent to help provide the
+ * behavior of a TemplateComponent. It is NOT an
+ * implementation by itself. A TemplateComonent
+ * implementation class may use this to help define its functionality and
+ * must also be an instance of UIComponent.
+ *
+ * @see com.sun.jsftemplating.renderer.TemplateRenderer
+ * @see TemplateComponent
+ * @see TemplateComponentBase
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+public class TemplateComponentHelper {
+
+ /**
+ * This class should only be used by TemplateComponent
+ * implementations to help them provide their
+ * TemplateComponent funtionality.
+ */
+ public TemplateComponentHelper() {
+ }
+
+ /**
+ * This method will find the request child UIComponent by id. If it
+ * is not found, it will attempt to create it if it can find a
+ * {@link LayoutElement} describing it.
+ *
+ * @param context The FacesContext.
+ * @param id The UIComponent id to find.
+ *
+ * @return The requested UIComponent
+ */
+ public UIComponent getChild(UIComponent comp, FacesContext context, String id) {
+ if ((id == null) || (id.trim().equals(""))) {
+ // No id, no LayoutComponent, nothing we can do.
+ return null;
+ }
+
+ // We have an id, use it to search for an already-created child
+// FIXME: I am doing this 2x if it falls through to create the child...
+// FIXME: think about optimizing this
+ UIComponent childComponent = ComponentUtil.getInstance(context).findChild(comp, id, id);
+ if (childComponent != null) {
+ return childComponent;
+ }
+
+ // If we're still here, then we need to create it... hopefully we have
+ // a LayoutComponent to tell us how to do this!
+ LayoutDefinition ld = getLayoutDefinition(context);
+ if (ld == null) {
+ // No LayoutDefinition to tell us how to create it... return null
+ return null;
+ }
+
+ // Attempt to find a LayoutComponent matching the id
+ LayoutElement elt =
+ LayoutDefinition.getChildLayoutElementById(context, id, ld, comp);
+
+ // Create the child from the LayoutComponent
+ return getChild(comp, context, (LayoutComponent) elt);
+ }
+
+
+ /**
+ * This method will find the request child UIComponent
+ * by id (the id is obtained from the given {@link LayoutComponent}).
+ * If it is not found, it will attempt to create it from the supplied
+ * {@link LayoutElement}.
+ *
+ * @param descriptor The {@link LayoutElement} describing the UIComponent.
+ *
+ * @return The requested UIComponent
+ */
+ public UIComponent getChild(UIComponent comp, FacesContext context, LayoutComponent descriptor) {
+ UIComponent childComponent = null;
+
+ // Sanity check
+ if (descriptor == null) {
+ throw new IllegalArgumentException("The LayoutComponent is null!");
+ }
+
+ // First pull off the id from the descriptor
+ String id = descriptor.getId(context, comp);
+ ComponentUtil compUtil = ComponentUtil.getInstance(context);
+ if ((id != null) && !(id.trim().equals(""))) {
+ // We have an id, use it to search for an already-created child
+ childComponent = compUtil.findChild(comp, id, id);
+ if (childComponent != null) {
+ return childComponent;
+ }
+ }
+
+ // No id, or the component hasn't been created. In either case, we
+ // create a new component (moral: always have an id)
+
+ // Invoke "beforeCreate" handlers
+ descriptor.beforeCreate(context, comp);
+
+ // Create UIComponent
+ childComponent =
+ compUtil.createChildComponent(context, descriptor, comp);
+
+ // Invoke "afterCreate" handlers
+ descriptor.afterCreate(context, childComponent);
+
+ // Return the newly created UIComponent
+ return childComponent;
+ }
+
+ /**
+ * This method returns the {@link LayoutDefinition} associated with
+ * the UIComponent.
+ *
+ * @param context The FacesContext.
+ *
+ * @return {@link LayoutDefinition} associated with the UIComponent.
+ */
+ public LayoutDefinition getLayoutDefinition(FacesContext context) {
+ // Make sure we don't already have it...
+ if (_layoutDefinition != null) {
+ return _layoutDefinition;
+ }
+
+ // Get the LayoutDefinitionManager key
+ String key = getLayoutDefinitionKey();
+ if (key == null) {
+ throw new NullPointerException("LayoutDefinition key is null!");
+ }
+
+ // Save the LayoutDefinition for future calls to this method
+ try {
+ _layoutDefinition = LayoutDefinitionManager.
+ getLayoutDefinition(context, key);
+ } catch (LayoutDefinitionException ex) {
+ throw new IllegalArgumentException(
+ "A LayoutDefinition was not provided for '" + key
+ + "'! This is required.", ex);
+ }
+
+ // Return the LayoutDefinition (if found)
+ return _layoutDefinition;
+ }
+
+ /**
+ * This method saves the state for the UIComponent. It
+ * relies on the UIComponent's superclass to save its own
+ * sate, and to pass in that Object to this method.
+ *
+ * @param context The FacesContext.
+ * @param superState The UIComponent's superclass state.
+ *
+ * @return The serialized State.
+ */
+ public Object saveState(FacesContext context, Object superState) {
+ Object[] values = new Object[2];
+ values[0] = superState;
+ values[1] = _ldmKey;
+ return values;
+ }
+
+ /**
+ * This method restores the state for the UIComponent.
+ * It will return an Object that must be passed to the
+ * superclass's restoreState method.
+ *
+ * @param context The FacesContext.
+ * @param state The serialized state.
+ *
+ * @return The State for the superclass to deserialize.
+ */
+ public Object restoreState(FacesContext context, Object state) {
+ Object[] values = (Object[]) state;
+ _ldmKey = (java.lang.String) values[1];
+ return values[0];
+ }
+
+ /**
+ * This method returns the {@link LayoutDefinition} key for the
+ * UIComponent.
+ *
+ * @return key The key to use in the {@link LayoutDefinitionManager}.
+ */
+ public String getLayoutDefinitionKey() {
+ return _ldmKey;
+ }
+
+
+ /**
+ * This method sets the LayoutDefinition key for the
+ * UIComponent.
+ *
+ * @param key The key to use in the {@link LayoutDefinitionManager}.
+ */
+ public void setLayoutDefinitionKey(String key) {
+ _ldmKey = key;
+ }
+
+ public V getAttributeValue(UIComponent comp, V field, String attributeName, V defaultValue) {
+ if (field != null) {
+ return field;
+ }
+ ValueExpression ve = comp.getValueExpression(attributeName);
+ return (ve != null) ? (V) ve.getValue(FacesContext.getCurrentInstance().getELContext()) :
+ defaultValue;
+ }
+
+ /**
+ * This is the LayoutDefinition key for the UIComponent.
+ * This is typically set by the Tag. The Component may also provide
+ * a default by setting it in its constructor.
+ */
+ private String _ldmKey = null;
+
+
+ /**
+ * This is a cached reference to the {@link LayoutDefinition} used by
+ * the UIComponent.
+ */
+ private transient LayoutDefinition _layoutDefinition = null;
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/TemplateInputComponentBase.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/TemplateInputComponentBase.java
new file mode 100644
index 0000000..655a156
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/TemplateInputComponentBase.java
@@ -0,0 +1,161 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2007 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component;
+
+import com.sun.jsftemplating.layout.LayoutDefinitionManager;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+import com.sun.jsftemplating.layout.descriptors.LayoutDefinition;
+import com.sun.jsftemplating.layout.descriptors.LayoutElement;
+
+import javax.faces.component.UIComponent;
+import javax.faces.component.UIInput;
+import javax.faces.context.FacesContext;
+
+
+/**
+ * This abstract class provides base functionality for components that
+ * work in conjunction with the
+ * {@link com.sun.jsftemplating.renderer.TemplateRenderer} and would like
+ * to provide UIInput functionality. It provides a default
+ * implementation of the {@link TemplateComponent} interface.
+ *
+ * @see com.sun.jsftemplating.renderer.TemplateRenderer
+ * @see com.sun.jsftemplating.component.TemplateComponent
+ * @see com.sun.jsftemplating.component.TemplateComponentHelper
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+public abstract class TemplateInputComponentBase extends UIInput implements TemplateComponent {
+
+ /**
+ * This method will find the request child UIComponent
+ * by id. If it is not found, it will attempt to create it if it can
+ * find a {@link LayoutElement} describing it.
+ *
+ * @param context The FacesContext.
+ * @param id The UIComponent id to find.
+ *
+ * @return The requested UIComponent.
+ */
+ public UIComponent getChild(FacesContext context, String id) {
+ return getHelper().getChild(this, context, id);
+ }
+
+
+ /**
+ * This method will find the request child UIComponent by
+ * id (the id is obtained from the given {@link LayoutComponent}). If
+ * it is not found, it will attempt to create it from the supplied
+ * {@link LayoutElement}.
+ *
+ * @param context The FacesContext.
+ * @param descriptor The {@link LayoutElement} describing the UIComponent
+ *
+ * @return The requested UIComponent.
+ */
+ public UIComponent getChild(FacesContext context, LayoutComponent descriptor) {
+ return getHelper().getChild(this, context, descriptor);
+ }
+
+ /**
+ * This method returns the {@link LayoutDefinition} associated with
+ * this component.
+ *
+ * @param context The FacesContext.
+ *
+ * @return {@link LayoutDefinition} associated with this component.
+ */
+ public LayoutDefinition getLayoutDefinition(FacesContext context) {
+ return getHelper().getLayoutDefinition(context);
+ }
+
+ /**
+ * This method saves the state for this component. It relies on the
+ * superclass to save its own sate, this method will invoke
+ * super.saveState().
+ *
+ * @param context The FacesContext.
+ *
+ * @return The serialized state.
+ */
+ public Object saveState(FacesContext context) {
+ return getHelper().saveState(context, super.saveState(context));
+ }
+
+ /**
+ * This method restores the state for this component. It will invoke
+ * the superclass to restore its state.
+ *
+ * @param context The FacesContext.
+ * @param state The serialized state.
+ */
+ public void restoreState(FacesContext context, Object state) {
+ super.restoreState(context, getHelper().restoreState(context, state));
+ }
+
+ /**
+ * This method returns the {@link LayoutDefinition} key for this
+ * component.
+ *
+ * @return The key to use in the {@link LayoutDefinitionManager}.
+ */
+ public String getLayoutDefinitionKey() {
+ return getHelper().getLayoutDefinitionKey();
+ }
+
+
+ /**
+ * This method sets the {@link LayoutDefinition} key for this
+ * component.
+ *
+ * @param key The key to use in the {@link LayoutDefinitionManager}.
+ */
+ public void setLayoutDefinitionKey(String key) {
+ getHelper().setLayoutDefinitionKey(key);
+ }
+
+ public V getPropertyValue(V field, String attributeName, V defaultValue) {
+ return getHelper().getAttributeValue(this, field, attributeName, defaultValue);
+ }
+
+ /**
+ * This method retrieves the {@link TemplateComponentHelper} used by
+ * this class to help implement the {@link TemplateComponent}
+ * interface.
+ *
+ * @return The {@link TemplateComponentHelper} for this component.
+ */
+ protected TemplateComponentHelper getHelper() {
+ if (_helper == null) {
+ _helper = new TemplateComponentHelper();
+ }
+ return _helper;
+ }
+
+ /**
+ * Our TemplateComponentHelper. We initialize it on
+ * access b/c we want to ensure it exists, if it is serialized it
+ * won't exist if we init it here or in the constructor.
+ */
+ private transient TemplateComponentHelper _helper = null;
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/TemplateOutputComponentBase.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/TemplateOutputComponentBase.java
new file mode 100644
index 0000000..d92f224
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/TemplateOutputComponentBase.java
@@ -0,0 +1,161 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2007 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component;
+
+import javax.faces.component.UIComponent;
+import javax.faces.component.UIOutput;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.layout.LayoutDefinitionManager;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+import com.sun.jsftemplating.layout.descriptors.LayoutDefinition;
+import com.sun.jsftemplating.layout.descriptors.LayoutElement;
+
+
+/**
+ * This abstract class provides base functionality for components that
+ * work in conjunction with the
+ * {@link com.sun.jsftemplating.renderer.TemplateRenderer} and would like
+ * to provide UIInput functionality. It provides a default
+ * implementation of the {@link TemplateComponent} interface.
+ *
+ * @see com.sun.jsftemplating.renderer.TemplateRenderer
+ * @see com.sun.jsftemplating.component.TemplateComponent
+ * @see com.sun.jsftemplating.component.TemplateComponentHelper
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+public abstract class TemplateOutputComponentBase extends UIOutput implements TemplateComponent {
+
+ /**
+ * This method will find the request child UIComponent
+ * by id. If it is not found, it will attempt to create it if it can
+ * find a {@link LayoutElement} describing it.
+ *
+ * @param context The FacesContext.
+ * @param id The UIComponent id to find.
+ *
+ * @return The requested UIComponent.
+ */
+ public UIComponent getChild(FacesContext context, String id) {
+ return getHelper().getChild(this, context, id);
+ }
+
+
+ /**
+ * This method will find the request child UIComponent by
+ * id (the id is obtained from the given {@link LayoutComponent}). If
+ * it is not found, it will attempt to create it from the supplied
+ * {@link LayoutElement}.
+ *
+ * @param context The FacesContext.
+ * @param descriptor The {@link LayoutElement} describing the UIComponent
+ *
+ * @return The requested UIComponent.
+ */
+ public UIComponent getChild(FacesContext context, LayoutComponent descriptor) {
+ return getHelper().getChild(this, context, descriptor);
+ }
+
+ /**
+ * This method returns the {@link LayoutDefinition} associated with
+ * this component.
+ *
+ * @param context The FacesContext.
+ *
+ * @return {@link LayoutDefinition} associated with this component.
+ */
+ public LayoutDefinition getLayoutDefinition(FacesContext context) {
+ return getHelper().getLayoutDefinition(context);
+ }
+
+ /**
+ * This method saves the state for this component. It relies on the
+ * superclass to save its own sate, this method will invoke
+ * super.saveState().
+ *
+ * @param context The FacesContext.
+ *
+ * @return The serialized state.
+ */
+ public Object saveState(FacesContext context) {
+ return getHelper().saveState(context, super.saveState(context));
+ }
+
+ /**
+ * This method restores the state for this component. It will invoke
+ * the superclass to restore its state.
+ *
+ * @param context The FacesContext.
+ * @param state The serialized state.
+ */
+ public void restoreState(FacesContext context, Object state) {
+ super.restoreState(context, getHelper().restoreState(context, state));
+ }
+
+ /**
+ * This method returns the {@link LayoutDefinition} key for this
+ * component.
+ *
+ * @return The key to use in the {@link LayoutDefinitionManager}.
+ */
+ public String getLayoutDefinitionKey() {
+ return getHelper().getLayoutDefinitionKey();
+ }
+
+
+ /**
+ * This method sets the {@link LayoutDefinition} key for this
+ * component.
+ *
+ * @param key The key to use in the {@link LayoutDefinitionManager}.
+ */
+ public void setLayoutDefinitionKey(String key) {
+ getHelper().setLayoutDefinitionKey(key);
+ }
+
+ public V getPropertyValue(V field, String attributeName, V defaultValue) {
+ return getHelper().getAttributeValue(this, field, attributeName, defaultValue);
+ }
+
+ /**
+ * This method retrieves the {@link TemplateComponentHelper} used by
+ * this class to help implement the {@link TemplateComponent}
+ * interface.
+ *
+ * @return The {@link TemplateComponentHelper} for this component.
+ */
+ protected TemplateComponentHelper getHelper() {
+ if (_helper == null) {
+ _helper = new TemplateComponentHelper();
+ }
+ return _helper;
+ }
+
+ /**
+ * Our TemplateComponentHelper. We initialize it on
+ * access b/c we want to ensure it exists, if it is serialized it
+ * won't exist if we init it here or in the constructor.
+ */
+ private transient TemplateComponentHelper _helper = null;
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/While.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/While.java
new file mode 100644
index 0000000..2cc0eac
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/While.java
@@ -0,0 +1,54 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component;
+
+
+/**
+ * This UIComponent exists so "while" conditions can be
+ * processed during rendering.
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+public class While extends TemplateComponentBase {
+ /**
+ * Constructor for While.
+ */
+ public While() {
+ super();
+ setRendererType("com.sun.jsftemplating.While");
+ setLayoutDefinitionKey(LAYOUT_KEY);
+ }
+
+ /**
+ * Return the family for this component.
+ */
+ public String getFamily() {
+ return "com.sun.jsftemplating.While";
+ }
+
+ /**
+ * This is the location of the XML file that declares the layout for
+ * the While. (/jsftemplating/while.xml)
+ */
+ public static final String LAYOUT_KEY = "/jsftemplating/while.xml";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/dataprovider/IndexFieldKey.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/dataprovider/IndexFieldKey.java
new file mode 100644
index 0000000..ab40cf5
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/dataprovider/IndexFieldKey.java
@@ -0,0 +1,142 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://glassfish.dev.java.net/public/CDDLv1.0.html or
+ * glassfish/bootstrap/legal/CDDLv1.0.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at glassfish/bootstrap/legal/CDDLv1.0.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.dataprovider;
+
+import com.sun.data.provider.FieldKey;
+
+
+/**
+ * This implementation of FieldKey provides a way to
+ * associate an index along with the fieldId. One use case for this is
+ * when a DataProvider acts as a facade for multiple data sources, the
+ * index can be used to indicate to which underlying source the key
+ * pertains.
+ *
+ * Keey in mind that a single FieldKey is meant to represent
+ * all rows, so it would not be useful to store row information in a
+ * FieldKey. Therefor the index in this IndexFieldKey is
+ * not intended to specify a row!
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+public class IndexFieldKey extends FieldKey {
+ private static final long serialVersionUID = 1L;
+
+ /**
+ * Constructs a new IndexFieldKey with the specified
+ * fieldId and index.
+ *
+ * @param fieldId The desired cannonical ID String.
+ * @param index The index for this IndexFieldKey.
+ */
+ public IndexFieldKey(String fieldId, int index) {
+ super(fieldId);
+ setIndex(index);
+ }
+
+ /**
+ * Constructs a new IndexFieldKey with the specified
+ * fieldId, displayName, and
+ * index.
+ *
+ * @param fieldId The desired cannonical ID String for this field.
+ * @param displayName The desired display name String.
+ * @param index The index for this IndexFieldKey.
+ */
+ public IndexFieldKey(String fieldId, String displayName, int index) {
+ super(fieldId, displayName);
+ setIndex(index);
+ }
+
+ /**
+ * Constructs a new IndexFieldKey with the specified
+ * fieldId, displayName, and
+ * index.
+ *
+ * @param fk The FieldKey.
+ * @param index The index for this IndexFieldKey.
+ */
+ public IndexFieldKey(FieldKey fk, int index) {
+ super(fk.getFieldId(), fk.getDisplayName());
+ setIndex(index);
+ }
+
+ /**
+ * This method retreives the index associated with this object.
+ */
+ public int getIndex() {
+ return _index;
+ }
+
+ /**
+ * This method retreives the index associated with this object.
+ */
+ public void setIndex(int idx) {
+ _index = idx;
+ }
+
+ /**
+ * Standard equals implementation. This method compares the
+ * IndexFieldKey fieldId and
+ * index values for equality.
+ *
+ * @param obj The Object to check equality.
+ *
+ * @return true if equal, false if not.
+ */
+ public boolean equals(Object obj) {
+ boolean val = super.equals(obj);
+ if (val && (obj instanceof IndexFieldKey)) {
+ val = ((IndexFieldKey) obj).getIndex() == getIndex();
+ }
+ return val;
+ }
+
+ /**
+ * This provides a hash for instances of this class.
+ */
+ public int hashCode() {
+ if (_hash == -1) {
+ // Use the hashCode() of the String (id + index)
+ _hash = (getFieldId() + getIndex()).hashCode();
+ }
+ return _hash;
+ }
+
+ /**
+ * The toString() implementation. This implementation prints out
+ * the index and fieldId:
+ *
+ * IndexFieldKey[<index>][<id>]
+ *
+ */
+ public String toString() {
+ return "IndexFieldKey[" + getIndex() + "][" + getFieldId() + "]"; // NOI18N
+ }
+
+ /**
+ * Storate for the index.
+ */
+ private int _index = -1;
+ private transient int _hash = -1;
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/dataprovider/MapObjectFieldKeySupport.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/dataprovider/MapObjectFieldKeySupport.java
new file mode 100644
index 0000000..3134496
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/dataprovider/MapObjectFieldKeySupport.java
@@ -0,0 +1,208 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://glassfish.dev.java.net/public/CDDLv1.0.html or
+ * glassfish/bootstrap/legal/CDDLv1.0.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at glassfish/bootstrap/legal/CDDLv1.0.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.dataprovider;
+
+import java.util.Map;
+
+import com.sun.data.provider.DataProviderException;
+import com.sun.data.provider.FieldKey;
+import com.sun.data.provider.impl.ObjectFieldKeySupport;
+
+
+/**
+ * Support class for DataProvider implementations that need
+ * to instrospect Java classes to discover properties, or Map values and
+ * return FieldKey instances for them.
+ */
+public class MapObjectFieldKeySupport extends ObjectFieldKeySupport {
+
+ /**
+ * Construct a new support instance wrapping the specified Map class,
+ * with the specified flag for including public fields.
+ *
+ * @param cls Class whose properties should be exposed.
+ * @param inst Optional instance of cls used for
+ * resolving Map values.
+ */
+ public MapObjectFieldKeySupport(Class cls, Map inst) {
+ super(cls, false);
+ if (!Map.class.isAssignableFrom(cls)) {
+ throw new IllegalArgumentException(this.getClass().getName()
+ + " is only valid for java.util.Map classes!");
+ }
+ _inst = inst;
+ }
+
+ /**
+ * Return the FieldKey associated with the specified
+ * canonical identifier, if any; otherwise, return
+ * null.
+ *
+ * @param fieldId Canonical identifier of the required field.
+ */
+ public FieldKey getFieldKey(String fieldId) throws DataProviderException {
+ FieldKey key = super.getFieldKey(fieldId);
+ if ((key == null) && (_inst != null)) {
+ if (_inst.get(fieldId) != null) {
+ key = new FieldKey(fieldId);
+ }
+ }
+ return key;
+ }
+
+ /**
+ * Return an array of all supported FieldKeys.
+ */
+ public FieldKey[] getFieldKeys() throws DataProviderException {
+ FieldKey keys[] = super.getFieldKeys();
+ if (_inst != null) {
+ FieldKey tmp[] = new FieldKey[keys.length + _inst.size()];
+ int cnt = 0;
+ // Add all other keys
+ for (FieldKey key : keys) {
+ tmp[cnt++] = key;
+ }
+
+ // Add all Map keys
+ for (Object key : _inst.keySet()) {
+ tmp[cnt++] = new FieldKey(key.toString());
+ }
+ keys = tmp;
+ }
+ return keys;
+ }
+
+ /**
+ * Return the type of the field associated with the specified
+ * FieldKey, if it can be determined; otherwise, return
+ * null.
+ *
+ * @param fieldKey FieldKey to return the type for.
+ */
+ public Class getType(FieldKey fieldKey) throws DataProviderException {
+ Class type = super.getType(fieldKey);
+ if (type == null) {
+ Object obj = _inst.get(fieldKey.getFieldId());
+ if (obj != null) {
+ type = obj.getClass();
+ }
+ }
+ return type;
+ }
+
+
+ /**
+ * Return the value for the specified FieldKey, from the
+ * specified base object.
+ *
+ * @param fieldKey FieldKey for the requested field.
+ * @param base Base object to be used.
+ */
+ public Object getValue(FieldKey fieldKey, Object base) throws DataProviderException {
+ // Make sure we have an instance
+ if (base != null) {
+ _inst = (Map) base;
+ }
+ if (_inst == null) {
+ return null;
+ }
+
+ // Check the properties (super behavior)
+ Object val = super.getValue(fieldKey, _inst);
+
+ // If not found, check the Map
+ if (val == null) {
+ val = _inst.get(fieldKey.getFieldId());
+ }
+
+ // Return the result (if found, null otherwise)
+ return val;
+ }
+
+
+ /**
+ * Return true if the specified value may be successfully
+ * assigned to the specified field. The only time this is false is if
+ * a property of the Map implementation is being set. Map values can
+ * be any Object and therefor will always be true.
+ *
+ * @param fieldKey FieldKey to check assignability for.
+ * @param value Proposed value.
+ */
+ public boolean isAssignable(FieldKey fieldKey, Object value) throws DataProviderException {
+ Class type = super.getType(fieldKey);
+ if (type != null) {
+ // We only do this if we have a property...
+ return super.isAssignable(fieldKey, value);
+ }
+
+ // Return true in all other cases
+ return true;
+ }
+
+ /**
+ * Return the read only state of the field associated with the
+ * specified FieldKey, if it can be determined,
+ * otherwise, return false.
+ *
+ * @param fieldKey FieldKey to return read only state for
+ */
+ public boolean isReadOnly(FieldKey fieldKey) throws DataProviderException {
+ Class type = super.getType(fieldKey);
+ if (type != null) {
+ // We only do this if we have a property...
+ return super.isReadOnly(fieldKey);
+ }
+ return false;
+ }
+
+
+ /**
+ * Set the value for the specified fieldKey,
+ * on the specified base object. If the instance
+ * (base) is already set on this support object, then
+ * base may be null.
+ *
+ * @param fieldKey FieldKey for the requested field.
+ * @param base Base object to be used (null ok if already set).
+ * @param value Value to set.
+ *
+ * @exception NullPointerException If base and _inst are null.
+ * @exception IllegalArgumentException If a type mismatch occurs.
+ * @exception IllegalStateException If setting a read only field.
+ */
+ public void setValue(FieldKey fieldKey, Object base, Object value) throws DataProviderException {
+ if (base != null) {
+ _inst = (Map) base;
+ }
+ Class type = super.getType(fieldKey);
+ if (type != null) {
+ // We only do this if we have a property...
+ super.setValue(fieldKey, _inst, value);
+ } else {
+ _inst.put(fieldKey.getFieldId(), value);
+ }
+ }
+
+ private Map _inst = null;
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/dataprovider/MultipleListDataProvider.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/dataprovider/MultipleListDataProvider.java
new file mode 100644
index 0000000..1745d66
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/dataprovider/MultipleListDataProvider.java
@@ -0,0 +1,636 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://glassfish.dev.java.net/public/CDDLv1.0.html or
+ * glassfish/bootstrap/legal/CDDLv1.0.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at glassfish/bootstrap/legal/CDDLv1.0.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.dataprovider;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Set;
+import java.util.TreeSet;
+
+import com.sun.data.provider.DataProviderException;
+import com.sun.data.provider.FieldKey;
+import com.sun.data.provider.RowKey;
+import com.sun.data.provider.TransactionalDataListener;
+import com.sun.data.provider.impl.IndexRowKey;
+import com.sun.data.provider.impl.ObjectFieldKeySupport;
+import com.sun.data.provider.impl.ObjectListDataProvider;
+
+
+/**
+ * This implementation allows for multiple List objects to
+ * be used to represent table rows. If mulitiple Lists are
+ * used, they must be parallel lists (i.e. have the same # and order of
+ * information).
+ */
+public class MultipleListDataProvider extends ObjectListDataProvider {
+ private static final long serialVersionUID = 1L;
+
+ /**
+ * Default Constructor.
+ */
+ public MultipleListDataProvider() {
+ setIncludeFields(false);
+ }
+
+ /**
+ * Constructor that creates initializes the DataProvider with a
+ * single List. Fields are not included by
+ * default.
+ *
+ * @param list Primary list containing row information.
+ */
+ public MultipleListDataProvider(List> list) {
+ this(list, false);
+ }
+
+ /**
+ * Constructor that creates initializes the DataProvider with a
+ * single List. Fields are included if
+ * includeFields is true.
+ *
+ * @param lists List<List<Object>> to be
+ * wrapped.
+ * @param includeFields Desired include fields property setting
+ */
+ public MultipleListDataProvider(List> lists, boolean includeFields) {
+ // Set the lists
+ setLists(lists);
+
+ // Do not include fields
+ setIncludeFields(false);
+ }
+
+ /**
+ * Constructor for an empty DataProvider with a known
+ * type. This constructor is only useful when there is a single
+ * List. Fields are not included.
+ *
+ * @param objectTypes Desired object type Classes.
+ */
+ public MultipleListDataProvider(Class [] objectTypes) {
+ this(objectTypes, false);
+ }
+
+ /**
+ * Constructor for an empty DataProvider with a known
+ * type. This constructor is only useful when there is a single
+ * List. Fields are included if
+ * includeFields is true.
+ *
+ * @param objTypes Desired object type of Classes
+ * @param includeFields Desired include fields property setting
+ */
+ public MultipleListDataProvider(Class [] objTypes, boolean includeFields) {
+ setObjectTypes(objTypes);
+ setIncludeFields(includeFields);
+ }
+
+// FIXME: Provide apis to manage multiple lists:
+// FIXME: addList(String, List)
+// FIXME: removeList(String)??
+
+ /**
+ * This method returns an array of Object
+ * (Object []) for the given row. Each
+ * array element cooresponds to an Object in one of the
+ * Lists represented by this instance of
+ * MultipleListDataProvider.
+ *
+ * @throws IndexOutOfBoundsException If row is invalid.
+ */
+ public Object getObject(RowKey row) {
+ if (!isRowAvailable(row)) {
+ throw new IndexOutOfBoundsException("" + row);
+ }
+ int rowIdx = getRowIndex(row);
+ List> lists = getLists();
+ Object [] result = new Object[lists.size()];
+ int idx = 0;
+ for (List list : lists) {
+ result[idx++] = list.get(rowIdx);
+ }
+ return result;
+ }
+
+ /**
+ * This method returns an array of array ofObjects
+ * (Object [][]). The first element of the array is the
+ * row, the second cooresponds to the List:
+ * Object[row #][list #]. If there is only one
+ * List represented by this instance of
+ * MultipleListDataProvider, then the list # will be 0;
+ * if there are 2 Lists, then the list # will be 0 or 1,
+ * etc.
+ */
+ public Object [] getObjects() {
+ // Get the array demensions
+ List> lists = getLists();
+ int numLists = lists.size();
+ if (numLists == 0) {
+ // This isn't likely, but just in case...
+ return new Object[0][0];
+ }
+ int numRows = lists.get(0).size();
+ Object [][] result = new Object[numRows][numLists];
+
+ // Fill the array
+ int listNum = 0;
+ for (int rowNum = 0; rowNum < numRows; rowNum++) {
+ listNum = 0;
+ for (List list : lists) {
+ result[rowNum][listNum++] = list.get(rowNum);
+ }
+ }
+
+ // Return the result (Object[rows][lists])
+ return result;
+ }
+
+ /**
+ * This sets the Object type contained in the
+ * List that this MulitpleObjectDataProvider
+ * represents. This method should only be used when there is one
+ * List held by this
+ * MultipleListDataProvider. In cases where you have
+ * more than one list (and likely you do because you are using this
+ * DataProvider), you should use
+ * {@link #setObjectTypes(Class [])}.
+ */
+ public void setObjectType(Class objectType) {
+ setObjectTypes(new Class [] {objectType});
+ }
+
+
+ /**
+ * This method sets the Object types for each List that
+ * is represented by this instance of this class. By doing this, you
+ * allow the FieldKeys to be generated. You only need to specify this
+ * information if you have no rows. If there is some data, that data
+ * will be used to determine the type.
+ *
+ * @param objectTypes The Class types of the row data.
+ */
+ public void setObjectTypes(Class [] objectTypes) {
+ _types = objectTypes;
+ }
+
+ /**
+ * Not supported. This method does not appear to have great value.
+ */
+ public void removeObject(Object object) {
+ throw new UnsupportedOperationException();
+ }
+
+ /**
+ * Not yet supported.
+ *
+ * @param row The RowKey of the row to check.
+ */
+ public boolean isRemoved(RowKey row) {
+ return _deletes.contains(row);
+ }
+
+ /**
+ * Replace the object at the specified row.
+ *
+ * @param row The desired row to set the contained object
+ * @param object The new object to set at the specified row
+ */
+ public void setObject(RowKey row, Object object) {
+ throw new UnsupportedOperationException(this.getClass().getName()
+ + " does not support the setObject(RowKey, Object) method. "
+ + "Instead use setObjects(RowKey, Object []).");
+ }
+
+ /**
+ * This method allows the given row to be replaced with
+ * the given objects.
+ *
+ * @param row The row to replace.
+ * @param objects The array of Objects to use.
+ */
+ public void setObjects(RowKey row, Object [] objects) {
+ Object [] previous = (Object []) getObject(row);
+ int rowNum = getRowIndex(row);
+ int cnt = 0;
+ for (List list : getLists()) {
+ list.set(rowNum, objects[cnt++]);
+ }
+ fireValueChanged(null, row, previous, objects);
+ if (getCursorRow() == row) {
+ fireValueChanged(null, previous, objects);
+ }
+ }
+
+ /**
+ * Not yet supported...
+ */
+ public void addObject(Object object) {
+// FIXME: Add api to add the Object*s* (see addObject(object), must have 1 for each List
+ throw new UnsupportedOperationException();
+ }
+
+ // ---------------------------------------------------- DataProvider Methods
+
+
+ /**
+ *
+ */
+ public FieldKey getFieldKey(String fieldId) throws DataProviderException {
+ return getSupport().getFieldKey(fieldId);
+ }
+
+
+ /**
+ *
+ */
+ public FieldKey [] getFieldKeys() throws DataProviderException {
+ return getSupport().getFieldKeys();
+ }
+
+ /**
+ *
+ */
+ public Class getType(FieldKey fieldKey) throws DataProviderException {
+ return getSupport().getType(fieldKey);
+ }
+
+ /**
+ *
+ */
+ public boolean isReadOnly(FieldKey fieldKey) throws DataProviderException {
+ return getSupport().isReadOnly(fieldKey);
+ }
+
+// FIXME: The following method is very difficult to implement correctly b/c
+// FIXME: the super class uses its own private "getSupport()" method which will
+// FIXME: return the wrong "support" class. However, the superclass is also
+// FIXME: managing the "updates" so we must call it... Ask Creator group to
+// FIXME: properly expose "support" via an interface and get/setSupport()
+// FIXME: methods. Or ask them to provide access to the updates/deletes/etc.
+// FIXME: properties.
+//
+// FIXME: OK... it appears that they ObjectListDataProvider does not utilize the FieldKey methods in its superclass and instead maintains a private list via its support class. This means I cannot do anything to make this method work with updates!!!
+ /**
+ *
+ */
+ public Object getValue(FieldKey fieldKey, RowKey rowKey) throws DataProviderException {
+ Object val = null;
+ try {
+ // This will try to get the value, but is unlikely to succeed...
+ val = super.getValue(fieldKey, rowKey);
+ } catch(Exception ex) {
+ // Now check the "right" support class...
+ if (getSupport().getFieldKey(fieldKey.getFieldId()) == null) {
+ throw new IllegalArgumentException("" + fieldKey);
+ }
+
+ // Make sure it's a valid row key...
+ if (!isRowAvailable(rowKey)) {
+ throw new IndexOutOfBoundsException("" + rowKey);
+ }
+ int index = getRowIndex(rowKey);
+ if (index < getRowCount()) {
+ val = getSupport().getValue(
+ fieldKey, getListForFieldKey(fieldKey).get(index));
+ } else {
+// FIXME: Need to manually implement appends, updates, and deletes!! :(
+// return getSupport().getValue(fieldKey, appends.get(index - getRowCount()));
+ }
+ }
+ return val;
+ }
+
+ /**
+ *
+ */
+ public void setValue(FieldKey fieldKey, RowKey rowKey, Object value) throws DataProviderException {
+ if (getSupport().getFieldKey(fieldKey.getFieldId()) == null) {
+ throw new IllegalArgumentException("" + fieldKey);
+ }
+ if (getSupport().isReadOnly(fieldKey)) {
+ throw new IllegalStateException("" + fieldKey);
+ }
+ if (!isRowAvailable(rowKey)) {
+ throw new IndexOutOfBoundsException("" + rowKey);
+ }
+
+ // Retrieve the previous value and determine if it has changed
+ Object previous = getValue(fieldKey, rowKey);
+ if (((previous == null) && (value == null)) ||
+ ((previous != null) && (value != null) && previous.equals(value))) {
+ return; // No change
+ }
+
+ // Verify type compatibility of the proposed new value
+ if (!getSupport().isAssignable(fieldKey, value)) {
+ throw new IllegalArgumentException(fieldKey + " = " + value); // NOI18N
+ }
+
+// FIXME: Need to explicitly support updates (can't get via polymorphism due to bad design)! :(
+/*
+ // Record a pending change for this row and field
+ Map fieldUpdates = (Map) updates.get(rowKey);
+ if (fieldUpdates == null) {
+ fieldUpdates = new HashMap();
+ updates.put(rowKey, fieldUpdates);
+ }
+ fieldUpdates.put(fieldKey, value);
+*/
+ //Remove the following set line and defer until commit() once updates/deletes/etc. is worked out
+ int index = getRowIndex(rowKey);
+ getSupport().setValue(
+ fieldKey, getListForFieldKey(fieldKey).get(index), value);
+
+ fireValueChanged(fieldKey, rowKey, previous, value);
+ fireValueChanged(fieldKey, previous, value);
+ }
+
+ /**
+ * Construct new instances for each List represented by
+ * this class and appended them to each List.
+ */
+ public RowKey appendRow() throws DataProviderException {
+// FIXME: Support this!
+ throw new UnsupportedOperationException();
+ }
+
+ /**
+ *
This method returns true if rows may be appended.
+ */
+ public boolean canAppendRow() throws DataProviderException {
+ return (isUserResizable() && (getObjectTypes() != null));
+ }
+
+ /**
+ * This method is not supported.
+ *
+ * @param object Object to be appended.
+ */
+ public RowKey appendRow(Object object) throws DataProviderException {
+// FIXME: Support this!
+ throw new UnsupportedOperationException();
+ }
+
+ /**
+ * Remove the object at the specified row from the list.
+ *
+ * {@inheritDoc}
+ */
+ public void removeRow(RowKey rowKey) throws DataProviderException {
+ // Verify we can actually remove this row
+ if (!canRemoveRow(rowKey)) {
+// FIXME: I18N
+ throw new IllegalStateException(
+ "This ObjectListDataProvider is not resizable.");
+ }
+ if (!isRowAvailable(rowKey)) {
+// FIXME: I18N
+ throw new IllegalArgumentException(
+ "Cannot delete row for row key " + rowKey);
+ }
+
+ // Record the fact that we are going to delete this row
+ _deletes.add(rowKey);
+
+ // Fire appropriate events regarding this deletion
+ fireRowRemoved(rowKey);
+ if (getCursorRow() == rowKey) {
+ fireValueChanged(null, getObject(rowKey), null);
+ }
+ }
+
+ /**
+ * This method returns the # of rows represented by this
+ * MultipleListDataProvider.
+ */
+ public int getRowCount() throws DataProviderException {
+ List> lists = getLists();
+ int count = 0;
+ if ((lists != null) && (lists.size() != 0)) {
+ count = lists.get(0).size();
+ }
+ return count;
+ }
+
+ /**
+ * Return true if the specified RowKey
+ * represents a row in the original list, or a row that has been
+ * appended.
+ *
+ * @param row RowKey to test for availability.
+ */
+ public boolean isRowAvailable(RowKey row) throws DataProviderException {
+ int idx = getRowIndex(row);
+ if (idx < 0) {
+ return false;
+ }
+ if (idx < (getRowCount() /* + appendCount */)) {
+ return true;
+ }
+ return false;
+ }
+
+ // --------------------------------------- TransactionalDataProvider Methods
+ /**
+ * Cause any cached updates to existing field values, as well as
+ * inserted and deleted rows, to be flowed through to the underlying
+ * Lists wrapped by this DataProvider.
+ */
+ public void commitChanges() throws DataProviderException {
+ // FIXME: Do updates here... (see super())
+
+ // Commit pending deletes
+ // Iterate backwards so that we correctly modify List
+ RowKey deletes[] = (RowKey[])
+ _deletes.toArray(new RowKey[_deletes.size()]);
+ int rowIdx = -1;
+ for (int idx = (deletes.length - 1); idx >= 0; idx--) {
+ rowIdx = getRowIndex(deletes[idx]);
+ for (List list : getLists()) {
+ list.remove(rowIdx);
+ }
+ }
+ _deletes.clear();
+
+ // FIXME: Deal w/ appends (see super())
+
+ // Notify interested listeners that we have committed
+ fireChangesCommitted();
+ }
+
+ /**
+ * Fire a changesCommitted method to all registered
+ * listeners.
+ */
+ protected void fireChangesCommitted() {
+// FIXME: This method overrides a method by the same name in the superclass that is private! The super() should make this protected.
+ TransactionalDataListener listeners[] = getTransactionalDataListeners();
+ for (int i = 0; i < listeners.length; i++) {
+ listeners[i].changesCommitted(this);
+ }
+ }
+
+
+ /**
+ * Fire a changesReverted method to all registered
+ * listeners.
+ */
+ private void fireChangesReverted() {
+// FIXME: This method overrides a method by the same name in the superclass that is private! The super() should make this protected.
+ TransactionalDataListener listeners[] = getTransactionalDataListeners();
+ for (int i = 0; i < listeners.length; i++) {
+ listeners[i].changesReverted(this);
+ }
+ }
+
+ /**
+ *
+ */
+ public void revertChanges() throws DataProviderException {
+ // FIXME: Do updates here... (see super())
+ //updates.clear();
+
+ _deletes.clear();
+
+ // FIXME: Deal w/ appends
+ //appends.clear();
+
+ // Notify interested listeners that we are reverting
+ fireChangesReverted();
+ }
+
+ /**
+ * Accessor for the List of Lists.
+ */
+ public List> getLists() {
+ return _lists;
+ }
+
+ /**
+ * Setter for the List of Lists.
+ */
+ public void setLists(List> lists) {
+ _lists = lists;
+ }
+
+ /**
+ * This method returns
+ */
+ public List getListForFieldKey(FieldKey key) {
+ if ((key != null) && !(key instanceof IndexFieldKey)) {
+ key = support.getFieldKey(key.getFieldId());
+ }
+ if (key == null) {
+ throw new IllegalArgumentException("Invalid FieldKey: " + key);
+ }
+ return getLists().get(((IndexFieldKey) key).getIndex());
+ }
+
+ /**
+ *
The cached support object for field key manipulation. Must be
+ * transient because its content is not Serializable.
+ */
+ private transient MultipleObjectFieldKeySupport support = null;
+
+
+ /**
+ * Return the {@link ObjectFieldKeySupport} instance for the object
+ * class we are wrapping.
+ */
+ private MultipleObjectFieldKeySupport getSupport() {
+ if (support == null) {
+ // Try to get first element of the list to help find FieldKeys
+ Object [] objs = (Object []) getObject(getRowKey(0));
+ if ((objs != null) && (objs.length > 0)) {
+ support = new MultipleObjectFieldKeySupport(
+ objs, isIncludeFields());
+ }
+// else {
+// FIXME: Add ability to use other meta information (i.e. _types and/or special class to describe info (i.e. for Maps)) to do this.
+// }
+ }
+ return support;
+ }
+
+ /**
+ * This method converts the given rowKey to an
+ * int.
+ */
+ protected int getRowIndex(RowKey rowKey) {
+// FIXME: This method overrides a private method by the same name... that method shouldn't be private!
+ if (rowKey instanceof IndexRowKey) {
+ return ((IndexRowKey) rowKey).getIndex();
+ }
+ return -1;
+ }
+
+ /**
+ * This method converts the given int to a
+ * RowKey.
+ */
+ protected RowKey getRowKey(int index) {
+ return new IndexRowKey(index);
+ }
+
+
+ ////////////////////////////////////////////////////////////////////////
+ // Unsupported Methods
+ ////////////////////////////////////////////////////////////////////////
+
+ /**
+ * This method is not supported.
+ */
+ public Class getObjectType() {
+ throw new UnsupportedOperationException(this.getClass().getName()
+ + " does not support the getObjectType() method because it "
+ + "must return multiple types. Please use \"Class [] "
+ + "getObjectTypes()\" instead.");
+ }
+
+ /**
+ * This method returns an array of Class [] representing
+ * the Object types represented by this instance of this
+ * class.
+ */
+ public Class [] getObjectTypes() {
+ return _types;
+ }
+
+ /**
+ * Storage for our List of Lists.
+ */
+ private List> _lists = new ArrayList>();
+
+ /**
+ * Type information for the LIsts.
+ */
+ private Class [] _types = null;
+
+ /**
+ * Set of {@link RowKey}s marked to be deleted. An
+ * Iterator over this set will return the corresponding
+ * {@link RowKey}s in ascending order.
+ */
+ protected Set _deletes = new TreeSet();
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/dataprovider/MultipleObjectFieldKeySupport.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/dataprovider/MultipleObjectFieldKeySupport.java
new file mode 100644
index 0000000..2ea483e
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/dataprovider/MultipleObjectFieldKeySupport.java
@@ -0,0 +1,248 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://glassfish.dev.java.net/public/CDDLv1.0.html or
+ * glassfish/bootstrap/legal/CDDLv1.0.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at glassfish/bootstrap/legal/CDDLv1.0.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.dataprovider;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import java.util.TreeSet;
+
+import com.sun.data.provider.DataProviderException;
+import com.sun.data.provider.FieldKey;
+import com.sun.data.provider.impl.ObjectFieldKeySupport;
+
+
+/**
+ * Support class for DataProvider implementations that need
+ * to instrospect Java classes to discover properties, Map values, or
+ * public fields (optional) and return FieldKey instances for
+ * them. This implementation provides support for multiple Objects.
+ */
+public class MultipleObjectFieldKeySupport {
+
+ /**
+ * Construct a new support instance wrapping the specified classes,
+ * with the specified flag for including public fields.
+ *
+ * @param classes Class whose properties should be exposed.
+ * @param includeFields Flag indicating whether public fields should
+ * also be included.
+ public MultipleObjectFieldKeySupport(Class classes[], boolean includeFields) {
+ for (Class cls : classes) {
+ }
+ }
+ */
+
+ /**
+ * Construct a new support instance wrapping the specified objects,
+ * with the specified flag for including public fields.
+ *
+ * @param objs Class whose properties should be exposed.
+ * @param includeFields Flag indicating whether public fields should
+ * also be included.
+ */
+ public MultipleObjectFieldKeySupport(Object objs[], boolean includeFields) {
+ _children = new ArrayList();
+ for (Object obj : objs) {
+ if (obj instanceof Map) {
+ _children.add(
+ new MapObjectFieldKeySupport(obj.getClass(), (Map) obj));
+ } else {
+ _children.add(
+ new ObjectFieldKeySupport(obj.getClass(), includeFields));
+ }
+ }
+ }
+
+ /**
+ * Return the FieldKey associated with the specified
+ * canonical identifier, if any; otherwise, return
+ * null.
+ *
+ * @param fieldId Canonical identifier of the required field.
+ */
+ public FieldKey getFieldKey(String fieldId) throws DataProviderException {
+ FieldKey key = null;
+ int idx = 0;
+ for (ObjectFieldKeySupport support : _children) {
+ key = support.getFieldKey(fieldId);
+ if (key != null) {
+ key = new IndexFieldKey(key, idx);
+ break;
+ }
+ idx++;
+ }
+ return key;
+ }
+
+
+ /**
+ * Return an array of all supported FieldKeys.
+ */
+ public FieldKey[] getFieldKeys() throws DataProviderException {
+ Set keys = new TreeSet();
+ FieldKey keyArr[] = null;
+ int idx = 0;
+ for (ObjectFieldKeySupport support : _children) {
+ keyArr = support.getFieldKeys();
+ for (int cnt = 0; cnt < keyArr.length; cnt++) {
+ keyArr[cnt] = new IndexFieldKey(keyArr[cnt], idx++);
+ }
+ keys.addAll(Arrays.asList(keyArr));
+ }
+ return keys.toArray(new FieldKey[keys.size()]);
+ }
+
+
+ /**
+ * Return the type of the field associated with the specified
+ * FieldKey, if it can be determined; otherwise, return
+ * null.
+ *
+ * @param fieldKey FieldKey for which to return the type.
+ */
+ public Class getType(FieldKey fieldKey) throws DataProviderException {
+ Class type = null;
+ if (fieldKey instanceof IndexFieldKey) {
+ type = _children.get(((IndexFieldKey) fieldKey).getIndex()).
+ getType(fieldKey);
+ } else {
+ for (ObjectFieldKeySupport support : _children) {
+ type = support.getType(fieldKey);
+ if (type != null) {
+ break;
+ }
+ }
+ }
+ return type;
+ }
+
+ /**
+ * Return the value for the specified FieldKey, from the
+ * specified base object.
+ *
+ * @param fieldKey FieldKey for the requested field.
+ * @param base Base object to be used.
+ */
+ public Object getValue(FieldKey fieldKey, Object base) throws DataProviderException {
+ Object value = null;
+ if (fieldKey instanceof IndexFieldKey) {
+ value = _children.get(((IndexFieldKey) fieldKey).getIndex()).
+ getValue(fieldKey, base);
+ } else {
+ for (ObjectFieldKeySupport support : _children) {
+ value = support.getValue(fieldKey, base);
+ if (value != null) {
+ break;
+ }
+ }
+ }
+ return value;
+ }
+
+ /**
+ * Return true if the specified value may be successfully
+ * assigned to the specified field.
+ *
+ * @param fieldKey FieldKey to check assignability.
+ * @param value Proposed value.
+ */
+ public boolean isAssignable(FieldKey fieldKey, Object value) throws DataProviderException {
+ boolean assignable = false;
+ if (fieldKey instanceof IndexFieldKey) {
+ assignable = _children.get(((IndexFieldKey) fieldKey).getIndex()).
+ isAssignable(fieldKey, value);
+ } else {
+ for (ObjectFieldKeySupport support : _children) {
+ assignable = support.isAssignable(fieldKey, value);
+ if (assignable) {
+ break;
+ }
+ }
+ }
+ return assignable;
+ }
+
+ /**
+ * Return the read only state of the field associated with the
+ * specified FieldKey, if it can be determined,
+ * otherwise, return true.
+ *
+ * @param fieldKey FieldKey to check.
+ */
+ public boolean isReadOnly(FieldKey fieldKey) throws DataProviderException {
+ boolean readOnly = true;
+ if (fieldKey instanceof IndexFieldKey) {
+ readOnly = _children.get(((IndexFieldKey) fieldKey).getIndex()).
+ isReadOnly(fieldKey);
+ } else {
+ FieldKey fk = null;
+ for (ObjectFieldKeySupport support : _children) {
+ fk = support.getFieldKey(fieldKey.getFieldId());
+ if (fk != null) {
+ // Only call support for the one that claims it has a FieldKey!
+ readOnly = support.isReadOnly(fieldKey);
+ break;
+ }
+ }
+ }
+ return readOnly;
+ }
+
+
+ /**
+ * Set the value for the specified FieldKey, on the
+ * specified base object.
+ *
+ * @param fieldKey FieldKey for the requested field.
+ * @param base Base object to be used.
+ * @param value Value to be set.
+ *
+ * @exception IllegalArgumentException If a type mismatch occurs
+ * @exception IllegalStateException If setting a read only field
+ * is attempted.
+ */
+ public void setValue(FieldKey fieldKey, Object base, Object value) throws DataProviderException {
+ if (fieldKey instanceof IndexFieldKey) {
+ _children.get(((IndexFieldKey) fieldKey).getIndex()).
+ setValue(fieldKey, base, value);
+ } else {
+ FieldKey fk = null;
+ for (ObjectFieldKeySupport support : _children) {
+ fk = support.getFieldKey(fieldKey.getFieldId());
+ if (fk != null) {
+ // Only call support for the one that claims it has a FieldKey!
+ support.setValue(fieldKey, base, value);
+ break;
+ }
+ }
+ }
+ }
+
+ /**
+ * This list hold the child ObjectFieldKeySupport implementations.
+ */
+ private List _children = null;
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/dataprovider/README.txt b/jsftemplating/src/main/java/com/sun/jsftemplating/component/dataprovider/README.txt
new file mode 100644
index 0000000..0302348
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/dataprovider/README.txt
@@ -0,0 +1,17 @@
+The files in this directory extend the capabilities of the DataProvider API.
+The Woodstock (sun) and Creator (rave) components make use of the
+dataprovider APIs.
+
+Data Provider APIs are part of Visual web Pack (also part of Java Studio
+Creator). You can get the sources for the dataproviders from VisualWeb module
+that is open sourced as a sub project on netbeans.org. You can either download
+a source bundle or checkout the sources. Instructions are here:
+
+ http://visualweb.netbeans.org/
+
+Once you have the sources, you will find the data provider sources under:
+
+ visualweb\dataprovider\runtime\library\src\com\sun\data\provider
+
+
+ (above instructions from Jayashri)
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ComponentFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ComponentFactory.java
new file mode 100644
index 0000000..7d2589c
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ComponentFactory.java
@@ -0,0 +1,76 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory;
+
+import java.io.Serializable;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This interface must be implemented by all UIComponent factories.
+ * This enabled UIComponents to be created via a consistent interface.
+ * This is critical to classes such as
+ * {@link com.sun.jsftemplating.component.TemplateComponentBase}
+ * and {@link LayoutComponent}.
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+public interface ComponentFactory {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created UIComponent.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent);
+
+ /**
+ * This method returns the extraInfo that was set for this
+ * ComponentFactory from the
+ * {@link com.sun.jsftemplating.layout.descriptors.ComponentType}.
+ */
+ public Serializable getExtraInfo();
+
+ /**
+ * This method is invoked from the
+ * {@link com.sun.jsftemplating.layout.descriptors.ComponentType} to
+ * provide more information to the factory. For example, if the JSF
+ * component type was passed in, a single factory class could
+ * instatiate multiple components the extra info that is passed in.
+ *
+ * Some factory implementations may want to use this method to
+ * execute intialization code for the factory based in the value
+ * passed in.
+ */
+ public void setExtraInfo(Serializable extraInfo);
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ComponentFactoryBase.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ComponentFactoryBase.java
new file mode 100644
index 0000000..ae3c0d6
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ComponentFactoryBase.java
@@ -0,0 +1,295 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory;
+
+import java.io.Serializable;
+import java.lang.reflect.Method;
+import java.util.HashMap;
+import java.util.Iterator;
+import java.util.List;
+import java.util.Map;
+
+import javax.el.ValueExpression;
+import javax.faces.component.ActionSource;
+import javax.faces.component.EditableValueHolder;
+import javax.faces.component.UIComponent;
+import javax.faces.component.UIViewRoot;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.component.ComponentUtil;
+import com.sun.jsftemplating.el.VariableResolver;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+import com.sun.jsftemplating.layout.descriptors.handler.Handler;
+import com.sun.jsftemplating.layout.event.CommandActionListener;
+import com.sun.jsftemplating.layout.event.ValueChangeListener;
+import com.sun.jsftemplating.util.LogUtil;
+
+
+/**
+ * This abstract class provides common functionality for UIComponent
+ * factories.
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+public abstract class ComponentFactoryBase implements ComponentFactory {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created UIComponent.
+ */
+ public abstract UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent);
+
+ /**
+ * This method iterates through the Map of options. It looks at each
+ * one, if it contians an EL expression, it sets a value binding.
+ * Otherwise, it calls setAttribute() on the component (which in turn
+ * will invoke the bean setter if there is one).
+ *
+ * This method also interates through the child
+ * LayoutElements of the given {@link LayoutComponent}
+ * descriptor and adds Facets or children as appropriate.
+ *
+ * @param context The FacesContext
+ * @param desc The {@link LayoutComponent} descriptor associated with
+ * the requested UIComponent.
+ * @param comp The UIComponent
+ */
+ protected void setOptions(FacesContext context, LayoutComponent desc, UIComponent comp) {
+ if (desc == null) {
+ // Nothing to do
+ return;
+ }
+
+ // First set the id if supplied, treated special b/c the component
+ // used for ${} expressions is the parent and this must be set first
+ // so other ${} expressions can use $this{id} and $this{clientId}.
+ String compId = (String) desc.getId(context, comp.getParent());
+ if ((compId != null) && (!compId.equals(""))) {
+ comp.setId(compId);
+ }
+
+ // Loop through all the options and set the values
+// FIXME: Figure a way to skip options that should not be set on the Component
+ Iterator it = desc.getOptions().keySet().iterator();
+ String key = null;
+ while (it.hasNext()) {
+ // Get next property
+ key = it.next();
+
+ setOption(context, comp, desc, key, desc.getOption(key));
+ }
+
+ // Check for "command" handlers...
+ List handlers = desc.getHandlers(LayoutComponent.COMMAND);
+ if ((handlers != null) && (comp instanceof ActionSource)) {
+ ((ActionSource) comp).addActionListener(
+ CommandActionListener.getInstance());
+ }
+
+ // Check for "valueChange" handlers...
+ handlers = desc.getHandlers(ValueChangeListener.VALUE_CHANGE);
+ if ((handlers != null) && (comp instanceof EditableValueHolder)) {
+ ((EditableValueHolder) comp).addValueChangeListener(
+ ValueChangeListener.getInstance());
+ }
+
+ // Set the events on the new component
+ storeInstanceHandlers(desc, comp);
+ }
+
+ /**
+ * This method sets an individual option on the
+ * UIComponent. It will check to see if it is a
+ * ValueExpression, if it is it will store it as
+ * such.
+ */
+ protected void setOption(FacesContext context, UIComponent comp, LayoutComponent desc, String key, Object value) {
+ ComponentUtil.getInstance(context).setOption(context, key, value, desc, comp);
+ }
+
+ /**
+ * This method is responsible for interating over the "instance"
+ * handlers and applying them to the UIComponent. An "instance"
+ * handler is one that is defined outside a renderer, or a
+ * nested component within a renderer. In other words, a handler
+ * that would not get fired by the TemplateRenderer. By passing this
+ * in via the UIComponent, code that is aware of events (see
+ * {@link com.sun.jsftemplating.layout.descriptors.LayoutElementBase})
+ * may find these events and fire them. These may vary per "instance"
+ * of a particular component (i.e. TreeNode) unlike the
+ * handlers defined in a TemplateRender's XML (which are shared and
+ * therefor should not change dynamically).
+ *
+ * This method is invoked from setOptions(), however, if setOptions
+ * is not used in by a factory, this method may be invoked directly.
+ * Calling this method multiple times will not cause any harm,
+ * besides making an extra unnecessary call.
+ *
+ * @param desc The descriptor potentially containing handlers to copy.
+ * @param comp The UIComponent instance to store the handlers.
+ */
+ protected void storeInstanceHandlers(LayoutComponent desc, UIComponent comp) {
+ if (!desc.isNested()) {
+ UIComponent parent = comp.getParent();
+ if ((parent == null) || (parent instanceof UIViewRoot)) {
+ // This is not a nested LayoutComponent, it should not store
+ // instance handlers
+ // NOTE: could skip TemplateComponent children also. Although
+ // this is harder to detect as dynamic children aren't
+ // defined in the template and therefor must be stored in
+ // the UIComponent tree.
+ return;
+ }
+ }
+
+ // Iterate over the instance handlers
+ Iterator it = desc.getHandlersByTypeMap().keySet().iterator();
+ if (it.hasNext()) {
+ String eventType = null;
+ Map compAttrs = comp.getAttributes();
+ while (it.hasNext()) {
+ // Assign instance handlers to attribute for retrieval later
+ // (NOTE: retrieval must be explicit, see LayoutElementBase)
+ eventType = it.next();
+ if (eventType.equals(LayoutComponent.BEFORE_CREATE)) {
+ // This is handled directly, no need for instance handler
+ continue;
+ } else if (eventType.equals(LayoutComponent.AFTER_CREATE)) {
+ // This is handled directly, no need for instance handler
+ continue;
+ }
+ compAttrs.put(eventType, desc.getHandlers(eventType));
+ }
+ }
+ }
+
+ /**
+ * This method associates the given child with the given parent. By
+ * using this method we centralize the code so that if we decide
+ * later to add it as a real child it can be done in one place.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ * @param child The child UIComponent
+ */
+ protected void addChild(FacesContext context, LayoutComponent descriptor, UIComponent parent, UIComponent child) {
+ // Check to see if we should add this as a facet. NOTE: We add
+ // UIViewRoot children as facets b/c we render them via the
+ // LayoutElement tree.
+ String facetName = descriptor.getFacetName(parent);
+ if (facetName != null) {
+ // Add child as a facet...
+ if (LogUtil.configEnabled() && facetName.equals("_noname")) {
+ // Warn the developer that they may have a problem
+ LogUtil.config("Warning: no id was supplied for "
+ + "component '" + child + "'!");
+ }
+ // Resolve the id if its dynamic
+ facetName = (String) ComponentUtil.getInstance(context).resolveValue(
+ context, descriptor, child, facetName);
+ parent.getFacets().put(facetName, child);
+ } else {
+ // Add this as an actual child
+ parent.getChildren().add(child);
+ }
+ }
+
+ /**
+ * This method instantiates the UIComponent given its
+ * ComponentType. It will respect the
+ * binding property so that a UIComponent
+ * can be created via the binding property. While a
+ * custom {@link ComponentFactory} can do a better job, at times it
+ * may be desirable to use binding instead.
+ */
+ protected UIComponent createComponent(FacesContext ctx, String componentType, LayoutComponent desc, UIComponent parent) {
+ UIComponent comp = null;
+
+ // Check for the "binding" property
+ String binding = null;
+ if (desc != null) {
+ binding =
+ (String) desc.getEvaluatedOption(ctx, "binding", parent);
+ }
+ if ((binding != null) && ComponentUtil.getInstance(ctx).isValueReference(binding)) {
+ // Create a ValueExpression
+ ValueExpression ve =
+ ctx.getApplication().getExpressionFactory().
+ createValueExpression(
+ ctx.getELContext(), binding, UIComponent.class);
+ // Create / get the UIComponent
+ comp = ctx.getApplication().createComponent(
+ ve, ctx, componentType);
+ } else {
+ // No binding, do the normal way...
+ comp = ctx.getApplication().createComponent(componentType);
+ }
+
+ // Parent the new component
+ if (parent != null) {
+ addChild(ctx, desc, parent, comp);
+ }
+
+ // Return it...
+ return comp;
+ }
+
+ /**
+ * This method returns the extraInfo that was set for this
+ * ComponentFactory from the
+ * {@link com.sun.jsftemplating.layout.descriptors.ComponentType}.
+ */
+ public Serializable getExtraInfo() {
+ return _extraInfo;
+ }
+
+ /**
+ * This method is invoked from the
+ * {@link com.sun.jsftemplating.layout.descriptors.ComponentType} to
+ * provide more information to the factory. For example, if the JSF
+ * component type was passed in, a single factory class could
+ * instatiate multiple components the extra info that is passed in.
+ *
+ * Some factory implementations may want to override this method to
+ * execute intialization code for the factory based in the value
+ * passed in.
+ */
+ public void setExtraInfo(Serializable extraInfo) {
+ _extraInfo = extraInfo;
+ }
+
+ /**
+ * Extra information associated with this ComponentFactory.
+ */
+ private Serializable _extraInfo = null;
+
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/basic/EventComponentFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/basic/EventComponentFactory.java
new file mode 100644
index 0000000..6ed2c47
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/basic/EventComponentFactory.java
@@ -0,0 +1,68 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.basic;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating an EventComponent
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "event".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("event")
+public class EventComponentFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created EventComponent.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ public static final String COMPONENT_TYPE = "com.sun.jsftemplating.EventComponent";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/basic/ForEachFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/basic/ForEachFactory.java
new file mode 100644
index 0000000..09151fc
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/basic/ForEachFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.basic;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating an ForEach
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "foreach".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("foreach")
+public class ForEachFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created ForEach.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.jsftemplating.ForEach";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/basic/GenericFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/basic/GenericFactory.java
new file mode 100644
index 0000000..107f846
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/basic/GenericFactory.java
@@ -0,0 +1,100 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.basic;
+
+import java.io.Serializable;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is capable of creating any UIComponent that can be created
+ * via the Application.createComponent(componentType)
+ * method. It requires that the componentType property be
+ * set indicating what type of component should be instantiated.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "component".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("component")
+public class GenericFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent. It requires that the "componentType"
+ * attribute be supplied with a valid JSF ComponentType. This may
+ * be supplied in the page on a per-use basis, or on an instance of
+ * this Factory via the
+ * {@link ComponentFactoryBase#setExtraInfo(Serializable)}
+ * method.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created UIComponent.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Determine the componentType
+ String componentType = (String) descriptor.getEvaluatedOption(context, COMPONENT_TYPE, parent);
+ if (componentType == null) {
+ Serializable extraInfo = getExtraInfo();
+ if (extraInfo != null) {
+ // This component allows the (default) CompnentType to be set
+ // on the factory.
+ componentType = extraInfo.toString();
+ } else {
+ throw new IllegalArgumentException(
+ "\">component<\" requires a \"" + COMPONENT_TYPE
+ + "\" property to be set to the componentType of the "
+ + "component you wish to create.");
+ }
+ }
+
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, componentType, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * This the is the property name ("componentType") that will be used
+ * to define the componentType to be used to create the
+ * UIComponent. This much match the defined component
+ * type in the faces-config.xml file (this is usually stored along
+ * with the component .class files in the component's jar file).
+ */
+ public static final String COMPONENT_TYPE = "componentType";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/basic/IfFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/basic/IfFactory.java
new file mode 100644
index 0000000..51965d9
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/basic/IfFactory.java
@@ -0,0 +1,79 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.basic;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating an If
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "if".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("if")
+public class IfFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created If.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // (re)set the "condition" property to avoid using an evaluated version
+ Object val = descriptor.getOption("condition");
+ if (val != null) {
+ comp.getAttributes().put("condition", val);
+ }
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.jsftemplating.If";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/basic/MessageFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/basic/MessageFactory.java
new file mode 100644
index 0000000..f2b6e2e
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/basic/MessageFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.basic;
+
+import javax.faces.component.UIComponent;
+import javax.faces.component.UIMessage;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a UIMessage
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "message".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("message")
+public class MessageFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created UIMessage.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIMessage comp = new UIMessage();
+
+ // This needs to be done here (before setOptions) so that $...{...}
+ // expressions can be resolved... may want to defer these?
+ if (parent != null) {
+ addChild(context, descriptor, parent, comp);
+ }
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/basic/StaticTextFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/basic/StaticTextFactory.java
new file mode 100644
index 0000000..34b3916
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/basic/StaticTextFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.basic;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating an StaticText
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "staticText".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("staticText")
+public class StaticTextFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created StaticText.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.jsftemplating.StaticText";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/basic/WhileFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/basic/WhileFactory.java
new file mode 100644
index 0000000..0b01cb8
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/basic/WhileFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.basic;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating an While
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "while".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("while")
+public class WhileFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created While.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.jsftemplating.While";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/jmaki/AjaxWrapperFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/jmaki/AjaxWrapperFactory.java
new file mode 100644
index 0000000..2dc3d48
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/jmaki/AjaxWrapperFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.jmaki;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a jMaki
+ * AjaxWrapper UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "jmaki:ajax".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("jmaki:ajax")
+public class AjaxWrapperFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created AjaxWrapper.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "AjaxWrapper";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/jmaki/ExtensionFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/jmaki/ExtensionFactory.java
new file mode 100644
index 0000000..69f997e
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/jmaki/ExtensionFactory.java
@@ -0,0 +1,76 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.jmaki;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a jMaki
+ * Extension UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "jmaki:extension".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("jmaki:extension")
+public class ExtensionFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created Extension.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // jMaki doesn't do this -- 3/4/2008
+ comp.setRendererType("jmaki.ExtensionRenderer");
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "jmaki.Extension";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/jmaki/PageFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/jmaki/PageFactory.java
new file mode 100644
index 0000000..4120f69
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/jmaki/PageFactory.java
@@ -0,0 +1,76 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.jmaki;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a jMaki
+ * Page UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "jmaki:page".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("jmaki:page")
+public class PageFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created Page.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // jMaki doesn't do this -- 3/4/2008
+ comp.setRendererType("jmaki.PageRenderer");
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "jmaki.Page";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/jmaki/ResourcesFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/jmaki/ResourcesFactory.java
new file mode 100644
index 0000000..1a44a32
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/jmaki/ResourcesFactory.java
@@ -0,0 +1,76 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.jmaki;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a jMaki
+ * Resources UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "jmaki:resources".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("jmaki:resources")
+public class ResourcesFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created Resources.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // jMaki doesn't do this -- 3/4/2008
+ comp.setRendererType("jmaki.ResourcesRenderer");
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "jmaki.Resources";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/jmaki/WidgetFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/jmaki/WidgetFactory.java
new file mode 100644
index 0000000..19772e1
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/jmaki/WidgetFactory.java
@@ -0,0 +1,76 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.jmaki;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a jMaki
+ * Widget UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "jmaki:widget".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("jmaki:widget")
+public class WidgetFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created Widget.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // jMaki doesn't do this -- 3/4/2008
+ comp.setRendererType("jmaki.WidgetRenderer");
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "jmaki.Widget";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/jsfext/AjaxZoneFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/jsfext/AjaxZoneFactory.java
new file mode 100644
index 0000000..2f801b7
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/jsfext/AjaxZoneFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.jsfext;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating an AjaxZone
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "jsfExt:ajaxZone".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("jsfExt:ajaxZone")
+public class AjaxZoneFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating an
+ * AjaxZone UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created AjaxZone UIComponent.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.faces.AjaxZone";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/jsfext/ScriptsFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/jsfext/ScriptsFactory.java
new file mode 100644
index 0000000..2e3bf7a
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/jsfext/ScriptsFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.jsfext;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a Scripts
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "jsfExt:scripts".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("jsfExt:scripts")
+public class ScriptsFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created Scripts UIComponent.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.faces.extensions.avatar.Scripts";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/BodyFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/BodyFactory.java
new file mode 100644
index 0000000..8745a04
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/BodyFactory.java
@@ -0,0 +1,79 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2009 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a Body
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:body".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:body")
+public class BodyFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created Body.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+ comp.setRendererType(RENDERER_TYPE);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.Output";
+
+ /**
+ * The default RendererType to set on the newly created component.
+ */
+ public static final String RENDERER_TYPE = "javax.faces.Body";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/ColumnFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/ColumnFactory.java
new file mode 100644
index 0000000..d042eb2
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/ColumnFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a Column
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:column".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:column")
+public class ColumnFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created Column.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.Column";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/CommandButtonFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/CommandButtonFactory.java
new file mode 100644
index 0000000..6f0b4dc
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/CommandButtonFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a CommandButton
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:commandButton".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:commandButton")
+public class CommandButtonFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created CommandButton.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.HtmlCommandButton";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/CommandLinkFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/CommandLinkFactory.java
new file mode 100644
index 0000000..292a86d
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/CommandLinkFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a CommandLink
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:commandLink".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:commandLink")
+public class CommandLinkFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created CommandLink.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.HtmlCommandLink";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/DataTableFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/DataTableFactory.java
new file mode 100644
index 0000000..5ec4dad
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/DataTableFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a DataTable
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:dataTable".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:dataTable")
+public class DataTableFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created DataTable.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.HtmlDataTable";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/FormFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/FormFactory.java
new file mode 100644
index 0000000..1061498
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/FormFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a Form
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:form".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:form")
+public class FormFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created Form.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.Form";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/GraphicImageFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/GraphicImageFactory.java
new file mode 100644
index 0000000..fafbce6
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/GraphicImageFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a GraphicImage
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:graphicImage".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:graphicImage")
+public class GraphicImageFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created GraphicImage.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.HtmlGraphicImage";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/HeadFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/HeadFactory.java
new file mode 100644
index 0000000..ffcf441
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/HeadFactory.java
@@ -0,0 +1,79 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2009 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a Head
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:head".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:head")
+public class HeadFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created Head component.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+ comp.setRendererType(RENDERER_TYPE);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.Output";
+
+ /**
+ * The default RendererType to set on the newly created component.
+ */
+ public static final String RENDERER_TYPE = "javax.faces.Head";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/InputHiddenFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/InputHiddenFactory.java
new file mode 100644
index 0000000..e779e21
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/InputHiddenFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a InputHidden
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:inputHidden".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:inputHidden")
+public class InputHiddenFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created InputHidden.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.HtmlInputHidden";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/InputSecretFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/InputSecretFactory.java
new file mode 100644
index 0000000..6a7af7e
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/InputSecretFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a InputSecret
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:inputSecret".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:inputSecret")
+public class InputSecretFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created InputSecret.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.HtmlInputSecret";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/InputTextFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/InputTextFactory.java
new file mode 100644
index 0000000..03d431d
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/InputTextFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a InputText
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:inputText".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:inputText")
+public class InputTextFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created InputText.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.HtmlInputText";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/InputTextareaFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/InputTextareaFactory.java
new file mode 100644
index 0000000..ff5f59d
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/InputTextareaFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a InputTextarea
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:inputTextarea".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:inputTextarea")
+public class InputTextareaFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created InputTextarea.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.HtmlInputTextarea";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/LoadBundleFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/LoadBundleFactory.java
new file mode 100644
index 0000000..8f4db54
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/LoadBundleFactory.java
@@ -0,0 +1,104 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Locale;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.EventComponent;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.LayoutDefinitionManager;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+import com.sun.jsftemplating.layout.descriptors.handler.Handler;
+import com.sun.jsftemplating.layout.descriptors.handler.HandlerDefinition;
+
+
+/**
+ * When using JSP as the view technology for JSF, you not only have
+ * components but also JSP tags that interact with JSF. In JSFTemplating
+ * the recommended approach to doing this is to use handlers. This
+ * offers a clean way to execute arbitrary Java code. While that is still
+ * the recommendation, this class is provided for added flexibility. The
+ * purpose of this class is to read a ResourceBundle and make it available
+ * to the page. The better approach would be to use the
+ * {@link com.sun.jsftemplating.handlers.ScopeHandlers#setResourceBundle}
+ * handler.
+ *
+ * The >f:loadBundle< tag does not represent a component, so this
+ * handler does not create a component, it returns the parent
+ * (which is passed in) after configuring the
+ * ResourceBundle.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "f:loadBundle". It requires a
+ * basename and a var property to be passed
+ * in. Optionally the locale can be passed in (this is not
+ * a feature of the JSF version, but an extra feature supported by the
+ * handler in JSFTemplating.
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("f:loadBundle")
+public class LoadBundleFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method loads a ResourceBundle.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor.
+ * @param parent The parent UIComponent (not used)
+ *
+ * @return parent.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create an Event component for this
+ EventComponent event = new EventComponent();
+ if (parent != null) {
+ addChild(context, descriptor, parent, event);
+ }
+
+ // Get the inputs
+ String baseName = (String) descriptor.getEvaluatedOption(context, "basename", parent);
+ String var = (String) descriptor.getEvaluatedOption(context, "var", parent);
+ Locale locale = (Locale) descriptor.getEvaluatedOption(context, "locale", parent);
+
+ // Create a handler (needed to execute code each time displayed)...
+ HandlerDefinition def = LayoutDefinitionManager.
+ getGlobalHandlerDefinition("setResourceBundle");
+ Handler handler = new Handler(def);
+ handler.setInputValue("bundle", baseName);
+ handler.setInputValue("key", var);
+ handler.setInputValue("locale", locale);
+ List handlers = new ArrayList();
+ handlers.add(handler);
+ event.getAttributes().put("beforeEncode", handlers);
+
+ // Return (parent)
+ return event;
+ }
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/MessageFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/MessageFactory.java
new file mode 100644
index 0000000..41dfffc
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/MessageFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a Message
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:message".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:message")
+public class MessageFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created Message.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.Message";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/MessagesFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/MessagesFactory.java
new file mode 100644
index 0000000..4aa2f00
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/MessagesFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a Messages
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:messages".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:messages")
+public class MessagesFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created Messages.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.Messages";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/NamingContainerFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/NamingContainerFactory.java
new file mode 100644
index 0000000..c3c247f
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/NamingContainerFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2008 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a NamingContainer
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "namingContainer".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("namingContainer")
+public class NamingContainerFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created NamingContainer.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.NamingContainer";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/OutputFormatFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/OutputFormatFactory.java
new file mode 100644
index 0000000..4e25c8c
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/OutputFormatFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a OutputFormat
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:outputFormat".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:outputFormat")
+public class OutputFormatFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created OutputFormat.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.HtmlOutputFormat";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/OutputLabelFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/OutputLabelFactory.java
new file mode 100644
index 0000000..31d7879
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/OutputLabelFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a OutputLabel
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:outputLabel".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:outputLabel")
+public class OutputLabelFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created OutputLabel.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.HtmlOutputLabel";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/OutputLinkFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/OutputLinkFactory.java
new file mode 100644
index 0000000..833c2fe
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/OutputLinkFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a OutputLink
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:outputLink".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:outputLink")
+public class OutputLinkFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created OutputLink.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.HtmlOutputLink";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/OutputScriptFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/OutputScriptFactory.java
new file mode 100644
index 0000000..367a64f
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/OutputScriptFactory.java
@@ -0,0 +1,79 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2009 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a OutputScript
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:outputScript".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:outputScript")
+public class OutputScriptFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created OutputScript.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+ comp.setRendererType(RENDERER_TYPE);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.Output";
+
+ /**
+ * The default RendererType to set on the newly created component.
+ */
+ public static final String RENDERER_TYPE = "javax.faces.resource.Script";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/OutputStylesheetFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/OutputStylesheetFactory.java
new file mode 100644
index 0000000..722ab4b
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/OutputStylesheetFactory.java
@@ -0,0 +1,79 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2009 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a OutputStylesheet
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:outputStylesheet".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:outputStylesheet")
+public class OutputStylesheetFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created OutputStylesheet.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+ comp.setRendererType(RENDERER_TYPE);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.Output";
+
+ /**
+ * The default RendererType to set on the newly created component.
+ */
+ public static final String RENDERER_TYPE = "javax.faces.resource.Stylesheet";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/OutputTextFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/OutputTextFactory.java
new file mode 100644
index 0000000..bfd2201
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/OutputTextFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a OutputText
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:outputText".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:outputText")
+public class OutputTextFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created OutputText.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.HtmlOutputText";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/PanelGridFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/PanelGridFactory.java
new file mode 100644
index 0000000..640fb56
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/PanelGridFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a PanelGrid
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:panelGrid".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:panelGrid")
+public class PanelGridFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created PanelGrid.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.HtmlPanelGrid";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/PanelGroupFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/PanelGroupFactory.java
new file mode 100644
index 0000000..970c080
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/PanelGroupFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a PanelGroup
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:panelGroup".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:panelGroup")
+public class PanelGroupFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created PanelGroup.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.HtmlPanelGroup";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/ParamFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/ParamFactory.java
new file mode 100644
index 0000000..bd0e7ef
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/ParamFactory.java
@@ -0,0 +1,74 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a UIParameter
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "f:param".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("f:param")
+public class ParamFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created UIParameter.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE =
+ javax.faces.component.UIParameter.COMPONENT_TYPE;
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectBooleanCheckboxFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectBooleanCheckboxFactory.java
new file mode 100644
index 0000000..1821e4c
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectBooleanCheckboxFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a SelectBooleanCheckbox
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:selectBooleanCheckbox".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:selectBooleanCheckbox")
+public class SelectBooleanCheckboxFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created SelectBooleanCheckbox.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.HtmlSelectBooleanCheckbox";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectItemFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectItemFactory.java
new file mode 100644
index 0000000..bfb57d2
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectItemFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2008 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a UISelectItem
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "f:selectItem".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("f:selectItem")
+public class SelectItemFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created UISelectItem.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.SelectItem";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectItemsFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectItemsFactory.java
new file mode 100644
index 0000000..3b103d8
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectItemsFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2008 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a UISelectItems
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "f:selectItems".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("f:selectItems")
+public class SelectItemsFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created UISelectItems.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.SelectItems";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectManyCheckboxFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectManyCheckboxFactory.java
new file mode 100644
index 0000000..a3fc87d
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectManyCheckboxFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a SelectManyCheckbox
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:selectManyCheckbox".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:selectManyCheckbox")
+public class SelectManyCheckboxFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created SelectManyCheckbox.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.HtmlSelectManyCheckbox";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectManyListboxFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectManyListboxFactory.java
new file mode 100644
index 0000000..bcaaeb9
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectManyListboxFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a SelectManyListbox
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:selectManyListbox".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:selectManyListbox")
+public class SelectManyListboxFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created SelectManyListbox.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.SelectManyListbox";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectManyMenuFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectManyMenuFactory.java
new file mode 100644
index 0000000..894df5b
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectManyMenuFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a SelectManyMenu
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:selectManyMenu".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:selectManyMenu")
+public class SelectManyMenuFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created SelectManyMenu.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.HtmlSelectManyMenu";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectOneListboxFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectOneListboxFactory.java
new file mode 100644
index 0000000..ec1c9c9
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectOneListboxFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a SelectOneListbox
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:selectOneListbox".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:selectOneListbox")
+public class SelectOneListboxFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created SelectOneListbox.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.HtmlSelectOneListbox";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectOneMenuFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectOneMenuFactory.java
new file mode 100644
index 0000000..75746d5
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectOneMenuFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a SelectOneMenu
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:selectOneMenu".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:selectOneMenu")
+public class SelectOneMenuFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created SelectOneMenu.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.HtmlSelectOneMenu";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectOneRadioFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectOneRadioFactory.java
new file mode 100644
index 0000000..0e55c66
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/SelectOneRadioFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a SelectOneRadio
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "h:selectOneRadio".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("h:selectOneRadio")
+public class SelectOneRadioFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created SelectOneRadio.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "javax.faces.HtmlSelectOneRadio";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/ValidatorFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/ValidatorFactory.java
new file mode 100644
index 0000000..96b13f8
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/ri/ValidatorFactory.java
@@ -0,0 +1,114 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.ri;
+
+import javax.el.ELContext;
+import javax.el.ValueExpression;
+import javax.faces.application.Application;
+import javax.faces.component.EditableValueHolder;
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+import javax.faces.validator.Validator;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.ComponentUtil;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+import com.sun.jsftemplating.util.LogUtil;
+
+
+/**
+ * This factory is responsible for instantiating a
+ * Validator and adding it to the parent. This factory
+ * does not create a UIComponent.
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("f:validator")
+public class ValidatorFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The parent UIComponent.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ Object value = null;
+ Validator validator = null;
+
+ // Check for the "binding" property
+ String binding = (String) descriptor.getOption("binding");
+ if (binding != null) {
+ value = ComponentUtil.getInstance(context).resolveValue(context, descriptor, parent, binding);
+ if ((value != null) && !(value instanceof Validator)) {
+ // Warn developer that attempted to set a Validator that was
+ // not a Validator
+ if (LogUtil.warningEnabled()) {
+ LogUtil.warning("JSFT0009", (Object) parent.getId());
+ }
+ } else {
+ validator = (Validator) value;
+ }
+ }
+
+ // Check to see if we still need to create one...
+ if (validator == null) {
+ // Check for the "validatorId" property
+ String id = (String) descriptor.getOption("validatorId");
+ if (id != null) {
+ id = (String) ComponentUtil.getInstance(context).resolveValue(context, descriptor, parent, id);
+ if (id != null) {
+ // Create a new Validator
+ Application app = context.getApplication();
+ validator = app.createValidator(id);
+ if ((validator != null) && (binding != null)) {
+ // Set the validator on the binding, if bound
+ ELContext elctx = context.getELContext();
+ ValueExpression ve = app.getExpressionFactory().createValueExpression(elctx, binding, Object.class);
+ ve.setValue(elctx, validator);
+ }
+ }
+ }
+ }
+
+ // Set the validator on the parent...
+ if (validator != null) {
+ if (!(parent instanceof EditableValueHolder)) {
+ throw new IllegalArgumentException("You may only add "
+ + "f:validator tags to components which are "
+ + "EditableValueHolders. Component (" + parent.getId()
+ + ") is not an EditableValueHolder.");
+ }
+ ((EditableValueHolder) parent).addValidator(validator);
+ }
+
+ // Return the validator
+ return parent;
+ }
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/AddRemoveFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/AddRemoveFactory.java
new file mode 100644
index 0000000..ae14546
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/AddRemoveFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.sun;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating an AddRemove
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "sun:addRemove".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("sun:addRemove")
+public class AddRemoveFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created AddRemove.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.webui.jsf.AddRemove";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/AjaxRequestFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/AjaxRequestFactory.java
new file mode 100644
index 0000000..e9fbe1f
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/AjaxRequestFactory.java
@@ -0,0 +1,106 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.sun;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a Hyperlink
+ * UIComponent that is configured to submit an Ajax
+ * request.
+ *
+ * All properties are passed through to the underlying
+ * Hyperlink UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "ajaxRequest".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("ajaxRequest")
+public class AjaxRequestFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent. You should specify the
+ * ajaxTarget for this component. See
+ * {@link #AJAX_TARGET}.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created AjaxRequest.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Setup the AjaxRequest Request
+// FIXME: support javascript function to handle return value
+// FIXME: support extra NVPs?? Maybe not needed? UIParameter instead? May be easier as a &n=v&... string.
+ String clientId = comp.getClientId(context);
+// FIXME: XXX DEAL WITH THIS!!!
+// FIXME: BUG: JSF automatically converts the '&' characters in attributes to & this causes a problem... talk to LH and JSF about this.
+// String extraNVPs = "'&" + clientId + "_submittedField=" + clientId + "'";
+ String extraNVPs = "'" + clientId + "_submittedField=" + clientId + "'";
+ String jsHandlerFunction = "null";
+// FIXME: Support multiple targets? If I render multiple sections of the UIComponent tree and return a document describing the results...
+ String target = (String) descriptor.getEvaluatedOption(context, AJAX_TARGET, comp);
+ if ((target == null) || target.equals("")) {
+ target = clientId;
+ }
+ comp.getAttributes().put("onClick", "submitAjaxRequest('" + target + "', " +extraNVPs + ", " + jsHandlerFunction + "); return false;");
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * This is the property name that specifies the target for the
+ * Ajax request. If not specified, the link itself will be the target
+ * (which is likely not the desired target of the XMLHttpRequest).
+ * The target should be the clientId (i.e. the "id" you see in the
+ * HTML source) of the UIComponent.
+ *
+ * The property name is: ajaxTarget.
+ */
+ public static final String AJAX_TARGET = "ajaxTarget";
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.webui.jsf.Hyperlink";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/AlarmFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/AlarmFactory.java
new file mode 100644
index 0000000..8b6081b
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/AlarmFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.sun;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating an Alarm
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "sun:alarm".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("sun:alarm")
+public class AlarmFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created Alarm.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.webui.jsf.Alarm";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/AlarmStatusFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/AlarmStatusFactory.java
new file mode 100644
index 0000000..54f5134
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/AlarmStatusFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.sun;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating an AlarmStatus
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "sun:alarmStatus".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("sun:alarmStatus")
+public class AlarmStatusFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created AlarmStatus.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.webui.jsf.AlarmStatus";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/AlertFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/AlertFactory.java
new file mode 100644
index 0000000..2d650bc
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/AlertFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.sun;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating an Alert
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "sun:alert".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("sun:alert")
+public class AlertFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created Alert.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.webui.jsf.Alert";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/AnchorFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/AnchorFactory.java
new file mode 100644
index 0000000..f7fd12b
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/AnchorFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.sun;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a Anchor
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "sun:anchor".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("sun:anchor")
+public class AnchorFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created Anchor.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.webui.jsf.Anchor";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/BodyFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/BodyFactory.java
new file mode 100644
index 0000000..73de235
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/BodyFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.sun;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a Body
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "sun:body".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("sun:body")
+public class BodyFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created Body.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.webui.jsf.Body";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/BreadcrumbsFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/BreadcrumbsFactory.java
new file mode 100644
index 0000000..0229389
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/BreadcrumbsFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.sun;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating an Breadcrumbs
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "sun:breadcrumbs".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("sun:breadcrumbs")
+public class BreadcrumbsFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created Breadcrumbs.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.webui.jsf.Breadcrumbs";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/ButtonFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/ButtonFactory.java
new file mode 100755
index 0000000..736e14f
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/ButtonFactory.java
@@ -0,0 +1,82 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.sun;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a Button
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "sun:button".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("sun:button")
+public class ButtonFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created Button.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Default to primary button
+ if (descriptor.getOption("primary") == null) {
+ // Use ValueBinding vs. property so we don't set the local value
+ // flag which will hide any future VB that is set on the component
+ comp.setValueBinding("primary",
+ context.getApplication().createValueBinding("#{true}"));
+ }
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the value
+ return comp;
+
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.webui.jsf.Button";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/CalendarFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/CalendarFactory.java
new file mode 100644
index 0000000..9b621a4
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/CalendarFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.sun;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating an Calendar
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "sun:calendar".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("sun:calendar")
+public class CalendarFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created Calendar.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.webui.jsf.Calendar";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/CheckboxFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/CheckboxFactory.java
new file mode 100644
index 0000000..3dd8a22
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/CheckboxFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.sun;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a Checkbox
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "sun:checkbox".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("sun:checkbox")
+public class CheckboxFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created Checkbox.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.webui.jsf.Checkbox";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/CheckboxGroupFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/CheckboxGroupFactory.java
new file mode 100644
index 0000000..81b1213
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/CheckboxGroupFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.sun;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a CheckboxGroup
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "sun:checkboxGroup".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("sun:checkboxGroup")
+public class CheckboxGroupFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created CheckboxGroup.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.webui.jsf.CheckboxGroup";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/ColoredTextFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/ColoredTextFactory.java
new file mode 100644
index 0000000..d4fd8a5
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/ColoredTextFactory.java
@@ -0,0 +1,85 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2008 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.sun;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating a StaticText
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "sun:coloredText".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("sun:coloredText")
+public class ColoredTextFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created StaticText.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set escape as false by default, don't call setEscape() b/c then
+ // ValueExpressions won't get evaluated
+ if (!descriptor.getOptions().containsKey("escape")) {
+ setOption(context, comp, descriptor, "escape", "#{false}");
+ }
+
+ // Set the color
+ String color = (String) descriptor.getEvaluatedOption(context, "color", comp);
+ if (color != null) {
+ comp.getAttributes().put("style", "color: " + color + ";");
+ }
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.webui.jsf.StaticText";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/CommonTaskFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/CommonTaskFactory.java
new file mode 100644
index 0000000..22529aa
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/CommonTaskFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.sun;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating an CommonTask
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "sun:commonTask".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("sun:commonTask")
+public class CommonTaskFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created CommonTask.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.webui.jsf.CommonTask";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/CommonTasksGroupFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/CommonTasksGroupFactory.java
new file mode 100644
index 0000000..b72b925
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/CommonTasksGroupFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.sun;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating an CommonTasksGroup
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "sun:commonTasksGroup".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("sun:commonTasksGroup")
+public class CommonTasksGroupFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created CommonTasksGroup.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.webui.jsf.CommonTasksGroup";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/CommonTasksSectionFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/CommonTasksSectionFactory.java
new file mode 100644
index 0000000..bbb328f
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/CommonTasksSectionFactory.java
@@ -0,0 +1,73 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.sun;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+
+
+/**
+ * This factory is responsible for instantiating an CommonTasksSection
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "sun:commonTasksSection".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("sun:commonTasksSection")
+public class CommonTasksSectionFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created CommonTasksSection.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, COMPONENT_TYPE, descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Return the component
+ return comp;
+ }
+
+ /**
+ * The UIComponent type that must be registered in the
+ * faces-config.xml file mapping to the UIComponent class
+ * to use for this UIComponent.
+ */
+ public static final String COMPONENT_TYPE = "com.sun.webui.jsf.CommonTasksSection";
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/DropDownFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/DropDownFactory.java
new file mode 100644
index 0000000..9af8117
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/component/factory/sun/DropDownFactory.java
@@ -0,0 +1,145 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.component.factory.sun;
+
+import java.lang.reflect.Constructor;
+import java.lang.reflect.InvocationTargetException;
+import java.util.ArrayList;
+import java.util.Iterator;
+import java.util.List;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+import com.sun.jsftemplating.annotation.UIComponentFactory;
+import com.sun.jsftemplating.component.ComponentUtil;
+import com.sun.jsftemplating.component.factory.ComponentFactoryBase;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+import com.sun.jsftemplating.util.Util;
+
+
+// FIXME: Document
+/**
+ * This factory is responsible for instantiating a DropDrown
+ * UIComponent.
+ *
+ * The {@link com.sun.jsftemplating.layout.descriptors.ComponentType}
+ * id for this factory is: "sun:dropDown".
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+@UIComponentFactory("sun:dropDown")
+public class DropDownFactory extends ComponentFactoryBase {
+
+ /**
+ * This is the factory method responsible for creating the
+ * UIComponent.
+ *
+ * @param context The FacesContext
+ * @param descriptor The {@link LayoutComponent} descriptor associated
+ * with the requested UIComponent.
+ * @param parent The parent UIComponent
+ *
+ * @return The newly created DropDown.
+ */
+ public UIComponent create(FacesContext context, LayoutComponent descriptor, UIComponent parent) {
+ // Create the UIComponent
+ UIComponent comp = createComponent(context, getComponentType(), descriptor, parent);
+
+ // Set all the attributes / properties
+ setOptions(context, descriptor, comp);
+
+ // Check to see if the user is passing in Lists to be converted to a
+ // List of Option objects for the "items" property.
+ ComponentUtil compUtil = ComponentUtil.getInstance(context);
+ Object labels = compUtil.resolveValue(
+ context, descriptor, comp, descriptor.getOption("labels"));
+ if (labels != null) {
+ List optionList = new ArrayList();
+ Object values = compUtil.resolveValue(
+ context, descriptor, comp, descriptor.getOption("values"));
+ if (values == null) {
+ values = labels;
+ }
+
+ try {
+ // Use reflection (for now) to avoid a build dependency
+ // Find the Option constuctor...
+ Constructor optConst = Util.loadClass(
+ "com.sun.webui.jsf.model.Option", this).
+ getConstructor(Object.class, String.class);
+
+ if (values instanceof List) {
+ // We have a List, we need to convert to Option objects.
+ Iterator
descriptor
+ * @param component The UIComponent
+ * @param value The value to resolve
+ *
+ * @return The result
+ */
+ public static Object resolveVariables(LayoutElement desc,
+ UIComponent component, Object value) {
+ if (value == null) {
+ return null;
+ }
+ return VariableResolver.resolveVariables(
+ FacesContext.getCurrentInstance(), desc, component, value);
+ }
+
+ /**
+ * This method replaces the ${..} variables with their attribute values.
+ * It will only do this for Strings and List's that contain Strings.
+ *
+ * @param ctx The FacesContext
+ * @param desc The LayoutElement descriptor
+ * @param component The UIComponent
+ * @param value The value to resolve
+ *
+ * @return The result
+ */
+ public static Object resolveVariables(FacesContext ctx, LayoutElement desc, UIComponent component, Object value) {
+ if (value == null) {
+ return null;
+ }
+ if (value instanceof String) {
+ value = VariableResolver.resolveVariables(
+ ctx,
+ desc,
+ component,
+ (String) value,
+ VariableResolver.SUB_START,
+ VariableResolver.SUB_TYPE_DELIM,
+ VariableResolver.SUB_END);
+ } else if (value instanceof List) {
+ // Create a new List b/c invalid to change shared List
+ List
+ */
+ public void processAction(ActionEvent event) {
+ invokeCommandHandlers(event);
+ }
+
+ /**
+ * This is an ActionListener that delegates to handlers to process + * the action.
+ */ + public void invokeCommandHandlers(ActionEvent event) { + // Get the UIComponent source associated w/ this command + UIComponent command = (UIComponent) event.getSource(); + if (command == null) { + throw new IllegalArgumentException( + "Action invoked, however, no source was given!"); + } + + // Get the FacesContext + FacesContext context = FacesContext.getCurrentInstance(); + + // Look on the UIComponent for the CommandHandlers + LayoutElement desc = null; + List This method returns the "viewId" of the ViewRoot given
+ * a UIComponent that is part of that
+ * ViewRoot.
This method searches for the LayoutComponent that matches the given + * client ID. Although this is often possible, it won't work all the + * time. This is because there is no way to ensure a 1-to-1 mapping + * between the UIComponent and the LayoutComponent tree. A given + * LayoutComponent may create multiple UIComponent, the + * LayoutComponent tree may itself be dynamic, and the UIComponent + * tree may change after it is initially created from the + * LayoutComponent tree. For these reasons, this method may fail. In + * these circumstances, it is critical to store the necessary + * information with the UIComponent itself.
+ */ + public static LayoutElement findLayoutElementByClientId(FacesContext ctx, String layoutDefKey, String clientId) { + LayoutElement result = null; + try { + result = + findLayoutElementByClientId( + LayoutDefinitionManager. + getLayoutDefinition(ctx, layoutDefKey), clientId); + } catch (LayoutDefinitionException ex) { + if (LogUtil.configEnabled()) { + LogUtil.config("Unable to resolve client id '" + clientId + + "' for LayoutDefinition key: '" + + layoutDefKey + "'.", ex); + } + } + return result; + } + + public static LayoutElement findLayoutElementByClientId(LayoutDefinition def, String clientId) { +// FIXME: TBD... +// FIXME: Walk LE tree, ignore non-LayoutComponent entries (this may cause a problem itself b/c of conditional statements & loops) +// FIXME: Handle LayoutCompositions / LayoutInserts + return null; + } + + /** + *This method simply searches the LayoutElement tree using the given + * id. As soon as it matches any LayoutElement in the tree w/ the + * given id, it returns it. This method does *not* respect + * NamingContainers as the only information given to this method is a + * simple "id".
+ */ + public static LayoutElement findLayoutElementById(FacesContext ctx, String layoutDefKey, String id) { + // Sanity check + if (id == null) { + return null; + } + + LayoutElement result = null; + try { + result = findLayoutElementById( + LayoutDefinitionManager. + getLayoutDefinition(ctx, layoutDefKey), id); + } catch (LayoutDefinitionException ex) { + if (LogUtil.configEnabled()) { + LogUtil.config("Unable to resolve id '" + id + + "' for LayoutDefinition key: '" + + layoutDefKey + "'.", ex); + } + } + return result; + } + + /** + *This method does not evaluate the id field of the LayoutElement + * when checking for a match, this means it will not find values where + * the LayoutComponent's id must be evaulated. Store the handlers on + * the UIComponent in this case.
+ */ + public static LayoutElement findLayoutElementById(LayoutElement elt, String id) { + // First check to see if the given LayoutElement is it + if (elt.getUnevaluatedId().equals(id)) { + return elt; + } + + // Iterate over children and recurse (depth first) + LayoutElement child = null; + IteratorThe "command" event type. ("command")
+ */ + public static final String COMMAND_EVENT_TYPE = "command"; +} diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/event/CreateChildEvent.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/event/CreateChildEvent.java new file mode 100644 index 0000000..5f92b3e --- /dev/null +++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/event/CreateChildEvent.java @@ -0,0 +1,90 @@ +/* + * The contents of this file are subject to the terms + * of the Common Development and Distribution License + * (the License). You may not use this file except in + * compliance with the License. + * + * You can obtain a copy of the license at + * https://jsftemplating.dev.java.net/cddl1.html or + * jsftemplating/cddl1.txt. + * See the License for the specific language governing + * permissions and limitations under the License. + * + * When distributing Covered Code, include this CDDL + * Header Notice in each file and include the License file + * at jsftemplating/cddl1.txt. + * If applicable, add the following below the CDDL Header, + * with the fields enclosed by brackets [] replaced by + * you own identifying information: + * "Portions Copyrighted [year] [name of copyright owner]" + * + * Copyright 2007 Sun Microsystems, Inc. All rights reserved. + */ +package com.sun.jsftemplating.layout.event; + +import javax.faces.component.UIComponent; + + +/** + *This event is typically invoked when a factory not only creates a + * component, but creates children under that component. This event may + * be invoked to allow a page author to have greater control over what + * happens during the child creation. See individual factory JavaDocs to + * see which factories support this and what may be done during this + * event.
+ * + * @author Ken Paulsen (ken.paulsen@sun.com) + */ +public class CreateChildEvent extends EventObjectBase implements UIComponentHolder { + private static final long serialVersionUID = 1L; + + /** + *Constructor.
+ * + * @param component TheUIComponent associated with this
+ * EventObject.
+ */
+ public CreateChildEvent(UIComponent component) {
+ super(component);
+ }
+
+ /**
+ * Constructor.
+ * + * @param component TheUIComponent associated with this
+ * EventObject.
+ */
+ public CreateChildEvent(UIComponent component, Object data) {
+ super(component);
+ setData(data);
+ }
+
+ /**
+ * This method provides access to extra data that is set by the + * creator of this Event. See documentation of the code that fires + * this event to learn what (if anything) is stored here.
+ */ + public Object getData() { + return _data; + } + + /** + *This setter allows extending classes to set this value via this + * setter. Normally this value is passed into the constructor.
+ */ + protected void setData(Object data) { + _data = data; + } + + /** + *
The "createChild" event type. ("createChild")
+ */ + public static final String EVENT_TYPE = "createChild"; + + /** + *This value provides extra information that can be associated with + * this event. See code that uses this event to learn more about + * what (if anything) this information is used for.
+ */ + private Object _data = null; +} diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/event/DecodeEvent.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/event/DecodeEvent.java new file mode 100644 index 0000000..b2893d2 --- /dev/null +++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/event/DecodeEvent.java @@ -0,0 +1,44 @@ +/* + * The contents of this file are subject to the terms + * of the Common Development and Distribution License + * (the License). You may not use this file except in + * compliance with the License. + * + * You can obtain a copy of the license at + * https://jsftemplating.dev.java.net/cddl1.html or + * jsftemplating/cddl1.txt. + * See the License for the specific language governing + * permissions and limitations under the License. + * + * When distributing Covered Code, include this CDDL + * Header Notice in each file and include the License file + * at jsftemplating/cddl1.txt. + * If applicable, add the following below the CDDL Header, + * with the fields enclosed by brackets [] replaced by + * you own identifying information: + * "Portions Copyrighted [year] [name of copyright owner]" + * + * Copyright 2006 Sun Microsystems, Inc. All rights reserved. + */ +package com.sun.jsftemplating.layout.event; + +import javax.faces.component.UIComponent; + + +/** + * + * @author Ken Paulsen (ken.paulsen@sun.com) + */ +public class DecodeEvent extends EventObjectBase implements UIComponentHolder { + private static final long serialVersionUID = 1L; + + /** + *Constructor.
+ * + * @param component TheUIComponent associated with this
+ * EventObject.
+ */
+ public DecodeEvent(UIComponent component) {
+ super(component);
+ }
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/event/EncodeEvent.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/event/EncodeEvent.java
new file mode 100644
index 0000000..3c89eee
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/event/EncodeEvent.java
@@ -0,0 +1,44 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.layout.event;
+
+import javax.faces.component.UIComponent;
+
+
+/**
+ *
+ * @author Ken Paulsen (ken.paulsen@sun.com)
+ */
+public class EncodeEvent extends EventObjectBase implements UIComponentHolder {
+ private static final long serialVersionUID = 1L;
+
+ /**
+ * Constructor.
+ * + * @param component TheUIComponent associated with this
+ * EventObject.
+ */
+ public EncodeEvent(UIComponent component) {
+ super(component);
+ }
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/event/EventObjectBase.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/event/EventObjectBase.java
new file mode 100644
index 0000000..5123825
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/event/EventObjectBase.java
@@ -0,0 +1,79 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.layout.event;
+
+import java.util.EventObject;
+
+import javax.faces.component.UIComponent;
+
+
+/**
+ * This class serves as the base class for EventObjects in
+ * this package.
This constructor should not be used.
+ */ + private EventObjectBase() { + super(null); + } + + /** + *This constructor is protected to avoid direct instantiation, one + * of the sub-classes of this class should be used instead.
+ * + * @param component TheUIComponent associated with this
+ * EventObject.
+ */
+ protected EventObjectBase(UIComponent component) {
+ super(component);
+ }
+
+ /**
+ * This constructor should only be used when a
+ * UIComponent is not available.
This method returns the UIComponent held by the
+ * Object implementing this interface (or null if the
+ * event source is not a UIComponent).
UIComponent.
+ */
+ public UIComponent getUIComponent() {
+ Object source = getSource();
+ if (source instanceof UIComponent) {
+ return (UIComponent) getSource();
+ }
+ return null;
+ }
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/event/InitPageEvent.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/event/InitPageEvent.java
new file mode 100644
index 0000000..ce237e4
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/event/InitPageEvent.java
@@ -0,0 +1,47 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.layout.event;
+
+
+
+/**
+ * This event is fired for each page accessed during each request. This + * may be fired during the UIComponent tree creation time, while restoring + * the View, when forwarding to a new page, or when simply accessing a + * page via Java code.
+ * + * @author Ken Paulsen (ken.paulsen@sun.com) + */ +public class InitPageEvent extends EventObjectBase implements UIComponentHolder { + private static final long serialVersionUID = 1L; + + /** + *Constructor.
+ * + * @param component TheUIComponent associated with this
+ * EventObject (likely null).
+ */
+ public InitPageEvent(Object component) {
+ super(component);
+ }
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/event/UIComponentHolder.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/event/UIComponentHolder.java
new file mode 100644
index 0000000..7a9c485
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/event/UIComponentHolder.java
@@ -0,0 +1,46 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.layout.event;
+
+import javax.faces.component.UIComponent;
+
+
+/**
+ * This interface defines a method for obtaining a
+ * UIComponent. This is used by various
+ * EventObject implementations which hold
+ * UIComponent. This allows event handling code to access
+ * the UIComponent related to the event.
This method returns the UIComponent held by the
+ * Object implementing this interface.
UIComponent.
+ */
+ public UIComponent getUIComponent();
+}
diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/event/ValueChangeListener.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/event/ValueChangeListener.java
new file mode 100644
index 0000000..4d69f03
--- /dev/null
+++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/event/ValueChangeListener.java
@@ -0,0 +1,284 @@
+/*
+ * The contents of this file are subject to the terms
+ * of the Common Development and Distribution License
+ * (the License). You may not use this file except in
+ * compliance with the License.
+ *
+ * You can obtain a copy of the license at
+ * https://jsftemplating.dev.java.net/cddl1.html or
+ * jsftemplating/cddl1.txt.
+ * See the License for the specific language governing
+ * permissions and limitations under the License.
+ *
+ * When distributing Covered Code, include this CDDL
+ * Header Notice in each file and include the License file
+ * at jsftemplating/cddl1.txt.
+ * If applicable, add the following below the CDDL Header,
+ * with the fields enclosed by brackets [] replaced by
+ * you own identifying information:
+ * "Portions Copyrighted [year] [name of copyright owner]"
+ *
+ * Copyright 2008 Sun Microsystems, Inc. All rights reserved.
+ */
+package com.sun.jsftemplating.layout.event;
+
+import java.io.Serializable;
+import java.util.Iterator;
+import java.util.List;
+
+import javax.faces.component.UIComponent;
+import javax.faces.component.UIViewRoot;
+import javax.faces.context.FacesContext;
+import javax.faces.event.ValueChangeEvent;
+
+import com.sun.jsftemplating.layout.LayoutDefinitionException;
+import com.sun.jsftemplating.layout.LayoutDefinitionManager;
+import com.sun.jsftemplating.layout.descriptors.ComponentType;
+import com.sun.jsftemplating.layout.descriptors.LayoutComponent;
+import com.sun.jsftemplating.layout.descriptors.LayoutDefinition;
+import com.sun.jsftemplating.layout.descriptors.LayoutElement;
+import com.sun.jsftemplating.layout.descriptors.handler.Handler;
+import com.sun.jsftemplating.util.LogUtil;
+
+
+/**
+ * This class provides a ValueChangeListener that can
+ * delegate to handlers (that are likely defined via the template). It
+ * is safe to register this class as a managed bean at the Application
+ * scope. Or to use it directly as a
+ * ValueChangeListener.
Constructor. It is not recommended this constructor be used, + * however, it is available so that it may be used as a managed + * bean. Instead call {@link #getInstance()}.
+ */ + public ValueChangeListener() { + super(); + } + + /** + *This delegates to {@link #getInstance(FacesContext)}.
+ */ + public static ValueChangeListener getInstance() { + return getInstance(FacesContext.getCurrentInstance()); + } + + /** + *This is the preferred way to obtain an instance of this object.
+ */ + public static ValueChangeListener getInstance(FacesContext ctx) { + if (ctx == null) { + ctx = FacesContext.getCurrentInstance(); + } + ValueChangeListener instance = null; + if (ctx != null) { + instance = (ValueChangeListener) ctx.getExternalContext(). + getApplicationMap().get(VCL_INSTANCE); + } + if (instance == null) { + instance = new ValueChangeListener(); + if (ctx != null) { + ctx.getExternalContext().getApplicationMap().put( + VCL_INSTANCE, instance); + } + } + return instance; + } + + /** + * This method is invoked, when used directly as a
+ * ValueChangeListener.
+ */
+ public void processValueChange(ValueChangeEvent event) {
+ invokeValueChangeHandlers(event);
+ }
+
+ /**
+ *
This is an ValueChangeListener that delegates to handlers to + * process the action.
+ */ + public void invokeValueChangeHandlers(ValueChangeEvent event) { + // Get the UIComponent (evh) source associated w/ this valueChangeEvent + UIComponent evh = (UIComponent) event.getSource(); + if (evh == null) { + throw new IllegalArgumentException( + "ValueChange invoked, however, no source was given!"); + } + + // Get the FacesContext + FacesContext context = FacesContext.getCurrentInstance(); + + // Look on the UIComponent for the ValueChangeHandlers + LayoutElement desc = null; + List This method returns the "viewId" of the ViewRoot given
+ * a UIComponent that is part of that
+ * ViewRoot.
This method searches for the LayoutComponent that matches the given + * client ID. Although this is often possible, it won't work all the + * time. This is because there is no way to ensure a 1-to-1 mapping + * between the UIComponent and the LayoutComponent tree. A given + * LayoutComponent may create multiple UIComponent, the + * LayoutComponent tree may itself be dynamic, and the UIComponent + * tree may change after it is initially created from the + * LayoutComponent tree. For these reasons, this method may fail. In + * these circumstances, it is critical to store the necessary + * information with the UIComponent itself.
+ */ + public static LayoutElement findLayoutElementByClientId(FacesContext ctx, String layoutDefKey, String clientId) { +// FIXME: This should be a util method. (Same as CommandActionListener) + LayoutElement result = null; + try { + result = + findLayoutElementByClientId( + LayoutDefinitionManager. + getLayoutDefinition(ctx, layoutDefKey), clientId); + } catch (LayoutDefinitionException ex) { + if (LogUtil.configEnabled()) { + LogUtil.config("Unable to resolve client id '" + clientId + + "' for LayoutDefinition key: '" + + layoutDefKey + "'.", ex); + } + } + return result; + } + + public static LayoutElement findLayoutElementByClientId(LayoutDefinition def, String clientId) { +// FIXME: This should be a util method. (Same as CommandActionListener) +// +// FIXME: TBD... +// FIXME: Walk LE tree, ignore non-LayoutComponent entries (this may cause a problem itself b/c of conditional statements & loops) +// FIXME: Handle LayoutCompositions / LayoutInserts + return null; + } + + /** + *This method simply searches the LayoutElement tree using the given + * id. As soon as it matches any LayoutElement in the tree w/ the + * given id, it returns it. This method does *not* respect + * NamingContainers as the only information given to this method is a + * simple "id".
+ */ + public static LayoutElement findLayoutElementById(FacesContext ctx, String layoutDefKey, String id) { +// FIXME: This should be a util method. (Same as CommandActionListener) + // Sanity check + if (id == null) { + return null; + } + + LayoutElement result = null; + try { + result = findLayoutElementById( + LayoutDefinitionManager. + getLayoutDefinition(ctx, layoutDefKey), id); + } catch (LayoutDefinitionException ex) { + if (LogUtil.configEnabled()) { + LogUtil.config("Unable to resolve id '" + id + + "' for LayoutDefinition key: '" + + layoutDefKey + "'.", ex); + } + } + return result; + } + + /** + *This method does not evaluate the id field of the LayoutElement + * when checking for a match, this means it will not find values where + * the LayoutComponent's id must be evaulated. Store the handlers on + * the UIComponent in this case.
+ */ + public static LayoutElement findLayoutElementById(LayoutElement elt, String id) { +// FIXME: This should be a util method. (Same as CommandActionListener) + // First check to see if the given LayoutElement is it + if (elt.getUnevaluatedId().equals(id)) { + return elt; + } + + // Iterate over children and recurse (depth first) + LayoutElement child = null; + IteratorThis is the "event type" for handlers to be invoked to handle + * value change event for this component.
+ */ + public static final String VALUE_CHANGE = "valueChange"; + +} diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/facelets/DbFactory.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/facelets/DbFactory.java new file mode 100644 index 0000000..63ffabb --- /dev/null +++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/facelets/DbFactory.java @@ -0,0 +1,43 @@ +/** + * + */ +package com.sun.jsftemplating.layout.facelets; + +import com.sun.jsftemplating.layout.xml.XMLErrorHandler; + +import java.io.OutputStreamWriter; +import java.io.PrintWriter; +import java.io.UnsupportedEncodingException; + +import javax.xml.parsers.DocumentBuilder; +import javax.xml.parsers.DocumentBuilderFactory; +import javax.xml.parsers.ParserConfigurationException; + +/** + * This class provides a convenient way to create a DocumentBuilder using the + * JSFTemplating entity resolver. + * @author Jason Lee + * + */ +public class DbFactory { + public static DocumentBuilder getInstance() throws ParserConfigurationException { + DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance(); + factory.setNamespaceAware(true); + factory.setValidating(false); + factory.setIgnoringComments(true); + factory.setIgnoringElementContentWhitespace(false); + factory.setCoalescing(false); + factory.setExpandEntityReferences(true); + DocumentBuilder builder = factory.newDocumentBuilder(); + try { + builder.setErrorHandler(new XMLErrorHandler(new PrintWriter( + new OutputStreamWriter(System.err, "UTF-8"), true))); + } catch (UnsupportedEncodingException ex) { + throw new RuntimeException(ex); + } + + builder.setEntityResolver(new FaceletsClasspathEntityResolver()); + + return builder; + } +} diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/facelets/FaceletsClasspathEntityResolver.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/facelets/FaceletsClasspathEntityResolver.java new file mode 100644 index 0000000..a4de9e4 --- /dev/null +++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/facelets/FaceletsClasspathEntityResolver.java @@ -0,0 +1,18 @@ +/** + * + */ +package com.sun.jsftemplating.layout.facelets; + +import com.sun.jsftemplating.util.ClasspathEntityResolver; +import org.xml.sax.InputSource; + +/** + * @author Jason Lee + * + */ +public class FaceletsClasspathEntityResolver extends ClasspathEntityResolver { + public InputSource resolveEntity(String name, String publicId, String baseURI, String systemId) { + String grammarName = systemId.substring(systemId.lastIndexOf('/') + 1); + return super.resolveEntity(name, publicId, baseURI, grammarName); + } +} diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/facelets/FaceletsLayoutDefinitionManager.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/facelets/FaceletsLayoutDefinitionManager.java new file mode 100644 index 0000000..84ff7ab --- /dev/null +++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/facelets/FaceletsLayoutDefinitionManager.java @@ -0,0 +1,170 @@ +/* + * The contents of this file are subject to the terms + * of the Common Development and Distribution License + * (the License). You may not use this file except in + * compliance with the License. + * + * You can obtain a copy of the license at + * https://jsftemplating.dev.java.net/cddl1.html or + * jsftemplating/cddl1.txt. + * See the License for the specific language governing + * permissions and limitations under the License. + * + * When distributing Covered Code, include this CDDL + * Header Notice in each file and include the License file + * at jsftemplating/cddl1.txt. + * If applicable, add the following below the CDDL Header, + * with the fields enclosed by brackets [] replaced by + * you own identifying information: + * "Portions Copyrighted [year] [name of copyright owner]" + * + * Copyright 2007 Sun Microsystems, Inc. All rights reserved. + */ +package com.sun.jsftemplating.layout.facelets; + +import com.sun.jsftemplating.annotation.FormatDefinition; +import com.sun.jsftemplating.layout.LayoutDefinitionException; +import com.sun.jsftemplating.layout.LayoutDefinitionManager; +import com.sun.jsftemplating.layout.descriptors.LayoutDefinition; +import com.sun.jsftemplating.layout.template.TemplateParser; +import com.sun.jsftemplating.util.FileUtil; + +import java.io.IOException; +import java.net.URL; + +import javax.faces.context.FacesContext; + + +/** + * + * @author Jason Lee + * @author Ken Paulsen + */ +@FormatDefinition +public class FaceletsLayoutDefinitionManager extends LayoutDefinitionManager { + + /** + * Default Constructor. + */ + public FaceletsLayoutDefinitionManager() { + super(); + } + + @Override + public boolean accepts(String key) { + boolean accept = false; + URL url = null; + try { + url = FileUtil.searchForFile(key, defaultSuffix); + } catch (IOException ex) { + // Ignore this b/c we're just trying to detect if we're the right + // LDM... if we're here, probably we're not. + } + if (url == null) { + return false; + } + + // Eventually, we may want this check to be configurable via a + // context-param... + if (url.getPath().contains(".xhtml")) { + accept = true; + } else { + // Use the TemplateParser to help us read the file to see if it is a + // valid XML-format file + TemplateParser parser = new TemplateParser(url); + accept = true; + try { + parser.open(); + parser.readUntil("=\"http://java.sun.com/jsf/facelets\"", true); + } catch (Exception ex) { + // Didn't work... + accept = false; + } finally { + parser.close(); + } + } + + return accept; + } + + /** + * This method is responsible for finding the requested
+ * {@link LayoutDefinition} for the given key.
This method returns an instance of this LayoutDefinitionManager. + * The object returned is a singleton (only 1 instance will be + * created per application).
+ * + * @returnFaceletsLayoutDefinitionManager instance
+ */
+ public static LayoutDefinitionManager getInstance() {
+ return getInstance(FacesContext.getCurrentInstance());
+ }
+
+ /**
+ * This method provides access to the application-scoped instance
+ * of the FaceletsLayoutDefinitionManager.
FacesContext (may be null).
+ */
+ public static LayoutDefinitionManager getInstance(FacesContext ctx) {
+ if (ctx == null) {
+ ctx = FacesContext.getCurrentInstance();
+ }
+ FaceletsLayoutDefinitionManager instance = null;
+ if (ctx != null) {
+ instance = (FaceletsLayoutDefinitionManager)
+ ctx.getExternalContext().getApplicationMap().get(FLDM_INSTANCE);
+ }
+ if (instance == null) {
+ instance = new FaceletsLayoutDefinitionManager();
+ if (ctx != null) {
+ ctx.getExternalContext().getApplicationMap().put(
+ FLDM_INSTANCE, instance);
+ }
+ }
+ return instance;
+ }
+
+ /**
+ * Application scope key for an instance of this class.
+ */ + private static final String FLDM_INSTANCE = "__jsft_FaceletsLDM"; + + private static final String defaultSuffix = ".xhtml"; +} diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/facelets/FaceletsLayoutDefinitionReader.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/facelets/FaceletsLayoutDefinitionReader.java new file mode 100644 index 0000000..4866617 --- /dev/null +++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/facelets/FaceletsLayoutDefinitionReader.java @@ -0,0 +1,458 @@ +/* + * The contents of this file are subject to the terms + * of the Common Development and Distribution License + * (the License). You may not use this file except in + * compliance with the License. + * + * You can obtain a copy of the license at + * https://jsftemplating.dev.java.net/cddl1.html or + * jsftemplating/cddl1.txt. + * See the License for the specific language governing + * permissions and limitations under the License. + * + * When distributing Covered Code, include this CDDL + * Header Notice in each file and include the License file + * at jsftemplating/cddl1.txt. + * If applicable, add the following below the CDDL Header, + * with the fields enclosed by brackets [] replaced by + * you own identifying information: + * "Portions Copyrighted [year] [name of copyright owner]" + * + * Copyright 2007 Sun Microsystems, Inc. All rights reserved. + */ +package com.sun.jsftemplating.layout.facelets; + +import java.io.BufferedInputStream; +import java.io.ByteArrayInputStream; +import java.io.IOException; +import java.io.InputStream; +import java.net.URL; + +import javax.xml.parsers.DocumentBuilder; + +import org.w3c.dom.Document; +import org.w3c.dom.DocumentType; +import org.w3c.dom.NamedNodeMap; +import org.w3c.dom.Node; +import org.w3c.dom.NodeList; + +import com.sun.jsftemplating.layout.LayoutDefinitionException; +import com.sun.jsftemplating.layout.LayoutDefinitionManager; +import com.sun.jsftemplating.layout.SyntaxException; +import com.sun.jsftemplating.layout.descriptors.ComponentType; +import com.sun.jsftemplating.layout.descriptors.LayoutComponent; +import com.sun.jsftemplating.layout.descriptors.LayoutComposition; +import com.sun.jsftemplating.layout.descriptors.LayoutDefine; +import com.sun.jsftemplating.layout.descriptors.LayoutDefinition; +import com.sun.jsftemplating.layout.descriptors.LayoutElement; +import com.sun.jsftemplating.layout.descriptors.LayoutFacet; +import com.sun.jsftemplating.layout.descriptors.LayoutForEach; +import com.sun.jsftemplating.layout.descriptors.LayoutIf; +import com.sun.jsftemplating.layout.descriptors.LayoutInsert; +import com.sun.jsftemplating.layout.descriptors.LayoutStaticText; +import com.sun.jsftemplating.layout.template.BaseProcessingContext; +import com.sun.jsftemplating.layout.template.EventParserCommand; +import com.sun.jsftemplating.layout.template.ProcessingContextEnvironment; +import com.sun.jsftemplating.layout.template.TemplateParser; +import com.sun.jsftemplating.layout.template.TemplateReader; +import com.sun.jsftemplating.util.IncludeInputStream; +import com.sun.jsftemplating.util.LayoutElementUtil; +import com.sun.jsftemplating.util.Util; + +import javax.faces.FactoryFinder; +import javax.faces.application.Application; +import javax.faces.application.ApplicationFactory; + + +/** + * @author Jason Lee + * + */ +public class FaceletsLayoutDefinitionReader { + private URL url; + private String key; + private Document document; + private int _idNumber; + + public FaceletsLayoutDefinitionReader(String key, URL url) { + _idNumber = LayoutElementUtil.getStartingIdNumber(null, key); + InputStream is = null; + BufferedInputStream bs = null; + try{ + this.key = key; + this.url = url; + + DocumentBuilder builder = DbFactory.getInstance(); + builder.setErrorHandler(new ParsingErrorHandler()); + is = this.url.openStream(); + bs = new BufferedInputStream(is); + document = builder.parse(new IncludeInputStream(bs)); + } catch (Exception e) { + throw new LayoutDefinitionException(e); + } finally { + Util.closeStream(bs); + Util.closeStream(is); + } + } + + public LayoutDefinition read() throws IOException { + LayoutDefinition layoutDefinition = new LayoutDefinition(key); + NodeList nodeList = document.getChildNodes(); + boolean abortProcessing = false; + DocumentType docType = document.getDoctype(); + if (docType != null) { + LayoutStaticText stDocType = new LayoutStaticText(layoutDefinition, "", + ""); + layoutDefinition.addChildLayoutElement(stDocType); + } + for (int i = 0; i < nodeList.getLength() && (abortProcessing != true); i++) { + abortProcessing = process(layoutDefinition, nodeList.item(i), false); + } + return layoutDefinition; + } + + public boolean process(LayoutElement parent, Node node, boolean nested) throws IOException { + boolean abortProcessing = false; + LayoutElement element = null; + LayoutElement newParent = parent; + boolean endElement = false; + + String value = node.getNodeValue(); +// TODO: find out what "name" should be in the ctors + switch (node.getNodeType()) { + case Node.TEXT_NODE : + if (!value.trim().equals("")) { + element = new LayoutStaticText(parent, + LayoutElementUtil.getGeneratedId(node.getNodeName(), getNextIdNumber()), + value); + } + break; + case Node.ELEMENT_NODE: + element = createComponent(parent, node, nested); + if (element instanceof LayoutStaticText) { + // We have a element node that needs to be static text + endElement = true; + } else if (element instanceof LayoutForEach) { + newParent = element; + } else if (element instanceof LayoutIf) { + newParent = element; + } else if (element instanceof LayoutComponent) { + nested = true; + newParent = element; + } else if (element instanceof LayoutComposition) { + abortProcessing = ((LayoutComposition)element).isTrimming(); + newParent = element; + } else if (element instanceof LayoutDefine) { + newParent = element; + } else if (element instanceof LayoutFacet) { + newParent = element; + } else if (element instanceof LayoutInsert) { + newParent = element; + } +// FIXME: Jason, this code may need to be refactored. I think almost +// FIXME: everything should have newParent = element. The problem comes when +// FIXME: you are turning and into 2 separate staticText +// FIXME: components. This should be a single component, then it could contain +// FIXME: children also. You may want a to create a component like Woodstock's +// FIXME: "markup" component to do this. + break; + default: + // just because... :P + } + + if (element != null) { + parent.addChildLayoutElement(element); + + NodeList nodeList = node.getChildNodes(); + boolean abortChildProcessing = false; + for (int i = 0; i < nodeList.getLength() && (abortChildProcessing != true); i++) { + abortChildProcessing = process(newParent, nodeList.item(i), nested); + } + if (abortChildProcessing == true) { + abortProcessing = abortChildProcessing; + }else { + + if (endElement) { + String nodeName = node.getNodeName(); + element = new LayoutStaticText(parent, LayoutElementUtil.getGeneratedId(nodeName, getNextIdNumber()), ""); + parent.addChildLayoutElement(element); + } + } + } + + return abortProcessing; + } + + private LayoutComposition processComposition(LayoutElement parent, String attrName, NamedNodeMap attrs, String id, boolean trimming) { + LayoutComposition lc = new LayoutComposition(parent, id); + lc.setTrimming(trimming); + if (trimming) { + parent = parent.getLayoutDefinition(); // parent to the LayoutDefinition + parent.getChildLayoutElements().clear(); // a ui:composition clears everything outside of it + } + Node fileNameNode = attrs.getNamedItem(attrName); + String fileName = (fileNameNode != null) ? fileNameNode.getNodeValue() : null; + lc.setTemplate(fileName); + + return lc; + } + + private LayoutComponent processComponent(LayoutElement parent, Node node, NamedNodeMap attrs, String id, boolean trimming) { + if (trimming) { + parent = parent.getLayoutDefinition(); // parent to the LayoutDefinition + parent.getChildLayoutElements().clear(); // a ui:composition clears everything outside of it + } + LayoutComponent lc = new LayoutComponent(parent, id, + LayoutDefinitionManager.getGlobalComponentType(null, "event")); + parent.addChildLayoutElement(lc); + LayoutComposition comp = processComposition(lc, "template", attrs, id+"_lc", trimming); + + NodeList nodeList = node.getChildNodes(); + boolean abortChildProcessing = false; + for (int i = 0; i < nodeList.getLength() && (abortChildProcessing != true); i++) { + try { + abortChildProcessing = process(comp, nodeList.item(i), true); + } catch (IOException e) { + e.printStackTrace(); + } + } + lc.addChildLayoutElement(comp); + + return lc; + } + +/* +This code is not used and does not appear to be correct, it should use FacesContext.getApplication() + private Application getApplication() { + ApplicationFactory appFactory = (ApplicationFactory) FactoryFinder + .getFactory(FactoryFinder.APPLICATION_FACTORY); + return appFactory.getApplication(); + } + + private Object getElValue(String el) { + FacesContext context = FacesContext.getCurrentInstance(); + return getApplication() + .evaluateExpressionGet(context, el, Object.class); + } +*/ + + + private LayoutElement createComponent(LayoutElement parent, Node node, boolean nested) { + LayoutElement element = null; + String nodeName = node.getNodeName(); + NamedNodeMap attrs = node.getAttributes(); + Node nameNode = attrs.getNamedItem("id"); + String id = (nameNode != null) ? nameNode.getNodeValue() : + LayoutElementUtil.getGeneratedId(nodeName, getNextIdNumber()); + + if ("ui:composition".equals(nodeName)) { + element = processComposition(parent, "template", attrs, id, true); + } else if ("ui:decorate".equals(nodeName)) { + element = processComposition(parent, "template", attrs, id, false); + } else if ("ui:define".equals(nodeName)) { + String name = attrs.getNamedItem("name").getNodeValue(); + element = new LayoutDefine(parent, name); + } else if ("ui:insert".equals(nodeName)) { + LayoutInsert li = new LayoutInsert(parent, id); + Node nameAttr = attrs.getNamedItem("name"); + String name = (nameAttr != null) ? nameAttr.getNodeValue() : null; + li.setName(name); + element = li; + // Let these be handled by the else below, and let's see what happens :) + } else if ("ui:component".equals(nodeName)) { + element = processComponent(parent, node, attrs, id, true); + } else if ("ui:fragment".equals(nodeName)) { + element = processComponent(parent, node, attrs, id, false); + /* + Node bindingAttr = attrs.getNamedItem("binding"); + if (bindingAttr == null) { + throw new LayoutDefinitionException("ui:fragment requires a binding attribute"); + } + String bindingEl = bindingAttr.getNodeValue(); + Object obj = getElValue(bindingEl); + if (!(obj instanceof UIComponent)) { + throw new LayoutDefinitionException("Binding EL must return a UIComponent"); + } + UIComponent comp = (UIComponent) obj; + String family = comp.getFamily(); // TODO: is the correct? + System.out.println(LayoutDefinitionManager.getGlobalComponentTypes(null)); + ComponentType componentType = + LayoutDefinitionManager.getGlobalComponentType(null, family); + LayoutComponent lc = new LayoutComponent(parent, id, componentType); + addAttributesToComponent(lc, node); + lc.setFacetChild(false); + lc.setNested(nested); + element = lc; + */ + } else if ("ui:debug".equals(nodeName)) { + } else if ("ui:include".equals(nodeName)) { + element = processComposition(parent, "src", attrs, id, false); + } else if ("ui:param".equals(nodeName)) { + // Handle "param" + Node nameAttNode = attrs.getNamedItem("name"); + if (nameAttNode == null) { + throw new SyntaxException("The 'name' attribute is required on 'param'."); + } + Node valueNode = attrs.getNamedItem("value"); + if (valueNode == null) { + throw new SyntaxException("The 'value' attribute is required on 'param'."); + } + + // For now only handle cases where the parent is a LayoutComposition + if (!(parent instanceof LayoutComposition)) { + throw new SyntaxException("<" + nodeName + + " name='" + nameAttNode.getNodeValue() + + "' value='" + valueNode.getNodeValue() + + "'> must be child of a 'composition' element!"); + } + // Set the name=value on the parent LayoutComposition + ((LayoutComposition) parent).setParameter( + nameAttNode.getNodeValue(), valueNode.getNodeValue()); + } else if ("ui:remove".equals(nodeName)) { + // Let the element remain null + } else if ("ui:repeat".equals(nodeName)) { + } else if ("ui:event".equals(nodeName)) { + // per Ken, we need to append "/>" to allow the handler parser code + // to end correctly + String body = node.getTextContent(); + body = (body == null) ? "/>" : (body.trim() + "/>"); + Node type = node.getAttributes().getNamedItem("type"); + if (type == null) { + // Ensure type != null + throw new SyntaxException( + "The 'type' attribute is required on 'ui:event'!"); + } + String eventName = type.getNodeValue(); + InputStream is = new ByteArrayInputStream(body.getBytes()); + EventParserCommand command = new EventParserCommand(); + try { + TemplateParser parser = new TemplateParser(is); + parser.open(); // Needed to initialize things. + // Setup the reader... + TemplateReader reader = new TemplateReader("foo", parser); // TODO: get a real ID + reader.pushTag("event"); // The tag will be popped at the end + // Read the handlers... + command.process(new BaseProcessingContext(), + new ProcessingContextEnvironment(reader, parent, true), eventName); + // Clean up + parser.close(); + } catch (IOException e) { + // TODO Auto-generated catch block + e.printStackTrace(); + } finally { + if (is != null) { + try { + is.close(); + } catch (Exception e) { + // ignore + } + } + } + } else if ("ui:if".equals(nodeName)) { + // Handle "if" conditions + String condition = attrs.getNamedItem("condition").getNodeValue(); + element = new LayoutIf(parent, condition); + } else if ("ui:foreach".equals(nodeName)) { + // Handle "foreach" conditions + Node valueNode = attrs.getNamedItem("value"); + if (valueNode == null) { + throw new SyntaxException("The 'value' property is required on 'foreach'."); + } + Node varNode = attrs.getNamedItem("var"); + if (varNode == null) { + throw new SyntaxException("The 'var' property is required on 'foreach'."); + } + + element = new LayoutForEach(parent, valueNode.getNodeValue(), varNode.getNodeValue()); + } else if ("f:facet".equals(nodeName)) { + // FIXME: Need to take NameSpace into account + nameNode = attrs.getNamedItem("name"); + if (nameNode == null) { + throw new IllegalArgumentException("You must provide a name " + + "attribute for all facets! Parent component is: '" + + parent.getUnevaluatedId() + "'."); + } + LayoutFacet facetElt = new LayoutFacet(parent, nameNode.getNodeValue()); + + // Determine if this is a facet place holder (i.e. we're defining + // a renderer w/ a facet), or if it is a facet value to set on a + // containing component. + boolean isRendered = + !LayoutElementUtil.isNestedLayoutComponent(facetElt); + facetElt.setRendered(isRendered); + element = facetElt; + } else { + LayoutComponent lc = null; + ComponentType componentType = null; + String nsURI = node.getNamespaceURI(); + if (nsURI != null) { + // Do lookup using namespace... + componentType = LayoutDefinitionManager.getGlobalComponentType( + null, nsURI + ':' + node.getLocalName()); + } + if (componentType == null) { + // Try w/o using namespace + componentType = LayoutDefinitionManager. + getGlobalComponentType(null, nodeName); + } + if (componentType == null) { + String value = node.getNodeValue(); + if (value == null) { + value = ""; + } +// FIXME: This needs to account for beginning and ending tags.... + lc = new LayoutStaticText(parent, id, + "<" + nodeName + buildAttributeList(node) + ">"); + } else { + lc = new LayoutComponent(parent, id, componentType); + addAttributesToComponent(lc, node); + } + lc.setNested(nested); +// FIXME: Because of the way pages are composed in facelets, the parent +// FIXME: LayoutComponent may not exist in this LD. In that case it is not +// FIXME: a "facet child", but it appears to be according to the following +// FIXME: method. We need a better way to mark children as facets or real +// FIXME: children. This may even require diverging the LD into 1 for +// FIXME: components and 1 for pages. :( + //LayoutElementUtil.checkForFacetChild(parent, lc); + //lc.setFacetChild(false); This is done by checkForFacetChild(...) + element = lc; + } + + return element; + } + + private void addAttributesToComponent (LayoutComponent lc, Node node) { + NamedNodeMap map = node.getAttributes(); + for (int i = 0; i < map.getLength(); i++) { + Node attr = map.item(i); + lc.addOption(attr.getNodeName(), attr.getNodeValue()); + } + } + + private String buildAttributeList(Node node) { + StringBuilder attrs = new StringBuilder(); + + NamedNodeMap map = node.getAttributes(); + for (int i = 0; i < map.getLength(); i++) { + Node attr = map.item(i); + attrs.append(" ") + .append(attr.getNodeName()) + .append("=\"") + .append(attr.getNodeValue()) + .append("\""); + } + + return attrs.toString(); + } + + /** + *This method returns the next ID number. Calling this method will + * increment the id number.
+ */ + public int getNextIdNumber() { + // Make sure we increment the global counter, if appropriate + LayoutElementUtil.incHighestId(_idNumber); + return _idNumber++; + } +} diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/facelets/NSContext.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/facelets/NSContext.java new file mode 100644 index 0000000..d2b63cd --- /dev/null +++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/facelets/NSContext.java @@ -0,0 +1,128 @@ +/* + * The contents of this file are subject to the terms + * of the Common Development and Distribution License + * (the License). You may not use this file except in + * compliance with the License. + * + * You can obtain a copy of the license at + * https://jsftemplating.dev.java.net/cddl1.html or + * jsftemplating/cddl1.txt. + * See the License for the specific language governing + * permissions and limitations under the License. + * + * When distributing Covered Code, include this CDDL + * Header Notice in each file and include the License file + * at jsftemplating/cddl1.txt. + * If applicable, add the following below the CDDL Header, + * with the fields enclosed by brackets [] replaced by + * you own identifying information: + * "Portions Copyrighted [year] [name of copyright owner]" + * + * Copyright 2007 Sun Microsystems, Inc. All rights reserved. + */ +package com.sun.jsftemplating.layout.facelets; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.Iterator; +import java.util.Map; + +import javax.xml.XMLConstants; + + +/** + *This class provides namespace support for facelets taglib.xml + * files.
+ * + * @author Ken Paulsen + */ +public class NSContext implements javax.xml.namespace.NamespaceContext { + + /** + *Creates a default NSContext.
+ */ + public NSContext() { + addNamespace("xml", XMLConstants.XML_NS_URI); + addNamespace("xmlns", XMLConstants.XMLNS_ATTRIBUTE_NS_URI); + } + + /** + *Returns the namespace for the given prefix.
+ * + * @throws IllegalArgumentException Ifnull prefix is given.
+ */
+ public String getNamespaceURI(String prefix) {
+ if (prefix == null) {
+ throw new IllegalArgumentException("null is not allowed.");
+ }
+ String result = _uris.get(prefix);
+ if (result == null) {
+ if (prefix.equals(XMLConstants.DEFAULT_NS_PREFIX)) {
+ result = _defaultNSURI;
+ }
+ if (result == null) {
+ result = XMLConstants.NULL_NS_URI;
+ }
+ }
+ return result;
+ }
+
+ /**
+ * Returns the prefix for the given namespace. If not mapped,
+ * null is returned.
null prefix is given.
+ */
+ public String getPrefix(String namespaceURI) {
+ if (namespaceURI == null) {
+ throw new IllegalArgumentException("null is not allowed.");
+ }
+ String result = _prefixes.get(namespaceURI);
+ if (result == null) {
+ if (namespaceURI.equals(_defaultNSURI)) {
+ result = XMLConstants.DEFAULT_NS_PREFIX;
+ }
+ }
+ return result;
+ }
+
+ /**
+ * This implementation doesn't support this functionality. Instead
+ * returns the same result as {@link #getPrefix(String)} via an
+ * Iterator.
This method sets the default NS URI to be used when the default
+ * prefix (XMLConstants.DEFAULT_NS_PREFIX) is
+ * supplied.
This method returns the default NS URI (null if not set).
+ */ + public String getDefaultNSURI() { + return _defaultNSURI; + } + + /** + *This method registers a Namespace mapping.
+ */ + public void addNamespace(String prefix, String uri) { + _uris.put(prefix, uri); + _prefixes.put(uri, prefix); + } + + private String _defaultNSURI = null; + + private MapSince many contexts share common functionality (i.e. processing static + * text elements), it makes sense to have a base {@link ProcessingContext} + * which may be specialized as needed.
+ */ +public class BaseProcessingContext implements ProcessingContext { + + /** + *This is called when a component tag is found + * (<tagname ...).
+ */ + public void beginComponent(ProcessingContextEnvironment env, String content) throws IOException { + // We have a UIComponent tag... first get the parser + // Skip white Space + TemplateReader reader = env.getReader(); + TemplateParser parser = reader.getTemplateParser(); + parser.skipCommentsAndWhiteSpace(TemplateParser.SIMPLE_WHITE_SPACE); + +// tagStack.push(content); + // Create the LayoutComponent + LayoutElement parent = env.getParent(); + LayoutComponent child = reader.createLayoutComponent( + parent, env.isNested(), content); + parent.addChildLayoutElement(child); + + // See if this is a single tag or if there is a closing tag + boolean single = false; + int ch = parser.nextChar(); + if (ch == '/') { + // Single Tag + ch = parser.nextChar(); // Throw away '>' + single = true; + reader.popTag(); // Don't look for ending tag + } + if (ch != '>') { + throw new SyntaxException( + "Expected '>' found '" + (char) ch + "'."); + } + + if (single) { + // This is also the end of the component in this case... + endComponent(env, content); + } else { + // Process child LayoutElements (recurse) + reader.process( + TemplateReader.LAYOUT_COMPONENT_CONTEXT, child, true); + } + } + + /** + *This is called when an end component tag is found (</tagname> + * or <tagname ... />). Because it may be called for either of + * the above syntaxes, the caller of this method is responsible for + * maintaining the parser position, this method (or its subclasses) + * should not effect the parser position.
+ */ + public void endComponent(ProcessingContextEnvironment env, String content) throws IOException { + } + + /** + *This is called when a special tag is found (<!tagname ...).
+ */ + public void beginSpecial(ProcessingContextEnvironment env, String content) throws IOException { + CustomParserCommand command = + env.getReader().getCustomParserCommand(content); + if (command == null) { + // If there is no Custom command for this, use the default... + command = TemplateReader.EVENT_PARSER_COMMAND; + } + command.process(this, env, content); + } + + /** + *This is called when a special end tag is found (</tagname ... or + * <!tagname ... />).
+ */ + public void endSpecial(ProcessingContextEnvironment env, String content) throws IOException { + } + + /** + *This is called when static text is found (").
+ */ + public void staticText(ProcessingContextEnvironment env, String content) throws IOException { + LayoutElement parent = env.getParent(); + + // Create a LayoutStaticText + LayoutComponent child = new LayoutStaticText( + parent, + LayoutElementUtil.getGeneratedId( + "txt", env.getReader().getNextIdNumber()), + content); + child.addOption("value", content); + child.setNested(env.isNested()); + + parent.addChildLayoutElement(child); + } + + /** + *This is called when escaped static text is found ('). The + * difference between this and staticText is that HTML is expected to + * be escaped so the browser does not parse it.
+ */ + public void escapedStaticText(ProcessingContextEnvironment env, String content) throws IOException { + staticText(env, Util.htmlEscape(content)); + } + + /** + *This method is invoked when nothing else matches.
+ * + *This implementation reads a character and does nothing with it.
+ */ + public void handleDefault(ProcessingContextEnvironment env, String content) throws IOException { + env.getReader().getTemplateParser().nextChar(); + } + + /** + *This is a static reference to the "staticText" + * {@link ComponentType}.
+ public static final ComponentType STATIC_TEXT = + LayoutDefinitionManager.getGlobalComponentType(null, "staticText"); + */ +} diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/CompositionParserCommand.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/CompositionParserCommand.java new file mode 100644 index 0000000..9db223f --- /dev/null +++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/CompositionParserCommand.java @@ -0,0 +1,170 @@ +/* + * The contents of this file are subject to the terms + * of the Common Development and Distribution License + * (the License). You may not use this file except in + * compliance with the License. + * + * You can obtain a copy of the license at + * https://jsftemplating.dev.java.net/cddl1.html or + * jsftemplating/cddl1.txt. + * See the License for the specific language governing + * permissions and limitations under the License. + * + * When distributing Covered Code, include this CDDL + * Header Notice in each file and include the License file + * at jsftemplating/cddl1.txt. + * If applicable, add the following below the CDDL Header, + * with the fields enclosed by brackets [] replaced by + * you own identifying information: + * "Portions Copyrighted [year] [name of copyright owner]" + * + * Copyright 2007 Sun Microsystems, Inc. All rights reserved. + */ +package com.sun.jsftemplating.layout.template; + +import com.sun.jsftemplating.layout.ProcessingCompleteException; +import com.sun.jsftemplating.layout.SyntaxException; +import com.sun.jsftemplating.layout.descriptors.LayoutComposition; +import com.sun.jsftemplating.layout.descriptors.LayoutDefinition; +import com.sun.jsftemplating.layout.descriptors.LayoutElement; +import com.sun.jsftemplating.util.LayoutElementUtil; + +import java.io.IOException; +import java.util.List; + + +/** + *This {@link CustomParserCommand} handles "composition" statements. + * TBD... + *
+ * + * @author Ken Paulsen (ken.paulsen@sun.com) + */ +public class CompositionParserCommand implements CustomParserCommand { + + /** + *Constructor. This constructor requires a flag to be passed in + * indicating wether content outside this component should be ignored + * (trimmed) or left alone.
+ * + * @param trimtrue if content outside this component
+ * should be thrown away.
+ *
+ * @param templateAttName The name of the attribute for the template name.
+ */
+ public CompositionParserCommand(boolean trim, String templateAttName) {
+ this.trimming = trim;
+ this.templateAttName = templateAttName;
+ }
+
+ /**
+ * This method processes a "custom" command. These are commands that
+ * start with a !. When this method receives control, the
+ * name (i.e. the token after the '!' character) has
+ * already been read. It is passed via the name
+ * parameter.
The {@link ProcessingContext} and + * {@link ProcessingContextEnvironment} are both available.
+ */ + public void process(ProcessingContext ctx, ProcessingContextEnvironment env, String name) throws IOException { + // Get the reader + TemplateReader reader = env.getReader(); + + LayoutElement parent = env.getParent(); + if (trimming) { + // First remove the current children on the LD (trimming == true) + parent = parent.getLayoutDefinition(); + parent.getChildLayoutElements().clear(); + } + + // Next get the attributes + ListThis is the {@link ProcessingContext} for + * {@link LayoutComposition}s.
+ */ + protected static class LayoutCompositionContext extends BaseProcessingContext { + /** + *This is called when a special tag is found (<!tagname ...).
+ * + *This implementation looks for "define" tags and handles them + * specially. These tags are only valid in this context.
+ */ + public void beginSpecial(ProcessingContextEnvironment env, String content) throws IOException { + if (content.equals("define")) { + DEFINE_PARSER_COMMAND.process(this, env, content); + } else { + super.beginSpecial(env, content); + } + } + } + + + /** + *This indicates whether content outside of this tag should be left + * alone or used.
+ */ + private boolean trimming = true; + private String templateAttName = null; + + public static final String REQUIRED_ATTRIBUTE = "required"; + /** + *The {@link ProcessingContext} to be used when processing children + * of a {@link LayoutComposition}. This {@link ProcessingContext} may + * have special meaning for + * {@link com.sun.jsftemplating.layout.descriptors.LayoutDefine}s and + * other tags.
+ */ + public static final ProcessingContext LAYOUT_COMPOSITION_CONTEXT = + new LayoutCompositionContext(); + + public static final CustomParserCommand DEFINE_PARSER_COMMAND = + new DefineParserCommand(); +} diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/CustomParserCommand.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/CustomParserCommand.java new file mode 100644 index 0000000..1a45219 --- /dev/null +++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/CustomParserCommand.java @@ -0,0 +1,49 @@ +/* + * The contents of this file are subject to the terms + * of the Common Development and Distribution License + * (the License). You may not use this file except in + * compliance with the License. + * + * You can obtain a copy of the license at + * https://jsftemplating.dev.java.net/cddl1.html or + * jsftemplating/cddl1.txt. + * See the License for the specific language governing + * permissions and limitations under the License. + * + * When distributing Covered Code, include this CDDL + * Header Notice in each file and include the License file + * at jsftemplating/cddl1.txt. + * If applicable, add the following below the CDDL Header, + * with the fields enclosed by brackets [] replaced by + * you own identifying information: + * "Portions Copyrighted [year] [name of copyright owner]" + * + * Copyright 2006 Sun Microsystems, Inc. All rights reserved. + */ +package com.sun.jsftemplating.layout.template; + +import java.io.IOException; + + +/** + *This interface provides a way to process "custom" parser commands. + * These commands are in the format: "<![custom command name] ...". + * They must be registered with the TemplateParser to be recognized. + * See {@link TemplateReader#setCustomParserCommand(String, CustomParserCommand)}.
+ * + * @author Ken Paulsen (ken.paulsen@sun.com) + */ +public interface CustomParserCommand { + + /** + * This method processes a "custom" command. These are commands that
+ * start with a !. When this method receives control, the
+ * name (i.e. the token after the '!' character) has
+ * already been read. It is passed via the name
+ * parameter.
The {@link ProcessingContext} and + * {@link ProcessingContextEnvironment} are both available.
+ */ + void process(ProcessingContext ctx, ProcessingContextEnvironment env, String name) throws IOException; +} diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/DefineParserCommand.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/DefineParserCommand.java new file mode 100644 index 0000000..326fb2d --- /dev/null +++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/DefineParserCommand.java @@ -0,0 +1,103 @@ +/* + * The contents of this file are subject to the terms + * of the Common Development and Distribution License + * (the License). You may not use this file except in + * compliance with the License. + * + * You can obtain a copy of the license at + * https://jsftemplating.dev.java.net/cddl1.html or + * jsftemplating/cddl1.txt. + * See the License for the specific language governing + * permissions and limitations under the License. + * + * When distributing Covered Code, include this CDDL + * Header Notice in each file and include the License file + * at jsftemplating/cddl1.txt. + * If applicable, add the following below the CDDL Header, + * with the fields enclosed by brackets [] replaced by + * you own identifying information: + * "Portions Copyrighted [year] [name of copyright owner]" + * + * Copyright 2007 Sun Microsystems, Inc. All rights reserved. + */ +package com.sun.jsftemplating.layout.template; + +import com.sun.jsftemplating.layout.ProcessingCompleteException; +import com.sun.jsftemplating.layout.SyntaxException; +import com.sun.jsftemplating.layout.descriptors.LayoutDefine; +import com.sun.jsftemplating.layout.descriptors.LayoutDefinition; +import com.sun.jsftemplating.layout.descriptors.LayoutElement; +import com.sun.jsftemplating.util.LayoutElementUtil; + +import java.io.IOException; + + +/** + *This {@link CustomParserCommand} handles "composition" statements. + * TBD... + *
+ * + * @author Ken Paulsen (ken.paulsen@sun.com) + */ +public class DefineParserCommand implements CustomParserCommand { + + /** + * This method processes a "custom" command. These are commands that
+ * start with a !. When this method receives control, the
+ * name (i.e. the token after the '!' character) has
+ * already been read. It is passed via the name
+ * parameter.
The {@link ProcessingContext} and + * {@link ProcessingContextEnvironment} are both available.
+ */ + public void process(ProcessingContext ctx, ProcessingContextEnvironment env, String name) throws IOException { + // Get the reader and parser + TemplateReader reader = env.getReader(); + TemplateParser parser = reader.getTemplateParser(); + + // Skip any white space... + parser.skipCommentsAndWhiteSpace(TemplateParser.SIMPLE_WHITE_SPACE); + + // Get the parent and define name + LayoutElement parent = env.getParent(); + String id = (String) parser.getNVP(NAME_ATTRIBUTE, true).getValue(); + + // Create new LayoutDefine + LayoutDefine compElt = new LayoutDefine(parent, id); + parent.addChildLayoutElement(compElt); + + // Skip any white space or extra junk... + String theRest = parser.readUntil('>', true).trim(); + if (theRest.endsWith("/")) { + reader.popTag(); // Don't look for end tag + } else { + // Process child LayoutElements (recurse) + reader.process( + LAYOUT_DEFINE_CONTEXT, compElt, + LayoutElementUtil.isLayoutComponentChild(compElt)); + } + } + + + /** + *This is the {@link ProcessingContext} for + * {@link LayoutDefine}s.
+ */ + protected static class LayoutDefineContext extends BaseProcessingContext { + } + + /** + *A String containing "template". This is the attribute name of the + * template file to use in the {@link LayoutDefine}.
+ */ + public static final String NAME_ATTRIBUTE = "name"; + + /** + *The {@link ProcessingContext} to be used when processing children + * of a {@link LayoutDefine}. This {@link ProcessingContext} may + * have special meaning for {@link LayoutDefine}s and other tags.
+ */ + public static final ProcessingContext LAYOUT_DEFINE_CONTEXT = + new LayoutDefineContext(); +} diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/EventParserCommand.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/EventParserCommand.java new file mode 100644 index 0000000..574b703 --- /dev/null +++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/EventParserCommand.java @@ -0,0 +1,406 @@ +/* + * The contents of this file are subject to the terms + * of the Common Development and Distribution License + * (the License). You may not use this file except in + * compliance with the License. + * + * You can obtain a copy of the license at + * https://jsftemplating.dev.java.net/cddl1.html or + * jsftemplating/cddl1.txt. + * See the License for the specific language governing + * permissions and limitations under the License. + * + * When distributing Covered Code, include this CDDL + * Header Notice in each file and include the License file + * at jsftemplating/cddl1.txt. + * If applicable, add the following below the CDDL Header, + * with the fields enclosed by brackets [] replaced by + * you own identifying information: + * "Portions Copyrighted [year] [name of copyright owner]" + * + * Copyright 2007 Sun Microsystems, Inc. All rights reserved. + */ +package com.sun.jsftemplating.layout.template; + +import com.sun.jsftemplating.layout.LayoutDefinitionManager; +import com.sun.jsftemplating.layout.SyntaxException; +import com.sun.jsftemplating.layout.descriptors.LayoutElement; +import com.sun.jsftemplating.layout.descriptors.handler.Handler; +import com.sun.jsftemplating.layout.descriptors.handler.HandlerDefinition; +import com.sun.jsftemplating.layout.descriptors.handler.OutputTypeManager; +import com.sun.jsftemplating.util.LayoutElementUtil; + +import java.io.IOException; +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.Stack; + + +/** + *This {@link CustomParserCommand} implementation processes handlers for + * an event.
+ */ +public class EventParserCommand implements CustomParserCommand { + /** + * This method processes a "custom" command. These are commands that
+ * start with a !. When this method receives control, the
+ * name (i.e. the token after the '!' character) has
+ * already been read. It is passed via the name
+ * parameter.
This implementation processes events and their handlers. 2 + * syntaxes are supported:
+ * + *The first format should be preferred.
+ * + *The {@link ProcessingContext} and + * {@link ProcessingContextEnvironment} are both available.
+ */ + public void process(ProcessingContext ctx, ProcessingContextEnvironment env, String eventName) throws IOException { + Handler handler = null; + List This method parses and creates an individual
+ * Handler.
This is the {@link ProcessingContext} for events. Currently does + * nothing.
+ */ + protected static class EventProcessingContext extends BaseProcessingContext { + } + + public static final String IF_HANDLER = "if"; + public static final String CONDITION_ATTRIBUTE = "condition"; + public static final ProcessingContext EVENT_PROCESSING_CONTEXT = + new EventProcessingContext(); + + public static final char LEFT_CURLY = '{'; + public static final char RIGHT_CURLY = '}'; +} diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/InsertParserCommand.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/InsertParserCommand.java new file mode 100644 index 0000000..045efba --- /dev/null +++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/InsertParserCommand.java @@ -0,0 +1,104 @@ +/* + * The contents of this file are subject to the terms + * of the Common Development and Distribution License + * (the License). You may not use this file except in + * compliance with the License. + * + * You can obtain a copy of the license at + * https://jsftemplating.dev.java.net/cddl1.html or + * jsftemplating/cddl1.txt. + * See the License for the specific language governing + * permissions and limitations under the License. + * + * When distributing Covered Code, include this CDDL + * Header Notice in each file and include the License file + * at jsftemplating/cddl1.txt. + * If applicable, add the following below the CDDL Header, + * with the fields enclosed by brackets [] replaced by + * you own identifying information: + * "Portions Copyrighted [year] [name of copyright owner]" + * + * Copyright 2007 Sun Microsystems, Inc. All rights reserved. + */ +package com.sun.jsftemplating.layout.template; + +import com.sun.jsftemplating.layout.ProcessingCompleteException; +import com.sun.jsftemplating.layout.SyntaxException; +import com.sun.jsftemplating.layout.descriptors.LayoutInsert; +import com.sun.jsftemplating.layout.descriptors.LayoutDefinition; +import com.sun.jsftemplating.layout.descriptors.LayoutElement; +import com.sun.jsftemplating.util.LayoutElementUtil; + +import java.io.IOException; + + +/** + *This {@link CustomParserCommand} handles "insert" statements. + * TBD... + *
+ * + * @author Ken Paulsen (ken.paulsen@sun.com) + */ +public class InsertParserCommand implements CustomParserCommand { + + /** + * This method processes a "custom" command. These are commands that
+ * start with a !. When this method receives control, the
+ * name (i.e. the token after the '!' character) has
+ * already been read. It is passed via the name
+ * parameter.
The {@link ProcessingContext} and + * {@link ProcessingContextEnvironment} are both available.
+ */ + public void process(ProcessingContext ctx, ProcessingContextEnvironment env, String name) throws IOException { + // Get the reader and parser + TemplateReader reader = env.getReader(); + TemplateParser parser = reader.getTemplateParser(); + + // Skip any white space... + parser.skipCommentsAndWhiteSpace(TemplateParser.SIMPLE_WHITE_SPACE); + + // Get the parent and insert name + LayoutElement parent = env.getParent(); + String id = (String) parser.getNVP(NAME_ATTRIBUTE, true).getValue(); + + // Create new LayoutInsert + LayoutInsert compElt = new LayoutInsert(parent, id); + compElt.setName(id); + parent.addChildLayoutElement(compElt); + + // Skip any white space or extra junk... + String theRest = parser.readUntil('>', true).trim(); + if (theRest.endsWith("/")) { + reader.popTag(); // Don't look for end tag + } else { + // Process child LayoutElements (recurse) + reader.process( + LAYOUT_INSERT_CONTEXT, compElt, + LayoutElementUtil.isLayoutComponentChild(compElt)); + } + } + + + /** + *This is the {@link ProcessingContext} for + * {@link LayoutInsert}s.
+ */ + protected static class LayoutInsertContext extends BaseProcessingContext { + } + + /** + *A String containing "template". This is the attribute name of the + * template file to use in the {@link LayoutInsert}.
+ */ + public static final String NAME_ATTRIBUTE = "name"; + + /** + *The {@link ProcessingContext} to be used when processing children + * of a {@link LayoutInsert}. This {@link ProcessingContext} may + * have special meaning for {@link LayoutInsert}s and other tags.
+ */ + public static final ProcessingContext LAYOUT_INSERT_CONTEXT = + new LayoutInsertContext(); +} diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/NameValuePair.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/NameValuePair.java new file mode 100644 index 0000000..886925c --- /dev/null +++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/NameValuePair.java @@ -0,0 +1,86 @@ +/* + * The contents of this file are subject to the terms + * of the Common Development and Distribution License + * (the License). You may not use this file except in + * compliance with the License. + * + * You can obtain a copy of the license at + * https://jsftemplating.dev.java.net/cddl1.html or + * jsftemplating/cddl1.txt. + * See the License for the specific language governing + * permissions and limitations under the License. + * + * When distributing Covered Code, include this CDDL + * Header Notice in each file and include the License file + * at jsftemplating/cddl1.txt. + * If applicable, add the following below the CDDL Header, + * with the fields enclosed by brackets [] replaced by + * you own identifying information: + * "Portions Copyrighted [year] [name of copyright owner]" + * + * Copyright 2006 Sun Microsystems, Inc. All rights reserved. + */ +package com.sun.jsftemplating.layout.template; + + +/** + * This class is used to represent NVP information. This information
+ * consists of 2 or 3 parts. If this is a simple Name Value Pair, it will
+ * contain a name and a value. If it is an NVP
+ * that is used to map a return value, then it also contains a
+ * target as well (which should be set to "session" or
+ * "attribute"). name and target contain
+ * String values. The value property contains
+ * an Object value because it may be a String,
+ * java.util.List, or an array[].
Name accessor.
+ */ + public String getName() { + return _name; + } + + /** + *Value accessor.
+ */ + public Object getValue() { + return _value; + } + + /** + *Target accessor. If this value is non-null it can be assumed that + * this is an output mapping. However, if it is null it cannot be + * assumed to be an input mapping -- it may still be an output mapping + * or an in-out mapping which uses EL. Valid values for this are + * currently: (null), "pageSession", "attribute", or "session" (this + * list may be expanded in the future).
+ */ + public String getTarget() { + return _target; + } + + /** + *Customized to reconstruct the NVP.
+ */ + public String toString() { + if (getTarget() == null) { + return getName() + "=\"" + getValue() + '"'; + } else { + return getName() + "=>$" + getTarget() + '{' + getValue() + '}'; + } + } + + private String _name = null; + private Object _value = null; + private String _target = null; +} diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/NamespaceParserCommand.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/NamespaceParserCommand.java new file mode 100644 index 0000000..390bae9 --- /dev/null +++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/NamespaceParserCommand.java @@ -0,0 +1,103 @@ +/* + * The contents of this file are subject to the terms + * of the Common Development and Distribution License + * (the License). You may not use this file except in + * compliance with the License. + * + * You can obtain a copy of the license at + * https://jsftemplating.dev.java.net/cddl1.html or + * jsftemplating/cddl1.txt. + * See the License for the specific language governing + * permissions and limitations under the License. + * + * When distributing Covered Code, include this CDDL + * Header Notice in each file and include the License file + * at jsftemplating/cddl1.txt. + * If applicable, add the following below the CDDL Header, + * with the fields enclosed by brackets [] replaced by + * you own identifying information: + * "Portions Copyrighted [year] [name of copyright owner]" + * + * Copyright 2009 Sun Microsystems, Inc. All rights reserved. + */ +package com.sun.jsftemplating.layout.template; + +import com.sun.jsftemplating.layout.ProcessingCompleteException; +import com.sun.jsftemplating.layout.SyntaxException; +import com.sun.jsftemplating.layout.descriptors.LayoutComposition; +import com.sun.jsftemplating.layout.descriptors.LayoutDefinition; +import com.sun.jsftemplating.layout.descriptors.LayoutElement; +import com.sun.jsftemplating.util.LayoutElementUtil; + +import java.io.IOException; +import java.util.List; + + +/** + *This {@link CustomParserCommand} handles "namespace" declarations. The + * format of this command should be:
+ * + *For example:
+ * + *Constructor.
+ */ + public NamespaceParserCommand() { + } + + /** + * This method processes a "custom" command. These are commands that
+ * start with a !. When this method receives control, the
+ * name (i.e. the token after the '!' character) has
+ * already been read. It is passed via the name
+ * parameter.
The {@link ProcessingContext} and + * {@link ProcessingContextEnvironment} are both available.
+ */ + public void process(ProcessingContext ctx, ProcessingContextEnvironment env, String name) throws IOException { + // Get the reader + TemplateReader reader = env.getReader(); + TemplateParser parser = reader.getTemplateParser(); + parser.skipCommentsAndWhiteSpace(TemplateParser.SIMPLE_WHITE_SPACE); + int ch = parser.nextChar(); + if ((ch == '>') || (ch == '/')) { + // Nothing specified, throw exception! + throw new IllegalArgumentException( + "Found an empty \"\" delcaration! The long and" + + " short namespace names must be provided."); + } + parser.unread(ch); + + // Next get the next NVP... + NameValuePair nvp = parser.getNVP(null, true); + + // Make sure we read the WS after the data... + parser.skipCommentsAndWhiteSpace(TemplateParser.SIMPLE_WHITE_SPACE); + + // Now make sure this is an end tag... + ch = parser.nextChar(); + int ch2 = parser.nextChar(); + if ((ch != '/') || (ch2 != '>')) { + throw new IllegalArgumentException( + "[\"!"); + } + reader.popTag(); // Don't look for end tag + + // Save the mapping... + reader.setNamespace(nvp.getName(), nvp.getValue().toString()); + } +} diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/ProcessingContext.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/ProcessingContext.java new file mode 100644 index 0000000..b0a814c --- /dev/null +++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/ProcessingContext.java @@ -0,0 +1,88 @@ +/* + * The contents of this file are subject to the terms + * of the Common Development and Distribution License + * (the License). You may not use this file except in + * compliance with the License. + * + * You can obtain a copy of the license at + * https://jsftemplating.dev.java.net/cddl1.html or + * jsftemplating/cddl1.txt. + * See the License for the specific language governing + * permissions and limitations under the License. + * + * When distributing Covered Code, include this CDDL + * Header Notice in each file and include the License file + * at jsftemplating/cddl1.txt. + * If applicable, add the following below the CDDL Header, + * with the fields enclosed by brackets [] replaced by + * you own identifying information: + * "Portions Copyrighted [year] [name of copyright owner]" + * + * Copyright 2006 Sun Microsystems, Inc. All rights reserved. + */ +package com.sun.jsftemplating.layout.template; + +import java.io.IOException; + +import com.sun.jsftemplating.layout.descriptors.LayoutElement; + + +/** + *This interface defines the operations that may be acted upon while + * a "template" document is traversed. The intent is that this + * interface may be implemented by the different "processing contexts" + * which occur throught the template file. This provides the + * opportunity for context sensitive syntax in an easy to provide + * way.
+ * + * While the standard ProcessingContext instances are
+ * likely to be sufficient, there may be cases where a custom
+ * ProcessingContext may be needed to process the
+ * children of a {@link CustomParserCommand}. This may be done by
+ * implementing this interface, or extending one of the existing
+ * implementations. Typically this object is used by passing it to
+ * the {@link TemplateReader#process(ProcessingContext, LayoutElement, boolean)}
+ * method -- this method will delegate actions back to the given
+ * ProcessingContext.
This is called when a component tag is found (<tagname ...).
+ */ + void beginComponent(ProcessingContextEnvironment env, String content) throws IOException; + + /** + *This is called when an end component tag is found (</tagname + * ... or <tagname ... />).
+ */ + void endComponent(ProcessingContextEnvironment env, String content) throws IOException; + + /** + *This is called when a special tag is found (<!tagname ...).
+ */ + void beginSpecial(ProcessingContextEnvironment env, String content) throws IOException; + + /** + *This is called when a special end tag is found (</tagname ... + * or <!tagname ... />).
+ */ + void endSpecial(ProcessingContextEnvironment env, String content) throws IOException; + + /** + *This is called when static text is found (").
+ */ + void staticText(ProcessingContextEnvironment env, String content) throws IOException; + + /** + *This is called when escaped static text is found ('). The + * difference between this and staticText is that HTML is expected to + * be escaped so the browser does not parse it.
+ */ + void escapedStaticText(ProcessingContextEnvironment env, String content) throws IOException; + + /** + *This method is invoked when nothing else matches.
+ */ + void handleDefault(ProcessingContextEnvironment env, String content) throws IOException; +} diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/ProcessingContextEnvironment.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/ProcessingContextEnvironment.java new file mode 100644 index 0000000..c905c95 --- /dev/null +++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/ProcessingContextEnvironment.java @@ -0,0 +1,98 @@ +/* + * The contents of this file are subject to the terms + * of the Common Development and Distribution License + * (the License). You may not use this file except in + * compliance with the License. + * + * You can obtain a copy of the license at + * https://jsftemplating.dev.java.net/cddl1.html or + * jsftemplating/cddl1.txt. + * See the License for the specific language governing + * permissions and limitations under the License. + * + * When distributing Covered Code, include this CDDL + * Header Notice in each file and include the License file + * at jsftemplating/cddl1.txt. + * If applicable, add the following below the CDDL Header, + * with the fields enclosed by brackets [] replaced by + * you own identifying information: + * "Portions Copyrighted [year] [name of copyright owner]" + * + * Copyright 2006 Sun Microsystems, Inc. All rights reserved. + */ +package com.sun.jsftemplating.layout.template; + +import com.sun.jsftemplating.layout.descriptors.LayoutElement; + + +/** + *This class hold environmental information needed while a parsing. This + * information is specific to the nested level that is currently being + * processed. This is unlike the {@link ProcessingContext} + * which is related to the "type" of element that is being processed. Or + * said another way, the {@link ProcessingContext} + * specifies how / what sub-elements are to be processed based on the + * context; this class provides the "where" information for that + * processing. Another difference is this class is stateful, the + * {@link ProcessingContext} has stateless methods that + * parse specific portions of the document.
+ * + * @see TemplateReader + * @see ProcessingContext + * + * @author Ken Paulsen (ken.paulsen@sun.com) + */ +public class ProcessingContextEnvironment { + + /** + *Constructor.
+ */ + public ProcessingContextEnvironment(TemplateReader reader, LayoutElement parent, boolean nested) { + _reader = reader; + _parent = parent; + _nested = nested; + } + + /** + * @return TheTemplateReader instance.
+ */
+ public TemplateReader getReader() {
+ return _reader;
+ }
+
+ /**
+ * @return true if nested in a LayoutComponent.
+ */
+ public boolean isNested() {
+ return _nested;
+ }
+
+ /**
+ * @return The parent {@link LayoutElement}.
+ */
+ public LayoutElement getParent() {
+ return _parent;
+ }
+
+ /**
+ * This method marks the current {@link ProcessingContext} as + * complete.
+ */ + public void setFinished(boolean finished) { + _finished = finished; + } + + /** + *This method indicates if the current {@link ProcessingContext} + * is still valid.
+ */ + public boolean isFinished() { + return _finished; + } + + boolean _finished = false; + boolean _special = false; + boolean _nested = false; + LayoutElement _parent = null; + TemplateReader _reader = null; +} diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/TemplateLayoutDefinitionManager.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/TemplateLayoutDefinitionManager.java new file mode 100644 index 0000000..cb39ca1 --- /dev/null +++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/TemplateLayoutDefinitionManager.java @@ -0,0 +1,211 @@ +/* + * The contents of this file are subject to the terms + * of the Common Development and Distribution License + * (the License). You may not use this file except in + * compliance with the License. + * + * You can obtain a copy of the license at + * https://jsftemplating.dev.java.net/cddl1.html or + * jsftemplating/cddl1.txt. + * See the License for the specific language governing + * permissions and limitations under the License. + * + * When distributing Covered Code, include this CDDL + * Header Notice in each file and include the License file + * at jsftemplating/cddl1.txt. + * If applicable, add the following below the CDDL Header, + * with the fields enclosed by brackets [] replaced by + * you own identifying information: + * "Portions Copyrighted [year] [name of copyright owner]" + * + * Copyright 2006 Sun Microsystems, Inc. All rights reserved. + */ +package com.sun.jsftemplating.layout.template; + +import com.sun.jsftemplating.annotation.FormatDefinition; +import com.sun.jsftemplating.layout.LayoutDefinitionException; +import com.sun.jsftemplating.layout.LayoutDefinitionManager; +import com.sun.jsftemplating.layout.descriptors.LayoutDefinition; +import com.sun.jsftemplating.util.FileUtil; + +import java.io.IOException; +import java.net.URL; + +import javax.faces.context.FacesContext; + + +/** + * This class is a concrete implmentation of the abstract class
+ * {@link LayoutDefinitionManager}. It obtains {@link LayoutDefinition}
+ * objects by interpreting the key passed to
+ * {@link #getLayoutDefinition(String)} as a path to a template file
+ * describing the {@link LayoutDefinition}. It will first attempt to
+ * resolve this path from the document root of the ServletContext or
+ * PortletCotnext. If that fails, it will attempt to use the Classloader
+ * to resolve it.
This class is a singleton.
+ * + * @author Ken Paulsen (ken.paulsen@sun.com) + */ +@FormatDefinition +public class TemplateLayoutDefinitionManager extends LayoutDefinitionManager { + + /** + *Constructor.
+ */ + protected TemplateLayoutDefinitionManager() { + super(); + } + + /** + *This method returns an instance of this LayoutDefinitionManager. + * The object returned is a singleton (only 1 instance will be + * created per application).
+ * + * @returnTemplateLayoutDefinitionManager instance
+ */
+ public static LayoutDefinitionManager getInstance() {
+ return getInstance(FacesContext.getCurrentInstance());
+ }
+
+ /**
+ * This method provides access to the application-scoped instance
+ * of the TemplateLayoutDefinitionManager.
FacesContext (may be null).
+ */
+ public static LayoutDefinitionManager getInstance(FacesContext ctx) {
+ if (ctx == null) {
+ ctx = FacesContext.getCurrentInstance();
+ }
+ TemplateLayoutDefinitionManager instance = null;
+ if (ctx != null) {
+ instance = (TemplateLayoutDefinitionManager)
+ ctx.getExternalContext().getApplicationMap().get(TLDM_INSTANCE);
+ }
+ if (instance == null) {
+ instance = new TemplateLayoutDefinitionManager();
+ if (ctx != null) {
+ ctx.getExternalContext().getApplicationMap().put(
+ TLDM_INSTANCE, instance);
+ }
+ }
+ return instance;
+ }
+
+ /**
+ * This method uses the key to determine if this + * {@link LayoutDefinitionManager} is responsible for handling the + * key.
+ * + *The template format is very flexible which makes it difficult to + * detect this vs. another format. For this reason, it is suggested + * that this format be attempted last (or at least after more + * detectable formats).
+ * + * This method checks the first character that is not a comment or
+ * whitespace (according to the TemplateParser). If this first
+ * character is a single quote or double quote it return
+ * true. If it is a "<" character, it looks to see
+ * if it starts with "<?" or "<!DOCTYPE". If it does start
+ * that way, it returns false; otherwise it returns
+ * true. If any other character is found or an
+ * exception is thrown, it will return false.
key.
+ *
+ * @param key Key identifying the desired {@link LayoutDefinition}.
+ *
+ * @return The requested {@link LayoutDefinition}.
+ */
+ public LayoutDefinition getLayoutDefinition(String key) throws LayoutDefinitionException {
+ // Make sure we found the url
+ URL url = null;
+ try {
+ url = FileUtil.searchForFile(key, ".jsf");
+ } catch (IOException ex) {
+ throw new LayoutDefinitionException(
+ "Unable to locate '" + key + "'", ex);
+ }
+ if (url == null) {
+ throw new LayoutDefinitionException(
+ "Unable to locate '" + key + "'");
+ }
+
+ // Read the template file
+ LayoutDefinition ld = null;
+ try {
+ ld = new TemplateReader(key, url).read();
+ } catch (IOException ex) {
+ throw new LayoutDefinitionException(
+ "Unable to process '" + url.toString() + "'.", ex);
+ }
+
+ // Dispatch "initPage" handlers
+ ld.dispatchInitPageHandlers(FacesContext.getCurrentInstance(), ld);
+
+ // Return the LayoutDefinition
+ return ld;
+ }
+
+ /**
+ * Application scope key for an instance of this class.
+ */ + private static final String TLDM_INSTANCE = "__jsft_TemplateLDM"; +} diff --git a/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/TemplateParser.java b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/TemplateParser.java new file mode 100644 index 0000000..9d87f3b --- /dev/null +++ b/jsftemplating/src/main/java/com/sun/jsftemplating/layout/template/TemplateParser.java @@ -0,0 +1,791 @@ +/* + * The contents of this file are subject to the terms + * of the Common Development and Distribution License + * (the License). You may not use this file except in + * compliance with the License. + * + * You can obtain a copy of the license at + * https://jsftemplating.dev.java.net/cddl1.html or + * jsftemplating/cddl1.txt. + * See the License for the specific language governing + * permissions and limitations under the License. + * + * When distributing Covered Code, include this CDDL + * Header Notice in each file and include the License file + * at jsftemplating/cddl1.txt. + * If applicable, add the following below the CDDL Header, + * with the fields enclosed by brackets [] replaced by + * you own identifying information: + * "Portions Copyrighted [year] [name of copyright owner]" + * + * Copyright 2006 Sun Microsystems, Inc. All rights reserved. + */ +package com.sun.jsftemplating.layout.template; + +import java.io.BufferedInputStream; +import java.io.BufferedReader; +import java.io.IOException; +import java.io.InputStream; +import java.io.InputStreamReader; +import java.net.URL; +import java.util.ArrayList; +import java.util.List; +import java.util.Stack; + +import com.sun.jsftemplating.layout.SyntaxException; +import com.sun.jsftemplating.layout.descriptors.handler.OutputTypeManager; +import com.sun.jsftemplating.util.IncludeInputStream; +import com.sun.jsftemplating.util.LogUtil; + + +/** + *This class is responsible for the actual parsing of a template.
+ * + *This class is intended to read the template one time. Often it may be + * useful to cache the result as it would be inefficient to reread a + * template multiple times. Templates that are generated from this class + * are intended to be static and safe to share. However, this class + * itself is not thread safe.
+ * + * @author Ken Paulsen (ken.paulsen@sun.com) + */ +public class TemplateParser { + + /** + *Constructor.
+ * + * @param urlURL pointing to the template.
+ */
+ public TemplateParser(URL url) {
+ _url = url;
+ }
+
+ /**
+ * Constructor which accepts a InputStream.
InputStream for the template.
+ */
+ public TemplateParser(InputStream stream) {
+ _inputStream = stream;
+ }
+
+ /**
+ * Accessor for the URL.
+ */ + public URL getURL() { + return _url; + } + + /** + * Accessor for the InputStream. This either comes from
+ * the supplied URL, or simply from the supplied
+ * InputStream.
The init method opens the given URL pointing to a
+ * template and prepares to parses it.
This method closes the stream if it is open. It doesn't throw an + * exception, instead it logs any exceptions at the CONFIG level.
+ */ + public void close() { + try { + if (_reader != null) { + _reader.close(); + } + } catch (Exception ex) { + if (LogUtil.configEnabled(this)) { + LogUtil.config("Exception while closing stream for url: '" + + getURL() + "'.", ex); + } + } + } + + /** + *This method returns the next character.
+ */ + public int nextChar() throws IOException { + if (!_stack.empty()) { + // We have values in the queue + return _stack.pop().charValue(); + } + return _reader.read(); + } + + /** + *This method pushes a character on the read queue so that it will + * be read next.
+ */ + public void unread(int ch) { + _stack.push(new Character((char) ch)); + } + + /** + *This method reads a "Name Value Pair" from the stream. For the + * purposes of this method, a "Name Value Pair" may look like like one + * of these formats:
+ * + *
+ * - keyName="keyValue"
+ * - keyName='keyValue'
+ * - "keyValue" (only if defName is supplied)
+ * - 'keyValue' (only if defName is supplied)
+ * - keyName=>$attribute{attributeKey}
+ * - keyName=>$session{sessionKey}
+ * keyName=>$page{pageSessionKey}
+ * keyName=>$pageSession{pageSessionKey}
+ *
+ *
+ * In the first two formats, keyName must consist of
+ * letters, numbers, or the underscore '_' character.
+ * keyValue must be wrapped in single or double quotes.
+ * The backslash '\' character may be used to escape characters, this
+ * may be useful if a backslash, single, or double quote exists in
+ * the string.
The last four formats are only used for mapping return values.
+ * This is necessary when a handler returns a value so that the value
+ * can be stored somewhere. keyName in these cases is
+ * the name of the return value to map. The value after the dollar
+ * '$' character (which is either "attribute", "page", "pageSession",
+ * or "session") specifies the type of storage the value should be
+ * saved. The value inside the curly braces "{}" specifies the key
+ * that should be used when saving the value as a request, page, or
+ * session attribute.
The return value is of type {@link NameValuePair}. This object + * contains the necessary information to interpret this NVP.
+ * + * @param defName The default name to use if ommitted. If + *null, no default will be used -- a
+ * {@link SyntaxException} will be generated.
+ *
+ * @return A {@link NameValuePair} object containing the NVP info.
+ */
+ public NameValuePair getNVP(String defName) throws IOException {
+ return getNVP(defName, true);
+ }
+
+ /**
+ * This method behaves the same as {@link #getNVP(String)}, however,
+ * it adds the ability to make quotes around the value optional. This
+ * is done by passing in false for
+ * requireQuotes. This is used by some special commands
+ * which only take a single argument with no property name. In this
+ * case, the value will be read until a '>' is encountered (if
+ * "/>" is encountered, it will stop before the '/').
Also, in cases where quotes are optional, output NVPs will not be + * allowed. The rationale is that the "=>$...{...}" syntax did + * not require quotes already, and use cases which allow for omitting + * quotes do not use output mappings.
+ * + * @param defName The default name to use if ommitted. If + *null, no default will be used -- a
+ * {@link SyntaxException} will be generated.
+ *
+ * @param requireQuotes Flag indicating whether enforce the use of
+ * quotes or not.
+ *
+ * @return A {@link NameValuePair} object containing the NVP info.
+ *
+ * @throws {@link SyntaxException} if the syntax is not correct.
+ */
+ public NameValuePair getNVP(String defName, boolean requireQuotes) throws IOException {
+ return getNVP(defName, requireQuotes, "_.");
+ }
+
+ /**
+ * This method behaves the same as {@link #getNVP(String, boolean)},
+ * however, it adds the ability to specify the valid characters which
+ * may appear in the parameter name (via otherChars).
null, no default will be used -- a
+ * {@link SyntaxException} will be generated.
+ *
+ * @param requireQuotes Flag indicating whether enforce the use of
+ * quotes or not.
+ *
+ * @param otherChars Other valid characters.
+ *
+ * @return A {@link NameValuePair} object containing the NVP info.
+ *
+ * @throws {@link SyntaxException} if the syntax is not correct.
+ */
+ public NameValuePair getNVP(String defName, boolean requireQuotes, String otherChars) throws IOException {
+ // Read the name
+ String name = readToken(otherChars);
+ Object value = null;
+
+ // Check for empty name
+ if ((name.length() == 0) && (defName != null)) {
+ name = defName; // Use default name
+ unread('='); // Add '=' character
+ }
+
+ // Skip White Space
+ skipCommentsAndWhiteSpace(SIMPLE_WHITE_SPACE);
+
+ // Ensure next character is '='
+ int next = nextChar();
+ if ((next != '=') && (next != ':')) {
+ if (!requireQuotes && !name.equals(defName)) {
+ // This is the case where there is no property name and no
+ // quotes, the whole string is the value.
+ value = name;
+ name = defName;
+ // Add a flag to ensure the next switch goes to the "default" case
+ unread(next);
+ unread('f');
+ } else {
+ throw new SyntaxException(
+ "'=' or ':' missing for Name Value Pair: '" + name + "'!");
+ }
+ }
+
+ // Skip whitespace...
+ skipCommentsAndWhiteSpace(SIMPLE_WHITE_SPACE);
+
+ // Check for '>' character (means we're mapping an output value)
+ String target = null;
+ int endingChar = -1;
+ next = nextChar();
+ switch (next) {
+ case '>':
+ if (!requireQuotes) {
+ // This means output mappings are not allowed, this must
+ // be the end of the input (meaning there was no input
+ // since we're at the beginning also)
+ unread(next);
+ value = "";
+ break;
+ }
+
+ // We are mapping an output value, this should look like:
+ // keyName => $attribute{attKey}
+ // keyName => $application{appKey}
+ // keyName => $session{sessionKey}
+ // keyName => $pageSession{pageSessionKey}
+
+ // First skip any whitespace after the '>'
+ skipCommentsAndWhiteSpace(SIMPLE_WHITE_SPACE);
+
+ // Next Make sure we have a '$' character
+ next = nextChar();
+ if (next != '$') {
+ throw new SyntaxException(
+ "'$' missing for Name Value Pair named: '" + name
+ + "=>'! This NVP appears to be a mapping expression, "
+ + "therefor requires a format similar to:\n\t" + name
+ + " => $attribute{attKey}\nor:\n\t" + name
+ + " => $application{applicationKey}\nor:\n\t" + name
+ + " => $session{sessionKey}\nor:\n\t" + name
+ + " => $pageSession{pageSessionKey}");
+ }
+
+ // Next look for valid type...
+ target = readToken();
+ OutputTypeManager otm = OutputTypeManager.getInstance();
+ if (otm.getOutputType(null, target) == null) {
+ throw new SyntaxException(
+ "Invalid OutputType ('" + target + "') for Name Value "
+ + "Pair named: '" + name + "=>$" + target + "{...}'! "
+ + "This NVP appears to be a mapping expression, "
+ + "therefor requires a format similar to:\n\t" + name
+ + " => $attribute{attKey}\nor:\n\t" + name
+ + " => $application{applicationKey}\nor:\n\t" + name
+ + " => $session{sessionKey}\nor:\n\t" + name
+ + " => $pageSession{pageSessionKey}");
+ }
+
+ // Skip whitespace again...
+ skipCommentsAndWhiteSpace(SIMPLE_WHITE_SPACE);
+
+ // Now look for '{'
+ next = nextChar();
+ if (next != '{') {
+ throw new SyntaxException(
+ "'{' missing for Name Value Pair: '" + name
+ + "=>$" + target
+ + "'! The format must resemble the following:\n\t"
+ + name + " => $" + target + "{key}");
+ }
+ endingChar = '}';
+ break;
+ case '{':
+ // NVP w/ a List as its value
+ value = parseList('}');
+ break;
+ case '[':
+ // NVP w/ an array as its value
+ value = parseList(']').toArray();
+ break;
+ case '"':
+ case '\'':
+ // Regular NVP...
+ // Set the ending character to the same type of quote
+ endingChar = next;
+ break;
+ case 'f':
+ if ((value != null) && (value.toString().length() > 0)) {
+ // We have the case where the whole string is the value
+ // Get the next character so we can fall through w/ it
+ // to the default case
+ next = nextChar();
+ }
+ // Don't break here, fall through...
+ default:
+ // See if we require quotes around the value...
+ if (!requireQuotes) {
+ unread(next); // Include "next" when getting the value
+ // Read the value until '>'
+ String strVal = readUntil('>', true);
+
+ // Unread the '>'
+ unread('>');
+
+ // See if we also need put back a '/'...
+ if (strVal.endsWith("/")) {
+ // Remove the '/' and place back in the read buffer
+ strVal = strVal.substring(0, strVal.length() - 1).trim();
+ unread('/');
+ }
+ value = (value == null) ? strVal : (value.toString() + strVal);
+ break;
+ }
+
+ // This isn't legal, throw an exception
+ throw new SyntaxException("Name Value Pair named '"
+ + name + "' is missing single or double quotes enclosing "
+ + "its value. It must follow one of these formats:\n\t"
+ + name + "=\"value\"\nor:\n\t" + name + "='value'");
+ }
+
+ // Read the value
+ if (endingChar != -1) {
+ value = readUntil(endingChar, false);
+ }
+
+ // Create the NVP object and return it
+ return new NameValuePair(name, value, target);
+ }
+
+ /**
+ * This method processes lists of String values in the format:
+ * + *"value1", "value2", ...}
The content inside the Strings can be anything. The double quotes
+ * can also be single quotes. The separators can be spaces, tabs, new
+ * lines, commas, semi-colons, or colons. The terminating character
+ * is whatever is passed in for endChar (shown as '}'
+ * above).
This method reads while the stream contains letters, numbers, the + * colon character ':', a dot '.', or the underscore '_' character, + * and returns the result.
+ */ + public String readToken() throws IOException { + return readToken("_:."); + } + + /** + *This method reads while the stream contains letters or numbers and + * returns the result.
+ * + * It also allows any charcters specified by otherChars
+ * to be considered as part of the token. This allows tokens with
+ * additional valid characters to be read. otherChars
+ * may be null if no additional chars are valid.
This method returns a String of characters from the
+ * current position in the file until the given character (or end of
+ * file) is encountered. It will not leave the given character in the
+ * buffer, so the next character to be read will be the character
+ * following the given character.
true to strip comments.
+ */
+ public String readUntil(int endingChar, boolean skipComments) throws IOException {
+ if (skipComments) {
+ // In case we start on a comment and should skip it...
+ skipCommentsAndWhiteSpace("");
+ }
+ int tmpch;
+ int next = nextChar();
+ StringBuffer buf = new StringBuffer();
+ while ((next != endingChar) && (next != -1)) {
+ switch (next) {
+ case '\'' :
+ case '\"' :
+ if ((skipComments) && (next != endingChar)) {
+ // In this case, we want to make sure no comments are
+ // skipped when inside a quote
+ //
+ // NOTE: Also means endingChar will not be found in
+ // a quote.
+ buf.append((char) next);
+ buf.append(readUntil(next, false));
+ buf.append((char) next);
+ } else {
+ buf.append((char) next);
+ }
+ break;
+ case '#' :
+ case '/' :
+ case '<' :
+ // When reading we want to ignore comments, don't skip
+ // whitespace, though...
+ if (skipComments) {
+ unread(next);
+ skipCommentsAndWhiteSpace("");
+ // If same char, read next to prevent infinite loop
+ // We don't have to go through switch again b/c its
+ // not the ending char and its not escaped -- so it is
+ // safe to add.
+ tmpch = nextChar();
+ if (next == tmpch) {
+ buf.append((char) next);
+ } else {
+ // We're somewhere different, unread
+ unread(tmpch);
+ }
+ } else {
+ buf.append((char) next);
+ }
+ break;
+ case '\\' :
+ // Escape Character...
+ next = nextChar();
+ if (next == 'n') {
+ // Special case, insert a '\n' character.
+ buf.append('\n');
+ } else if (next == 't') {
+ // Special case, insert a '\t' character.
+ buf.append('\t');
+ } else if (next != '\n') {
+ // add the next char unless it's a return char
+ buf.append((char) next);
+ }
+ break;
+ default:
+ buf.append((char) next);
+ break;
+ }
+ next = nextChar();
+ }
+
+ // Return the result
+ return buf.toString();
+ }
+
+ /**
+ * This method returns a String of characters from the
+ * current position in the file until the given String (or end of
+ * file) is encountered. It will not leave the given String in the
+ * buffer, so the next character to be read will be the character
+ * following the given character.
String.
+ * @param skipComments true to ignore comments.
+ */
+ public String readUntil(String endingStr, boolean skipComments) throws IOException {
+ // Sanity Check
+ if ((endingStr == null) || (endingStr.length() == 0)) {
+ return "";
+ }
+
+ // Break String into characters
+ char arr[] = endingStr.toCharArray();
+ int arrlen = arr.length;
+
+ StringBuffer buf = new StringBuffer("");
+ int ch = nextChar(); // Read a char to unread
+ int idx = 1;
+ do {
+ // We didn't find the end, push read values back on queue
+ unread(ch);
+ for (int cnt = idx-1; cnt > 0; cnt--) {
+ unread(arr[cnt]);
+ }
+
+ // Read until the beginning of the end (maybe)
+ buf.append(readUntil(arr[0], skipComments));
+ buf.append(arr[0]); // readUntil reads but doesn't return this char
+
+ // Check to see if we are at the end
+ for (idx = 1; idx < arrlen; idx++) {
+ ch = nextChar();
+ if (ch != arr[idx]) {
+ // This is not the end!
+ break;
+ }
+ }
+ } while ((ch != -1) && (idx < arrlen));
+
+ // Append the remaining characters (use idx in case we hit eof)...
+ for (int cnt = 1; cnt < idx; cnt++) {
+ buf.append(arr[cnt]);
+ }
+
+ if (arrlen != idx) {
+ // Didn't find it!
+ throw new SyntaxException("Unable to find: '" + endingStr
+ + "'. Read to EOF and gave up. Read: \n" + buf.toString());
+ }
+
+ // Return the result
+ return buf.toString();
+ }
+
+ /**
+ * This method skips the given String of characters (usually used to + * skip white space. The contents of the String that is skipped is + * lost. Often you may wish to skip comments as well, use + * {@link TemplateParser#skipCommentsAndWhiteSpace(String)} in this + * case.
+ * + * @param skipChars The white space characters to skip. + * + * @see TemplateParser#skipCommentsAndWhiteSpace(String) + */ + public void skipWhiteSpace(String skipChars) throws IOException { + int next = nextChar(); + while ((next != -1) && (skipChars.indexOf(next) != -1)) { + // Skip... + next = nextChar(); + } + + // This will skip one too many + unread(next); + } + + /** + *Normally you don't just want to skip white space, you also want to + * skip comments. This method allows you to do that. It skips + * comments of the following types:
+ * + *
+ * - // - Comment extends to the rest of the line.
+ * - # - Comment extends to the rest of the line.
+ * - /* - Comment extends until closing '*' and '/'.
+ * - <!-- - Comment extends until closing -->.
+ *
+ *
+ * @param skipChars The white space characters to skip
+ *
+ * @see TemplateParser#skipWhiteSpace(String)
+ */
+ public void skipCommentsAndWhiteSpace(String skipChars) throws IOException {
+ int ch = 0;
+ while (ch != -1) {
+ ch = nextChar();
+ switch (ch) {
+ case '#' :
+ // Skip rest of line
+ readLine();
+ break;
+ case '/' :
+ ch = nextChar();
+ if (ch == '/') {
+ // Skip rest of line
+ readLine();
+ } else if (ch == '*') {
+ // Throw away everything until '*' & '/'.
+ readUntil("*/", false);
+ } else {
+ // Not a comment, don't read
+ unread(ch);
+ unread('/');
+ ch = -1; // Exit loop
+ }
+ break;
+ case '<' :
+ ch = nextChar(); // !
+ if (ch == '!') {
+ ch = nextChar(); // -
+ if (ch == '-') {
+ ch = nextChar(); // -
+ if (ch == '-') {
+ // Ignore HTML-style comment
+ readUntil("-->", false);
+ } else {
+ // Not a comment, probably a mistake... lets
+ // throw an exception
+ unread(ch);
+ unread('-');
+ unread('!');
+ unread('<');
+ throw new IllegalArgumentException("Invalid "
+ + "comment! Expected comment to begin "
+ + "with \"
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/jsftemplating/src/main/resources/META-INF/faces-config.xml b/jsftemplating/src/main/resources/META-INF/faces-config.xml
new file mode 100644
index 0000000..3788881
--- /dev/null
+++ b/jsftemplating/src/main/resources/META-INF/faces-config.xml
@@ -0,0 +1,115 @@
+
+
+
+
+