com.google.cloud.tools.jib.cache

Class CacheReader

java.lang.Object

com.google.cloud.tools.jib.cache.CacheReader

public class CacheReader
extends java.lang.Object

Reads image content from the cache.

Constructor Summary

Constructors

Constructor and Description
CacheReader(Cache cache)

Method Summary

Modifier and Type	Method and Description
CachedLayer	getLayer(DescriptorDigest layerDigest)
java.nio.file.Path	getLayerFile(com.google.common.collect.ImmutableList<LayerEntry> layerEntries) Finds the file that stores the content BLOB for an application layer.
CachedLayerWithMetadata	getUpToDateLayerByLayerEntries(com.google.common.collect.ImmutableList<LayerEntry> layerEntries) Gets an up-to-date layer that is built from the sourceFiles.

Methods inherited from class java.lang.Object

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

Constructor Detail

CacheReader

public CacheReader(Cache cache)

Method Detail

getLayer

@Nullable
public CachedLayer getLayer(DescriptorDigest layerDigest)

Parameters:

layerDigest - the layer digest of the layer to get.

Returns:

the cached layer with digest layerDigest, or null if not found.

getLayerFile

@Nullable
public java.nio.file.Path getLayerFile(com.google.common.collect.ImmutableList<LayerEntry> layerEntries)
                                          throws CacheMetadataCorruptedException

Finds the file that stores the content BLOB for an application layer.

Parameters:

layerEntries - the entries for the layer content

Returns:

the newest cached layer file that matches the layerType and sourceFiles, or null if there is no match.

Throws:

CacheMetadataCorruptedException - if getting the cache metadata fails.

getUpToDateLayerByLayerEntries

@Nullable
public CachedLayerWithMetadata getUpToDateLayerByLayerEntries(com.google.common.collect.ImmutableList<LayerEntry> layerEntries)
                                                                 throws java.io.IOException,
                                                                        CacheMetadataCorruptedException

Gets an up-to-date layer that is built from the sourceFiles.

The method returns the first up-to-date layer found. This is safe because the source files will not have been modified since creation of any up-to-date layer (ie. all up-to-date layers should have the same file contents).

Parameters:

layerEntries - the layer's content entries

Returns:

an up-to-date layer containing the source files.

Throws:

java.io.IOException - if reading the source files fails.

CacheMetadataCorruptedException - if reading the cache metadata fails.