001 /*
002 * Licensed to the Apache Software Foundation (ASF) under one or more
003 * contributor license agreements. See the NOTICE file distributed with
004 * this work for additional information regarding copyright ownership.
005 * The ASF licenses this file to You under the Apache License, Version 2.0
006 * (the "License"); you may not use this file except in compliance with
007 * the License. You may obtain a copy of the License at
008 *
009 * http://www.apache.org/licenses/LICENSE-2.0
010 *
011 * Unless required by applicable law or agreed to in writing, software
012 * distributed under the License is distributed on an "AS IS" BASIS,
013 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
014 * See the License for the specific language governing permissions and
015 * limitations under the License.
016 */
017 package org.apache.commons.validator;
018
019 import org.xml.sax.Attributes;
020 import org.apache.commons.digester.AbstractObjectCreationFactory;
021 import org.apache.commons.logging.Log;
022 import org.apache.commons.logging.LogFactory;
023
024 /**
025 * Factory class used by Digester to create FormSet's.
026 *
027 * @version $Revision: 493905 $ $Date: 2007-01-08 03:11:38 +0100 (Mo, 08. Jan 2007) $
028 * @since Validator 1.2
029 */
030 public class FormSetFactory extends AbstractObjectCreationFactory {
031
032 /** Logging */
033 private transient Log log = LogFactory.getLog(FormSetFactory.class);
034
035 /**
036 * <p>Create or retrieve a <code>FormSet</code> for the specified
037 * attributes.</p>
038 *
039 * @param attributes The sax attributes for the formset element.
040 * @return The FormSet for a locale.
041 * @throws Exception If an error occurs creating the FormSet.
042 */
043 public Object createObject(Attributes attributes) throws Exception {
044
045 ValidatorResources resources = (ValidatorResources)digester.peek(0);
046
047 String language = attributes.getValue("language");
048 String country = attributes.getValue("country");
049 String variant = attributes.getValue("variant");
050
051 return createFormSet(resources, language, country, variant);
052
053 }
054
055 /**
056 * <p>Create or retrieve a <code>FormSet</code> based on the language, country
057 * and variant.</p>
058 *
059 * @param resources The validator resources.
060 * @param language The locale's language.
061 * @param country The locale's country.
062 * @param variant The locale's language variant.
063 * @return The FormSet for a locale.
064 * @since Validator 1.2
065 */
066 private FormSet createFormSet(ValidatorResources resources,
067 String language,
068 String country,
069 String variant) throws Exception {
070
071 // Retrieve existing FormSet for the language/country/variant
072 FormSet formSet = resources.getFormSet(language, country, variant);
073 if (formSet != null) {
074 if (getLog().isDebugEnabled()) {
075 getLog().debug("FormSet[" + formSet.displayKey() + "] found - merging.");
076 }
077 return formSet;
078 }
079
080 // Create a new FormSet for the language/country/variant
081 formSet = new FormSet();
082 formSet.setLanguage(language);
083 formSet.setCountry(country);
084 formSet.setVariant(variant);
085
086 // Add the FormSet to the validator resources
087 resources.addFormSet(formSet);
088
089 if (getLog().isDebugEnabled()) {
090 getLog().debug("FormSet[" + formSet.displayKey() + "] created.");
091 }
092
093 return formSet;
094
095 }
096
097 /**
098 * Accessor method for Log instance.
099 *
100 * The Log instance variable is transient and
101 * accessing it through this method ensures it
102 * is re-initialized when this instance is
103 * de-serialized.
104 *
105 * @return The Log instance.
106 */
107 private Log getLog() {
108 if (log == null) {
109 log = LogFactory.getLog(FormSetFactory.class);
110 }
111 return log;
112 }
113
114 }