View Javadoc

1   ////////////////////////////////////////////////////////////////////////////////
2   // MillScript: an Open Spice interpreter and batch website creation tool
3   // Copyright (C) 2004-2005 Kevin Rogers
4   //
5   // This file is part of MillScript.
6   //
7   // MillScript is free software; you can redistribute it and/or modify it under
8   // the terms of the GNU General Public License as published by the Free
9   // Software Foundation; either version 2 of the License, or (at your option)
10  // any later version.
11  //
12  // MillScript is distributed in the hope that it will be useful, but WITHOUT
13  // ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
14  // FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
15  // more details.
16  //
17  // You should have received a copy of the GNU General Public License along with
18  // MillScript; if not, write to the Free Software Foundation, Inc., 59 Temple
19  // Place, Suite 330, Boston, MA  02111-1307  USA
20  ////////////////////////////////////////////////////////////////////////////////
21  package org.millscript.millscript;
22  
23  import org.millscript.millscript.alert.Alerts;
24  
25  import java.io.IOException;
26  import java.io.InputStream;
27  import java.net.URL;
28  
29  /**
30   * This class represents a URL as a source of information.
31   */
32  public class URLSource extends Source {
33  
34      /**
35       * The URL this source will read from.
36       */
37      private URL url;
38  
39      /**
40       * Constructs a new URL source for the specified URL.
41       *
42       * @param u the source URL
43       */
44      public URLSource( final URL u ) {
45          this.url = u;
46      }
47  
48      /**
49       * @see org.millscript.millscript.Source#getInputStream()
50       */
51      @Override
52      public final InputStream getInputStream() {
53          try {
54              return this.url.openStream();
55          } catch ( IOException ex ) {
56              throw(
57                  Alerts.compile(
58                      "Problem opening URL for reading",
59                      null
60                  ).
61                  culprit( "source", getOrigin() ).
62                  culprit( "reason", ex.getMessage() ).
63                  mishap()
64              );
65          }
66      }
67  
68      /**
69       * @see org.millscript.millscript.Source#getOrigin()
70       */
71      @Override
72      public final String getOrigin() {
73          return this.url.getPath();
74      }
75  
76      /**
77       * @see org.millscript.millscript.Source#getOriginURL()
78       */
79      @Override
80      public URL getOriginURL() {
81          return this.url;
82      }
83  
84  }