001: /*
002: * $Id: UrlDataSource.java,v 1.3 2002/04/26 05:23:11 skavish Exp $
003: *
004: * ===========================================================================
005: *
006: * The JGenerator Software License, Version 1.0
007: *
008: * Copyright (c) 2000 Dmitry Skavish (skavish@usa.net). All rights reserved.
009: *
010: * Redistribution and use in source and binary forms, with or without
011: * modification, are permitted provided that the following conditions are met:
012: *
013: * 1. Redistributions of source code must retain the above copyright
014: * notice, this list of conditions and the following disclaimer.
015: *
016: * 2. Redistributions in binary form must reproduce the above copyright
017: * notice, this list of conditions and the following disclaimer in
018: * the documentation and/or other materials provided with the
019: * distribution.
020: *
021: * 3. The end-user documentation included with the redistribution, if
022: * any, must include the following acknowlegement:
023: * "This product includes software developed by Dmitry Skavish
024: * (skavish@usa.net, http://www.flashgap.com/)."
025: * Alternately, this acknowlegement may appear in the software itself,
026: * if and wherever such third-party acknowlegements normally appear.
027: *
028: * 4. The name "The JGenerator" must not be used to endorse or promote
029: * products derived from this software without prior written permission.
030: * For written permission, please contact skavish@usa.net.
031: *
032: * 5. Products derived from this software may not be called "The JGenerator"
033: * nor may "The JGenerator" appear in their names without prior written
034: * permission of Dmitry Skavish.
035: *
036: * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
037: * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
038: * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
039: * DISCLAIMED. IN NO EVENT SHALL DMITRY SKAVISH OR THE OTHER
040: * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
041: * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
042: * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
043: * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
044: * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
045: * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
046: * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
047: * SUCH DAMAGE.
048: *
049: */
050:
051: package org.openlaszlo.iv.flash.util;
052:
053: import java.io.*;
054: import java.net.*;
055: import java.util.*;
056: import org.openlaszlo.iv.flash.api.*;
057: import org.openlaszlo.iv.flash.url.*;
058:
059: /**
060: * Text datasource.
061: * <P>
062: * This class reads and creates text datasource from:
063: * <UL>
064: * <LI>a string
065: * <LI>an url
066: * <LI>list of url, seperated by semicolon
067: * </UL>
068: *
069: * @author Dmitry Skavish
070: * @see XMLDataSource
071: */
072: public class UrlDataSource extends DataSource {
073:
074: private IVUrl url;
075:
076: public UrlDataSource() {
077: }
078:
079: /**
080: * Creates datasource from specified string in the context of FlashFile.
081: *
082: * @param surl string representing the datasource<BR>
083: * can be one of the following:<BR>
084: * <UL>
085: * <LI>data itself if prefixed with '#'
086: * <LI>url pointing to text datasource
087: * <LI>several urls to text datasources, separated by semicolon
088: * </UL>
089: * @param flashFile flash file in the context of which this datasource is created<BR>
090: * if datasource is given by relative url, then this flash file can be used
091: * to resolve this relative url to an absolute one
092: * @exception IVException thrown if there are some problems with parsing the datasource
093: * @exception IOException thrown if there are some problems with reading the datasource
094: */
095: public UrlDataSource(String surl, FlashFile flashFile)
096: throws IVException, IOException {
097: url = null;
098:
099: if (surl == null || surl.length() == 0) {
100: throw new IOException("null datasource");
101: }
102:
103: if (surl.charAt(0) == '#' || surl.charAt(0) == '=') {
104: setReader(new NativeLineReader(surl));
105: } else {
106: StringTokenizer st = new StringTokenizer(surl, ";");
107: IVVector urls = new IVVector();
108: while (st.hasMoreTokens()) {
109: url = IVUrl.newUrl(st.nextToken(), flashFile);
110: urls.addElement(url);
111: }
112: if (urls.size() > 1) {
113: url = null;
114: setReader(new MultipleUrlsReader(urls, flashFile));
115: } else {
116: if (!url.hasDataReady()) {
117: setReader(Util.getUrlReader(flashFile, url));
118: }
119: }
120: }
121: }
122:
123: /**
124: * Returns the datasource as two dimensional array of strings.
125: *
126: * @return datasource parsed to array of strings
127: * @exception IOException throws if there are some problems with reading the datasource
128: */
129: public String[][] getData() throws IOException {
130: if (url != null && url.hasDataReady())
131: return url.getData();
132: return super.getData();
133: }
134: }
|