Package org.apache.karaf.features.internal.service

Interface RepositoryCache

All Known Implementing Classes:

RepositoryCacheImpl

public interface RepositoryCache

An interface for accessing repository/features information. Simple implementations may just map feature XMLs directly to JAXB model (see: Features).

In more complex cases, additional processing (blacklisting, overrides, patching) may be performed.

Method Summary

Modifier and Type	Method	Description
void	addRepository(Repository repository)	Adds existing Repository to be tracked/managed by this cache and later be available e.g., via getRepository(String)
Repository	create(URI uri, boolean validate)	Creates Repository without adding it to cache
Repository	getRepository(String uri)	Gets Repository by its URI
Repository	getRepositoryByName(String name)	Gets Repository by its name
Set<Repository>	getRepositoryClosure(Repository repo)	Returns a set of repositories including passed repository and all referenced repositories.
Repository[]	listMatchingRepositories(Set<String> uris)	Returns an array of cached repositories for a set of repository URIs
Repository[]	listRepositories()	Returns an array of all cached repositories
void	removeRepository(URI repositoryUri)	Removes existing Repository by its URI

Method Detail

create

Repository create(URI uri,
                  boolean validate)

Creates Repository without adding it to cache

Parameters:

uri - an URI (e.g., mvn:groupId/artifactId/version/xml/features of repository

validate - whether to perform XML Schema validation of loaded features XML

Returns:

a Repository that may be inspected or added to cache

addRepository

void addRepository(Repository repository)

Adds existing Repository to be tracked/managed by this cache and later be available e.g., via getRepository(String)

Parameters:

repository - existing repository to add to cache

removeRepository

void removeRepository(URI repositoryUri)

Removes existing Repository by its URI

Parameters:

repositoryUri - URI of the Repository to remove

getRepository

Repository getRepository(String uri)

Gets Repository by its URI

Parameters:

uri - URI of the repository

Returns:

Repository as it's stored inside the cache

getRepositoryByName

Repository getRepositoryByName(String name)

Gets Repository by its name

Parameters:

name - Name of the repository

Returns:

Repository as it's stored inside the cache

listRepositories

Repository[] listRepositories()

Returns an array of all cached repositories

Returns:

list of all repositories

listMatchingRepositories

Repository[] listMatchingRepositories(Set<String> uris)

Returns an array of cached repositories for a set of repository URIs

Returns:

list of matched repositories

getRepositoryClosure

Set<Repository> getRepositoryClosure(Repository repo)

Returns a set of repositories including passed repository and all referenced repositories.

Parameters:

repo - A Repository, that possibly references other feature repositories.

Returns:

A closure of repositories