01: /*
02: * Licensed to the Apache Software Foundation (ASF) under one or more
03: * contributor license agreements. See the NOTICE file distributed with
04: * this work for additional information regarding copyright ownership.
05: * The ASF licenses this file to You under the Apache License, Version 2.0
06: * (the "License"); you may not use this file except in compliance with
07: * the License. You may obtain a copy of the License at
08: *
09: * http://www.apache.org/licenses/LICENSE-2.0
10: *
11: * Unless required by applicable law or agreed to in writing, software
12: * distributed under the License is distributed on an "AS IS" BASIS,
13: * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14: * See the License for the specific language governing permissions and
15: * limitations under the License.
16: */
17:
18: package org.apache.commons.betwixt.strategy;
19:
20: import org.apache.commons.betwixt.io.read.MappingAction;
21: import org.apache.commons.betwixt.io.read.ReadContext;
22: import org.xml.sax.Attributes;
23:
24: /**
25: * <p>
26: * Pluggable strategy interface used for free mappings.
27: * </p>
28: * <p>
29: * Free mappings (ones where the current mapping )
30: * are executed by calling a <code>ActionMappingStrategy</code>
31: * implementation.
32: * So, using a custom strategy is an easy way to
33: * customize the mapping.
34: * </p>
35: * @author <a href='http://jakarta.apache.org/'>Jakarta Commons Team</a>
36: * @version $Revision: 438373 $
37: */
38: public abstract class ActionMappingStrategy {
39:
40: /**
41: * Default <code>ActionMappingStrategy</code>
42: * used by betwixt
43: */
44: public static final ActionMappingStrategy DEFAULT = new DefaultActionMappingStrategy();
45:
46: /**
47: * Gets the mapping action to map the given element.
48: * @param namespace not null
49: * @param name not null
50: * @param attributes <code>Attributes</code>, not null
51: * @param context <code>ReadContext</code>, not null
52: * @return <code>MappingAction</code>, not null
53: * @throws Exception
54: */
55: public abstract MappingAction getMappingAction(String namespace,
56: String name, Attributes attributes, ReadContext context)
57: throws Exception;
58: }
|