01: //$Id: IParser.java 282 2007-07-19 22:46:27Z jg_hamburg $
02: /********************************************************************************
03: * DDTUnit, a Datadriven Approach to Unit- and Moduletesting
04: * Copyright (c) 2004, Joerg and Kai Gellien
05: * All rights reserved.
06: *
07: * The Software is provided under the terms of the Common Public License 1.0
08: * as provided with the distribution of DDTUnit in the file cpl-v10.html.
09: * Redistribution and use in source and binary forms, with or without
10: * modification, are permitted provided that the following conditions
11: * are met:
12: *
13: * + Redistributions of source code must retain the above copyright
14: * notice, this list of conditions and the following disclaimer.
15: *
16: * + Redistributions in binary form must reproduce the above
17: * copyright notice, this list of conditions and the following
18: * disclaimer in the documentation and/or other materials provided
19: * with the distribution.
20: *
21: * + Neither the name of the authors or DDTUnit, nor the
22: * names of its contributors may be used to endorse or promote
23: * products derived from this software without specific prior
24: * written permission.
25: *
26: * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
27: * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
28: * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
29: * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR
30: * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
31: * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
32: * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
33: * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
34: * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
35: * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
36: * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
37: ********************************************************************************/package junitx.ddtunit.data.processing;
38:
39: import junitx.ddtunit.data.TestClusterDataSet;
40: import junitx.ddtunit.data.TypedObject;
41:
42: public interface IParser {
43:
44: /**
45: * Parse xml resource provided by resource name filtered by classId.
46: *
47: * @param resource
48: * to parse
49: * @param byName
50: * TODO
51: * @param clusterId
52: * to filter class tag
53: * @return generated {@link TestClusterDataSet}
54: */
55: public abstract TestClusterDataSet parse(String resource,
56: boolean byName, String clusterId,
57: TestClusterDataSet baseDataSet);
58:
59: /**
60: * Parse xml resource provided by reader.
61: *
62: * @param xmlDef
63: * string of object to instanciate
64: * @param addXMLHeader
65: * true if xml header should be included automatically
66: * @return generated object as defined in xml definition
67: */
68: public abstract TypedObject parseElement(String xmlDef,
69: boolean addXMLHeader);
70: }
|