1 /* 2 * (c) Copyright 2004, 2005 Hewlett-Packard Development Company, LP 3 * [See end of file] 4 */ 5 6 package com.hp.hpl.jena.rdf.arp; 7 8 /** 9 * Used to set event handlers and options 10 * on {@link ARP}, {@link SAX2Model}, and 11 * {@link SAX2RDF} instances. 12 * @author Jeremy J. Carroll 13 * 14 */ 15 public interface ARPConfig { 16 /** 17 * The handlers used during parsing. 18 * The handlers can be changed by calling this method 19 * and then using the <code>set..Handler</code> methods 20 * in {@link ARPHandlers}. 21 * The handlers can be copied onto another ARP instance 22 * using the {@link #setHandlersWith} method. 23 * @see ARPHandlers#setStatementHandler(StatementHandler) 24 * @see ARPHandlers#setErrorHandler(ErrorHandler) 25 * @see ARPHandlers#setExtendedHandler(ExtendedHandler) 26 * @see ARPHandlers#setNamespaceHandler(NamespaceHandler) 27 * @see #setHandlersWith 28 * @return The handlers used during parsing. 29 */ 30 public ARPHandlers getHandlers(); 31 32 /** 33 * Copies the handlers from the argument 34 * to be used by this instance. 35 * To make further modifications it is necessary 36 * to call {@link #getHandlers} to retrieve this 37 * instance's copy of the handler information. 38 * @param handlers The new values to use. 39 */ 40 public void setHandlersWith(ARPHandlers handlers); 41 42 /** 43 * The options used during parsing. 44 * The options can be changed by calling this method 45 * and then using the <code>set..</code> methods 46 * in {@link ARPOptions}. 47 * The options can be copied onto another ARP instance 48 * using the {@link #setOptionsWith} method. 49 * @see ARPOptions#setDefaultErrorMode() 50 * @see ARPOptions#setLaxErrorMode() 51 * @see ARPOptions#setStrictErrorMode() 52 * @see ARPOptions#setStrictErrorMode(int) 53 * @see ARPOptions#setEmbedding(boolean) 54 * @see ARPOptions#setErrorMode(int, int) 55 * 56 * @see #setOptionsWith 57 * @return The handlers used during parsing. 58 */ 59 public ARPOptions getOptions(); 60 61 /** 62 * Copies the options from the argument 63 * to be used by this instance. 64 * To make further modifications it is necessary 65 * to call {@link #getOptions} to retrieve this 66 * instance's copy of the options. 67 * @param opts The new values to use. 68 */ 69 public void setOptionsWith(ARPOptions opts); 70 } 71 72 /* 73 * (c) Copyright 2004, 2005 Hewlett-Packard Development Company, LP 74 * All rights reserved. 75 * 76 * Redistribution and use in source and binary forms, with or without 77 * modification, are permitted provided that the following conditions 78 * are met: 79 * 1. Redistributions of source code must retain the above copyright 80 * notice, this list of conditions and the following disclaimer. 81 * 2. Redistributions in binary form must reproduce the above copyright 82 * notice, this list of conditions and the following disclaimer in the 83 * documentation and/or other materials provided with the distribution. 84 * 3. The name of the author may not be used to endorse or promote products 85 * derived from this software without specific prior written permission. 86 * 87 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 88 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 89 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 90 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 91 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 92 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 93 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 94 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 95 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 96 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 97 */ 98 99