Zrób to sam

Podobnie jak kowertery czy walidatory, można też samemu pisać własne komponenty i renderery, choć zwykle nie ma takiej potrzeby. Można też oczywiście tworzyć też kombinacje nowy komponenttandardowy renderer i na odwrót. Zawsze jednak trzeba też oprogramować nowy znacznik.

• Komponent
  Jeśli już chce się napisać nowy komponent, to zwykle tworzy się podklasę UICommand, UIInput itp:

      public class UISimple extends UIInput {
  
         public UISimple() {
             public String getComponentType() { return "komponenty.Simple"; }
             public String getRendererType() { return "komponenty.Simple"; }
             setConverter(new IntegerConverter()); 
         }
         ...
      }
  

  Być trzeba zaimplementować getFamily (rodzina komponentu używana jest przy szukaniu rendererów do jego wyświetlania, tu bez zmian rodziną została javax.faces.Input), napisać kod wyświetlający bądź, jak wyżej, zrzucić to na renderera - no i zaimplementować zachowanie komponentu.
• Renderer
  Jeśli chce się napisać renderer (oczywiście nic nie stoi na przeszkodzie, żeby komponent sam odpowiadał za swój sposób wyświetlania, tyle że to nieeleganckie. Trzeba by wtedy określić w konstruktorze setRendererType(null), trzeba będzie zaimplementować metody konwertujące lokalne wartości komponentu na HTML: encodeBegin() - ewentualnie encodeChildren() (jeśli komponent może być kontenerem dla innych komponentów) - oraz encodeEnd() dla fazy Render Response:

  public class SimpleRenderer extends Renderer {
  
     public void encodeBegin(FacesContext context, UIComponent simple)
            throws IOException {
         ResponseWriter writer = context.getResponseWriter();
         String clientId = simple.getClientId(context);
         writer.startElement("input", simple);
         writer.writeAttribute("name", clientId + VAL, "clientId");
         Object v = (UIInput) simple).getValue();
         if (v != null)
           writer.writeAttribute("value", v.toString(), "value");
         writer.endElement("input");
     }
  }
  

  Nie trzeba implementować wszystkich metod. ResponseWriter dostarcza przydatnych metod
  • void startElement(String elementName, UIComponent component)
  • void writeAttribute(String attributeName, String attributeValue, String componentProperty)
  • void endElement(String elementName)
  Następnie należy umożliwić dekodowanie, czyli konwersję parametrów żądań na wartości komponentu:

  public void decode(FacesContext context, UIComponent component) {
     EditableValueHolder simple = (EditableValueHolder) component;
     Map requestMap = context.getExternalContext().getRequestParameterMap(
     String clientId = component.getClientId(context);
     if (requestMap.containsKey(clientId + VAL)) {
        int submittedValue
           = Integer.parseInt((String) requestMap.get(clientId + VAL));
        simple.setSubmittedValue("" + submittedValue);
        simple.setValid(true);
     }
  }
  

• Tag Handler
  TagHandler powinien rozszerzać (ewentualnie podklasę) javax.faces.webapp. UIComponentTag, nie takie rzeczy się robiło... trzeba tylko zaimplementować getRendererType i getConverterType - no i zaimplementować ustawianie własności:

  protected void setProperties(UIComponent component) {
     super.setProperties(component);
  
     MyComponent map = (MyComponent) component;
     if (styleClass != null) {
        if (isValueReference(styleClass)) {
           ValueBinding vb =
              FacesContext.getCurrentInstance().
                 getApplication().
                    createValueBinding(styleClass);
           map.setValueBinding("styleClass", vb);
        } else {
           map.getAttributes().put("styleClass", styleClass);
        }
     }
  }
  

• TLD - wpisać do TLD definicje znacznika
• zarejestrować renderer i komponent w faces-config:

  <faces-config>
     ...
     <component>
         <component-type>komponenty.Simple</component-type>
         <component-class>komponenty.UISimple</component-class>
     </component>
     <render-kit>
         <renderer>
            <component-family>javax.faces.Input</component-family>
            <renderer-type>komponenty.Simple</renderer-type>
            <renderer-class>komponenty.SimpleRenderer</renderer-class>
         </renderer>
     </render-kit>
  </faces-config>