org.openl.rules.repository.db

Class DBRepository

java.lang.Object

org.openl.rules.repository.db.DBRepository

All Implemented Interfaces:

Closeable, AutoCloseable, Repository, RRepositoryFactory

Direct Known Subclasses:

DatasourceDBRepositoryFactory, JdbcDBRepositoryFactory

public abstract class DBRepository
extends Object
implements Repository, Closeable, RRepositoryFactory

Constructor Summary

Constructors

Constructor and Description
DBRepository()

Method Summary

Modifier and Type	Method and Description
FileData	check(String name) Read a file descriptor by the given path name.
FileData	checkHistory(String name, String version) Read a file descriptor by the given path name of the given version.
void	close()
FileData	copyHistory(String srcName, FileData destData, String version) Copy a file of the given version to the destination file.
boolean	delete(FileData path) Delete a file or mark it as deleted.
boolean	deleteHistory(FileData data) Delete a file from the history.
protected abstract Connection	getConnection()
void	initialize() Initialize factory.
List<FileData>	list(String path) Return a list of files recursively in the given folder.
List<FileData>	listHistory(String name) List a versions of the given file.
FileItem	read(String name) Read a file by the given path name.
FileItem	readHistory(String name, String version) Read a file by the given path name of the given version.
protected void	safeClose(Connection connection)
protected void	safeClose(ResultSet rs)
protected void	safeClose(Statement st)
FileData	save(FileData data, InputStream stream) Save a file.
List<FileData>	save(List<FileItem> fileItems) Save multiple projects in one transaction.
void	setListener(Listener callback) Set a listener to monitor changes in the repository.
Features	supports() Get the features supported by the repository.

Methods inherited from class java.lang.Object

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

Constructor Detail

DBRepository

public DBRepository()

Method Detail

list

public List<FileData> list(String path)
                    throws IOException

Description copied from interface: Repository

Return a list of files recursively in the given folder.

Specified by:

list in interface Repository

Parameters:

path - the folder to scan. The path must be ended by '/' or be empty.

Returns:

the list of the file descriptors. Invalid files are ignored.

Throws:

IOException - if not possible to read the directory.

check

public FileData check(String name)
               throws IOException

Description copied from interface: Repository

Read a file descriptor by the given path name.

Specified by:

check in interface Repository

Parameters:

name - the path name of the file to read.

Returns:

the file descriptor or null if the file is absent.

Throws:

IOException - if not possible to read the file descriptor.

read

public FileItem read(String name)
              throws IOException

Description copied from interface: Repository

Read a file by the given path name.

Specified by:

read in interface Repository

Parameters:

name - the path name of the file to read.

Returns:

the file descriptor or null if the file is absent.

Throws:

IOException - if not possible to read the file.

save

public FileData save(FileData data,
                     InputStream stream)
              throws IOException

Description copied from interface: Repository

Save a file.

Specified by:

save in interface Repository

Parameters:

data - the file descriptor.

stream - the stream to save with the specified file descriptor.

Returns:

the resulted file descriptor after successful writing.

Throws:

IOException - if not possible to save the file.

save

public List<FileData> save(List<FileItem> fileItems)
                    throws IOException

Description copied from interface: Repository

Save multiple projects in one transaction. Used only in deployment services

Specified by:

save in interface Repository

Parameters:

fileItems - list of file descriptor and stream pairs

Throws:

IOException - if not possible to save the file.

delete

public boolean delete(FileData path)
               throws IOException

Description copied from interface: Repository

Delete a file or mark it as deleted.

Specified by:

delete in interface Repository

Parameters:

path - the file descriptor to delete.

Returns:

true if file has been deleted successfully or false if the file is absent.

Throws:

IOException - if not possible to delete the file.

setListener

public void setListener(Listener callback)

Description copied from interface: Repository

Set a listener to monitor changes in the repository.

Specified by:

setListener in interface Repository

Parameters:

callback - the listener.

listHistory

public List<FileData> listHistory(String name)
                           throws IOException

Description copied from interface: Repository

List a versions of the given file. If the repository does not support file versions, then it will return one record of the given file. The order of the file descriptions is undefined, but the first element is the actual file which can be access by Repository.read(String) method.

Specified by:

listHistory in interface Repository

Parameters:

name - the file name.

Returns:

the list of file descriptions.

Throws:

IOException - if not possible to read the directory.

checkHistory

public FileData checkHistory(String name,
                             String version)
                      throws IOException

Description copied from interface: Repository

Read a file descriptor by the given path name of the given version. If the version is null, then it will work like Repository.check(String) method.

Specified by:

checkHistory in interface Repository

Parameters:

name - the path name of the file to read.

version - the version of the file to read, can be null.

Returns:

the file descriptor or null if the file is absent.

Throws:

IOException - if not possible to read the file descriptor.

See Also:

Repository.read(String)

readHistory

public FileItem readHistory(String name,
                            String version)
                     throws IOException

Description copied from interface: Repository

Read a file by the given path name of the given version. If the version is null, then it will work like Repository.read(String) method.

Specified by:

readHistory in interface Repository

Parameters:

name - the path name of the file to read.

version - the version of the file to read, can be null.

Returns:

the file descriptor or null if the file is absent.

Throws:

IOException - if not possible to read the file.

See Also:

Repository.read(String)

deleteHistory

public boolean deleteHistory(FileData data)
                      throws IOException

Description copied from interface: Repository

Delete a file from the history. If the version is null, then it will delete all versions of the file from the history.

Specified by:

deleteHistory in interface Repository

Parameters:

data - the file descriptor to delete. The fields "name", "version", "author" and "comment" must be initialized.

Returns:

true if file has been deleted successfully or false if the file is absent.

Throws:

IOException - if not possible to delete the file.

See Also:

Repository.delete(FileData)

copyHistory

public FileData copyHistory(String srcName,
                            FileData destData,
                            String version)
                     throws IOException

Description copied from interface: Repository

Copy a file of the given version to the destination file. If the version is null, then copy latest version.

Specified by:

copyHistory in interface Repository

Parameters:

srcName - the file to copy.

destData - the destination file descriptor.

version - the version of the file to copy

Returns:

the file descriptor of the resulted file.

Throws:

IOException - if not possible to copy the file

supports

public Features supports()

Description copied from interface: Repository

Get the features supported by the repository. If specific feature is supported, repository instance can be casted to interface class that support that feature.

Specified by:

supports in interface Repository

Returns:

Supported features

getConnection

protected abstract Connection getConnection()
                                     throws SQLException

Throws:

SQLException

safeClose

protected void safeClose(ResultSet rs)

safeClose

protected void safeClose(Connection connection)

safeClose

protected void safeClose(Statement st)

close

public void close()

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

initialize

public void initialize()

Description copied from interface: RRepositoryFactory

Initialize factory.

Specified by:

initialize in interface RRepositoryFactory