1 /* SchemaFactory.java --
2 Copyright (C) 2004, 2005 Free Software Foundation, Inc.
4 This file is part of GNU Classpath.
6 GNU Classpath is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2, or (at your option)
11 GNU Classpath is distributed in the hope that it will be useful, but
12 WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GNU Classpath; see the file COPYING. If not, write to the
18 Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
21 Linking this library statically or dynamically with other modules is
22 making a combined work based on this library. Thus, the terms and
23 conditions of the GNU General Public License cover the whole
26 As a special exception, the copyright holders of this library give you
27 permission to link this library with independent modules to produce an
28 executable, regardless of the license terms of these independent
29 modules, and to copy and distribute the resulting executable under
30 terms of your choice, provided that you also meet, for each linked
31 independent module, the terms and conditions of the license of that
32 module. An independent module is a module which is not derived from
33 or based on this library. If you modify this library, you may extend
34 this exception to your version of the library, but you are not
35 obligated to do so. If you do not wish to do so, delete this
36 exception statement from your version. */
38 package javax
.xml
.validation
;
42 import javax
.xml
.transform
.Source
;
43 import javax
.xml
.transform
.stream
.StreamSource
;
44 import org
.w3c
.dom
.ls
.LSResourceResolver
;
45 import org
.xml
.sax
.ErrorHandler
;
46 import org
.xml
.sax
.SAXException
;
47 import org
.xml
.sax
.SAXNotRecognizedException
;
48 import org
.xml
.sax
.SAXNotSupportedException
;
51 * Factory for obtaining schemata.
53 * @author (a href='mailto:dog@gnu.org'>Chris Burdess</a)
56 public abstract class SchemaFactory
59 ErrorHandler errorHandler
;
61 protected SchemaFactory()
66 * Returns an implementation of <code>SchemaFactory</code> that supports
67 * the specified schema language.
68 * @param schemaLanguage the URI of a schema language (see
69 * <code>XMLConstants</code>)
71 public static final SchemaFactory
newInstance(String schemaLanguage
)
74 throw new IllegalArgumentException(schemaLanguage
);
78 * Indicates whether the specified schema language is supported.
79 * @param schemaLanguage the URI of a schema language (see
80 * <code>XMLConstants</code>)
82 public abstract boolean isSchemaLanguageSupported(String schemaLanguage
);
84 public boolean getFeature(String name
)
85 throws SAXNotRecognizedException
, SAXNotSupportedException
87 throw new SAXNotRecognizedException(name
);
90 public void setFeature(String name
, boolean value
)
91 throws SAXNotRecognizedException
, SAXNotSupportedException
93 throw new SAXNotRecognizedException(name
);
96 public Object
getProperty(String name
)
97 throws SAXNotRecognizedException
, SAXNotSupportedException
99 throw new SAXNotRecognizedException(name
);
102 public void setProperty(String name
, Object value
)
103 throws SAXNotRecognizedException
, SAXNotSupportedException
105 throw new SAXNotRecognizedException(name
);
108 public ErrorHandler
getErrorHandler()
113 public void setErrorHandler(ErrorHandler errorHandler
)
115 this.errorHandler
= errorHandler
;
118 public abstract LSResourceResolver
getResourceResolver();
120 public abstract void setResourceResolver(LSResourceResolver resourceResolver
);
123 * Returns a schema based on the specified source resource.
124 * @param schema the source resource
126 public Schema
newSchema(Source schema
)
129 return newSchema(new Source
[] { schema
});
133 * Returns a schema based on the specified source file.
134 * @param schema the source resource
136 public Schema
newSchema(File schema
)
139 return newSchema(new StreamSource(schema
));
143 * Returns a schema based on the specified URL.
144 * @param schema the source resource
146 public Schema
newSchema(URL schema
)
149 return newSchema(new StreamSource(schema
.toString()));
153 * Parses the specified sources, and combine them into a single schema.
154 * The exact procedure and semantics of this depends on the schema
156 * @param schemata the schema resources to load
158 public abstract Schema
newSchema(Source
[] schemata
)
162 * Creates a special schema.
163 * The exact semantics of this depends on the schema language.
165 public abstract Schema
newSchema()