KickJava   Java API By Example, From Geeks To Geeks.

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


1 /*
2  * $Id: DataSourceHelper.java,v 1.5 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.util.*;
55
56 import org.openlaszlo.iv.flash.api.*;
57 import org.openlaszlo.iv.flash.url.*;
58 import org.openlaszlo.iv.flash.xml.*;
59
60 import org.w3c.dom.*;
61
62 /**
63  * Helper class for reading any kind of datasources.
64  *
65  * @author Dmitry Skavish
66  * @see XMLDataSource
67  * @see DataSource
68  */
69 public class DataSourceHelper {
70
71     /**
72      * Reads datasource from given url, detects it's type: xml or text
73      * and creates either LineReader (text) or else (xml)<P>
74      * Datasources can be specified by url or inline. If url starts
75      * with '#' then this is inline datasource which is completely given
76      * in the url string.
77      *
78      * @param surl url or inline datasource
79      * @param flashFile current flash file from which this datasource is requested
80      * @return either LineReader (plain datasource) or IVUrl
81      * @exception IOException
82      * @exception IVException
83      */
84     public static Object JavaDoc readContextData( String JavaDoc surl, FlashFile flashFile )
85         throws IVException, IOException
86     {
87         if( surl == null || surl.length() == 0 ) {
88             throw new IOException( "null datasource" );
89         }
90
91         Object JavaDoc dsrc = null;
92
93         if( surl.charAt(0) == '#' ) {
94             if( surl.charAt(1) == '<' ) {
95                 // xml datasource
96 byte[] bytes = flashFile.getEncoding() != null?
97                                     surl.substring(1).getBytes(flashFile.getEncoding()):
98                                     PropertyManager.defaultEncoding != null?
99                                         surl.substring(1).getBytes(PropertyManager.defaultEncoding):
100                                         surl.substring(1).getBytes();
101                 dsrc = new BufferedUrl( new FlashBuffer(bytes) );
102             } else {
103                 // text datasource
104 dsrc = new NativeLineReader(surl);
105             }
106         } else {
107             int idx = surl.indexOf(';');
108             if( idx == -1 ) {
109                 dsrc = new BufferedUrl( surl, flashFile );
110             } else {
111                 StringTokenizer st = new StringTokenizer(surl, ";");
112                 IVVector urls = new IVVector();
113                 while( st.hasMoreTokens() ) {
114                     IVUrl url = IVUrl.newUrl( st.nextToken(), flashFile );
115                     urls.addElement(url);
116                 }
117                 dsrc = new MultipleUrlsReader(urls, flashFile);
118             }
119         }
120
121         if( dsrc instanceof BufferedUrl ) {
122             BufferedUrl burl = (BufferedUrl) dsrc;
123             byte[] buf = burl.getFlashBuffer().getBuf();
124             if( !(buf.length > 3 && (buf[0] == '<' || (buf[0] == -1 && buf[1] == -2 && buf[2] == '<'))) ) {
125                 dsrc = Util.getUrlReader(flashFile, burl);
126             }
127         }
128
129         return dsrc;
130     }
131
132     /**
133      * Return context data.<p>
134      * Reads datasource from given url, detects it's type: xml or text
135      * and creates either xml Node or array of strings.<P>
136      * Datasources can be specified by url or inline. If url starts
137      * with '#' then this is inline datasource which is completely given
138      * in the utl string.
139      *
140      * @param surl url or inline datasource
141      * @param flashFile current flash file from which this datasource is requested
142      * @return either Node or String[][]
143      * @exception IVException
144      * @exception IOException
145      */
146     public static Object JavaDoc getContextData( String JavaDoc surl, FlashFile flashFile )
147         throws IVException, IOException
148     {
149         Object JavaDoc dsrc = readContextData(surl, flashFile);
150
151         if( dsrc instanceof LineReader ) {
152             DataSource ds = new DataSource( (LineReader) dsrc );
153             String JavaDoc[][] data = ds.getData();
154             return data;
155         } else {
156             try {
157                 return XMLHelper.getNode( (IVUrl) dsrc );
158             } catch( Exception JavaDoc e ) { // otherwise it requires xml libs to be in classpath
159 if( e instanceof IOException ) throw (IOException) e;
160                 throw new IVException(e);
161             }
162         }
163
164     }
165
166 }
167
Popular Tags