com.ecyrd.jspwiki.providers
Class AbstractFileProvider

java.lang.Object
  extended by com.ecyrd.jspwiki.providers.AbstractFileProvider
All Implemented Interfaces:
WikiPageProvider, WikiProvider
Direct Known Subclasses:
FileSystemProvider, RCSFileProvider, VersioningFileProvider

public abstract class AbstractFileProvider
extends Object
implements WikiPageProvider

Provides a simple directory based repository for Wiki pages.

All files have ".txt" appended to make life easier for those who insist on using Windows or other software which makes assumptions on the files contents based on its name.

This class functions as a superclass to all file based providers.

Since:
2.1.21.
Author:
Janne Jalkanen

Nested Class Summary
 class AbstractFileProvider.WikiFileFilter
           
 
Field Summary
static String DEFAULT_ENCODING
           
static String FILE_EXT
          All files should have this extension to be recognized as JSPWiki files.
protected  String m_encoding
           
protected  WikiEngine m_engine
           
static String PROP_PAGEDIR
          Name of the property that defines where page directories are.
 
Fields inherited from interface com.ecyrd.jspwiki.WikiProvider
LATEST_VERSION
 
Constructor Summary
AbstractFileProvider()
           
 
Method Summary
 void deletePage(String pageName)
          Removes an entire page from the repository.
 void deleteVersion(String pageName, int version)
          Removes a specific version from the repository.
protected  File findPage(String page)
          Finds a Wiki page from the page repository.
 Collection findPages(QueryItem[] query)
          Iterates through all WikiPages, matches them against the given query, and returns a Collection of SearchResult objects.
 Collection getAllChangedSince(Date date)
          Gets a list of recent changes.
 Collection getAllPages()
          Returns all pages.
 int getPageCount()
          Gets the number of pages.
 WikiPage getPageInfo(String page, int version)
          Always returns the latest version, since FileSystemProvider does not support versioning.
 String getPageText(String page, int version)
          This implementation just returns the current version, as filesystem does not provide versioning information for now.
 String getProviderInfo()
          Return a valid HTML string for information.
 List getVersionHistory(String page)
          The FileSystemProvider provides only one version.
 void initialize(WikiEngine engine, Properties properties)
          Initializes the page provider.
protected  String mangleName(String pagename)
          This makes sure that the queried page name is still readable by the file system.
 boolean pageExists(String page)
          Return true, if page exists.
 void putPageText(WikiPage page, String text)
          Attempts to save the page text for page "page".
protected  String unmangleName(String filename)
          This makes the reverse of mangleName.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface com.ecyrd.jspwiki.providers.WikiPageProvider
movePage
 

Field Detail

m_encoding

protected String m_encoding

m_engine

protected WikiEngine m_engine

PROP_PAGEDIR

public static final String PROP_PAGEDIR
Name of the property that defines where page directories are.

See Also:
Constant Field Values

FILE_EXT

public static final String FILE_EXT
All files should have this extension to be recognized as JSPWiki files. We default to .txt, because that is probably easiest for Windows users, and guarantees correct handling.

See Also:
Constant Field Values

DEFAULT_ENCODING

public static final String DEFAULT_ENCODING
See Also:
Constant Field Values
Constructor Detail

AbstractFileProvider

public AbstractFileProvider()
Method Detail

initialize

public void initialize(WikiEngine engine,
                       Properties properties)
                throws NoRequiredPropertyException,
                       IOException
Description copied from interface: WikiProvider
Initializes the page provider.

Specified by:
initialize in interface WikiProvider
Throws:
FileNotFoundException - If the specified page directory does not exist.
IOException - In case the specified page directory is a file, not a directory.
NoRequiredPropertyException

mangleName

protected String mangleName(String pagename)
This makes sure that the queried page name is still readable by the file system.


unmangleName

protected String unmangleName(String filename)
This makes the reverse of mangleName.


findPage

protected File findPage(String page)
Finds a Wiki page from the page repository.


pageExists

public boolean pageExists(String page)
Description copied from interface: WikiPageProvider
Return true, if page exists.

Specified by:
pageExists in interface WikiPageProvider

getPageText

public String getPageText(String page,
                          int version)
                   throws ProviderException
This implementation just returns the current version, as filesystem does not provide versioning information for now.

Specified by:
getPageText in interface WikiPageProvider
Parameters:
page - Name of the page to fetch.
version - Version of the page to fetch.
Returns:
The content of the page, or null, if the page does not exist.
Throws:
ProviderException

putPageText

public void putPageText(WikiPage page,
                        String text)
                 throws ProviderException
Description copied from interface: WikiPageProvider
Attempts to save the page text for page "page".

Specified by:
putPageText in interface WikiPageProvider
Throws:
ProviderException

getAllPages

public Collection getAllPages()
                       throws ProviderException
Description copied from interface: WikiPageProvider
Returns all pages. Each element in the returned Collection should be a WikiPage.

Specified by:
getAllPages in interface WikiPageProvider
Throws:
ProviderException

getAllChangedSince

public Collection getAllChangedSince(Date date)
Description copied from interface: WikiPageProvider
Gets a list of recent changes.

Specified by:
getAllChangedSince in interface WikiPageProvider

getPageCount

public int getPageCount()
Description copied from interface: WikiPageProvider
Gets the number of pages.

Specified by:
getPageCount in interface WikiPageProvider

findPages

public Collection findPages(QueryItem[] query)
Iterates through all WikiPages, matches them against the given query, and returns a Collection of SearchResult objects.

Specified by:
findPages in interface WikiPageProvider

getPageInfo

public WikiPage getPageInfo(String page,
                            int version)
                     throws ProviderException
Always returns the latest version, since FileSystemProvider does not support versioning.

Specified by:
getPageInfo in interface WikiPageProvider
Throws:
ProviderException

getVersionHistory

public List getVersionHistory(String page)
                       throws ProviderException
The FileSystemProvider provides only one version.

Specified by:
getVersionHistory in interface WikiPageProvider
Returns:
A collection of wiki pages.
Throws:
ProviderException

getProviderInfo

public String getProviderInfo()
Description copied from interface: WikiProvider
Return a valid HTML string for information. May be anything.

Specified by:
getProviderInfo in interface WikiProvider

deleteVersion

public void deleteVersion(String pageName,
                          int version)
                   throws ProviderException
Description copied from interface: WikiPageProvider
Removes a specific version from the repository. The implementations should really do no more security checks, since that is the domain of the PageManager. Just delete it as efficiently as you can.

Specified by:
deleteVersion in interface WikiPageProvider
Parameters:
pageName - Name of the page to be removed.
version - Version of the page to be removed. May be LATEST_VERSION.
Throws:
ProviderException - If the page cannot be removed for some reason.

deletePage

public void deletePage(String pageName)
                throws ProviderException
Description copied from interface: WikiPageProvider
Removes an entire page from the repository. The implementations should really do no more security checks, since that is the domain of the PageManager. Just delete it as efficiently as you can. You should also delete any auxiliary files that belong to this page, IF they were created by this provider.

The reason why this is named differently from deleteVersion() (logically, this method should be an overloaded version) is that I want to be absolutely sure I don't accidentally use the wrong method. With overloading something like that happens sometimes...

Specified by:
deletePage in interface WikiPageProvider
Parameters:
pageName - Name of the page to be removed completely.
Throws:
ProviderException - If the page could not be removed for some reason.