Jakarta Server Faces

jakarta.faces

Specification: Jakarta Server Faces

Version: 3.0

Status: Final

Release: September 23, 2020
LifecycleFactory lFactory = (LifecycleFactory)
    FactoryFinder.getFactory(FactoryFinder.LIFECYCLE_FACTORY);
Lifescycle lifecycle =
    lFactory.getLifecycle(LifecycleFactory.DEFAULT_LIFECYCLE);
FacesContextFactory fcFactory = (FacesContextFactory)
    FactoryFinder.getFactory(FactoryFinder.FACES_CONTEXT_FACTORY);
FacesContext facesContext =
    fcFactory.getFacesContext(context, request, response, lifecycle);
String viewId = ... identifier of the desired Tree ...;
ViewHandler viewHandler = application.getViewHandler();
UIViewRoot view = viewHandler.createView(facesContext, viewId);
String renderKitId = ... identifier of desired RenderKit ...;
RenderKitFactory rkFactory = (RenderKitFactory)
    FactoryFinder.getFactory(FactoryFinder.RENDER_KIT_FACTORY);
RenderKit renderKit = rkFactory.getRenderKit(renderKitId, facesContext);
view.setRenderKitId(renderKitId);
FooComponent component = ... create a FooComponent instance ...;
facesContext.getViewRoot().getChildren().add(component);
<faces-config>
  <application>
    <locale-config>
      <default-locale>en</default-locale>
      <supported-locale>de</supported-locale>
      <supported-locale>fr</supported-locale>
      <supported-locale>es</supported-locale>
    </locale-config>
  </application>
<f:loadBundle basename=”com.foo.industryMessages.chemical”
              var=”messages” />
<h:outputText value=”#\{messages.benzene}” />
public class Slider extends UISelectOne {
  protected Integer min = null;
  protected Integer max = null;
  protected Integer cur = null;

  // ... details omitted
  public Object saveState(FacesContext context) {
    Object values[] = new Object[4];
    values[0] = super.saveState(context);
    values[1] = min;
    values[2] = max;
    values[3] = cur;
  }

  public void restoreState(FacesContext context, Object state) {
    Object values[] = (Object {}) state; // guaranteed to succeed
    super.restoreState(context, values[0]);
    min = (Integer) values[1];
    max = (Integer) values[2];
    cur = (Integer) values[3];
  }
<h:commandButton>
  <f:ajax event="mouseover"/>
</h:commandButton>
[0-9]+(_[0-9]+)*
[A-Za-z]{2}(_[A-Za-z]{2}(_[A-Za-z]+)*)?
function createResource(resourceName, libraryName) {
    var resource = null;
    var resourceId = null;
    for (var contract : getLibraryContracts()) {
        resourceId = deriveResourceIdConsideringResourceLoaders(contract,
                resourceName, libraryName)
        if (null != resourceId) {
            resource = create the resource using the resourceId;
            return resource;
        }
    }

    // try without a contract
    resourceId = deriveResourceIdConsideringResourceLoaders(null,
            resourceName, libraryName)
    if (null != resourceId) {
        resource = create the resource using the resourceId;
    }
    return resource;
}

function deriveResourceIdConsideringResourceLoaders(contract,
        resourceName, libraryName) {
    var prefix = web app root resource prefix;
    var resourceLoader = web app resource loader;
    // these are shorthand for the prefix and resource loading
    // facility specified in Section 2.6.1.1. They are
    // not actual API per se.
    var resourceId = deriveResourceIdConsideringLocalePrefix(contract,
            prefix, resourceLoader, resourceName, libraryName);

    if (null == resourceId) {
        prefix = classpath resource prefix;
        resourceLoader = classpath resource loader;
        // these are shorthand for the prefix and resource
        // loading facility specified in Section 2.6.1.2. They are
        // not actual API per se.
        resourceId = deriveResourceIdConsideringLocalePrefix(contract,
                prefix, resourceLoader, resourceName, libraryName);
    }
    return resourceId;
}

function deriveResourceIdConsideringLocalePrefix(contract, prefix,
        resourceLoader, resourceName, libraryName) {
    var localePrefix = getLocalePrefix();
    var result = deriveResourceId(contract, prefix, resourceLoader,
            resourceName, libraryName, localePrefix);
    // If the application has been configured to have a localePrefix,
    // and the resource is not found, try to find it again,
    // without the localePrefix.
    if (null == result && null != localePrefix) {
        result = deriveResourceId(contract, prefix, resourceLoader,
                resourceName, libraryName, null);
    }
    return result;
}

function deriveResourceId(contract, prefix, resourceLoader,
        resourceName, libraryName, localePrefix) {
    var resourceVersion = null;
    var libraryVersion = null;
    var resourceId;
    if (null != localePrefix) {
        prefix = localePrefix + '/' + prefix;
    }
    if (null != contract) {
        prefix = contract + '/' + prefix;
    }

    if (null != libraryName) {
        // actual argument is
        // resourcesInContractInJar/resources/resourcesInContractInJar
        var libraryPaths = resourceLoader.getResourcePaths(
                prefix + '/' + libraryName);

        if (null != libraryPaths && !libraryPaths.isEmpty()) {
            libraryVersion = // execute the comment
            // Look in the libraryPaths for versioned libraries.
            // If one or more versioned libraries are found, take
            // the one with the highest version number as the value
            // of libraryVersion. If no versioned libraries
            // are found, let libraryVersion remain null.
        }
        if (null != libraryVersion) {
            libraryName = libraryName + '/' + libraryVersion;
        }
        var resourcePaths = resourceLoader.getResourcePaths(
            prefix + '/' + libraryName + '/' + resourceName);
        if (null != resourcePaths && !resourcePaths.isEmpty()) {
            resourceVersion = // execute the comment +
            // Look in the resourcePaths for versioned resources.
            // If one or more versioned resources are found, take
            // the one with the â€œhighestâ€? version number as the value
            // of resourceVersion. If no versioned libraries
            // are found, let resourceVersion remain null.
        }
        if (null != resourceVersion) {
            resourceId = prefix + '/' + libraryName + '/' +
                    resourceName + '/' + resourceVersion;
        }
        else {
            resourceId = prefix + '/' + libraryName + '/' + resourceName;
        }
    } // end of if (null != libraryName)
    else {
        // libraryName == null
        var resourcePaths = resourceLoader.getResourcePaths(
                prefix + '/' + resourceName);
        if (null != resourcePaths && !resourcePaths.isEmpty()) {
            resourceVersion = // execute the comment
            // Look in the resourcePaths for versioned resources.
            // If one or more versioned resources are found, take
            // the one with the â€œhighestâ€? version number as the value
            // of resourceVersion. If no versioned libraries
            // are found, let resourceVersion remain null.
        }
        if (null != resourceVersion) {
            resourceId = prefix + '/' + resourceName + '/' +
                    resourceVersion;
        } else {
            resourceId = prefix + '/' + resourceName;
        }
    } // end of else, when libraryName == null
    return resourceId;
}

function getLocalePrefix() {
    var localePrefix;
    var appBundleName = facesContext.application.messageBundle;
    if (null != appBundleName) {
        var locale =
            // If there is a viewRoot on the current facesContext,
            // use its locale.
            // Otherwise, use the locale of the application's ViewHandler
        ResourceBundle appBundle = ResourceBundle.getBundle(
                appBundleName, locale);
        localePrefix = appBundle.getString(ResourceHandler. LOCALE_PREFIX);
    }
    // Any MissingResourceException instances that are encountered
    // in the above code must be swallowed by this method, and null
    // returned;
    return localePrefix;
}
<h:graphicImage name=”Planets.gif” library=”images”/>
<h:graphicImage value=”#{resource[‘images:Planets.gif’]}”/>
<f:view contentType="text/html">
  <h:head>
    <meta http-equiv="Content-Type"
        content="text/html;charset=iso-8859-1" />
    <title>Example View</title>
  </h:head>
  <h:body>
    <h:form>
      <h:outputScript name=”ajax.js” library=”jakarta.faces”
          target=”head”/>
    </h:form>
  </h:body>
</f:view>
@ListenerFor(facesEventClass=PostAddToViewEvent.class,
        sourceClass=UIOutput.class)
public class ScriptRenderer extends Renderer
        implements ComponentSystemEventListener {...
META-INF/contracts/
                  siteLayout/
                            jakarta.faces.contract.xml
                            topNav_template.xhtml
                            leftNav_foo.xhtml
                            styles.css
                            script.js
                            background.png
                  subSiteLayout/
                            jakarta.faces.contract.xml
                            sub_template.xhtml
public String getId();
public void setId(String componentId);
public String getFamily();
public ValueExpression getValueExpression(String name);
public void setValueExpression(String name, ValueExpression expression);
public ValueBinding getValueBinding(String name);
public void setValueBinding(String name, ValueBinding binding);
public String getClientId(FacesContext context);
protected String getContainerClientId(FacesContext context);
public UIComponent getParent();
public void setParent(UIComponent parent);
public List<UIComponent> getChildren();
public int getChildCount();
public UIComponent findComponent(String expr);
public Iterator<UIComponent> getFacetsAndChildren();
public boolean invokeOnComponent(FacesContext context,
    String clientId, ContextCallback callback) throws FacesException;
public interface ContextCallback {
  public void invokeContextCallback(
      FacesContext context, UIComponent target);
}
public static UIComponent getCurrentComponent(FacesContext context);
public static UIComponent getCurrentCompositeComponent(
    FacesContext context);
public boolean visitTree(VisitContext context, VisitCallback callback);
public Map<String, UIComponent> getFacets();
public UIComponent getFacet(String name);
public UIHeader getHeader() {
  return ((UIHeader) getFacet(“header”);
}

public void setHeader(UIHeader header) {
  getFacets().put(“header”, header);
}
public void addBehavior(String eventName, Behavior behavior)
public Collection<String> getEventNames()
public Map<String, List<Behavior>> getBehaviors()
public String getDefaultEventName()
public Map<String, Object> getAttributes();
public static final String CURRENT_COMPONENT =
    "jakarta.faces.component.CURRENT_COMPONENT";
public static final String CURRENT_COMPOSITE_COMPONENT =
    "jakarta.faces.component.CURRENT_COMPOSITE_COMPONENT";
public static final String BEANINFO_KEY =
    "jakarta.faces.component.BEANINFO_KEY";
public static final String FACETS_KEY =
    "jakarta.faces.component.FACETS_KEY";
public static final String COMPOSITE_COMPONENT_TYPE_KEY =
    "jakarta.faces.component.COMPOSITE_COMPONENT_TYPE";
public static final String COMPOSITE_FACET_NAME =
    "jakarta.faces.component.COMPOSITE_FACET_NAME";
public boolean broadcast(FacesEvent event)
    throws AbortProcessingException;
public void decode(FacesContext context);
public void encodeAll(FacesContext context) throws IOException
public void encodeBegin(FacesContext context) throws IOException;
public void encodeChildren(FacesContext context) throws IOException;
public void encodeEnd(FacesContext context) throws IOException;
public void queueEvent(FacesEvent event);
protected void pushComponentToEL(FacesContext context);
protected void popComponentFromEL(FacesContext context)
public void processRestoreState(FacesContext context, Object state);
public void processDecodes(FacesContext context);
public void processValidators(FacesContext context);
public void processUpdates(FacesContext context);
public void processSaveState(FacesContext context);
protected FacesContext getFacesContext();
protected Renderer getRenderer(FacesContext context);
protected void addFacesListener(FacesListener listener);
protected void removeFacesListener(FacesListener listener);
public Map<String, String> getResourceBundleMap();
public void addActionListener(ActionListener listener);
public void removeActionListener(ActionListener listener);
public Object saveState(FacesContext context);
public void restoreState(FacesContext context,
    Object state) throws IOException;
void clearInitialState();
boolean initialStateMarked();
void markInitialState();
public void addValidator(Validator validator);
public void removeValidator(Validator validator);
public void addValueChangeListener(ValueChangeListener listener);
public void removeValueChangeListener(ValueChangeListener listener);
public List<FacesLifecycleListener> getListenersForEventClass(
    Class<? extends SystemEvent> facesEventClass);
public void addClientBehavior(String eventName, ClientBehavior behavior);
public Collection<String> getEventNames();
public Map<String, List<ClientBehavior>> getClientBehaviors();
public String getDefaultEventName();
public Object getAsObject(FacesContext context,
    UIComponent component, String value) throws ConverterException;
public String getAsString(FacesContext context,
    UIComponent component, Object value) throws ConverterException;
public UIComponent getComponent();
public PhaseId getPhaseId();
public void setPhaseId(PhaseId phaseId);
public abstract boolean isAppropriateListener(FacesListener listener);
public abstract void processListener(FacesListener listener);
public void queue();
public void addFooListener(FooListener listener);
public FooListener[] getFooListeners();
public void removeFooListener(FooListener listener);
public void subscribeToEvent(Class<? extends SystemEvent> eventClass,
    ComponentSystemEventListener componentListener);
public void unsubscribeFromEvent(Class<? extends SystemEvent> eventClass,
    ComponentSystemEventListener componentListener);
<h:inputText value="#{myBean.text}">
  <f:event type="preRenderComponent"
      listener="#{myBean.beforeTextRender}" />
</h:inputText>
public void processEvent(jakarta.faces.event.ComponentSystemEvent event)
    throws AbortProcessingException
public void validate(FacesContext context,
    UIComponent component, Object value);
<faces-config>
  <application>
    <default-validators>
      <validator-id>jakarta.faces.Bean</validator-id>
    </default-validators>
  </application>
</faces-config>
ValidatorFactory validatorFactory =
    Validation.buildDefaultValidatorFactory();
public class FacesMessageInterpolator implements MessageInterpolator {
  private final MessageInterpolator delegate;

  public FacesMessageInterpolator(MessageInterpolator delegate) {
    this.delegate = delegate;
  }

  public String interpolate(String message,
      ConstraintDescriptor constraintDescriptor,Object value) {
    Locale locale = FacesContext.getCurrentInstance()
        .getViewRoot().getLocale();
    return this.delegate.interpolate(
        message, constraintDescriptor, value, locale);
  }

  public String interpolate(String message, ConstraintDescriptor
      constraintDescriptor, Object value, Locale locale) {
    return this.delegate.interpolate(
        message, constraintDescriptor, value, locale);
  }
}
//could be cached
MessageInterpolator facesMessageInterpolator = new FacesMessageInterpolator(
    validatorFactory.getMessageInterpolator() );

//...

Validator validator = validatorFactory
    .usingContext()
    .messageInterpolator(facesMessageInterpolator)
    .getValidator();
jakarta.faces.validator.BeanValidator.MESSAGE={0}
jakarta.faces.validator.BeanValidator.MESSAGE={1}:{0}
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml"
    xmlns:h="http://java.sun.com/jsf/html"
    xmlns:f="http://java.sun.com/jsf/core"
    xmlns:ez="http://java.sun.com/jsf/composite/ezcomp">
  <h:head>
    <title>A simple example of EZComp</title>
  </h:head>
  <h:body>
    <h:form>
      <ez:loginPanel id="loginPanel">
        <f:actionListener for="loginEvent"
            binding="#{bean.loginEventListener}" />
      </ez:loginPanel>
    </h:form>
  </h:body>
</html>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml"
    xmlns:h="http://java.sun.com/jsf/html"
    xmlns:f="http://java.sun.com/jsf/core"
    xmlns:ui="http://java.sun.com/jsf/facelets"
    xmlns:composite="http://java.sun.com/jsf/composite">
  <head>
    <title>Not present in rendered output</title>
  </head>
  <body>
    <composite:interface>
      <composite:actionSource name="loginEvent" />
    </composite:interface>
    <composite:implementation>
      <p>Username: <h:inputText id="usernameInput" /></p>
      <p>Password: <h:inputSecret id="passwordInput" /></p>
      <p><h:commandButton id="loginEvent" value="login"/></p>
    </composite:implementation>
  </body>
</html>
public BeanInfo getComponentMetadata(
    FacesContext context, Resource componentResource)
<composite:interface>
  <composite:editableValueHolder name=”username” />
  <composite:actionSource name=”loginEvent” />
  <composite:actionSource name=”allEvents”
      targets=”loginEvent cancelEvent” />
<composite:interface>
public void broadcast(BehaviorEvent event) throws AbortProcessingException
public void broadcast(BehaviorEvent event) throws AbortProcessingException
protected void addBehaviorListener(BehaviorListener listener)
protected void removeBehaviorListener(BehaviorListener listener);
public String getScript(BehaviorContext behaviorContext)
public void decode(FacesContext context,UIComponent component)
public Set<ClientBehaviorHint> getHints()
public static ClientBehaviorContext createClientBehaviorContext(
    FacesContext context,UIComponent component,
    String eventName, String sourceId,
    Collection<ClientBehaviorContext.Parameter> parameters)
SUBMITTING
public String getScript(BehaviorContext behaviorContext)
public void decode(FacesContext context,UIComponent component)
public Set<ClientBehaviorHint> getHints()
public String getRendererType();
protected ClientBehaviorRenderer getRenderer(FacesContext context);
public Behavior getBehavior()
public void processAjaxBehavior(AjaxBehaviorEvent event)
public class HtmlCommandButton extends
    jakarta.faces.component.UICommand implements ClientBehaviorHolder {
...
  private static final Collection<String> EVENT_NAMES =
      Collections.unmodifiableCollection(
          Arrays.asList("blur","change","click","action",...) );

  public Collection<String> getEventNames() {
    return EVENT_NAMES;
  }

  public String getDefaultEventName() {
    return "action";
  }
...
<behavior>
  <behavior-id>custom.behavior.Greet</behavior-id>
  <behavior-class>greet.GreetBehavior</behavior-class>
</behavior>
@FacesBehavior(value="custom.behavior.Greet")
public class GreetBehavior extends BehaviorBase implements Serializable {
...
}
public boolean isSubmitted();
public void setSubmitted(boolean submitted)
public void processDecodes(FacesContext context);
public void processValidators(FacesContext context);
public void processUpdates(FacesContext context);
public void saveState(FacesContext context);
protected String getContainerClientId(FacesContext context);
public void updateModel(FacesContext context);
public void broadcast(FacesEvent event);
public void validate(FacesContext context);
public void resetValue();
public void addComponentResource(FacesContext context,
    UIComponent componentResource);
public void addComponentResource(FacesContext context,
    UIComponent componentResource, String target);
public List<UIComponent> getComponentResources(String target);
public void addPhaseListener(PhaseListener listener);
public void removePhaseListener(VPhaseListener listener);
public List<PhaseListener> getPhaseListeners();
<h:outputText value=”#{customer.name}”/>
<h:outputText rendered=”#{user.manager}” value=”#{employee.salary}”/>
<h:inputText value=”#{employee.number}”/>
<managed-bean>
  <description>
    A customer bean will be created as needed, and stored in request
    scope. Its “mailingAddress” and “streetAddress” properties will
    be initialized by virtue of the fact that the “value” expressions
    will not encounter any object under key “addressBean” in any scope.
  </description>
  <managed-bean-name>customer</managed-bean-name>
  <managed-bean-class>
    com.mycompany.mybeans.CustomerBean
  </managed-bean-class>
  <managed-bean-scope>request</managed-bean-scope>
  <managed-property>
    <property-name>mailingAddress</property-name>
    <value>#{addressBean}</value>
  </managed-property>
  <managed-property>
    <property-name>shippingAddress</property-name>
    <value>#{addressBean}</value>
  </managed-property>
  <managed-property>
    <property-name>customerType</property-name>
    <value>New</value> <!-- Set to literal value -->
  </managed-property>
</managed-bean>
<managed-bean>
  <description>
    A new AddressBean will not be added to any scope, because we
    only want to create instances when a CustomerBean creation asks
    for them. Therefore, we set the scope to “none”.
  </description>
  <managed-bean-name>addressBean</managed-bean-name>
  <managed-bean-class>
    com.mycompany.mybeans.AddressBean
  </managed-bean-class>
  <managed-bean-scope>none</managed-bean-scope>
</managed-bean>
<referenced-bean>
  <description>
    A JDBC data source will be initialized and made available in
    some scope (presumably application) for use by the Jakarta Faces based
    application when it is actually run. This information is not
    used by the Jakarta Faces implementation itself; only by tools.
  </description>
  <referenced-bean-name>dataSource</referenced-bean-name>
  <referenced-bean-class>
    javax.sql.DataSource
  </referenced-bean-class>
</referenced-bean>
public class User extends Object {
  private @EJB ShoppingCart cart;
  private @Resource Inventory inventory;
  private DataSource customerData;

  @Resource(name=”customerData”)
  private void setCustomerData(DataSource data) {
    customerData = data;
  }

  public String getOrderSummary() {
    // Do something with the injected resources
    // And generate a textual summary of the order
  }
}
public Object getContext(Class key);
void putContext(Class key, Object contextInstance);
...
public Object getValue(ELContext context, Object base, Object property);
void setValue(ELContext context,
    Object base, Object property, Object value);
...
public MethodExpression createMethodExpression(ELContext context,
    String expression, FunctionMapper fnMapper, Class[] paramTypes);
public ValueExpression createValueExpression(ELContext context,
    String expression, Class expectedType, FunctionMapper fnMapper);
public Object getValue(FacesContext context)
    throws EvaluationException, PropertyNotFoundException;
public void setValue(FacesContext context, Object value)
    throws EvaluationException, PropertyNotFoundException;
public boolean isReadOnly(FacesContext context)
    throws EvaluationException, PropertyNotFoundException;
public Class getType(FacesContext context)
    throws EvaluationException, PropertyNotFoundException;
public Object invoke(FacesContext context, Object params[])
    throws EvaluationException, MethodNotFoundException;
public Class getType(FacesContext context) throws MethodNotFoundException;
public Application getApplication();
public Map<Object,Object> getAttributes();
public ELContext getELContext();
public ExternalContext getExternalContext();
public UIViewRoot getViewRoot();
public void setViewRoot(UIViewRoot root);
public void addMessage(String clientId, FacesMessage message);
public Interator<String> getClientIdsWithMessages();
public Severity getMaximumSeverity();
public Iterator<FacesMessage> getMessages(String clientId);
public Iterator<FacesMessage> getMessages();
public RenderKit getRenderKit();
public ResponseStream getResponseStream();
public void setResponseStream(ResponseStream responseStream);
public ResponseWriter getResponseWriter();
public void setResponseWriter(ResponseWriter responseWriter);
public void enableResponseWriting(boolean enable);
public void renderResponse();
public void responseComplete();
public boolean getRenderResponse();
public boolean getResponseComplete();
public PartialViewContext getPartialViewContext();
public static FacesContext getCurrentInstance();
protected static void setCurrentInstance(FacesContext context);
public ExceptionQueuedEvent getHandledExceptionEvent();
public Iterable<ExceptionQueuedEvent> getHandledExceptionEvents();
public Throwable getRootCause(Throwable t);
public Iterable<ExceptionQueuedEvent> getUnhandledExceptionEvents();
public void handle() throws FacesException;
public boolean isListenerForSource(Object source);
public void processEvent(SystemEvent ExceptionQueuedEvent)
    throws AbortProcessingException;
public FacesMessage();
public FacesMessage(String summary, String detail);
public FacesMessage(Severity severity, String summary, String detail);
public String getDetail();
public void setDetail(String detail);

public Severity getSeverity();
public void setSeverity(Severity severity);

public String getSummary();
public void setSummary(String summary);
public void close() throws IOException;
public void flush() throws IOException;
public void write(char c[]) throws IOException;
public void write(char c[], int off, int len) throws IOException;
public void write(int c) throws IOException;
public void write(String s) throws IOException;
public void write(String s, int off, int len) throws IOException;
public abstract String getContentType();
public abstract String getCharacterEncoding();
public void startCDATA();
public void endCDATA();
public void startDocument() throws IOException;
public void endDocument() throws IOException;
public void startElement(String name,
    UIComponent componentForElement) throws IOException;
public void endElement(String name) throws IOException;
public void writeComment(Object comment) throws IOException;
public void writeAttribute(String name, Object value,
    String componentPropertyName) throws IOException;

public void writeURIAttribute(String name, Object value,
    String componentPropertyName) throws IOException;
public void writeText(Object text, String property) throws IOException;
public void writeText(char text[], int off, int len) throws IOException;
public abstract ResponseWriter cloneWithWriter(Writer writer);
FacesContextFactory factory = (FacesContextFactory)
    FactoryFinder.getFactory(FactoryFinder.FACES_CONTEXT_FACTORY);
public FacesContext getFacesContext(Object context,
    Object request, Object response, Lifecycle lifecycle);
ExceptionHandlerFactory factory = (ExceptionHandlerFactory)
    FactoryFinder.getFactory(FactoryFinder.EXCEPTION_HANDLER_FACTORY);
public ExceptionHandler getExceptionHandler(FacesContext currentContext);
ExternalContextFactory factory = (ExternalContextFactory)
    FactoryFinder.getFactory(FactoryFinder.EXTERNAL_CONTEXT_FACTORY);
public ExternalContext getExternalContext(
Object context, Object request, Object response);
public ActionListener getActionListener();
public void setActionListener(ActionListener listener);
public String getDefaultRenderKitId();
public void setDefaultRenderKitId(String defaultRenderKitId);
public FlowHandler getFlowHandler();
public void setFlowHandler(FlowHandler handler);
public NavigationHandler getNavigationHandler();
public void setNavigationHandler(NavigationHandler handler);
public StateManager getStateManager();
public void setStateManager(StateManager manager);
public ELResolver getELResolver();
public void addELResolver(ELResolver resolver);
public addELContextListener(ELContextListener listener);
public void removeELContextListener(ELContextListener listener);
public ELContextListener[] getELContextListeners();
public ViewHandler getViewHandler();
public void setViewHandler(ViewHandler handler);
public ProjectStage getProjectStage();
public ExpressionFactory getExpressionFactory();
public Object evaluateExpressionGet(FacesContext context,
    String expression, Class expectedType)
public UIComponent createComponent(String componentType);
public UIComponent createComponent(
    String componentType, String rendererType);

public Converter createConverter(Class targetClass);
public Converter createConverter(String converterId);
public Validator createValidator(String validatorId);
public Behavior createBehavior(String behaviorId);
public UIComponent createComponent(ValueExpression componentExpression,
    FacesContext context, String componentType);
public UIComponent createComponent(
    FacesContext context, Resource componentResource);
public void addComponent(String componentType, String componentClass);
public void addConverter(Class targetClass, String converterClass);
public void addConverter(String converterId, String converterClass);
public void addValidator(String validatorId, String validatorClass);
public void addBehavior(String behaviorId, String behaviorClass);
public Iterator<String> getComponentTypes();
public Iterator<String> getConverterIds();
public Iterator<Class> getConverterTypes();
public Iterator<String> getValidatorIds();
public Iterator<String> getBehaviorIds();
public void addDefaultValidatorId(String validatorId);
public Map<String,String> getDefaultValidatorInfo();
public Iterator<Locale> getSupportedLocales();
public void setSupportedLocales(Collection<Locale> newLocales);
public Locale getDefaultLocale();
public void setDefaultLocale(Locale newLocale);
public String getMessageBundle();
public void setMessageBundle(String messageBundle);
public abstract void subscribeToEvent(Class<? extends SystemEvent>
    systemEventClass, SystemEventListener listener)

public abstract void subscribeToEvent(Class<? extends SystemEvent>
    systemEventClass, Class sourceClass, SystemEventListener listener);

public abstract void publishEvent(Class<? extends SystemEvent>
    systemEventClass, SystemEventListenerHolder source);

public void publishEvent(Class<? extends SystemEvent>
    systemEventClass, Class<?> sourceBaseType, Object source)
public abstract void unsubscribeFromEvent(Class<? extends SystemEvent>
    systemEventClass, SystemEventListener listener);

public abstract void unsubscribeFromEvent(Class<? extends SystemEvent>
    systemEventClass, Class sourceClass, SystemEventListener listener);
ApplicationFactory factory = (ApplicationFactory)
    FactoryFinder.getFactory(FactoryFinder.APPLICATION_FACTORY);
public Application getApplication();
public void setApplication(Application application);
public void handleNavigation(FacesContext context,
    String fromAction, String outcome);
public NavigationCase getNavigationCase(FacesContext context,
    String fromAction, String outcome);

public Map<String, Set<NavigationCase>> getNavigationCases();
<navigation-rule>
  <description>
    APPLICATION WIDE NAVIGATION HANDLING
  </description>
  <from-view-id> * </from-view-id>

  <navigation-case>
    <description>
      Assume there is a “Logout” button on every page that
      invokes the logout Action.
    </description>
    <display-name>Generic Logout Button</display-name>
    <from-action>#{userBean.logout}</from-action>
    <to-view-id>/logout.jsp</to-view-id>
  </navigation-case>

  <navigation-case>
    <description>
      Handle a generic error outcome that might be returned
      by any application Action.
    </description>
    <display-name>Generic Error Outcome</display-name>
    <from-outcome>loginRequired</from-outcome>
    <to-view-id>/must-login-first.jsp</to-view-id>
  </navigation-case>

  <navigation-case>
    <description>
      Illustrate paramaters
    </description>
    <from-outcome>redirectPasswordStrength</from-outcome>
    <redirect>
      <view-param>
        <name>userId</name>
        <value>someValue</value>
      </view-param>
      <include-view-params>true</include-view-params>
    </redirect>
  </navigation-case>
</navigation-rule>
<navigation-rule>
  <description>
    LOGIN PAGE NAVIGATION HANDLING
  </description>
  <from-view-id> /login.jsp </from-view-id>

  <navigation-case>
    <description>
      Handle case where login succeeded.
    </description>
    <display-name>Successful Login</display-name>
    <from-action>#{userBean.login}</from-action>
    <from-outcome>success</from-outcome>
    <to-view-id>/home.jsp</to-view-id>
  </navigation-case>

  <navigation-case>
    <description>
      User registration for a new user succeeded.
    </description>
    <display-name>Successful New User Registration</display-name>
    <from-action>#{userBean.register}</from-action>
    <from-outcome>success</from-outcome>
    <to-view-id>/welcome.jsp</to-view-id>
  </navigation-case>

  <navigation-case>
    <description>
      User registration for a new user failed because of a
      duplicate username.
    </description>
    <display-name>Failed New User Registration</display-name>
    <from-action>#{userBean.register}</from-action>
    <from-outcome>duplicateUserName</from-outcome>
    <to-view-id>/try-another-name.jsp</to-view-id>
  </navigation-case>
</navigation-rule>
<navigation-rule>
  <description>
    Assume there is a search form on every page. These navigation
    cases get merged with the application-wide rules above because
    they use the same “from-view-id” pattern. The same thing would
    also happen if “from-view-id” was omitted here, because that is
    equivalent to a matching pattern of “*”.
  </description>
  <from-view-id> * </from-view-id>

  <navigation-case>
    <display-name>Search Form Success</display-name>
    <from-action>#{searchForm.go}</from-action>
    <from-outcome>success</from-outcome>
    <to-view-id>/search-results.jsp</to-view-id>
  </navigation-case>

  <navigation-case>
    <display-name>Search Form Failure</display-name>
    <from-action>#{searchForm.go}</from-action>
    <to-view-id>/search-problem.jsp</to-view-id>
  </navigation-case>
</navigation-rule>
<navigation-rule>
  <description>
    Searching works slightly differently in part of the site.
  </description>
  <from-view-id> /movies/* </from-view-id>

  <navigation-case>
    <display-name>Search Form Success</display-name>
    <from-action>#{searchForm.go}</from-action>
    <from-outcome>success</from-outcome>
    <to-view-id>/movie-search-results.jsp</to-view-id>
  </navigation-case>

  <navigation-case>
    <display-name>Search Form Failure</display-name>
    <from-action>#\{searchForm.go}</from-action>
    <to-view-id>/search-problem.jsp</to-view-id>
  </navigation-case>
</navigation-rule>
public void savePizza();

<navigation-rule>
  <description>
    Pizza topping selection navigation handling
  </description>
  <from-view-id>/selectToppings.xhtml</from-view-id>

  <navigation-case>
    <description>
      Case where pizza is saved but there is additional cost
    </description>
    <display-name>Pizza saved w/ extras</display-name>
    <from-action>#{pizzaBuilder.savePizza}</from-action>
    <if>#{pizzaBuilder.additionalCost}</if>
    <to-view-id>/approveExtras.xhtml</to-view-id>
  </navigation-case>

  <navigation-case>
    <description>
      Case where pizza is saved and additional pizzas are needed
    </description>
    <display-name>Pizza saved, additional pizzas needed</display-name>
    <from-action>#{pizzaBuilder.savePizza}</from-action>
    <if>#{not order.complete}</if>
    <to-view-id>/createPizza.xhtml</to-view-id>
  </navigation-case>

  <navigation-case>
    <description>
      Handle case where pizza is saved and order is complete
    </description>
    <display-name>Pizza complete</display-name>
    <from-action>#{pizzaBuilder.savePizza}</from-action>
    <if>#{order.complete}</if>
    <to-view-id>/cart.xhtml</to-view-id>
  </navigation-case>
</navigation-rule>
public String placeOrder();

<navigation-rule>
  <description>
    Cart navigation handling
  </description>
  <from-view-id>/cart.xhtml</from-view-id>

  <navigation-case>
    <description>
      Handle case where account has one click delivery enabled
    </description>
    <display-name>Place order w/ one-click delivery</display-name>
    <from-action>#{pizzaBuilder.placeOrder}</from-action>
    <if>#{account.oneClickDelivery}</if>
    <to-view-id>/confirmation.xhtml</to-view-id>
  </navigation-case>

  <navigation-case>
    <description>
      Handle case where delivery information is required
    </description>
    <display-name>Place order w/o one-click delivery</display-name>
    <from-action>#{pizzaBuilder.placeOrder}</from-action>
    <if>#{not account.oneClickDelivery}</if>
    <to-view-id>/delivery.xhtml</to-view-id>
  </navigation-case>
</navigation-rule>
basic_faces_flow_call/
  pom.xml
  src/main/webapp/
             index.xhtml
             return1.xhtml
             WEB-INF/beans.xml
             flow-a/
               flow-a.xhtml
               next_a.xhtml
               next_b.xhtml
             flow-b/
               flow-b-flow.xml
               next_a.xhtml
               next_b.xhtml
  src/main/java/com/sun/faces/basic_faces_flow_call/
                                FlowA.java
                                Flow_a_Bean.java
                                Flow_b_Bean.java
public Locale calculateLocale(FacesContext context);
public String calculateRenderKitId(FacesContext context);
public void initView(FacesContext) throws FacesException;
public String calculateCharacterEncoding(FacesContext context);
public String deriveViewId(FacesContext context, String input);
public UIViewRoot createView(FacesContext context, String viewId);
public String getActionURL(FacesContext context, String viewId);
public String getBookmarkableURL(FacesContext context, String viewId,
    Map<String,List<String>> parameters, boolean includeViewParams);
public String getRedirectURL(FacesContext context, String viewId,
    Map<String, List<String>> parameters, boolean includeViewParams);
public String getResourceURL(FacesContext context, String path);
public void renderView(FacesContext context, UIViewRoot viewToRender)
    throws IOException, FacesException;
public UIViewRoot restoreView(FacesContext context,
    String viewId) throws IOException;
public void writeState(FacesContext context) throws IOException;
public ViewDeclarationLanguage getViewDeclarationLanguage();
public Set<String> getProtectedViewsUnmodifiable();
public void addProtectedView(String urlPattern);
public boolean removeProtectedView(String urlPattern)
public ViewDeclarationLanguage getViewDeclarationLanguage(String viewId)
public UIViewRoot createView(FacesContext context, String viewId)
public List<String> calculateResourceLibraryContracts(
    FacesContext context, String viewId)
public void buildView(FacesContext context, UIComponent root)
public BeanInfo getComponentMetadata(
    FacesContext context, Resource componentResource)
public ViewMetadata getViewMetadata(FacesContext context, String viewId)
public UIViewRoot createMetadataView()
public Collection<UIViewParameter> getViewParameters(UIViewRoot root)
public Resource getScriptComponentResource(
    FacesContext context, Resource componentResource)
public void renderView(FacesContext context, String viewId)
public UIViewRoot restoreView(FacesContext context, String viewId)
public Object saveView(FacesContext context);
public void writeState(FacesContext context, Object state)
    throws IOException;
public UIViewRoot restoreView(FacesContext context, String viewId);
public boolean isSavingStateInClient(FacesContext context);
public String getViewState(FacesContext context);
public ResourceHandler getResourceHandler();
public void setResourceHandler(ResourceHandler impl);
/** @deprecated */
public PropertyResolver getPropertyResolver();

/** @deprecated */
public void setPropertyResolver(PropertyResolver resolver);
/** @deprecated */
public VariableResolver getVariableResolver();

/** @deprecated */
public void setVariableResolver(VariableResolver resolver);
/** @deprecated */
public ValueBinding createValueBinding(String ref);
/** @deprecated */
public MethodBinding createMethodBinding(String ref, Class params[]);
/** @deprecated */
public UIComponent createComponent(ValueBinding componentBinding,
    FacesContext context, String componentType);
/** @deprecated */
public void writeState(FacesContext context,
    StateManager.SerializedView state) throws IOException;
/** @deprecated */
protected Object getTreeStructureToSave(FacesContext context);
/** @deprecated */
protected Object getComponentStateToSave(FacesContext context);
/** @deprecated */
public void writeState(FacesContext context,
    StateManager.SerializedView state) throws IOException;
/** @deprecated */
protected Object getTreeStructureToRestore(
    FacesContext context, String viewId);
/** @deprecated */
protected Object getComponentStateToRestore(
    FacesContext context, String viewId);
public Renderer getRenderer(String family, String rendererType);
public ClientBehaviorRenderer getClientBehaviorRenderer(String type);
public void addRenderer(String family,
    String rendererType, Renderer renderer);
public void addClientBehaviorRenderer(String type,
    ClientBehaviorRenderer renderer);
public Iterator<String> getClientBehaviorRendererTypes();
public ResponseWriter createResponseWriter(Writer writer,
    String contentTypeList, String characterEncoding);
public ResponseStream createResponseStream(OuputStream out);
public ResponseStateManager getResponseStateManager();
public Iterator<String> getComponentFamilies();
public Iterator<String> getRendererTypes(String componentFamily);
public void decode(FacesContext context, UIComponent component);
public void encodeBegin(FacesContext context,
    UIComponent component) throws IOException;

public void encodeChildren(FacesContext context,
    UIComponent component) throws IOException;

public void encodeEnd(FacesContext context,
    UIComponent component) throws IOException;
public String convertClientId(FacesContext context, String clientId);
public boolean getRendersChildren();
public Object getConvertedValue(FacesContext context,
    UIComponent component, Object submittedValue) throws ConverterException;
public String getScript(ClientBehaviorContext behaviorContext,
    ClientBehavior behavior);
public void decode(FacesContext context,
    UIComponent component, ClientBehavior behavior);
<render-kit>
  <render-kit-id>HTML_BASIC</render-kit-id>
  <client-behavior-renderer>
    <client-behavior-renderer-type>
      custom.behavior.Greet
    </client-behavior-renderer-type>
    <client-behavior-renderer-class>
      greet.GreetRenderer
    </client-behavior-renderer-class>
  </client-behavior-renderer>
  ...
@FacesClientBehaviorRenderer(value=”Hello”)
public class MyRenderer extends ClientBehaviorRenderer {
  ...
}
public Object getState(FacesContext context);
public void writeState(FacesContext context, Object state)
    throws IOException;
public boolean isPostback(FacesContext context);
public String getViewState(FacesContext context);
RenderKitFactory factory = (RenderKitFactory)
    FactoryFinder.getFactory(FactoryFinder.RENDER_KIT_FACTORY);
public RenderKit getRenderKit(FacesContext context, String renderKitId);
public Iterator<String> getRenderKitIds();
public void addRenderKit(String renderKitId, RenderKit renderKit);
<tag>
  <name>inputText</name>
  <tag-class>acme.html.tags.InputTag</tag-class>
  <bodycontent>JSP</bodycontent>

  <attribute>
    <name>id</name>
    <required>false</required>
    <rtexprvalue>true</rtexprvalue>
  </attribute>

  <attribute>
    <name>value</name>
    <required>false</required>
    <deferred-value>
      <type>java.lang.Object</type>
    <deferred-value>
  </attribute>

  <attribute>
    <name>size</name>
    <required>false</required>
    <deferred-value>
      <type>java.lang.Integer</type>
    <deferred-value>
  </attribute>
  ...
</tag>
<%@ taglib uri=”http://java.sun.com/jsf/core” prefix=”f” %>
<%@ taglib uri=”http://java.sun.com/jsf/html” prefix=”h” %>
<h:inputText id=”username” value=”#{logonBean.username}”/>
<h:form id=”logonForm”>
  <h:panelGrid columns=”2”>
    <h:outputLabel for=”username”>
      <h:outputText value=”Username:”/>
    </h:outputLabel>
    <h:inputText id=”username” value=”#{logonBean.username}”/>
    <h:outputLabel for=”password”>
      <h:outputText value=”Password:”/>
    </h:outputLabel>
    <h:inputSecret id=”password” value=”#{logonBean.password}”/>
    <h:commandButton id=”submitButton” type=”SUBMIT”
        action=”#{logonBean.logon}”/>
    <h:commandButton id=”resetButton” type=”RESET”/>
  </h:panelGrid>
</h:form>
<h:inputText id=”username” value=”#{logonBean.username}”>
  <f:validateLength minimum=”6”/>
</h:inputText>
<h:inputText id=”maxUsers”>
  <f:convertNumber integerOnly=”true”/>
  <f:valueChangeListener type="custom.MyValueChangeListener"/>
</h:inputText>
<h:commandButton label="Login">
  <f:actionListener type="custom.MyActionListener"/>
</h:commandButton>
<h:dataTable ...>
  <f:facet name=”header”>
    <h:outputText value=”Customer List”/>
  </f:facet>
  <h:column>
    <f:facet name=”header”>
      <h:outputText value=”Account Id”/>
    </f:facet>
    <h:outputText id=”accountId” value= ”#{customer.accountId}”/>
  </h:column>
  ...
</h:dataTable>
public void setTitle(jakarta.el.ValueExpression title) {
  this.title = title;
}

protected void setProperties(UIComponent component) throws JspException {
  super.setProperties(component);
  if (title != null) {
    try {
      component.setValueExpression(“title”, title);
    } catch (ELException e) {
      throw new JspException(e);
    }
  ...
}
public void setValueChangeListener(jakarta.el.MethodExpression me) {
  valueChangeListener = me;
}

protected void setProperties(UIComponent component) {
  super.setProperties(component);
  MethodExpressionValueChangeListener listener =
      new MethodExpressionValueChangeListener(valueChangeListener);
  input.addValueChangeListener(listener);
  ...
}
public void setRows(jakarta.el.ValueExpression rows) {
  this.rows = rows;
}

protected void setProperties(UIComponent component) {
  super.setProperties(component);
  if (rows != null) {
    try {
      component.setValueExpression(“rows”, rows);
    } catch (ELException e) {
      throw new JspException(e);
    }
  }
  ...
}
“main.jsp”
<f:view>
  <c:import url=”foo.jsp”/>
  <c:import url=”bar.jsp”/>
</f:view>

“foo.jsp”
<f:subview id=”aaa”>
  ... components and other content ...
</f:subview>

“bar.jsp”
<f:subview id=”bbb”>
  ... components and other content ...
</f:subview>
“main.jsp”
<f:view>
  <f:subview id=”aaa”>
    <c:import url=”foo.jsp”/>
  </f:subview>
  <f:subview id=”bbb”>
    <c:import url=”bar.jsp”/>
  </f:subview>
</f:view>

“foo.jsp”
... components and other content ...

“bar.jsp”
... components and other content ...
“main.jsp”
<f:view>
  <f:subview id=”aaa”>
    <c:import url=”foo.jsp”/>
  </f:subview>
  <f:subview id=”bbb”>
    <c:import url=”foo.jsp”/>
  </f:subview>
</f:view>

“foo.jsp”
... components and other content ...
siteLayout/
  topNav_template.xhtml
  leftNav_foo.xhtml
  styles.css
  script.js
  background.png
<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:ui="http://java.sun.com/jsf/facelets"
      xmlns:h="http://java.sun.com/jsf/html">
  <h:head>
    <h:outputStylesheet id="default" name="default.css" />
    <h:outputStylesheet name="cssLayout.css" />
    <title><ui:insert name="title"></ui:insert></title>
  </h:head>
  <h:body>
    <div id="top" class="top">
      <p>Top Navigation Menu</p>
      <ui:insert name="nav">Nav content</ui:insert>
    </div>
    <div id="content" class="center_content">
      <ui:insert name="content">Content</ui:insert>
    </div>
  </h:body>
</html>
useContract/
  pom.xml
  src/main/webapp/
             /WEB-INF/lib/siteLayout.jar
             index.xhtml
             page2.xhtml
<!DOCTYPE HTML>
<html xmlns=”http://www.w3.org/1999/xhtml”
      xmlns:ui=”http://java.sun.com/jsf/facelets”
      xmlns:h=”http://java.sun.com/jsf/html”>
  <body>
    <ui:composition template=”/topNav_template.xhtml”>
      <ui:define name=”title”>#{msgs.contactsWindowTitle}</ui:define>
      <ui:define name=”content”>
        <h:commandButton value=”next” action=”page2” />
      </ui:define>
      <ui:define name=”nav”>#{msgs.contactsNavMessage}</ui:define>
    </ui:composition>
  </body>
</html>
<!DOCTYPE HTML>
<html xmlns=”http://www.w3.org/1999/xhtml”
      xmlns:ui=”http://java.sun.com/jsf/facelets”
      xmlns:h=”http://java.sun.com/jsf/html”>
  <body>
    <ui:composition template=”/leftNav_foo.xhtml”>
      <ui:define name=”title”>Hard coded title</ui:define>
      <ui:define name=”content”>
        <h:commandButton value=”back” action=”index” />
      </ui:define>
      <ui:define name=”nav”>Hard coded nav</ui:define>
    </ui:composition>
  </body>
</html>
    <h:inputText value=”#{user.name}”>
      <f:passThroughAttribute name=”data-sermon” value=”#{pastor.message}” />
    </h:inputText>
    <h:inputText value=”#{user.name}”>
      <f:passThroughAttributes value=”#{service.nameValuePairs}” />
    </h:inputText>
    <html xmlns:p=”http://java.sun.com/jsf/passthrough”
          xmlns:h=”http://java.sun.com/jsf/html”>
      <h:inputText p:foo=”{bar.baz}” value=”#{user.name}” />
    </html>
<!DOCTYPE HTML>
<html xmlns=”http://www.w3.org/1999/xhtml”
      xmlns:jsf=”http://java.sun.com/jsf”>
  <body>
    <input type=”number” pattern=”[0-9]*” jsf:value=”#{my.age}” />
  </body>
</html>
<!DOCTYPE HTML>
<html xmlns=”http://www.w3.org/1999/xhtml”
      xmlns:jsf=”http://java.sun.com/jsf”>
  <body>
    <meter jsf:id="meter2" min="#{bean.min}" max="#{bean.max}" value="350">
      350 degrees
    </meter>
  </body>
</html>
public void buildView(FacesContext context, UIViewRoot root)
    throws IOException
<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:prefix="namespace_uri">
<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:h="http://java.sun.com/jsf/html">
  <math xmlns="http://www.w3.org/1998/Math/MathML">
    <msup>
      <msqrt>
        <mrow>
          <mi>a</mi>
          <mo>+</mo>

          <mi>b</mi>
        </mrow>
      </msqrt>
    <mn>27</mn>
  </msup>
</math>
<html xmlns="http://www.w3.org/1999/xhtml">
  <math xmlns="http://www.w3.org/1998/Math/MathML">
    <msup>
      <msqrt>
        <mrow>
          <mi>a</mi>
          <mo>+</mo>

          <mi>b</mi>
        </mrow>
      </msqrt>
    <mn>27</mn>
  </msup>
</math>
<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:ez="http://java.sun.com/jsf/composite/ezcomp">
<h:commandButton ..>
  <f:ajax event=”valueChange”/>
</h:commandButton id=”button1” ...>
<f:ajax>
  <h:panelGrid>
    <h:inputText id=”text1”/>
    <h:commandButton id=”button1”/>
  </h:panelGrid>
</f:ajax>
<f:ajax event=”click”>
  <h:panelGrid id=”grid1”>
    <h:inputText id=”text1”/>
    <h:commandButton id=”button1”>
      <f:ajax event=”mouseover”/>
    </h:commandButton>
  </h:panelGrid>
</f:ajax>
<f:ajax>
  <h:commandButton id=”button1”>
    <f:ajax/>
  </h:commandButton>
</f:ajax>
<f:ajax event=”click”>
  <h:inputText id=”text1”>
    <f:ajax event=”click”/>
  </h:inputText>
</f:ajax>
<f:ajax event=”action”>
  <h:commandButton id=”button1”>
    <b:greet event=”action”/>
  </h:commandButton>
</f:ajax>
<f:ajax>
  <h:form>
    <h:commandButton id=”button1” ...>
    <h:inputText id=”text1” ..>
  </h:form>
</f:ajax>
<f:ajax event=”valueChange”>
  <h:form>
    <h:commandButton id=”button1” ...>
    <h:inputText id=”text1” ..>
  </h:form>
</f:ajax>
<f:ajax event=”action”>
  <h:form>
    <h:commandButton id=”button1” ...>
    <h:inputText id=”text1” ..>
  </h:form>
</f:ajax>
<f:ajax event=”action” execute=”reset”>
  <h:form>
    <h:commandButton id=”button1” ...>
      <f:ajax execute=”cancel”/>
    </h:commandButton>
    <h:inputText id=”text1” ..>
  </h:form>
</f:ajax>
<h:inputText value=”#{model.property}”>
  <f:validateBean validationGroups=
      "jakarta.validation.groups.Default,app.validation.groups.Order"/>
</h:inputText>
<h:form>
  <f:validateBean>
    <h:inputText value=”#{model.property}” />
    <h:selectOneRadio value=”#{model.radioProperty}” >
      ...
    </h:selectOneRadio>
    <!-- other input components here -->
  </f:validateBean>
</h:form>
<f:validateRequired/>
<!-- one or more components validated by <f:validateBean />
     precede this tag in the tree, with each one using the same
     validationGroups value and referencing properties on the same
     model object -->
<f:validateWholeBean value="#{model}"
    validationGroups="fully.qualified.class.Name" />
<context-param>
  <param-name>jakarta.faces.ENABLE_WEBSOCKET_ENDPOINT</param-name>
  <param-value>true</param-value>
</context-param>
<context-param>
  <param-name>jakarta.faces.WEBSOCKET_ENDPOINT_PORT</param-name>
  <param-value>8000</param-value>
</context-param>
<f:websocket channel="someChannel"
    onmessage="someWebsocketListener" />

function someWebsocketListener(message, channel, event) {
    console.log(message);
}
<f:websocket channel="someChannel"
    onmessage="function(m){console.log(m);}" />
@Inject @Push
private PushContext someChannel;

public void sendMessage(Object message) {
  someChannel.send(message);
}
@Inject @Push(channel="foo")
private PushContext bar;
<f:websocket channel="someChannel" scope="session" ... />
<f:websocket channel="someChannel" scope="view" ... />
<f:websocket channel="someChannel" user="#{request.remoteUser}" ... />
<f:websocket channel="someChannel" user="#{someLoggedInUser.id}" ... />
@Inject @Push
private PushContext someChannel;

public void sendMessage(Object message, User recipientUser) {
  Long recipientUserId = recipientUser.getId();
  someChannel.send(message, recipientUserId);
}
public void sendMessage(Object message, Group recipientGroup) {
  Collection<Long> recipientUserIds = recipientGroup.getUserIds();
  someChannel.send(message, recipientUserIds);
}
<f:websocket ... connected="#{bean.pushable}" />
<h:commandButton ... onclick="jsf.push.open('foo')">
  <f:ajax ... />
</h:commandButton>
<f:websocket id="foo" channel="bar" scope="view" ... connected="false" />
function someWebsocketListener(message) {
    // ...
    jsf.push.close('foo');
}
<f:websocket ... onopen="websocketOpenListener" />

function websocketOpenListener(channel) {
    // ...
}
<f:websocket ... onclose="websocketCloseListener" />

function websocketCloseListener(code, channel, event) {
    if (code == -1) {
        // Websockets not supported by client.
    } else if (code == 1000) {
        // Normal close (as result of expired session or view).
    } else {
        // Abnormal close reason (as result of an error).
    }
}
@ApplicationScoped
public class WebsocketObserver {

public void onOpen(@Observes @Opened WebsocketEvent event) {
  String channel = event.getChannel();
  // Returns <f:websocket channel>.
  Long userId = event.getUser();
  // Returns <f:websocket user>, if any.
  // ...
}

public void onClose(@Observes @Closed WebsocketEvent event) {
  String channel = event.getChannel();
  // Returns <f:websocket channel>.
  Long userId = event.getUser();
  // Returns <f:websocket user>, if any.
  CloseCode code = event.getCloseCode();
  // Returns close reason code.
  // ...
}
<security-constraint>
  <web-resource-collection>
    <web-resource-name>
      Restrict access to role USER.
    </web-resource-name>
    <url-pattern>/user/*</url-pattern>
  </web-resource-collection>
  <auth-constraint>
    <role-name>USER</role-name>
  </auth-constraint>
</security-constraint>
<security-constraint>
  <web-resource-collection>
    <web-resource-name>
      Restrict access to role USER.
    </web-resource-name>
    <url-pattern>/user/*</url-pattern>
    <url-pattern>/jakarta.faces.push/foo</url-pattern>
  </web-resource-collection>
  <auth-constraint>
    <role-name>USER</role-name>
  </auth-constraint>
</security-constraint>
<h:panelGroup id="foo">
  ... (some complex UI here) ...
</h:panelGroup>

<h:form>
  <f:websocket channel="someChannel" scope="view">
    <f:ajax event="someEvent" listener="#{bean.pushed}" render=":foo" />
  </f:websocket>
</h:form>
someChannel.send("someEvent");
<h:panelGroup id="foo">
  ... (some complex UI here) ...
</h:panelGroup>
<f:websocket channel="someChannel" scope="view" onmessage="pushed" />
<h:form>
  <h:commandScript name="pushed" action="#{bean.pushed}" render=":foo" />
</h:form>
public static Object getFactory(String factoryName);
public void init(ServletConfig config) throws ServletException;
public void destroy();
public void service(ServletRequest request, ServletResponse response)
    throws IOException, ServletException;
<resource-library-contracts>
  <contract-mapping>
    <url-pattern>*</url-pattern>
    <contracts>”all available contracts”</contracts>
  </contract-mapping>
</resource-library-contracts>
<faces-config
    xmlns="http://xmlns.jcp.org/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
        http://xmlns.jcp.org/xml/ns/javaee/web-facesconfig_3_0.xsd"
    version="2.3">
<faces-config
    xmlns="http://xmlns.jcp.org/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
        http://xmlns.jcp.org/xml/ns/javaee/web-facesconfig_2_3.xsd"
    version="2.3">
<faces-config
    xmlns="http://xmlns.jcp.org/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
        http://xmlns.jcp.org/xml/ns/javaee/web-facesconfig_2_2.xsd"
    version="2.2">
<faces-config
    xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
        http://java.sun.com/xml/ns/javaee/web-facesconfig_2_1.xsd"
    version="2.1">
<faces-config
    xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
        http://java.sun.com/xml/ns/javaee/web-facesconfig_2_0.xsd"
    version="2.0">
<faces-config version="1.2"
    xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
        http://java.sun.com/xml/ns/javaee/web-facesconfig_1_2.xsd">
<!DOCTYPE faces-config PUBLIC
    “-//Sun Microsystems, Inc.//DTD JavaServer Faces Config 1.1//EN”
    “http://java.sun.com/dtd/web-facesconfig_1_1.dtd”>
<!DOCTYPE faces-config PUBLIC
    “-//Sun Microsystems, Inc.//DTD JavaServer Faces Config 1.0//EN”
    “http://java.sun.com/dtd/web-facesconfig_1_0.dtd”>
<!DOCTYPE faces-config PUBLIC
    “-//Sun Microsystems, Inc.//DTD JavaServer Faces Config 1.1//EN”
    “http://java.sun.com/dtd/web-facesconfig_1_1.dtd”>
public class MyViewHandler extends ViewHandler {

  public MyViewHandler() { }

  public MyViewHandler(ViewHandler handler) {
    super();
    oldViewHandler = handler;
  }

  private ViewHandler oldViewHandler = null;

  // Delegate the renderView() method to the old handler
  public void renderView(FacesContext context, UIViewRoot view)
      throws IOException, FacesException {
    oldViewHandler.renderView(context, view);
  }

  // Delegate other methods in the same manner

  // Overridden version of calculateLocale()
  public Locale calculateLocale(FacesContext context) {
    Locale locale = ... // Custom calculation
    return locale;
  }
}
<application>
  <view-handler>com.foo.NewViewHandler</view-handler>
  <state-manager>com.foo.NewStateManager</state-manager>
</application>
package com.foo;

import jakarta.faces.application.ViewHandler;
import jakarta.faces.application.ViewHandlerWrapper;

public class NewViewHandler extends ViewHandlerWrapper {
  private ViewHandler oldViewHandler = null;

  public NewViewHandler(ViewHandler oldViewHandler) {
    this.oldViewHandler = oldViewHandler;
  }

  public ViewHandler getWrapped() {
    return oldViewHandler;
  }
}

package com.foo;

import jakarta.faces.application.StateManager;
import jakarta.faces.application.StateManagerWrapper;

public class NewStateManager extends StateManagerWrapper {
  private StateManager oldStateManager = null;

  public NewStateManager(StateManager oldStateManager) {
    this.oldStateManager = oldStateManager;
  }

  public StateManager getWrapped() {
    return oldStateManager;
  }
}
<faces-config>
  <name>A</name>
  <ordering><after><name>B</name></after></ordering>
  <application>
    <view-handler>com.a.ViewHandlerImpl</view-handler>
  </application>
  <lifecycle>
    <phase-listener>com.a.PhaseListenerImpl</phase-listener>
  </lifecycle>
</faces-config>
<faces-config>
  <name>B</name>
  <application>
    <view-handler>com.b.ViewHandlerImpl</view-handler>
  </application>
  <lifecycle>
    <phase-listener>com.b.PhaseListenerImpl</phase-listener>
  </lifecycle>
</faces-config>
<faces-config>
  <name>C</name>
  <ordering><before><others/></before></ordering>
  <application>
    <view-handler>com.c.ViewHandlerImpl</view-handler>
  </application>
  <lifecycle>
    <phase-listener>com.c.PhaseListenerImpl</phase-listener>
  </lifecycle>
</faces-config>
<faces-config>
  <name>my</name>
  <application>
    <view-handler>com.my.ViewHandlerImpl</view-handler>
  </application>
  <lifecycle>
    <phase-listener>com.my.PhaseListenerImpl</phase-listener>
  </lifecycle>
</faces-config>
Implementation Specific Config
C
B
A
my
<faces-config>
  <name>my</name>
  <absolute-ordering>
    <name>C</name>
    <name>A</name>
  </absolute-ordering>
  <application>
    <view-handler>com.my.ViewHandlerImpl</view-handler>
  </application>
  <lifecycle>
    <phase-listener>com.my.PhaseListenerImpl</phase-listener>
  </lifecycle>
</faces-config>
Document A - <after><others/><name>C</name></after>
Document B - <before><others/></before>
Document C - <after><others/></after>
Document D - no ordering
Document E - no ordering
Document F - <before><others/><name>B</name></before>
Document <no id> - <after><others/></after>
                   <before><name>C</name></before>
Document B - <before><others/></before>
Document C - no ordering
Document D - <after><others/></after>
Document E - <before><others/></before>
Document F - no ordering
Document A - <after><name>B</name></after>
Document B - no ordering
Document C - <before><others/></before>
Doucment D - no ordering
<?xml version=”1.0”?>

<faces-config version="1.2"
    xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
        http://java.sun.com/xml/ns/javaee/web-facesconfig_1_2.xsd">

  <!-- Define our custom component -->
  <component>
    <description>
      A custom component for rendering
      user-selectable dates in various formats.
    </description>
    <display-name>My Custom Date</display-name>
    <component-type>Date</component-type>
    <component-class>
      com.example.components.DateComponent
    </component-class>
  </component>

  <!-- Define two renderers that know how to deal with dates -->
  <render-kit>
    <!-- No render-kit-id, so add them to default RenderKit -->
    <renderer>
      <display-name>Calendar Widget</display-name>
      <component-family>MyComponent</component-family>
      <renderer-type>MyCalendar</renderer-type>
      <renderer-class>
        com.example.renderers.MyCalendarRenderer
      </renderer-class>
    </renderer>

    <renderer>
      <display-name>Month/Day/Year</display-name>
      <renderer-type>MonthDayYear</renderer-type>
      <renderer-class>
        com.example.renderers.MonthDayYearRenderer
      </renderer-class>
    </renderer>
  </render-kit>
</faces-config>
public void execute(FacesContext context) throws FacesException;
public void render(FacesContext context) throws FacesException;
public void addPhaseListener(PhaseListener listener);
public void removePhaseListener(PhaseListener listener);
public PhaseEvent(FacesContext context,
    PhaseId phaseId, Lifecycle lifecycle);
public FacesContext getFacesContext();
public PhaseId getPhaseId();
public PhaseId getPhaseId();
public void beforePhase(PhaseEvent event);
public void afterPhase(PhaseEvent event);
FacesContext facesContext = FacesContext.getCurrentInstance();
Application app = facesContext.getApplication();
ExceptionHandler handler = facesContext.getExceptionHandler();

try {
  callBeforePhaseListeners();
} catch (Throwable thrownException) {
  jakarta.faces.event.ExceptionEventContext eventContext =
      new ExceptionEventContext(
          thrownException, null, facesContext.getPhaseId());
  eventContext.getAttributes()
      .put(EventContext.IN_BEFORE_PHASE, Boolean.TRUE);
  app.publishEvent(ExceptionQueuedEvent.class, eventContext);
}

try {
  doCurrentPhase();
} catch (Throwable thrownException) {
  jakarta.faces.event.ExceptionEventContext eventContext =
      new ExceptionEventContext(
          thrownException, null, facesContext.getPhaseId());
  app.publishEvent(ExceptionQueuedEvent.class, eventContext);
} finally {
  try {
    callAfterPhaseListeners();
  } catch (Throwable thrownException) {
    jakarta.faces.event.ExceptionEventContext eventContext =
        new ExceptionEventContext(
            thrownException, null, facesContext.getPhaseId());
    eventContext.getAttributes()
        .put(EventContext.IN_AFTER_PHASE, Boolean.TRUE);
    app.publishEvent(ExceptionQueuedEvent.class, eventContext);
  }
  handler.handle();
}
LifecycleFactory factory = (LifecycleFactory)
    FactoryFinder.getFactory(FactoryFinder.LIFECYCLE_FACTORY);
public void addLifecycle(String lifecycleId, Lifecycle lifecycle);
public Lifecycle getLifecycle(String lifecycleId);
public Iterator<String> getLifecycleIds();
@ResourceDependency (name="jsf.js", library="jakarta.faces", target="head")
public class MyComponent extends UIOutput...
Resource resource = context.getApplication().getResourceHandler()
    .createResource(“jsf.js”, “jakarta.faces”);
...
writer.startElement("script", component);
writer.writeAttribute("type", "text/javascript", "type");
writer.writeAttribute("src",
    ((resource != null)? resource.getRequestPath(): "RES_NOT_FOUND"), ”src”);
writer.endElement(“script”);
public class MyComponent extends UIOutput {
...
  getAttributes().put(“target”, “head”);
...
}
public void processEvent(SystemEvent event)
    throws AbortProcessingException {
  UIComponent component = (UIComponent) event.getSource();
  FacesContext context = FacesContext.getCurrentInstance();
  if (component.getAttributes().get("target") != null) {
    context.getViewRoot().addComponentResource(context, component);
  }
}
<f:view contentType=”text/html”/>
  <h:head>
    <meta...
    <title...
  </h:head>
  <h:body>
    ...
    <h:outputScript name=”jsf.js” library=”jakarta.faces” target=”body”/>
    ...
  </h:body>
  ...
if (jsf == null || typeof jsf == "undefined") {
    var jsf = new Object();
}
if (jsf.ajax == null || typeof jsf.ajax == "undefined") {
    jsf["ajax"] = new Object();
}
<partial-response id="j_id1">
  <error>
    <error-name>...</error-name>
    <error-message>...</error-message>
  </error>
</partial-response>
jsf.getViewState(FORM_ELEMENT)
var viewState = jsf.getViewState(form);
jsf.ajax.request(source, |event|, { |OPTIONS| });
<ANY_HTML_OR_FACES_ELEMENT
    on|EVENT|="jsf.ajax.request(source, event, { |OPTIONS| });" />
<h:commandButton id=”button1” value=”submit”
    onclick="jsf.ajax.request(this,event);" />

is the same as:

<h:commandButton id=”button1” value=”submit”>
    onclick="jsf.ajax.request(this, event,
        {execute:’@this’, render:’@this’});" />
<h:commandButton id=”button1” value=”submit”
    onclick="jsf.ajax.request(this,event, {execute:’@this’});" />

is the same as:

<h:commandButton id=”button1” value=”submit”>
    onclick="jsf.ajax.request(this,event, {execute:’button1’});" />
<h:commandbutton id="submit" value="submit"
    onclick="jsf.ajax.request(this, event,
        {execute:'submit',render:'outtext'}); return false;" />
jsf.ajax.response(request, context);
jsf.ajax.addOnEvent(callback);
function statusUpdate(data) {
  // do something with data.status or other parts of data payload
}
...
jsf.ajax.addOnEvent(statusUpdate);
<f:ajax ... onevent="statusUpdate" />
jsf.ajax.addOnError(callback);
jsf.ajax.addOnError(handleError);
...
var handleError = function handleError(data) {
  ... do something with “data payload” ...
}
jsf.getProjectStage();
var projectStage = jakarta.faces.Ajax.getProjectStage();
if (projectStage == “Production”) {
  .... throw exception
} else if (projectStage == “Development”) {
  .... send an alert for debugging
}
jsf.util.chain(source, event, |<script>, <script>,...| )
<xsd:complexType name ="faces-config-extensionType">
  <xsd:annotation>
    <xsd:documentation>
      Extension element for faces-config. It may contain
      implementation specific content.
    </xsd:documentation>
  </xsd:annotation>
  <xsd:sequence>
    <xsd:any namespace="##any" processContents="lax"
        minOccurs="0" maxOccurs="unbounded" />
  </xsd:sequence>
  <xsd:attribute name="id" type="xsd:ID"/>
</xsd:complexType>
<!ELEMENT facelets-processing (file-extension, process-as) >
<!ELEMENT file-extension ANY>
<!ELEMENT process-as ANY>
<?xml version='1.0' encoding='UTF-8'?>
<faces-config
    xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
        http://java.sun.com/xml/ns/javaee/web-facesconfig_2_1.xsd"
    version="2.1">
  <faces-config-extension>
    <facelets-processing>
      <file-extension>.jspx</file-extension>
      <process-as>jspx</process-as>
    </facelets-processing>
    <facelets-processing>
      <file-extension>.view.xml</file-extension>
      <process-as>xml</process-as>
    </facelets-processing>
  </faces-config-extension>
</faces-config>
<context-param>
  <param-name>jakarta.faces.FACELETS_VIEW_MAPPINGS</param-name>
  <param-value>*.xhtml;*.view.xml;*.jspx</param-value>
</context-param>
<context-param>
  <param-name>jakarta.faces.DEFAULT_SUFFIX</param-name>
  <param-value>.xhtml .view.xml .jsp .jspx</param-value>
</context-param>
<!DOCTYPE facelet-taglib PUBLIC
    "-//Sun Microsystems, Inc.//DTD Facelet Taglib 1.0//EN"
    "http://java.sun.com/dtd/facelet-taglib_1_0.dtd">
<!ELEMENT facelet-taglib (library-class|(namespace,(tag|function)+))>
<!ATTLIST facelet-taglib xmlns CDATA #FIXED "http://java.sun.com/JSF/Facelet">
<!ELEMENT namespace (#PCDATA)>
<!ELEMENT library-class (#PCDATA)>
<!ELEMENT tag (tag-name,(handler-class|component|converter|validator|source))>
<!ELEMENT tag-name (#PCDATA)>
<!ELEMENT handler-class (#PCDATA)>
<!ELEMENT component (component-type,renderer-type?,handler-class?)>
<!ELEMENT component-type (#PCDATA)>
<!ELEMENT renderer-type (#PCDATA)>
<!ELEMENT converter (converter-id, handler-class?)>
<!ELEMENT converter-id (#PCDATA)>
<!ELEMENT validator (validator-id, handler-class?)>
<!ELEMENT validator-id (#PCDATA)>
<!ELEMENT source (#PCDATA)>
<!ELEMENT function (function-name,function-class,function-signature)>
<!ELEMENT function-name (#PCDATA)>
<!ELEMENT function-class (#PCDATA)>
<!ELEMENT function-signature (#PCDATA)>
<xsd:schema
    targetNamespace="http://java.sun.com/xml/ns/javaee"
    xmlns:javaee="http://java.sun.com/xml/ns/javaee"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xml="http://www.w3.org/XML/1998/namespace"
    elementFormDefault="qualified"
    attributeFormDefault="unqualified"
    version="2.0">

  <xsd:annotation>
    <xsd:documentation>
      $Id: web-facesuicomponent_2_0.xsd,v 1.1.8.2 2008/03/20 21:12:50 edburns Exp $
    </xsd:documentation>
  </xsd:annotation>

  <xsd:annotation>
    <xsd:documentation>
      Copyright 2007 Sun Microsystems, Inc.,
      901 San Antonio Road,
      Palo Alto, California 94303, U.S.A.
      All rights reserved.

      Sun Microsystems, Inc. has intellectual property
      rights relating to technology described in this document. In
      particular, and without limitation, these intellectual
      property rights may include one or more of the U.S. patents
      listed at http://www.sun.com/patents and one or more
      additional patents or pending patent applications in the
      U.S. and other countries.

      This document and the technology which it describes are
      distributed under licenses restricting their use, copying,
      distribution, and decompilation. No part of this document
      may be reproduced in any form by any means without prior
      written authorization of Sun and its licensors, if any.

      Third-party software, including font technology, is
      copyrighted and licensed from Sun suppliers.

      Sun, Sun Microsystems, the Sun logo, Solaris, Java, Java EE,
      JavaServer Pages, Enterprise JavaBeans and the Java Coffee
      Cup logo are trademarks or registered trademarks of Sun
      Microsystems, Inc. in the U.S. and other countries.

      Federal Acquisitions: Commercial Software - Government Users
      Subject to Standard License Terms and Conditions.

    </xsd:documentation>
  </xsd:annotation>

  <xsd:annotation>
    <xsd:documentation>
      <![CDATA[
      The XML Schema for a Jakarta Server Faces UIComponent (Version 2.0).

      The elements in this schema may be used in an XHTML page for
      a composite component, by pulling in the composite namespace:

<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:composite="http://java.sun.com/jsf/composite">

      <composite:interface>
        <composite:attribute name="foo" default="bar" />
      </composite:/interface>
      <!-- the rest omitted -->
</html>

      The elements in this schema may also be used in a facelet taglibrary
      file in the same manner:

<facelet-taglib xmlns="http://java.sun.com/xml/ns/javaee"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                xmlns:composite="http://java.sun.com/jsf/composite"
                xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
                http://java.sun.com/xml/ns/javaee/web-facelettaglibary_2_0.xsd"
                version="2.0">
  <namespace>http://domain.com/test_schema</namespace>
  <tag>
    <tag-name>testSchema</tag-name>
    <component>
      <component-type>jakarta.faces.Input</component-type>
      <renderer-type>jakarta.faces.Text</renderer-type>
      <handler-class>com.sun.faces.facelets.tag.jsf.ComponentHandler</handler-class>
      <component-extension>
        <composite:attribute name="foo" default="bar" />
      </component-extension>
    </component>
  </tag>
</facelet-taglib>

      The instance documents may indicate the published
      version of the schema using xsi:schemaLocation attribute
      for javaee namespace with the following location:

      http://java.sun.com/xml/ns/javaee/web-facesuicomponent_2_0.xsd

      ]]>

    </xsd:documentation>
  </xsd:annotation>

  <xsd:include schemaLocation="javaee_5.xsd"/>

  <!-- **************************************************** -->

  <xsd:element name = "attribute" type="javaee:uicomponent-attributeType">
  </xsd:element>

  <!-- **************************************************** -->

  <xsd:complexType name="uicomponent-attributeType">
    <xsd:annotation>
      <xsd:documentation>

        The "attribute" element declares an attribute of this
        ui component.

      </xsd:documentation>
    </xsd:annotation>

    <xsd:choice minOccurs="0" maxOccurs="unbounded">
      <xsd:element name="attribute"
                   type="javaee:uicomponent-attributeType"/>
    </xsd:choice>

    <xsd:attribute name="name"
                   type="xsd:string"
                   use="required"/>

    <xsd:attribute name="displayName"
                   type="xsd:string"
                   use="optional"/>

    <xsd:attribute name="shortDescription"
                   type="xsd:string"
                   use="optional"/>

    <xsd:attribute name="default"
                   type="xsd:string"
                   use="optional"/>

    <xsd:attribute name="method-signature"
                   type="xsd:string"
                   use="optional">
      <xsd:annotation>
        <xsd:documentation>
          <![CDATA[
            Provides the signature of the Java method. The syntax of
            the method-signature element is as follows (taken from
            function-signature in web-jsptaglibrary_2_1.xsd):

            MethodSignature ::= ReturnType S MethodName S?
                               '(' S? Parameters? S? ')'

            ReturnType ::= Type

            MethodName ::= Identifier

            Parameters ::= Parameter
                         | ( Parameter S? ',' S? Parameters )

            Parameter ::= Type
                Where:

                   * Type is a basic type or a fully qualified
                     Java class name (including package name),
                     as per the 'Type' production in the Java
                     Language Specification, Second Edition,
                     Chapter 18.

                   * Identifier is a Java identifier, as per
                     the 'Identifier' production in the Java
                     Language Specification, Second
                     Edition, Chapter 18.

                   Example:

                     java.lang.String nickName( java.lang.String, int )

          ]]>
        </xsd:documentation>
      </xsd:annotation>
    </xsd:attribute>

    <xsd:attribute name="applyTo"
                   type="xsd:string"
                   use="optional"/>

    <xsd:attribute name="required"
                   type="xsd:boolean"
                   use="optional"/>

    <xsd:attribute name="preferred"
                   type="xsd:boolean"
                   use="optional"/>

    <xsd:attribute name="expert"
                   type="xsd:boolean"
                   use="optional"/>

  </xsd:complexType>

  <!-- **************************************************** -->

</xsd:schema>
<?xml version="1.0" encoding="UTF-8"?>
<facelet-taglib xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
    http://java.sun.com/xml/ns/javaee/web-facelettaglibary_2_2.xsd"
    version="2.2">
  <namespace>test</namespace>
  <tag>
    <tag-name>layout</tag-name>
    <resource-id>myCC/whatever.xhtml</resource-id>
  </tag>
</facelet-taglib>
<html xmlns="http://www.w3.org/1999/xhtml"
    xmlns:h="http://java.sun.com/jsf/html"
    xmlns:f="http://java.sun.com/jsf/core"
    xmlns:ez="http://java.sun.com/jsf/composite/ezcomp">
  <h:head>
    <title>A simple example of EZComp</title>
  </h:head>
  <h:body>
    <h:form>
    </h:form>
  </h:body>
</html>
<f:view xmlns="http://www.w3.org/1999/xhtml"
    xmlns:h="http://java.sun.com/jsf/html"
    xmlns:f="http://java.sun.com/jsf/core"
    xmlns:ez="http://java.sun.com/jsf/composite/ezcomp">
  ...
</f:view>
<h:inputText value="#{myBean.text}">
  <f:event type="beforeRender" listener="#{myBean.beforeTextRender}" />
</h:inputText>
<f:ajax>
  <h:panelGrid>
    <h:inputText id=˝text1˝/>
    <h:commandButton id=˝button1˝/>
  </h:panelGrid>
</f:ajax>
<f:ajax event=˝click˝>
  <h:panelGrid id=˝grid1˝>
    <h:inputText id=˝text1˝/>
    <h:commandButton id=˝button1˝>
      <f:ajax event=˝mouseover˝/>
    </h:commandButton>
  </h:panelGrid>
</f:ajax>
<!DOCTYPE facelet-taglib PUBLIC
    "-//Sun Microsystems, Inc.//DTD Facelet Taglib 1.0//EN"
    "http://java.sun.com/dtd/facelet-taglib_1_0.dtd">

Section	Feature
Implicit Object ELResolver for Facelets and Programmatic Access	Ability for the composite component author to refer to the top level component from a Jakarta Expression Language expression, such as #{cc.children[3]}.
Composite Component Attributes ELResolver	Ability for the composite component author to refer to attributes declared on the composite component tag using EL expressions such as #{cc.attrs.usernameLabel}
Object Factories	Methods called by the VDL page to create a new instance of a top level component for eventual inclusion in the view
Requirements specific to composite components	Requirements of the Facelet implementation relating to Facelets.
Composite Component Tag Library	Tag handlers for the composite tag library

component property	method signature
DEPRECATED action	public String <methodName>();
DEPRECATED actionListener	public void <methodName>(jakarta.faces.event.ActionEvent);
DEPRECATED validator	public void <methodName>(jakarta.faces.context.FacesContext, jakarta.faces.component.UIComponent, java.lang.Object)
DEPRECATED valueChangeListener	public void <methodName>(jakarta.faces.event.ValueChangeEvent);

component listener property	Wrapper class	method signature
actionListener	jakarta.faces.event.MethodExpressionActionListener	public void <methodName>(jakarta.faces.event.ActionEvent);
validator	jakarta.faces.validator.MethodExpressionValidator	public void <methodName>(jakarta.faces.context.FacesContext, jakarta.faces.component.UIComponent, java.lang.Object);
valueChangeListener	jakarta.faces.event.MethodExpressionValueChangeListener	public void <methodName>(jakarta.faces.event.ValueChangeEvent);

ELResolver method	implementation requirements
getValue	If base is non-null, return null. If base is null and property is null, throw PropertyNotFoundException. See ImplicitObjectELResolver for Programmatic Access If base is null and property is a String equal to “facesContext”, call setPropertyResolved(true) on the argument ELContext and return the FacesContext for this request. If base is null and property is a String equal to “view”, call setPropertyResolved(true) on the argument ELContext and return the UIViewRoot for this request by calling facesContext.getUIViewRoot(). This ELResolver must also support the implicit object “resource” as specified in Implicit Object ELResolver for Facelets and Programmatic Access
getType	If base is non-null, return null. If base is null and property is null, throw PropertyNotFoundException. If base is null and property is a String equal to “facesContext” or “view”, call setPropertyResolved(true) and return null; Otherwise, just return null;This ELResolver must also support the implicit object “resuorce” as specified in Implicit Object ELResolver for Facelets and Programmatic Access
setValue	If base is null and property is null, throw PropertyNotFoundException. If base is null and property is a String equal to “facesContext” or “view”, throw jakarta.el.PropertyNotWriteable, since “view” and “facesContext” are read-only. This ELResolver must also support the implicit object “resuorce” as specified in Implicit Object ELResolver for Facelets and Programmatic Access
isReadOnly	If base is non-null, return false. If base is null and property is null, throw PropertyNotFoundException. If base is null and property is a String equal to “facesContext” or “view”, call setPropertyResolved(true) on the argument ELContext and return true. Otherwise return false;This ELResolver must also support the implicit object “resuorce” as specified in Implicit Object ELResolver for Facelets and Programmatic Access
getFeatureDescriptors	If base is non-null, return null. If base is null, return an Iterator containing three java.beans.FeatureDescriptor instances, one for the “view” property, one for the “facesContext” property and one for the “resource” property. It is required that all of the FeatureDescriptor instances in the Iterator set Boolean.TRUE as the value of the ELResolver.RESOLVABLE_AT_DESIGN_TIME attribute. The name and displayName of the FeatureDescriptor must be “view”, “facesContext”, “ or “resource” as appropriate. FacesContext.class, UIViewRoot.class, or ResourceHandler.class must be stored as the value of the ELResolver.TYPE attribute, as approriate. The shortDescription must be a suitable description depending on the implementation. The expert and hidden properties must be false. The preferred property must be true.
getCommonPropertyType	If base is non-null, return null. If base is null and return String.class.

ELResorver method	implementation requirements
getValue	If base is non-null, return null. If base is null and property is null, throw PropertyNotFoundException. If property matches the name of an entry in the request, session, or application scopes, in that order, return null. If base is null, and property matches one of the managed-bean-name declarations in the application configuration resources, instantiate the bean, populate it with properties as described in The Managed Bean Facility, store it in the scope specified by the managed-bean-scope declaration for this this managed-bean, call setPropertyResolved(true) on the argument ELContext, and return the freshly instantiated managed-bean. Otherwise, return null.
getType	If base is null and property is null, throw PropertyNotFoundException. Otherwise return null;
setValue	If base is null and property is null, throw PropertyNotFoundException. Otherwise, if base is null, and property matches one of the managed-bean-name declarations in the application configuration resources, and a managed bean with that managed-bean-name does not yet exist in the specified scope, instantiate the bean, populate it with properties as described in The Managed Bean Facility, store it in the scope specified by the managed-bean-scope declaration for this this managed-bean and return. If the managed bean does exist, take no action and return. In either case (the bean exists or does not exist), the actual setting will happen by virtue of the BeanELResolver. Otherwise take no action and return.
isReadOnly	If base is non-null, return false. If base is null and property is null, throw PropertyNotFoundException. If base is null return false. We never set the propertyResloved property in this method because the set responsibility is taken care of by the ScopedAttributeELResolver.
getFeatureDescriptors	If base is non-null, return null. If base is null, return an Iterator containing java.beans.FeatureDescriptor instances for each managed-bean in the application-configuration resources. It is required that all of the FeatureDescriptor instances in the Iterator set Boolean.TRUE as the value of the ELResolver.RESOLVABLE_AT_DESIGN_TIME attribute. The name and displayName of the FeatureDescriptor must be the managed-bean-name. The actual java Class instance for the managed-bean-class must be stored as the value of the ELResolver.TYPE attribute. The shortDescription of the FeatureDescriptor must be the description of the managaged-bean element, if present, null otherwise. The expert and hidden properties must be false. The preferred property must be true.
getCommonPropertyType	If base is non-null, return null. If base is null, return Object.class.

ELResorver method	implementation requirements
getValue, getType, isReadOnly, setValue	If base or property are null, return null (or false if the method returns boolean). Call setPropertyResolved(true) on the argument ELContext. Get the ELContext from the FacesContext. Get the head of the propertyResolver chain. If base is a List or java language array, coerce the property to an int and call the corresponding method on the head of the property resolver chain that takes an int for property, returning the result (except in the case of setValue()). Otherwise, call the corresponding method on the head of the property resolver chain that takes an Object for property, returning the result (except in the case of setValue()). If an Exception is thrown by calling the above methods on the PropertyResolver chain, catch it, call setPropertyResolved(false) on the argument ELContext, and rethrow the Exception wrapped (snuggly) in a jakarta.el.ELException.
getFeatureDescriptors	return null;
getCommonPropertyType	If base is null, return null. If base is non-null, return Object.class.

ELResolver method	implementation requirements
getValue	If base is non-null, is an instance of UIComponent, is a composite component, and property is non-null and is equal to the string “attrs”, return a Map implementation with the following characteristics. Wrap the attributes map of the composite component and delegate all calls to the composite component attributes map with the following exceptions: get(), put(), and containsKey() are required to be supported. get(): if the result of calling get() on the component attributes map is null, and a default value was declared in the composite component metadata, the value will be a ValueExpression. Evaluate it and return it. Otherwise, simply return the value from the component attributes map. put(): Call getValueExpression() on the component. If this returns non-null, call setValue() on it, passing the value argument as the last argument. Otherwise, simply call through to put on the component attributes map. containsKey(): If the attributes map contains the key, return true. Otherwise, if a default value has been declared for the attribute, return true. Otherwise, return false. The Map implementation must also implement the interface jakarta.faces.el.CompositeComponentExpressionHolder. Otherwise, take no action.
getType	If the base argument to getType() is not an instance of the composite component attributes map or the property argument to getType() is not an instance of java.lang.String, return null. Otherwise, check the top level component’s ValueExpression collection for an expression under the name given by the property argument to getType(). If the expression exists, call getType() on the expression. If the property argument to getType() is not empty, search the composite component’s metadata for a declared type on a <composite:attribute> whose name matches the property argument to getType(). If the expression and the metadata both yield results, the metadata takes precedence ONLY if it provides a narrower result than does the expression, i.e. expression type is assignable from metadata type. If the metadata result does take precedence, call ELContext.setPropertyResolved(true). Otherwise, return whichever result was available, or null.
setValue	Take no action.
isReadOnly	Take no action and return true.
getFeatureDescriptors	Take no action.
getCommonPropertyType	Return String.class

ELResorver method	implementation requirements
getValue	If base and property are not null, and base is an instance of ResourceHandler (as will be the case with an expression such as #\{resource[‘ajax.js’]}, perform the following. (Note: This is possible due to the ImplicitObjectELResolver returning the ResourceHandler, see Implicit Object ELResolver for Facelets and Programmatic Access) If property does not contain a colon character ‘:’, treat property as the resourceName and pass property to ResourceHandler.createResource(resourceName). If property contains a single colon character ‘:’, treat the content before the ‘:’ as the libraryName and the content after the ‘:’ as the resourceName and pass both to ResourceHandler.createResource(resourceName, libraryName). If the value of libraryName is the literal string “this” (without the quotes), discover the library name of the current resource (or the contract name of the current resource, the two are mutually exclusive) and replace “this” with that library name (or contract name) before calling ResourceHandler.createResource(). In the case of resource library contracts, libraryName will actually be the contract name. If property contains more than one colon character ‘:’, throw a localized ELException, including property. If one of the above steps results in the creation of a non-null Resource instance, call ELContext.setPropertyResolved(true). Call the getRequestPath() method on the Resource instance, pass the result through ExternalContext.encodeResourceUrl() and return the result.
getType	Return null. This resolver only performs lookups.
setValue	Take no action.
isReadOnly	Return false in all cases.
getFeatureDescriptors	Return null.
getCommonPropertyType	If base is non-null, return null. If base is null, return Object.class.

jakarta.faces.component class	renderer-type	jakarta.faces.component.html class
UICommand	jakarta.faces.Button	HtmlCommandButton
UICommand	jakarta.faces.Link	HtmlCommandLink
UIData	jakarta.faces.Table	HtmlDataTable
UIForm	jakarta.faces.Form	HtmlForm
UIGraphic	jakarta.faces.Image	HtmlGraphicImage
UIInput	jakarta.faces.Hidden	HtmlInputHidden
UIInput	jakarta.faces.Secret	HtmlInputSecret
UIInput	jakarta.faces.Text	HtmlInputText
UIInput	jakarta.faces.Textarea	HtmlInputTextarea
UIMessage	jakarta.faces.Message	HtmlMessage
UIMessages	jakarta.faces.Messages	HtmlMessages
UIOutput	jakarta.faces.Format	HtmlOutputFormat
UIOutput	jakarta.faces.Label	HtmlOutputLabel
UIOutput	jakarta.faces.Link	HtmlOutputLink
UIOutput	jakarta.faces.Text	HtmlOutputText
UIOutcomeTarget	jakarta.faces.Link	HtmlOutcomeTargetLink
UIOutcomeTarget	jakarta.faces.Button	HtmlOutcomeTargetButton
UIPanel	jakarta.faces.Grid	HtmlPanelGrid
UIPanel	jakarta.faces.Group	HtmlPanelGroup
UISelectBoolean	jakarta.faces.Checkbox	HtmlSelectBooleanCheckbox
UISelectMany	jakarta.faces.Checkbox	HtmlSelectManyCheckbox
UISelectMany	jakarta.faces.Listbox	HtmlSelectManyListbox
UISelectMany	jakarta.faces.Menu	HtmlSelectManyMenu
UISelectOne	jakarta.faces.Listbox	HtmlSelectOneListbox
UISelectOne	jakarta.faces.Menu	HtmlSelectOneMenu
UISelectOne	jakarta.faces.Radio	HtmlSelectOneRadio

RendererType	Render-Dependent Attributes
“Text”	“size”
“Secret”	“size”, “secretChar”
“Textarea”	“size”, “rows”

getComponentType()	getRendererType()	custom action name
jakarta.faces.Column	(null)18	column
jakarta.faces.HtmlCommandButton	jakarta.faces.Button	commandButton
jakarta.faces.HtmlCommandLink	jakarta.faces.Link	commandLink
jakarta.faces.HtmlDataTable	jakarta.faces.Table	dataTable
jakarta.faces.HtmlForm	jakarta.faces.Form	form
jakarta.faces.HtmlGraphicImage	jakarta.faces.Image	graphicImage
jakarta.faces.HtmlInputHidden	jakarta.faces.Hidden	inputHidden
jakarta.faces.HtmlInputSecret	jakarta.faces.Secret	inputSecret
jakarta.faces.HtmlInputText	jakarta.faces.Text	inputText
jakarta.faces.HtmlInputTextarea	jakarta.faces.Textarea	inputTextarea
jakarta.faces.HtmlMessage	jakarta.faces.Message	message
jakarta.faces.HtmlMessages	jakarta.faces.Messages	messages
jakarta.faces.HtmlOutputFormat	jakarta.faces.Format	outputFormat
jakarta.faces.HtmlOutputLabel	jakarta.faces.Label	outputLabel
jakarta.faces.HtmlOutputLink	jakarta.faces.Link	outputLink
jakarta.faces.Output	jakarta.faces.Body	body
jakarta.faces.Output	jakarta.faces.Head	head
jakarta.faces.Output	jakarta.faces.resource.Script	outputScript
jakarta.faces.Output	jakarta.faces.resource.Stylesheet	outputStylesheet
jakarta.faces.HtmlOutputText	jakarta.faces.Text	outputText
jakarta.faces.HtmlPanelGrid	jakarta.faces.Grid	panelGrid
jakarta.faces.HtmlPanelGroup	jakarta.faces.Group	panelGroup
jakarta.faces.HtmlSelectBooleanCheckbox	jakarta.faces.Checkbox	selectBooleanCheckbox
jakarta.faces.HtmlSelectManyCheckbox	jakarta.faces.Checkbox	selectManyCheckbox
jakarta.faces.HtmlSelectManyListbox	jakarta.faces.Listbox	selectManyListbox
jakarta.faces.HtmlSelectManyMenu	jakarta.faces.Menu	selectManyMenu
jakarta.faces.HtmlSelectOneListbox	jakarta.faces.Listbox	selectOneListbox
jakarta.faces.HtmlSelectOneMenu	jakarta.faces.Menu	selectOneMenu
jakarta.faces.HtmlSelectOneRadio	jakarta.faces.Radio	selectOneRadio

Feature Name	Jakarta Server Pages	Facelets
Pages are compiled to…	A Servlet that gets executed each time the page renders. The UIComponent hierarchy is built by the presence of custom tags in the page.	An abstract syntax tree that, when executed, builds a UIComponent hierarchy.
Handling of tag attributes	All tag attributes must be declared in a TLD file. Conformance instances of components in a page with the expected attributes can be enforced with a taglibrary validator.	Tag attributes are completely dynamic and automatically map to properties, attributes and ValueExpressions on UIComponent instances
Page templating	Not supported, must go outside of core Jakarta Server Pages	Page templating is a core feature of Facelets
Performance	Due to the common implementation technique of compiling a Jakarta Server Pages page to a Servlet, performance can be slow	Facelets is simpler and faster than Jakarta Server Pages
Expression Language Expressions	Expressions in template text cause unexpected behavior when used in Jakarta Server Pages	Expressions in template text operate as expected.
JCP Standard	Yes, the specification is separate from the implementation for Jakarta Server Pages	No, the specification is defined by and is one with the implementation.

Common prefix	Namespace URI
h	http://java.sun.com/jsf/html
f	http://java.sun.com/jsf/core
c	http://java.sun.com/jsp/jstl/core
fn	http://java.sun.com/jsp/jstl/functions
ui	http://java.sun.com/jsf/facelets

Name	Exp	Type	Description
binding	VE	ValueExpression	A ValueExpression that evaluates to an object that implements jakarta.faces.validate.BeanValidator
disabled	VE	Boolean	A flag which indicates whether this validator, or a default validator with the id "jakarta.faces.Bean", should be permitted to be added to this component
validationGroups	VE	String	A comma-delimited of type-safe validation groups that are passed to the Bean Validation API when validating the value

getComponentType()	getRendererType()	custom action name
jakarta.faces.Command	jakarta.faces.Script	commandScript
jakarta.faces.Script	jakarta.faces.Websocket	does not apply

Name	Value
execute	A space delimited list of client identifiers or one of the keywords (Keywords). These reference the components that will be processed during the “execute” portion of the request processing lifecycle.
render	A space delimited list of client identifiers or one of the keywords (Keywords). These reference the components that will be processed during the “render” portion of the request processing lifecycle.
onevent	A String that is the name of the JavaScript function to call when an event occurs.
onerror	A String that is the name of the JavaScript function to call when an error occurs.
params	An object that may include additional parameters to include in the request.

Keyword	Description
@all	All component identifiers
@none	No identifiers
@this	The element that triggered the request
@form	The enclosing form

Event Name	Description
begin	Occurs immediately before the request is sent.
complete	Occurs immediately after the request has completed. For successful requests, this is immediately before jakarta.faces.response is called. For unsuccessful requests, this is immediately before the error handling callback is invoked.
success	Occurs immediately after jsf.ajax.response has completed.

Name	Description/Value
type	“event”
status	One of the events specified in Events
source	The DOM element that triggered the Ajax request.
responseCode	Ajax request object ‘status’ (XMLHttpRequest.status); Not present for “begin” event;
responseXML	The XML response (XMLHttpRequest.responseXML); Not present for “begin” event;
responseText	The text response (XMLHttpResponse.responseText) Not present for “begin” event;

Error Name	Description
httpError	request status==null or request.status==undefined or request.status<200 or request.status >=300
serverError	The Ajax response contains an “error” element.
malformedXML	The Ajax response does not follow the proper format. See XML Schema Definition for Composite Components
emptyResponse	There was no Ajax response from the server.

Name	Description/Value
type	“error”
status	One of error names defined Errors
description	Text describing the error
source	The DOM element that triggered the Ajax request.
responseCode	Ajax request object ‘status’ (XMLHttpRequest.status);
responseXML	The XML response (XMLHttpRequest.responseXML)
responseText	The text response (XMLHttpResponse.responseTxt)
errorName	The error name taken from the Ajax response “error” element.
errorMessage	The error messages taken from the Ajax response “error” element.

	<process-as>html5</process-as> HTML 5 (default)	<process-as>xhtml</process-as> Facelets XHTML	<process-as>xml</process-as> XML View	<process-as>jspx</process-as> Facelets JSPX
XML Doctype	Simplified to <!DOCTYPE html>	passed through	consumed	consumed
XML declaration	passed through	passed through	consumed	consumed
Processing instructions	passed through	passed through	consumed	consumed
CDATA section start and end tags	passed through	passed through	consumed	consumed
Escaping of inline text	escaped	escaped	escaped	not escaped
XML Comments	passed through	passed through	consumed	consumed

Jakarta Server Faces

Copyright

Eclipse Foundation Specification License

Disclaimers

Preface

Changes between 3.0 and 2.3

Backward Compatibility with Previous Versions

Related Technologies

Other Jakarta Platform Specifications

Related Documents and Specifications

Terminology

Providing Feedback

Acknowledgements

1. Overview

1.1. Solving Practical Problems of the Web

1.2. Specification Audience

1.2.1. Page Authors

1.2.2. Component Writers

1.2.3. Application Developers

1.2.4. Tool Providers

1.2.5. Jakarta Faces Implementors

1.3. Introduction to Jakarta Faces APIs

1.3.1. package jakarta.faces

1.3.2. package jakarta.faces.application

1.3.3. package jakarta.faces.component

1.3.4. package jakarta.faces.component.html

1.3.5. package jakarta.faces.context

1.3.6. package jakarta.faces.convert

1.3.7. package jakarta.faces.el

1.3.8. package jakarta.faces.flow and jakarta.faces.flow.builder

1.3.9. package jakarta.faces.lifecycle

1.3.10. package jakarta.faces.event

1.3.11. package jakarta.faces.render

1.3.12. package jakarta.faces.validator

1.3.13. package jakarta.faces.webapp

2. Request Processing Lifecycle

2.1. Request Processing Lifecycle Scenarios

2.1.1. Non-Faces Request Generates Faces Response

2.1.2. Faces Request Generates Faces Response

2.1.3. Faces Request Generates Non-Faces Response

2.2. Standard Request Processing Lifecycle Phases

2.2.1. Restore View

2.2.2. Apply Request Values

2.2.2.1. Apply Request Values Partial Processing

2.2.3. Process Validations

2.2.3.1. Partial Validations Partial Processing

2.2.4. Update Model Values

2.2.4.1. Update Model Values Partial Processing

2.2.5. Invoke Application

2.2.6. Render Response

2.2.6.1. Render Response Partial Processing

2.3. Common Event Processing

2.4. Common Application Activities

2.4.1. Acquire Faces Object References

2.4.1.1. Acquire and Configure Lifecycle Reference

2.4.1.2. Acquire and Configure FacesContext Reference

2.4.2. Create And Configure A New View

2.4.2.1. Create A New View

2.4.2.2. Configure the Desired RenderKit

2.4.2.3. Configure The View’s Components

2.4.2.4. Store the new View in the FacesContext

2.5. Concepts that impact several lifecycle phases

2.5.1. Value Handling

2.5.1.1. Apply Request Values Phase

2.5.1.2. Process Validators Phase

2.5.1.3. Executing Validation

2.5.1.4. Update Model Values Phase

2.5.2. Localization and Internationalization (L10N/I18N)

2.5.2.1. Determining the active Locale

2.5.2.2. Determining the Character Encoding

2.5.2.3. Localized Text

2.5.2.4. Localized Application Messages

2.5.3. State Management

2.5.3.1. State Management Considerations for the Custom Component Author

2.5.3.2. State Management Considerations for the Jakarta Faces Implementor

2.5.4. Resource Handling

2.5.5. View Parameters

2.5.6. Bookmarkability

2.5.7. Jakarta Bean Validation

2.5.8. Ajax