Class SVNRepositoryFactory

public static SVNRepository create(SVNURL url)
            throws SVNException

Creates an SVNRepository driver according to the protocol that is to be used to access a repository.

The protocol is defined as the beginning part of the URL schema. Currently SVNKit supports only svn:// (svn+ssh://) and http:// (https://) schemas.

The created SVNRepository driver can later be "reused" for another location - that is you can switch it to another repository url not to create yet one more SVNRepository object. Use the SVNRepository.setLocation() method for this purpose.

An SVNRepository driver created by this method uses a default session options driver (ISVNSession.DEFAULT) which does not allow to keep a single socket connection opened and commit log messages caching.

Parameters:

url - a repository location URL

Returns:

a protocol specific SVNRepository driver

Throws:

SVNException - if there's no implementation for the specified protocol (the user may have forgotten to register a specific factory that creates SVNRepository instances for that protocol or the SVNKit library does not support that protocol at all)

See Also:

create(SVNURL,ISVNSession), SVNRepository

public static SVNRepository create(SVNURL url,
                                   ISVNSession options)
            throws SVNException

Creates an SVNRepository driver according to the protocol that is to be used to access a repository.

The protocol is defined as the beginning part of the URL schema. Currently SVNKit supports only svn:// (svn+ssh://) and http:// (https://) schemas.

The created SVNRepository driver can later be "reused" for another location - that is you can switch it to another repository url not to create yet one more SVNRepository object. Use the SVNRepository.setLocation() method for this purpose.

This method allows to customize a session options driver for an SVNRepository driver. A session options driver must implement the ISVNSession interface. It manages socket connections - says whether an SVNRepository driver may use a single socket connection during the runtime, or it should open a new connection per each repository access operation. And also a session options driver may cache and provide commit log messages during the runtime.

Parameters:

url - a repository location URL

options - a session options driver

Returns:

a protocol specific SVNRepository driver

Throws:

SVNException - if there's no implementation for the specified protocol (the user may have forgotten to register a specific factory that creates SVNRepository instances for that protocol or the SVNKit library does not support that protocol at all)

See Also:

create(SVNURL), SVNRepository

public static SVNURL createLocalRepository(File path,
                                           String uuid,
                                           boolean enableRevisionProperties,
                                           boolean force)
            throws SVNException

Creates a local blank FSFS-type repository. This is just similar to the Subversion's command: svnadmin create --fs-type=fsfs REPOS_PATH. The resultant repository is absolutely format-compatible with Subversion.

If uuid is null or not 36 chars wide, the method generates a new UUID for the repository. This UUID would have the same format as if it's generated by Subversion itself.

If enableRevisionProperties is true then the method creates a pre-revprop-change executable file inside the "hooks" subdir of the repository tree. This executable file simply returns 0 thus allowing revision property modifications, which are not permitted, unless one puts such a hook into that very directory.

If force is true and path already exists, deletes that path and creates a repository in its place.

A call to this routine is equivalent to createLocalRepository(path, uuid, enableRevisionProperties, force, false).

Parameters:

path - a repository root location

uuid - a repository's uuid

enableRevisionProperties - enables or not revision property modifications

force - forces operation to run

Returns:

a local URL (file:///) of a newly created repository

Throws:

SVNException -

Since:

1.1

See Also:

createLocalRepository(File,String,boolean,boolean,boolean)

public static SVNURL createLocalRepository(File path,
                                           String uuid,
                                           boolean enableRevisionProperties,
                                           boolean force,
                                           boolean pre14Compatible)
            throws SVNException

Creates a local blank FSFS-type repository. This is just similar to the Subversion's command: svnadmin create --fs-type=fsfs REPOS_PATH. The resultant repository is absolutely format-compatible with Subversion.

If uuid is null or not 36 chars wide, the method generates a new UUID for the repository. This UUID would have the same format as if it's generated by Subversion itself.

If enableRevisionProperties is true then the method creates a pre-revprop-change executable file inside the "hooks" subdir of the repository tree. This executable file simply returns 0 thus allowing revision property modifications, which are not permitted, unless one puts such a hook into that very directory.

If force is true and path already exists, deletes that path and creates a repository in its place.

Set pre14Compatible to true if you want a new repository to be compatible with pre-1.4 servers.

Parameters:

path - a repository root location

uuid - a repository's uuid

enableRevisionProperties - enables or not revision property modifications

force - forces operation to run

pre14Compatible - true to create a repository with pre-1.4 format

Returns:

a local URL (file:///) of a newly created repository

Throws:

SVNException -

Since:

1.1.1

public static SVNURL createLocalRepository(File path,
                                           boolean enableRevisionProperties,
                                           boolean force)
            throws SVNException

Creates a local blank FSFS-type repository. A call to this routine is equivalent to createLocalRepository(path, null, enableRevisionProperties, force).

Parameters:

path - a repository root location

enableRevisionProperties - enables or not revision property modifications

force - forces operation to run

Returns:

a local URL (file:///) of a newly created repository

Throws:

SVNException -

Since:

1.1

See Also:

createLocalRepository(File,String,boolean,boolean)

protected abstract SVNRepository createRepositoryImpl(SVNURL url,
                                                      ISVNSession session)

protected static void registerRepositoryFactory(String protocol,
                                                SVNRepositoryFactory factory)