KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > openlaszlo > iv > flash > util > UrlDataSource


1 /*
2  * $Id: UrlDataSource.java,v 1.3 2002/04/26 05:23:11 skavish Exp $
3  *
4  * ===========================================================================
5  *
6  * The JGenerator Software License, Version 1.0
7  *
8  * Copyright (c) 2000 Dmitry Skavish (skavish@usa.net). All rights reserved.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions are met:
12  *
13  * 1. Redistributions of source code must retain the above copyright
14  * notice, this list of conditions and the following disclaimer.
15  *
16  * 2. Redistributions in binary form must reproduce the above copyright
17  * notice, this list of conditions and the following disclaimer in
18  * the documentation and/or other materials provided with the
19  * distribution.
20  *
21  * 3. The end-user documentation included with the redistribution, if
22  * any, must include the following acknowlegement:
23  * "This product includes software developed by Dmitry Skavish
24  * (skavish@usa.net, http://www.flashgap.com/)."
25  * Alternately, this acknowlegement may appear in the software itself,
26  * if and wherever such third-party acknowlegements normally appear.
27  *
28  * 4. The name "The JGenerator" must not be used to endorse or promote
29  * products derived from this software without prior written permission.
30  * For written permission, please contact skavish@usa.net.
31  *
32  * 5. Products derived from this software may not be called "The JGenerator"
33  * nor may "The JGenerator" appear in their names without prior written
34  * permission of Dmitry Skavish.
35  *
36  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
37  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
38  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
39  * DISCLAIMED. IN NO EVENT SHALL DMITRY SKAVISH OR THE OTHER
40  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
41  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
42  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
43  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
44  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
45  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
46  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
47  * SUCH DAMAGE.
48  *
49  */
50
51 package org.openlaszlo.iv.flash.util;
52
53 import java.io.*;
54 import java.net.*;
55 import java.util.*;
56 import org.openlaszlo.iv.flash.api.*;
57 import org.openlaszlo.iv.flash.url.*;
58
59 /**
60  * Text datasource.
61  * <P>
62  * This class reads and creates text datasource from:
63  * <UL>
64  * <LI>a string
65  * <LI>an url
66  * <LI>list of url, seperated by semicolon
67  * </UL>
68  *
69  * @author Dmitry Skavish
70  * @see XMLDataSource
71  */
72 public class UrlDataSource extends DataSource {
73
74     private IVUrl url;
75
76     public UrlDataSource() {}
77
78     /**
79      * Creates datasource from specified string in the context of FlashFile.
80      *
81      * @param surl string representing the datasource<BR>
82      * can be one of the following:<BR>
83      * <UL>
84      * <LI>data itself if prefixed with '#'
85      * <LI>url pointing to text datasource
86      * <LI>several urls to text datasources, separated by semicolon
87      * </UL>
88      * @param flashFile flash file in the context of which this datasource is created<BR>
89      * if datasource is given by relative url, then this flash file can be used
90      * to resolve this relative url to an absolute one
91      * @exception IVException thrown if there are some problems with parsing the datasource
92      * @exception IOException thrown if there are some problems with reading the datasource
93      */
94     public UrlDataSource( String JavaDoc surl, FlashFile flashFile ) throws IVException, IOException {
95         url = null;
96
97         if( surl == null || surl.length() == 0 ) {
98             throw new IOException( "null datasource" );
99         }
100
101         if( surl.charAt(0) == '#' || surl.charAt(0) == '=' ) {
102             setReader( new NativeLineReader(surl) );
103         } else {
104             StringTokenizer st = new StringTokenizer(surl, ";");
105             IVVector urls = new IVVector();
106             while( st.hasMoreTokens() ) {
107                 url = IVUrl.newUrl( st.nextToken(), flashFile );
108                 urls.addElement(url);
109             }
110             if( urls.size() > 1 ) {
111                 url = null;
112                 setReader( new MultipleUrlsReader(urls, flashFile) );
113             } else {
114                 if( !url.hasDataReady() ) {
115                     setReader(Util.getUrlReader(flashFile, url));
116                 }
117             }
118         }
119     }
120
121     /**
122      * Returns the datasource as two dimensional array of strings.
123      *
124      * @return datasource parsed to array of strings
125      * @exception IOException throws if there are some problems with reading the datasource
126      */
127     public String JavaDoc[][] getData() throws IOException {
128         if( url != null && url.hasDataReady() ) return url.getData();
129         return super.getData();
130     }
131 }
Popular Tags