1 /*
2 * Licensed to the Apache Software Foundation (ASF) under one
3 * or more contributor license agreements. See the NOTICE file
4 * distributed with this work for additional information
5 * regarding copyright ownership. The ASF licenses this file
6 * to you under the Apache License, Version 2.0 (the
7 * "License"); you may not use this file except in compliance
8 * with the License. You may obtain a copy of the License at
9 *
10 * http://www.apache.org/licenses/LICENSE-2.0
11 *
12 * Unless required by applicable law or agreed to in writing,
13 * software distributed under the License is distributed on an
14 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 * KIND, either express or implied. See the License for the
16 * specific language governing permissions and limitations
17 * under the License.
18 */
19 package javax.faces.view.facelets;
20
21 import javax.faces.view.ValueHolderAttachedObjectHandler;
22
23 import org.apache.myfaces.buildtools.maven2.plugin.builder.annotation.JSFFaceletTag;
24
25 /**
26 * Handles setting a Converter instance on a ValueHolder. Will wire all attributes set to the Converter instance
27 * created/fetched. Uses the "binding" attribute for grabbing instances to apply attributes to. <p/> Will only
28 * set/create Converter is the passed UIComponent's parent is null, signifying that it wasn't restored from an existing
29 * tree.
30 *
31 * @see javax.faces.webapp.ConverterELTag
32 * @see javax.faces.convert.Converter
33 * @see javax.faces.component.ValueHolder
34 */
35 @JSFFaceletTag
36 public class ConverterHandler extends FaceletsAttachedObjectHandler implements ValueHolderAttachedObjectHandler
37 {
38 private String converterId;
39 private TagHandlerDelegate helper;
40
41 public ConverterHandler(ConverterConfig config)
42 {
43 super(config);
44
45 converterId = config.getConverterId();
46 }
47
48 public String getConverterId (FaceletContext ctx)
49 {
50 return converterId;
51 }
52
53 protected TagHandlerDelegate getTagHandlerDelegate()
54 {
55 if (helper == null)
56 {
57 // Spec seems to indicate that the helper is created here, as opposed to other Handler
58 // instances, where it's presumably a new instance for every getter call.
59
60 this.helper = delegateFactory.createConverterHandlerDelegate (this);
61 }
62 return helper;
63 }
64 }