View Javadoc

1   /***
2    * Copyright 2006 Joseph M. Ferner
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 com.fernsroth.easyio;
17  
18  import java.io.IOException;
19  
20  /***
21   * 
22   * @author Joseph M. Ferner (Near Infinity Corporation)
23   */
24  public interface IRandomAccessSource extends IInputStream, IOutputStream {
25      /***
26       * sets the location.
27       * @param newLocation the location.
28       * @throws IOException 
29       */
30      void seek(long newLocation) throws IOException;
31  
32      /***
33       * gets the current location.
34       * @return the current location.
35       * @throws IOException 
36       */
37      long getFilePointer() throws IOException;
38  
39      /***
40       * sets the length.
41       * @param length the length.
42       * @throws IOException
43       */
44      void setLength(long length) throws IOException;
45  
46      /***
47       * gets the length.
48       * @return the length.
49       * @throws IOException
50       */
51      long length() throws IOException;
52  }