程序包 org.microbean.helm.chart.repository

类 ChartRepositoryRepository

java.lang.Object

org.microbean.helm.chart.resolver.AbstractChartResolver

org.microbean.helm.chart.repository.ChartRepositoryRepository

@Experimental
public class ChartRepositoryRepository
extends AbstractChartResolver

A repository of ChartRepository instances, normally built from a Helm repositories.yaml file.

作者:

Laird Nelson

嵌套类概要

嵌套类

修饰符和类型	类	说明
static interface	ChartRepositoryRepository.ChartRepositoryFactory	A factory for ChartRepository instances.

构造器概要

构造器

构造器	说明
ChartRepositoryRepository(Set<? extends ChartRepository> chartRepositories)	Creates a new ChartRepositoryRepository.

方法概要

修饰符和类型	方法	说明
static ChartRepositoryRepository	fromHelmRepositoriesYaml()	Creates and returns a new ChartRepositoryRepository from the contents of a repositories.yaml file typically located in the ~/.helm/repository directory.
static ChartRepositoryRepository	fromHelmRepositoriesYaml(boolean reifyHelmHomeIfNecessary)	Creates and returns a new ChartRepositoryRepository from the contents of a repositories.yaml file typically located in the ~/.helm/repository directory.
static ChartRepositoryRepository	fromYaml(InputStream stream)	Creates and returns a new ChartRepositoryRepository from the contents of a repositories.yaml file represented by the supplied InputStream.
static ChartRepositoryRepository	fromYaml(InputStream stream, boolean reifyHelmHomeIfNecessary)	Creates and returns a new ChartRepositoryRepository from the contents of a repositories.yaml file represented by the supplied InputStream.
static ChartRepositoryRepository	fromYaml(InputStream stream, Path archiveCacheDirectory, Path indexCacheDirectory)	Creates and returns a new ChartRepositoryRepository from the contents of a repositories.yaml file represented by the supplied InputStream.
static ChartRepositoryRepository	fromYaml(InputStream stream, Path archiveCacheDirectory, Path indexCacheDirectory, boolean reifyHelmHomeIfNecessary)	Creates and returns a new ChartRepositoryRepository from the contents of a repositories.yaml file represented by the supplied InputStream.
static ChartRepositoryRepository	fromYaml(InputStream stream, Path archiveCacheDirectory, Path indexCacheDirectory, boolean reifyHelmHomeIfNecessary, ChartRepositoryRepository.ChartRepositoryFactory factory)	Creates and returns a new ChartRepositoryRepository from the contents of a repositories.yaml file represented by the supplied InputStream.
static ChartRepositoryRepository	fromYaml(InputStream stream, Path archiveCacheDirectory, Path indexCacheDirectory, ChartRepositoryRepository.ChartRepositoryFactory factory)	Creates and returns a new ChartRepositoryRepository from the contents of a repositories.yaml file represented by the supplied InputStream.
Set<ChartRepository>	getChartRepositories()	Returns the non-null immutable Set of ChartRepository instances managed by this ChartRepositoryRepository.
ChartRepository	getChartRepository(String name)	Returns the ChartRepository managed by this ChartRepositoryRepository with the supplied name, or null if there is no such ChartRepository.
ChartOuterClass.Chart.Builder	resolve(String chartName, String chartVersion)	Uses the supplied chartName and chartVersion parameters to find an appropriate Helm chart and returns it in the form of a ChartOuterClass.Chart.Builder object.
ChartOuterClass.Chart.Builder	resolve(String repositoryName, String chartName, String chartVersion)	Uses the supplied repositoryName, chartName and chartVersion parameters to find an appropriate Helm chart and returns it in the form of a ChartOuterClass.Chart.Builder object.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

ChartRepositoryRepository

public ChartRepositoryRepository(Set<? extends ChartRepository> chartRepositories)

Creates a new ChartRepositoryRepository.

参数:

chartRepositories - the Set of ChartRepository instances to be managed by this ChartRepositoryRepository; may be null; copied by value

另请参阅:

getChartRepositories()

方法详细资料

getChartRepositories

public final Set<ChartRepository> getChartRepositories()

Returns the non-null immutable Set of ChartRepository instances managed by this ChartRepositoryRepository.

返回:

the non-null immutable Set of ChartRepository instances managed by this ChartRepositoryRepository

getChartRepository

public ChartRepository getChartRepository(String name)

Returns the ChartRepository managed by this ChartRepositoryRepository with the supplied name, or null if there is no such ChartRepository.

参数:

name - the name of the ChartRepository to return; must not be null

返回:

the ChartRepository managed by this ChartRepositoryRepository with the supplied name, or null

抛出:

NullPointerException - if name is null

resolve

public ChartOuterClass.Chart.Builder resolve(String chartName,
                                             String chartVersion)
                                      throws ChartResolverException

Uses the supplied chartName and chartVersion parameters to find an appropriate Helm chart and returns it in the form of a ChartOuterClass.Chart.Builder object.

Implementations of this method may return null.

This implementation splits the supplied slash-delimited chartName into a chart repository name and a chart name, uses the chart repository name to locate a suitable ChartRepository, and then calls ChartRepository.resolve(String, String) with the chart name and the supplied chartVersion, and returns the result.

指定者:

resolve 在类中 AbstractChartResolver

参数:

chartName - a slash-separated String whose first component is a chart repository name and whose second component is a Helm chart name; must not be null

chartVersion - the version of the chart to resolve; may be null in which case "latest" semantics are implied

返回:

a ChartOuterClass.Chart.Builder, or null

抛出:

ChartResolverException - if there was a problem with resolution

另请参阅:

resolve(String, String, String)

resolve

public ChartOuterClass.Chart.Builder resolve(String repositoryName,
                                             String chartName,
                                             String chartVersion)
                                      throws ChartResolverException

Uses the supplied repositoryName, chartName and chartVersion parameters to find an appropriate Helm chart and returns it in the form of a ChartOuterClass.Chart.Builder object.

This implementation uses the supplied repositoryName to locate a suitable ChartRepository, and then calls ChartRepository.resolve(String, String) with the chart name and the supplied chartVersion, and returns the result.

参数:

repositoryName - a chart repository name; must not be null

chartName - a Helm chart name; must not be null

chartVersion - the version of the Helm chart to select; may be null in which case "latest" semantics are implied

返回:

a ChartOuterClass.Chart.Builder, or null

抛出:

ChartResolverException - if there was a problem with resolution

NullPointerException - if repositoryName or chartName is null

另请参阅:

getChartRepository(String), ChartRepository.getName(), ChartRepository.resolve(String, String)

fromHelmRepositoriesYaml

public static final ChartRepositoryRepository fromHelmRepositoriesYaml()
                                                                throws IOException,
                                                                       URISyntaxException

Creates and returns a new ChartRepositoryRepository from the contents of a repositories.yaml file typically located in the ~/.helm/repository directory.

This method never returns null.

返回:

a new ChartRepositoryRepository; never null

抛出:

IOException - if there was a problem reading the file

URISyntaxException - if there was an invalid URI in the file

另请参阅:

fromHelmRepositoriesYaml(boolean)

fromHelmRepositoriesYaml

public static final ChartRepositoryRepository fromHelmRepositoriesYaml(boolean reifyHelmHomeIfNecessary)
                                                                throws IOException,
                                                                       URISyntaxException

Creates and returns a new ChartRepositoryRepository from the contents of a repositories.yaml file typically located in the ~/.helm/repository directory.

This method never returns null.

参数:

reifyHelmHomeIfNecessary - if true and, for whatever reason, the local Helm home directory structure needs to be partially or entirely created, then this method will attempt to reify it

返回:

a new ChartRepositoryRepository; never null

抛出:

IOException - if there was a problem reading the file or reifying the local Helm home directory structure

URISyntaxException - if there was an invalid URI in the file

另请参阅:

fromYaml(InputStream, Path, Path, boolean, ChartRepositoryFactory)

fromYaml

public static final ChartRepositoryRepository fromYaml(InputStream stream)
                                                throws IOException,
                                                       URISyntaxException

Creates and returns a new ChartRepositoryRepository from the contents of a repositories.yaml file represented by the supplied InputStream.

参数:

stream - the InputStream to read from; must not be null

返回:

a new ChartRepositoryRepository; never null

抛出:

IOException - if there was a problem reading the file

URISyntaxException - if there was an invalid URI in the file

另请参阅:

fromYaml(InputStream, Path, Path, boolean, ChartRepositoryFactory)

fromYaml

public static final ChartRepositoryRepository fromYaml(InputStream stream,
                                                       boolean reifyHelmHomeIfNecessary)
                                                throws IOException,
                                                       URISyntaxException

Creates and returns a new ChartRepositoryRepository from the contents of a repositories.yaml file represented by the supplied InputStream.

参数:

stream - the InputStream to read from; must not be null

reifyHelmHomeIfNecessary - if true and, for whatever reason, the local Helm home directory structure needs to be partially or entirely created, then this method will attempt to reify it

返回:

a new ChartRepositoryRepository; never null

抛出:

IOException - if there was a problem reading the file or reifying the local Helm home directory structure

URISyntaxException - if there was an invalid URI in the file

另请参阅:

fromYaml(InputStream, Path, Path, boolean, ChartRepositoryFactory)

fromYaml

public static final ChartRepositoryRepository fromYaml(InputStream stream,
                                                       Path archiveCacheDirectory,
                                                       Path indexCacheDirectory)
                                                throws IOException,
                                                       URISyntaxException

Creates and returns a new ChartRepositoryRepository from the contents of a repositories.yaml file represented by the supplied InputStream.

参数:

stream - the InputStream to read from; must not be null

archiveCacheDirectory - an absolute Path representing a directory where Helm chart archives may be stored; if null then a Path beginning with the absolute directory represented by the value of the helm.home system property, or the value of the HELM_HOME environment variable, appended with cache/archive will be used instead

indexCacheDirectory - an absolute Path representing a directory that the supplied cachedIndexPath parameter value will be considered to be relative to; will be ignored and hence may be null if the supplied cachedIndexPath parameter value Path.isAbsolute()

返回:

a new ChartRepositoryRepository; never null

抛出:

IOException - if there was a problem reading the file

URISyntaxException - if there was an invalid URI in the file

另请参阅:

fromYaml(InputStream, Path, Path, boolean, ChartRepositoryFactory)

fromYaml

public static final ChartRepositoryRepository fromYaml(InputStream stream,
                                                       Path archiveCacheDirectory,
                                                       Path indexCacheDirectory,
                                                       boolean reifyHelmHomeIfNecessary)
                                                throws IOException,
                                                       URISyntaxException

Creates and returns a new ChartRepositoryRepository from the contents of a repositories.yaml file represented by the supplied InputStream.

参数:

stream - the InputStream to read from; must not be null

archiveCacheDirectory - an absolute Path representing a directory where Helm chart archives may be stored; if null then a Path beginning with the absolute directory represented by the value of the helm.home system property, or the value of the HELM_HOME environment variable, appended with cache/archive will be used instead

indexCacheDirectory - an absolute Path representing a directory that the supplied cachedIndexPath parameter value will be considered to be relative to; will be ignored and hence may be null if the supplied cachedIndexPath parameter value Path.isAbsolute()

reifyHelmHomeIfNecessary - if true and, for whatever reason, the local Helm home directory structure needs to be partially or entirely created, then this method will attempt to reify it

返回:

a new ChartRepositoryRepository; never null

抛出:

IOException - if there was a problem reading the file or reifying the local Helm home directory structure

URISyntaxException - if there was an invalid URI in the file

另请参阅:

fromYaml(InputStream, Path, Path, boolean, ChartRepositoryFactory)

fromYaml

public static final ChartRepositoryRepository fromYaml(InputStream stream,
                                                       Path archiveCacheDirectory,
                                                       Path indexCacheDirectory,
                                                       ChartRepositoryRepository.ChartRepositoryFactory factory)
                                                throws IOException,
                                                       URISyntaxException

Creates and returns a new ChartRepositoryRepository from the contents of a repositories.yaml file represented by the supplied InputStream.

参数:

stream - the InputStream to read from; must not be null

archiveCacheDirectory - an absolute Path representing a directory where Helm chart archives may be stored; if null then a Path beginning with the absolute directory represented by the value of the helm.home system property, or the value of the HELM_HOME environment variable, appended with cache/archive will be used instead

indexCacheDirectory - an absolute Path representing a directory that the supplied cachedIndexPath parameter value will be considered to be relative to; will be ignored and hence may be null if the supplied cachedIndexPath parameter value Path.isAbsolute()

factory - a ChartRepositoryRepository.ChartRepositoryFactory that can create ChartRepository instances; may be null in which case the ChartRepository(String, URI, Path, Path, Path) constructor will be used instead

返回:

a new ChartRepositoryRepository; never null

抛出:

IOException - if there was a problem reading the file

URISyntaxException - if there was an invalid URI in the file

另请参阅:

fromYaml(InputStream, Path, Path, boolean, ChartRepositoryFactory)

fromYaml

public static final ChartRepositoryRepository fromYaml(InputStream stream,
                                                       Path archiveCacheDirectory,
                                                       Path indexCacheDirectory,
                                                       boolean reifyHelmHomeIfNecessary,
                                                       ChartRepositoryRepository.ChartRepositoryFactory factory)
                                                throws IOException,
                                                       URISyntaxException

Creates and returns a new ChartRepositoryRepository from the contents of a repositories.yaml file represented by the supplied InputStream.

参数:

stream - the InputStream to read from; must not be null

archiveCacheDirectory - an absolute Path representing a directory where Helm chart archives may be stored; if null then a Path beginning with the absolute directory represented by the value of the helm.home system property, or the value of the HELM_HOME environment variable, appended with cache/archive will be used instead

indexCacheDirectory - an absolute Path representing a directory that the supplied cachedIndexPath parameter value will be considered to be relative to; will be ignored and hence may be null if the supplied cachedIndexPath parameter value Path.isAbsolute()

reifyHelmHomeIfNecessary - if true and, for whatever reason, the local Helm home directory structure needs to be partially or entirely created, then this method will attempt to reify it

factory - a ChartRepositoryRepository.ChartRepositoryFactory that can create ChartRepository instances; may be null in which case the ChartRepository(String, URI, Path, Path, Path) constructor will be used instead

返回:

a new ChartRepositoryRepository; never null

抛出:

IOException - if there was a problem reading the file or reifying the local Helm home directory structure

URISyntaxException - if there was an invalid URI in the file