001/* $Id: LoaderSetProperties.java 992060 2010-09-02 19:09:47Z simonetripodi $
002 *
003 * Licensed to the Apache Software Foundation (ASF) under one or more
004 * contributor license agreements.  See the NOTICE file distributed with
005 * this work for additional information regarding copyright ownership.
006 * The ASF licenses this file to You under the Apache License, Version 2.0
007 * (the "License"); you may not use this file except in compliance with
008 * the License.  You may obtain a copy of the License at
009 *
010 *      http://www.apache.org/licenses/LICENSE-2.0
011 *
012 * Unless required by applicable law or agreed to in writing, software
013 * distributed under the License is distributed on an "AS IS" BASIS,
014 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
015 * See the License for the specific language governing permissions and
016 * limitations under the License.
017 */
018package org.apache.commons.digester.plugins.strategies;
019
020import org.apache.commons.digester.Digester;
021import org.apache.commons.logging.Log;
022import org.apache.commons.digester.plugins.RuleLoader;
023
024/**
025 * A RuleLoader which creates a single SetPropertiesRule and adds it to the
026 * digester when its addRules() method is invoked.
027 * <p>
028 * This loader ensures that any xml attributes on the plugin tag get
029 * mapped to equivalent properties on a javabean. This allows JavaBean
030 * classes to be used as plugins without any requirement to create custom
031 * plugin rules.
032 *
033 * @since 1.6
034 */
035
036public class LoaderSetProperties extends RuleLoader {
037    
038    /**
039     * Just add a SetPropertiesRule at the specified path.
040     */
041    @Override
042    public void addRules(Digester digester, String path) {
043        Log log = digester.getLogger();
044        boolean debug = log.isDebugEnabled();
045        if (debug) {
046            log.debug(
047                "LoaderSetProperties loading rules for plugin at path [" 
048                + path + "]");
049        }
050
051        digester.addSetProperties(path);
052    }
053}
054