com.android.repository.impl.manager

Class LocalRepoLoaderImpl

java.lang.Object

com.android.repository.impl.manager.LocalRepoLoaderImpl

All Implemented Interfaces:

LocalRepoLoader

public final class LocalRepoLoaderImpl
extends java.lang.Object
implements LocalRepoLoader

A utility class that finds LocalPackages under a given path based on package.xml files.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	PACKAGE_XML_FN The name of the package metadata file we can read.

Constructor Summary

Constructors

Constructor and Description
LocalRepoLoaderImpl(java.io.File root, RepoManager manager, FallbackLocalRepoLoader fallback, FileOp fop) Constructor.

Method Summary

Modifier and Type	Method and Description
LocalPackage	getPackage(java.lang.String pathId, ProgressIndicator progress) Gets a single package, specified by String pathId, loading them if necessary.
java.util.Map<java.lang.String,LocalPackage>	getPackages(ProgressIndicator progress) Gets our packages, loading them if necessary.
boolean	needsUpdate(long lastLocalRefreshMs, boolean deepCheck) Checks whether it looks like we need to be reloaded.

Methods inherited from class java.lang.Object

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

Field Detail

PACKAGE_XML_FN

public static final java.lang.String PACKAGE_XML_FN

The name of the package metadata file we can read.

See Also:

Constant Field Values

Constructor Detail

LocalRepoLoaderImpl

public LocalRepoLoaderImpl(@NonNull
                           java.io.File root,
                           @NonNull
                           RepoManager manager,
                           @Nullable
                           FallbackLocalRepoLoader fallback,
                           @NonNull
                           FileOp fop)

Constructor. Probably should only be used within repository framework.

Parameters:

root - The root directory under which we'll look for packages.

manager - A RepoManager, notably containing the SchemaModules we'll use for reading and writing LocalPackages

fallback - The FallbackLocalRepoLoader we'll use if we can't find a package in a directory.

fop - The FileOp to use for file operations. Should be FileOpUtils.create() for normal operation.

Method Detail

getPackages

@NonNull
public java.util.Map<java.lang.String,LocalPackage> getPackages(@NonNull
                                                                         ProgressIndicator progress)

Description copied from interface: LocalRepoLoader

Gets our packages, loading them if necessary.

Specified by:

getPackages in interface LocalRepoLoader

Parameters:

progress - A ProgressIndicator used to show progress (unimplemented) and logging.

Returns:

A map of install path to LocalPackage, containing all the packages found in the given root.

getPackage

@Nullable
public LocalPackage getPackage(@NonNull
                                         java.lang.String pathId,
                                         @NonNull
                                         ProgressIndicator progress)

Description copied from interface: LocalRepoLoader

Gets a single package, specified by String pathId, loading them if necessary.

This doesn't affect the overall caching mechanism of this instance.

Specified by:

getPackage in interface LocalRepoLoader

Parameters:

pathId - The path id that specifies this package. See DetailsTypes.

progress - A ProgressIndicator used to show progress (unimplemented) and logging.

Returns:

A the LocalPackage for pathId or null if the package was not found.

needsUpdate

public boolean needsUpdate(long lastLocalRefreshMs,
                           boolean deepCheck)

Checks whether it looks like we need to be reloaded. If deepCheck is false, we just check whether .knownPackages has been updated more recently than lastLocalRefreshMs. If deepCheck is true, we check whether the hash in .knownPackages accurately reflects the currently-installed packages (traversing the SDK directory tree to do so).

Specified by:

needsUpdate in interface LocalRepoLoader

Parameters:

lastLocalRefreshMs - The last time a load was done

deepCheck - How vigorously to check. If false, the check should be quite fast. If true it should still be reasonably fast, but less so.

Returns:

true if a reload is needed, false otherwise.