01: //
02: // Informa -- RSS Library for Java
03: // Copyright (c) 2002 by Niko Schmuck
04: //
05: // Niko Schmuck
06: // http://sourceforge.net/projects/informa
07: // mailto:niko_schmuck@users.sourceforge.net
08: //
09: // This library is free software.
10: //
11: // You may redistribute it and/or modify it under the terms of the GNU
12: // Lesser General Public License as published by the Free Software Foundation.
13: //
14: // Version 2.1 of the license should be included with this distribution in
15: // the file LICENSE. If the license is not included with this distribution,
16: // you may find a copy at the FSF web site at 'www.gnu.org' or 'www.fsf.org',
17: // or you may write to the Free Software Foundation, 675 Mass Ave, Cambridge,
18: // MA 02139 USA.
19: //
20: // This library is distributed in the hope that it will be useful,
21: // but WITHOUT ANY WARRANTY; without even the implied waranty of
22: // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
23: // Lesser General Public License for more details.
24: //
25: // $Id: InputSourceProviderIF.java,v 1.1 2005/03/04 18:28:34 spyromus Exp $
26: //
27:
28: package de.nava.informa.utils.poller;
29:
30: import org.xml.sax.InputSource;
31:
32: import java.io.InputStream;
33: import java.io.IOException;
34:
35: /**
36: * Interface of <code>InputSource</code> provider which is intended to
37: * return input source created from the given <code>InputStream</code>.
38: * It can be used to customize the string processing by wrapping the
39: * stream with custom <code>Reader</code>'s or another
40: * <code>FilterInputStream</code>'s.
41: *
42: * The source stream represents feed's stream of chars and
43: * <code>InputSource</code> object will be used for parsing this feed.
44: */
45: public interface InputSourceProviderIF {
46:
47: /**
48: * Return <code>InputSource</code> to be used with given stream.
49: *
50: * @param stream input stream.
51: *
52: * @return initialized input source ready for use in parsing.
53: *
54: * @throws IOException in case of any problems.
55: */
56: InputSource getInputSourceFor(InputStream stream)
57: throws IOException;
58: }
|