File: SchemaTestBase.java

package info (click to toggle)
libjibx1.2-java 1.2.6-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 26,260 kB
  • sloc: java: 75,013; xml: 14,068; makefile: 17
file content (412 lines) | stat: -rw-r--r-- 15,845 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
/*
Copyright (c) 2007-2009, Dennis M. Sosnoski.
All rights reserved.

Redistribution and use in source and binary forms, with or without modification,
are permitted provided that the following conditions are met:

 * Redistributions of source code must retain the above copyright notice, this
   list of conditions and the following disclaimer.
 * Redistributions in binary form must reproduce the above copyright notice,
   this list of conditions and the following disclaimer in the documentation
   and/or other materials provided with the distribution.
 * Neither the name of JiBX nor the names of its contributors may be used
   to endorse or promote products derived from this software without specific
   prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/

package org.jibx.schema;

import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.PrintStream;
import java.io.StringReader;
import java.io.StringWriter;
import java.net.MalformedURLException;
import java.net.URL;
import java.util.ArrayList;
import java.util.Map;

import junit.framework.TestCase;

import org.jibx.binding.Loader;
import org.jibx.binding.Utility;
import org.jibx.binding.classes.BoundClass;
import org.jibx.binding.classes.ClassCache;
import org.jibx.binding.classes.ClassFile;
import org.jibx.binding.classes.MungedClass;
import org.jibx.binding.def.BindingDefinition;
import org.jibx.extras.DocumentComparator;
import org.jibx.runtime.BindingDirectory;
import org.jibx.runtime.IBindingFactory;
import org.jibx.runtime.IMarshallingContext;
import org.jibx.runtime.IUnmarshallable;
import org.jibx.runtime.IUnmarshallingContext;
import org.jibx.runtime.JiBXException;
import org.jibx.schema.codegen.custom.SchemasetCustom;
import org.jibx.schema.elements.SchemaElement;
import org.jibx.schema.validation.NameMergeVisitor;
import org.jibx.schema.validation.PrevalidationVisitor;
import org.jibx.schema.validation.NameRegistrationVisitor;
import org.jibx.schema.validation.ValidationContext;
import org.jibx.schema.validation.ValidationProblem;
import org.jibx.schema.validation.ValidationVisitor;

/**
 * Base class for all schema tests. This binds and loads the schema classes during initialization, and provides access
 * methods for working with the schema classes.
 */
public class SchemaTestBase extends TestCase
{

    private static final String SCHEMA_CLASS = "org.jibx.schema.elements.SchemaElement";
    private static final String BINDING_FILE = "schema-xsprefix-binding.xml";
    private static final String BINDING_NAME = "schema_xsprefix_binding";
    private static final String EXTRACT_FILE = "schema-extract-binding.xml";
    private static final String EXTRACT_NAME = "schema_extract_binding";
    
    private static final IBindingFactory m_bindingFactory;
    static {
        ClassLoader loader;
        try {
            
            // set paths to be used for loading referenced classes
            loader = SchemaTestBase.class.getClassLoader();
            URL[] urls = Loader.getClassPaths();
            String[] paths = new String[urls.length];
            for (int i = 0; i < urls.length; i++) {
                paths[i] = urls[i].getFile();
            }
            ClassCache.setPaths(paths);
            ClassFile.setPaths(paths);
            
        } catch (MalformedURLException e) {
            throw new RuntimeException("Internal error - unable to set classpaths");
        }
        IBindingFactory factory = null;
        try {
            
            // look up the mapped class and existing binding factory
            Class mclas = Class.forName(SCHEMA_CLASS);
            factory = BindingDirectory.getFactory(BINDING_NAME, mclas);
            
        } catch (Exception e) { /* just fall through */ }
        if (factory == null) {
            try {
                
                // set paths to be used for loading referenced classes
                URL[] urls = Loader.getClassPaths();
                String[] paths = new String[urls.length];
                for (int i = 0; i < urls.length; i++) {
                    paths[i] = urls[i].getFile();
                }
                ClassCache.setPaths(paths);
                ClassFile.setPaths(paths);
                
                // find the binding definitions
                InputStream is1 = loader.getResourceAsStream(BINDING_FILE);
                if (is1 == null) {
                    throw new RuntimeException("Schema binding definition not found");
                }
                InputStream is2 = loader.getResourceAsStream(EXTRACT_FILE);
                if (is2 == null) {
                    throw new RuntimeException("Schema extract binding definition not found");
                }
                
                // process the binding
                BoundClass.reset();
                MungedClass.reset();
                BindingDefinition.reset();
                BindingDefinition def1 = Utility.loadBinding(BINDING_FILE, BINDING_NAME, is1, null, true);
                BindingDefinition def2 = Utility.loadBinding(EXTRACT_FILE, EXTRACT_NAME, is2, null, true);
                def1.generateCode(false, false);
                def2.generateCode(false, false);
                
                // finish binding factory with information on classes used
                ClassFile[][] lists = MungedClass.fixDispositions();
                def1.addClassList(lists[0], lists[1]);
                def2.addClassList(lists[0], lists[1]);
                
                // output the modified class files
                MungedClass.writeChanges();
                
                // look up the mapped class and associated binding factory
                Class mclas = Class.forName(SCHEMA_CLASS);
                factory = BindingDirectory.getFactory(BINDING_NAME, mclas);
                
            } catch (JiBXException e) {
                throw new RuntimeException("JiBXException: " + e.getMessage());
            } catch (IOException e) {
                throw new RuntimeException("IOException: " + e.getMessage());
            } catch (ClassNotFoundException e) {
                throw new RuntimeException("ClassNotFoundException: " + e.getMessage());
            }
        }
        m_bindingFactory = factory;
    }
    
    protected ValidationContext m_validationContext;
    
    protected NameRegister m_nameRegister;
    
    protected void setUp() throws Exception {
        m_validationContext = new ValidationContext();
    }
    
    /**
     * Read a schema definition into model.
     * 
     * @param is schema input stream
     * @param vctx validation context
     * @return schema element
     * @throws Exception
     */
    protected SchemaElement readSchema(InputStream is, ValidationContext vctx) throws Exception {
        final IUnmarshallingContext ictx = m_bindingFactory.createUnmarshallingContext();
        ictx.setDocument(is, null);
        ictx.setUserContext(vctx);
        SchemaElement schema = (SchemaElement)ictx.unmarshalElement();
        m_nameRegister = schema.getRegister();
        return schema;
    }
    
    /**
     * Read a schema definition into model.
     * 
     * @param text schema text
     * @param vctx validation context
     * @return schema element
     * @throws Exception
     */
    protected SchemaElement readSchema(String text, ValidationContext vctx) throws Exception {
        return readSchema(new ByteArrayInputStream(text.getBytes("utf-8")), vctx);
    }
    
    /**
     * Validate a schema definition.
     * 
     * @param schema schema element
     * @param vctx validation context
     */
    protected void validateSchema(SchemaElement schema, ValidationContext vctx) {
        TreeWalker tctx = new TreeWalker(vctx, vctx);
        tctx.walkSchema(schema, new PrevalidationVisitor(vctx));
        vctx.clearTraversed();
        tctx.walkSchema(schema, new NameRegistrationVisitor(vctx));
        vctx.clearTraversed();
        tctx.walkSchema(schema, new NameMergeVisitor(vctx));
        vctx.clearTraversed();
        tctx.walkSchema(schema, new ValidationVisitor(vctx));
    }
    
    /**
     * Check for validation problem.
     * 
     * @param vctx
     * @return <code>true</code> if any problem
     */
    protected boolean hasProblem(ValidationContext vctx) {
        return vctx.getProblems().size() > 0;
    }
    
    /**
     * Get validation problem report.
     * 
     * @param vctx
     * @return problem text
     */
    protected String getProblemText(ValidationContext vctx) {
        StringWriter writer = new StringWriter();
        writer.append("Problems found in schema definition");
        ArrayList problems = vctx.getProblems();
        for (int i = 0; i < problems.size(); i++) {
            writer.append('\n');
            ValidationProblem prob = (ValidationProblem)problems.get(i);
            writer.append(prob.getDescription());
        }
        return writer.toString();
    }
    
    /**
     * Write schema to text string.
     * 
     * @param schema schema element
     * @return output schema text
     * @throws Exception
     */
    protected String writeSchema(SchemaElement schema) throws Exception {
        StringWriter writer = new StringWriter();
        IMarshallingContext ictx = m_bindingFactory.createMarshallingContext();
        ictx.setOutput(writer);
        ictx.setIndent(2);
        ictx.marshalDocument(schema);
        return writer.toString();
    }
    
    /**
     * Verify that output schema matches original input. Fails the test if there's any difference between the two
     * versions of the schema.
     * 
     * @param text1 original schema text
     * @param text2 output schema text
     * @throws Exception
     */
    protected void verifySchema(String text1, String text2) throws Exception {
        StringReader rdr1 = new StringReader(text1);
        StringReader rdr2 = new StringReader(text2);
        ByteArrayOutputStream bos = new ByteArrayOutputStream();
        PrintStream pstr = new PrintStream(bos);
        DocumentComparator comp = new DocumentComparator(pstr);
        boolean match = comp.compare(rdr1, rdr2);
        if (!match) {
            pstr.close();
            fail("Error roundtripping schema:\n" + new String(bos.toByteArray()) + "\nOriginal schema:\n" + text1
                + "\nOutput schema:\n" + text2);
        }
    }
    
    /**
     * Read and validate schema, with one or more validation errors expected.
     * 
     * @param text schema text
     * @param count number of errors expected
     * @param msg text for wrong number of errors found
     * @throws Exception on unexpected error
     */
    protected void runErrors(String text, int count, String msg) throws Exception {
        SchemaElement schema = readSchema(text, m_validationContext);
        validateSchema(schema, m_validationContext);
        assertEquals(msg, count, m_validationContext.getProblems().size());
    }
    
    /**
     * Read and validate schema, with a particular validation error expected.
     * 
     * @param text schema text
     * @param msg text for wrong number of errors found
     * @throws Exception on unexpected error
     */
    protected void runOneError(String text, String msg) throws Exception {
        SchemaElement schema = readSchema(text, m_validationContext);
        validateSchema(schema, m_validationContext);
        assertTrue(msg, hasProblem(m_validationContext));
    }
    
    /**
     * Prepare schema model for use.
     * 
     * @param text schema text
     * @return schema
     * @throws Exception on unexpected error
     */
    protected SchemaElement prepareSchema(String text) throws Exception {
        m_validationContext.reset();
        SchemaElement schema = readSchema(text, m_validationContext);
        validateSchema(schema, m_validationContext);
        assertFalse(getProblemText(m_validationContext), hasProblem(m_validationContext));
        return schema;
    }
    
    /**
     * Run schema round-trip with validation, with no validation errors.
     * 
     * @param text schema text
     * @return schema
     * @throws Exception on unexpected error
     */
    protected SchemaElement runNoErrors(String text) throws Exception {
        SchemaElement schema = prepareSchema(text);
        verifySchema(text, writeSchema(schema));
        return schema;
    }

    /**
     * Load and validate schema directly. This takes the root schema resolver as input, and loads the schema along with
     * all associated schemas. Only the main schema document is actually validated, though.
     *
     * @param resolve resolver for all schema texts
     * @return root schema
     * @throws Exception
     */
    protected SchemaElement loadSchema(TestResolver resolve) throws Exception {
        SchemaElement schema = readSchema(resolve.getContent(), m_validationContext);
        schema.setResolver(resolve);
        m_validationContext.setSchema(resolve.getName(), schema);
        validateSchema(schema, m_validationContext);
        assertFalse(getProblemText(m_validationContext), hasProblem(m_validationContext));
        verifySchema(resolve.getText(), writeSchema(schema));
        return schema;
    }
    
    /**
     * Load a code generation customization.
     *
     * @param text customizations document text
     * @return loaded customization
     * @throws Exception
     */
    protected SchemasetCustom loadCustomization(String text) throws Exception {
        SchemasetCustom custom = new SchemasetCustom((SchemasetCustom)null);
        IBindingFactory fact = BindingDirectory.getFactory("xsdcodegen_customs_binding",
            "org.jibx.schema.codegen.custom");
        IUnmarshallingContext ictx = fact.createUnmarshallingContext();
        ictx.setDocument(new StringReader(text));
        ictx.setUserContext(m_validationContext);
        ((IUnmarshallable)custom).unmarshal(ictx);
        return custom;
    }

    /**
     * Resolver used for handling schema text strings directly.
     */
    protected static class TestResolver implements ISchemaResolver
    {
        /** Schema document. */
        private final String m_document;
        
        /** Schema name. */
        private final String m_name;
        
        /** Map from schema name to resolver. */
        private final Map m_schemaMap;
        
        public TestResolver(String document, String name, Map map) {
            m_document = document;
            m_name = name;
            m_schemaMap = map;
        }

        public InputStream getContent() throws IOException {
            return new ByteArrayInputStream(m_document.getBytes("UTF-8"));
        }

        public String getId() {
            return m_name;
        }

        public String getName() {
            return m_name;
        }

        public ISchemaResolver resolve(String loc, String tns) throws IOException {
            return (ISchemaResolver)m_schemaMap.get(loc);
        }
        
        public String getText() {
            return m_document;
        }
    }
}