01: /*
02: * Copyright 2007 Google Inc.
03: *
04: * Licensed under the Apache License, Version 2.0 (the "License"); you may not
05: * use this file except in compliance with the License. You may obtain a copy of
06: * the License at
07: *
08: * http://www.apache.org/licenses/LICENSE-2.0
09: *
10: * Unless required by applicable law or agreed to in writing, software
11: * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
12: * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
13: * License for the specific language governing permissions and limitations under
14: * the License.
15: */
16: package com.google.gwt.dev.cfg;
17:
18: import java.net.URL;
19:
20: /**
21: * Abstracts the process of querying for public files.
22: */
23: public interface PublicOracle {
24:
25: /**
26: * Finds a file on the public path.
27: *
28: * @param partialPath a file path relative to the root of any public package
29: * @return the url of the file, or <code>null</code> if no such file exists
30: */
31: URL findPublicFile(String partialPath);
32:
33: /**
34: * Returns all available public files.
35: *
36: * @return an array containing the partial path to each available public file
37: */
38: String[] getAllPublicFiles();
39: }
|