01: /**
02: * Licensed to the Apache Software Foundation (ASF) under one or more
03: * contributor license agreements. See the NOTICE file distributed with
04: * this work for additional information regarding copyright ownership.
05: * The ASF licenses this file to You under the Apache License, Version 2.0
06: * (the "License"); you may not use this file except in compliance with
07: * the License. You may obtain a copy of the License at
08: *
09: * http://www.apache.org/licenses/LICENSE-2.0
10: *
11: * Unless required by applicable law or agreed to in writing, software
12: * distributed under the License is distributed on an "AS IS" BASIS,
13: * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14: * See the License for the specific language governing permissions and
15: * limitations under the License.
16: */package org.apache.geronimo.kernel.repository;
17:
18: import java.io.File;
19: import java.util.LinkedHashSet;
20:
21: /**
22: * Provides access to things like JARs via a standard API. This is
23: * a fairly limited read-only type repository. There are additional
24: * interfaces that a Repository may implement to indicate additional
25: * capabilities.
26: *
27: * @version $Rev: 604483 $ $Date: 2007-12-15 10:28:19 -0800 (Sat, 15 Dec 2007) $
28: */
29: public interface Repository {
30: /**
31: * Checks whether this repository contains an entry for the specified
32: * artifact. The artifact must be fully resolved (isResolved() == true).
33: */
34: boolean contains(Artifact artifact);
35:
36: /**
37: * Gets the location on disk where the specified artifact is stored.
38: * The artifact must be fully resolved (isResolved() == true).
39: *
40: * @return The location of the artifact, or null if it is not in this
41: * repository.
42: */
43: File getLocation(Artifact artifact);
44:
45: /**
46: * Loads any dependencies for this artifact declared in
47: * META-INF/geronimo-dependency.xml within the configuration archive. This
48: * does not do anything special if the artifact is a configuration (which
49: * means it doesn't see dependencies in the ConfigurationData, etc.) so
50: * it's mainly useful for JAR-type artifacts.
51: *
52: * @param artifact A fully-resolved artifact representing the repository
53: * entry you're interested in.
54: *
55: * @return a LinkedHashSet (with elements of type Artifact) listing any
56: * dependencies declared in META-INF/geronimo-dependency.xml for the
57: * specified artifact.
58: */
59: LinkedHashSet<Artifact> getDependencies(Artifact artifact);
60: }
|