Frames | No Frames |
1: /* SchemaFactory.java -- 2: Copyright (C) 2004, 2005, 2006 Free Software Foundation, Inc. 3: 4: This file is part of GNU Classpath. 5: 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) 9: any later version. 10: 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. 15: 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., 51 Franklin Street, Fifth Floor, Boston, MA 19: 02110-1301 USA. 20: 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 24: combination. 25: 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. */ 37: 38: package javax.xml.validation; 39: 40: import java.io.File; 41: import java.net.URL; 42: import javax.xml.XMLConstants; 43: import javax.xml.transform.Source; 44: import javax.xml.transform.stream.StreamSource; 45: import org.w3c.dom.ls.LSResourceResolver; 46: import org.xml.sax.ErrorHandler; 47: import org.xml.sax.SAXException; 48: import org.xml.sax.SAXNotRecognizedException; 49: import org.xml.sax.SAXNotSupportedException; 50: 51: /** 52: * Factory for obtaining schemata. 53: * 54: * @author Chris Burdess (dog@gnu.org) 55: * @since 1.5 56: */ 57: public abstract class SchemaFactory 58: { 59: protected SchemaFactory() 60: { 61: } 62: 63: /** 64: * Returns an implementation of <code>SchemaFactory</code> that supports 65: * the specified schema language. 66: * @param schemaLanguage the URI of a schema language (see 67: * <code>XMLConstants</code>) 68: */ 69: public static final SchemaFactory newInstance(String schemaLanguage) 70: { 71: if (XMLConstants.W3C_XML_SCHEMA_NS_URI.equals(schemaLanguage)) 72: return new gnu.xml.validation.xmlschema.XMLSchemaSchemaFactory(); 73: if (XMLConstants.RELAXNG_NS_URI.equals(schemaLanguage)) 74: return new gnu.xml.validation.relaxng.RELAXNGSchemaFactory(); 75: throw new IllegalArgumentException(schemaLanguage); 76: } 77: 78: /** 79: * Indicates whether the specified schema language is supported. 80: * @param schemaLanguage the URI of a schema language (see 81: * <code>XMLConstants</code>) 82: */ 83: public abstract boolean isSchemaLanguageSupported(String schemaLanguage); 84: 85: public boolean getFeature(String name) 86: throws SAXNotRecognizedException, SAXNotSupportedException 87: { 88: throw new SAXNotRecognizedException(name); 89: } 90: 91: public void setFeature(String name, boolean value) 92: throws SAXNotRecognizedException, SAXNotSupportedException 93: { 94: throw new SAXNotRecognizedException(name); 95: } 96: 97: public Object getProperty(String name) 98: throws SAXNotRecognizedException, SAXNotSupportedException 99: { 100: throw new SAXNotRecognizedException(name); 101: } 102: 103: public void setProperty(String name, Object value) 104: throws SAXNotRecognizedException, SAXNotSupportedException 105: { 106: throw new SAXNotRecognizedException(name); 107: } 108: 109: public abstract ErrorHandler getErrorHandler(); 110: 111: public abstract void setErrorHandler(ErrorHandler errorHandler); 112: 113: public abstract LSResourceResolver getResourceResolver(); 114: 115: public abstract void setResourceResolver(LSResourceResolver resourceResolver); 116: 117: /** 118: * Returns a schema based on the specified source resource. 119: * @param schema the source resource 120: */ 121: public Schema newSchema(Source schema) 122: throws SAXException 123: { 124: return newSchema(new Source[] { schema }); 125: } 126: 127: /** 128: * Returns a schema based on the specified source file. 129: * @param schema the source resource 130: */ 131: public Schema newSchema(File schema) 132: throws SAXException 133: { 134: return newSchema(new StreamSource(schema)); 135: } 136: 137: /** 138: * Returns a schema based on the specified URL. 139: * @param schema the source resource 140: */ 141: public Schema newSchema(URL schema) 142: throws SAXException 143: { 144: return newSchema(new StreamSource(schema.toString())); 145: } 146: 147: /** 148: * Parses the specified sources, and combine them into a single schema. 149: * The exact procedure and semantics of this depends on the schema 150: * language. 151: * @param schemata the schema resources to load 152: */ 153: public abstract Schema newSchema(Source[] schemata) 154: throws SAXException; 155: 156: /** 157: * Creates a special schema. 158: * The exact semantics of this depends on the schema language. 159: */ 160: public abstract Schema newSchema() 161: throws SAXException; 162: 163: }