1 /* 2 * (c) Copyright 2000, 2001, 2002, 2003, 2004, 2005 Hewlett-Packard Development Company, LP 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * 1. Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer in the 12 * documentation and/or other materials provided with the distribution. 13 * 3. The name of the author may not be used to endorse or promote products 14 * derived from this software without specific prior written permission. 15 16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 17 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 18 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 19 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 20 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 21 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 22 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 23 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 24 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 25 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26 * 27 * $Id: RDFReaderF.java,v 1.6 2005/02/21 12:14:22 andy_seaborne Exp $ 28 */ 29 30 package com.hp.hpl.jena.rdf.model; 31 32 /** An RDFReader factory inferface. 33 * 34 * <p>This factory interface is slightly unusual, in that, as well as 35 * creating and returning RDFReader's, it also provides methods 36 * for creating a reader, invoking a read method on it and then 37 * shuting it down.</p> 38 * 39 * <p>The factory will create an appropriate reader for the particular 40 * serialization language being read. Predefined languages include:</p> 41 * <ul> 42 * <li>RDF/XML - default</li> 43 * <li>RDF/XML-ABBREV</li> 44 * <li>N-TRIPLE</li> 45 * <li>N3</li> 46 * </ul> 47 *<p>System wide defaults for classes to use as readers for these languages 48 *are defined. These defaults may be overwridden by setting a system property 49 *with a name of the form com.hp.hpl.jena.readers.<lang> to the class 50 *name.</p> 51 * @author bwm 52 * @version $Version$ $Date: 2005/02/21 12:14:22 $ 53 */ 54 55 public interface RDFReaderF { 56 57 /** return an RDFReader instance for the default serialization language. 58 * @return an RDFReader instance for the default serialization language. 59 */ 60 public RDFReader getReader() ; 61 62 /** return an RDFReader instance for the specified serialization language. 63 * @return the RDFWriter instance 64 * @param lang the serialization langauge - <code>null</code> selects the 65 * default 66 67 */ 68 public RDFReader getReader(String lang) ; 69 70 /** set the class name for the RDFReader for a langauge 71 * @param lang the language for which this class should be used 72 * @param className the class name for readers for this language 73 * @return the old class name for this language 74 */ 75 public String setReaderClassName(String lang, String className); 76 //* @deprecated Replaced by setReader 77 } 78 79