1 /*
2  * Copyright (C) 2013 The Android Open Source Project
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 
17 package com.android.multidex;
18 
19 import java.io.IOException;
20 import java.io.InputStream;
21 
22 /**
23  * An element of the class path in which class files can be found.
24  */
25 interface ClassPathElement {
26 
27     char SEPARATOR_CHAR = '/';
28 
29     /**
30      * Open a "file" from this {@code ClassPathElement}.
31      * @param path a '/' separated relative path to the wanted file.
32      * @return an {@code InputStream} ready to read the requested file.
33      * @throws IOException if the path can not be found or if an error occurred while opening it.
34      */
open(String path)35     InputStream open(String path) throws IOException;
36 
close()37     void close() throws IOException;
38 
list()39     Iterable<String> list();
40 
41 }
42