co.codewizards.cloudstore.local

Class LocalRepoManagerFactoryImpl

java.lang.Object

co.codewizards.cloudstore.local.LocalRepoManagerFactoryImpl

All Implemented Interfaces:

LocalRepoManagerFactory

public class LocalRepoManagerFactoryImpl
extends Object
implements LocalRepoManagerFactory

Registry of LocalRepoManagers.

There is one single instance of this registry. It serves as the central point to obtain LocalRepoManagers.

Author:

Marco หงุ่ยตระกูล-Schulze - marco at codewizards dot co

Nested Class Summary

Nested classes/interfaces inherited from interface co.codewizards.cloudstore.core.repo.local.LocalRepoManagerFactory

LocalRepoManagerFactory.Helper

Constructor Summary

Constructors

Constructor and Description
LocalRepoManagerFactoryImpl()

Method Summary

Methods

Modifier and Type	Method and Description
void	addLocalRepoManagerCloseListener(LocalRepoManagerCloseListener listener)
void	close()
LocalRepoManager	createLocalRepoManagerForExistingRepository(File localRoot) Creates a LocalRepoManager for the given localRoot.
LocalRepoManager	createLocalRepoManagerForNewRepository(File localRoot) Creates a LocalRepoManager for the given localRoot.
Set<File>	getLocalRoots()
void	removeLocalRepoManagerCloseListener(LocalRepoManagerCloseListener listener)

Methods inherited from class java.lang.Object

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

Constructor Detail

LocalRepoManagerFactoryImpl

public LocalRepoManagerFactoryImpl()

Method Detail

getLocalRoots

public Set<File> getLocalRoots()

Specified by:

getLocalRoots in interface LocalRepoManagerFactory

createLocalRepoManagerForExistingRepository

public LocalRepoManager createLocalRepoManagerForExistingRepository(File localRoot)
                                                             throws LocalRepoManagerException

Description copied from interface: LocalRepoManagerFactory

Creates a LocalRepoManager for the given localRoot.

Important: You must call LocalRepoManager.close(). Use a try-finally block or a similar construction to prevent resource leakage!

If there is already a LocalRepoManager implementation instance for this localRoot, the same instance is re-used in the background. If there is none, yet, it is implicitly instantiated and enlisted. However, this method always returns a new proxy instance! It never returns the same instance twice.

If localRoot is not an existing repository in the file system, one of the following exceptions is thrown:

• FileNotFoundException
• FileNoDirectoryException
• FileNoRepositoryException

Specified by:

createLocalRepoManagerForExistingRepository in interface LocalRepoManagerFactory

Parameters:

localRoot - the root-directory of the repository. Must not be null. Can be relative or absolute.

Returns:

the LocalRepoManagerImpl for the given localRoot. Never null.

Throws:

LocalRepoManagerException - if the given localRoot does not denote the root-directory of an existing repository.

See Also:

LocalRepoManagerFactory.createLocalRepoManagerForNewRepository(File)

createLocalRepoManagerForNewRepository

public LocalRepoManager createLocalRepoManagerForNewRepository(File localRoot)
                                                        throws LocalRepoManagerException

Description copied from interface: LocalRepoManagerFactory

Creates a LocalRepoManager for the given localRoot.

Important: You must call LocalRepoManager.close(). Use a try-finally block or a similar construction to prevent resource leakage!

This method turns an existing directory into a repository. If localRoot already is a repository, a FileAlreadyRepositoryException is thrown.

If localRoot is not an existing directory in the file system, one of the following exceptions is thrown:

• FileNotFoundException
• FileNoDirectoryException

Specified by:

createLocalRepoManagerForNewRepository in interface LocalRepoManagerFactory

Parameters:

localRoot - the directory which is turned into the repository's root. Must not be null. Can be relative or absolute.

Returns:

the LocalRepoManager for the given localRoot. Never null.

Throws:

LocalRepoManagerException - if the given localRoot does not denote an existing directory or if it is a directory inside an existing repository.

close

public void close()

Specified by:

close in interface LocalRepoManagerFactory

addLocalRepoManagerCloseListener

public void addLocalRepoManagerCloseListener(LocalRepoManagerCloseListener listener)

Specified by:

addLocalRepoManagerCloseListener in interface LocalRepoManagerFactory

removeLocalRepoManagerCloseListener

public void removeLocalRepoManagerCloseListener(LocalRepoManagerCloseListener listener)

Specified by:

removeLocalRepoManagerCloseListener in interface LocalRepoManagerFactory