(no commit message)
[utils] / src / org / wamblee / io / InputResource.java
1 /*
2  * Copyright 2005 the original author or authors.
3  * 
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  * 
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  * 
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */ 
16 package org.wamblee.io;
17
18 import java.io.IOException;
19 import java.io.InputStream;
20
21
22 /**
23  * Represents a resource from which information can be read.
24  */
25 public interface InputResource {
26     /**
27      * Gets the input stream to the resource. The obtained input stream 
28      * must be closed once reading has finished. 
29      * 
30      * @return Input stream to the resource, never null.
31      * @throws IOException in case the resource cannot be found.
32      */
33     InputStream getInputStream(  ) throws IOException;
34 }