com.sun.webui.jsf.component.util.Util Maven / Gradle / Ivy
/*
* 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://woodstock.dev.java.net/public/CDDLv1.0.html.
* 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 https://woodstock.dev.java.net/public/CDDLv1.0.html.
* 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.webui.jsf.component.util;
import java.beans.Beans;
import java.util.Iterator;
import javax.faces.FactoryFinder;
import javax.faces.component.UIComponent;
import javax.faces.component.UIForm;
import javax.faces.context.FacesContext;
import javax.faces.event.PhaseListener;
import javax.faces.lifecycle.Lifecycle;
import javax.faces.lifecycle.LifecycleFactory;
import javax.servlet.http.HttpServletRequest;
/**
* Utility class that contains helper methods for components.
*
* @author Ken Paulsen
*/
public class Util {
/**
* This constructor is here to prevent this class from being
* instantiated. It only contains static methods.
*/
private Util() {
}
/**
* 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 static 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 static 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 = (UIComponent) 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 = (UIComponent) it.next();
if (id.equals(child.getId())) {
return (child);
}
}
}
// Not found, return null
return null;
}
/**
* Helper method to obtain containing UIForm.
*
* @param context FacesContext for the request we are
* processing.
* @param component UIComponent to find form from.
*
* @return Returns the UIForm component that contains this element
*/
public static UIComponent getForm(FacesContext context, UIComponent component) {
//make sure component is not null
if (component != null) {
//make sure we don't already have a form
if (component instanceof UIForm) {
return component;
}
UIComponent form = component;
do {
form = form.getParent();
if (form != null && form instanceof UIForm) {
return form;
}
} while (form != null);
}
return null;
}
/**
* Gets the form id from the containing UIForm.
*
* @param context FacesContext for the request we are processing.
* @param component UIComponent to find form from.
*
* @return Returns the id of the UIForm that contains this
* element.
*/
public static String getFormName(FacesContext context, UIComponent component) {
UIComponent form = getForm(context, component);
if (form != null) {
return form.getClientId(context);
}
return null;
}
/**
* Return the base URI for the view identifier of the current view.
*
* @param context FacesContext for the current request
*/
public static String getBase(FacesContext context) {
return getContext(context) + context.getViewRoot().getViewId();
}
/**
* Return an absolute URL to our server and context path.
*
* @param context FacesContext for the current request
*/
public static String getContext(FacesContext context) {
// FIXME - design time FacesContext needs better instrumentaiton?
if (Beans.isDesignTime()) {
return "http://localhost:18080/myapp";
}
//FIXME - portlet environment variation?
HttpServletRequest request = (HttpServletRequest) context.getExternalContext().getRequest();
StringBuffer sb = new StringBuffer(request.getScheme());
sb.append("://"); //NOI18N
sb.append(request.getServerName());
if ("http".equals(request.getScheme()) && (80 == request.getServerPort())) {//NOI18N
;
} else if ("https".equals(request.getScheme()) && (443 == request.getServerPort())) {//NOI18N
;
} else {
sb.append(":" + request.getServerPort()); //NOI18N
}
sb.append(request.getContextPath());
return sb.toString();
}
public static String getActionURL(FacesContext context, String url) {
return context.getApplication().getViewHandler().getActionURL(context, url);
}
/**
* Add a PhaseListener.
*
* @param phaseListener PhaseListener instance.
*/
public static void addPhaseListener(PhaseListener phaseListener) {
LifecycleFactory factory = (LifecycleFactory) FactoryFinder.getFactory(FactoryFinder.LIFECYCLE_FACTORY);
Lifecycle lifecycle =
factory.getLifecycle(LifecycleFactory.DEFAULT_LIFECYCLE);
lifecycle.addPhaseListener(phaseListener);
}
/**
* Remove a PhaseListener.
*
* @param phaseListener PhaseListener instance.
*/
public static void removePhaseListener(PhaseListener phaseListener) {
LifecycleFactory factory = (LifecycleFactory) FactoryFinder.getFactory(FactoryFinder.LIFECYCLE_FACTORY);
Lifecycle lifecycle =
factory.getLifecycle(LifecycleFactory.DEFAULT_LIFECYCLE);
lifecycle.removePhaseListener(phaseListener);
}
}