001 /* $Id: DigesterLoaderBuilder.java 992099 2010-09-02 20:09:12Z 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 */
018 package org.apache.commons.digester.annotations;
019
020 import org.apache.commons.digester.annotations.internal.DefaultAnnotationRuleProviderFactory;
021 import org.apache.commons.digester.annotations.spi.AnnotationRuleProviderFactory;
022
023 /**
024 * {@link DigesterLoader} builder implementation.
025 *
026 * @since 2.1
027 */
028 public final class DigesterLoaderBuilder {
029
030 /**
031 * Builds a new {@link DigesterLoader} using the default SPI
032 * implementations.
033 *
034 * @return a new {@link DigesterLoader} using the default SPI
035 * implementations.
036 */
037 public static DigesterLoader byDefaultFactories() {
038 return new DigesterLoaderBuilder()
039 .useDefaultAnnotationRuleProviderFactory()
040 .useDefaultDigesterLoaderHandlerFactory();
041 }
042
043 /**
044 * Builds a new {@link DigesterLoader} using the default
045 * {@link AnnotationRuleProviderFactory} implementation.
046 *
047 * @return the next chained builder.
048 * @see DefaultAnnotationRuleProviderFactory
049 */
050 public FromAnnotationRuleProviderFactory useDefaultAnnotationRuleProviderFactory() {
051 return this.useAnnotationRuleProviderFactory(new DefaultAnnotationRuleProviderFactory());
052 }
053
054 /**
055 * Builds a new {@link DigesterLoader} using the user defined
056 * {@link AnnotationRuleProviderFactory} implementation.
057 *
058 * @param annotationRuleProviderFactory the user defined
059 * {@link AnnotationRuleProviderFactory} implementation.
060 * @return the next chained builder.
061 */
062 public FromAnnotationRuleProviderFactory
063 useAnnotationRuleProviderFactory(AnnotationRuleProviderFactory annotationRuleProviderFactory) {
064 if (annotationRuleProviderFactory == null) {
065 throw new IllegalArgumentException("Parameter 'annotationRuleProviderFactory' must be not null");
066 }
067 return new FromAnnotationRuleProviderFactory(annotationRuleProviderFactory);
068 }
069
070 }