Package com.logicaldoc.core.store

Class AbstractStorer

java.lang.Object

com.logicaldoc.core.store.AbstractStorer

All Implemented Interfaces:

Storer, Comparable<Storer>

Direct Known Subclasses:

FSStorer

public abstract class AbstractStorer
extends Object
implements Storer

Common methods for all the Storer implementations.

Since:

7.6.4

Author:

Marco Meschieri - LogicalDOC

Constructor Summary

Constructors

Constructor	Description
AbstractStorer()

Method Summary

Modifier and Type	Method	Description
int	compareTo(Storer o)
void	destroy()	Destroy method
boolean	equals(Object obj)
byte[]	getBytes(long docId, String resource)	Obtains the document's raw bytes for the specified resource
ContextProperties	getConfig()
int	getId()	The unique identifier
Map<String,String>	getParameters()	Returns the map of parameters
String	getResourceName(long docId, String fileVersion, String suffix)	Computes the resource name inside the container
String	getResourceName(Document doc, String fileVersion, String suffix)	Computes the resource name inside the container
String	getString(long docId, String resource)	Obtains the document's content as string for the specified resource
int	hashCode()
void	init()	Initialization method
boolean	isEnabled()	Tests if the storer is enabled
void	setConfig(ContextProperties config)
void	setId(int id)	Sets the unique identifier
void	setManager(StorerManager manager)
void	store(File file, long docId, String resource)	Stores a file
boolean	test()	Tests if the storer can read and write
String	toString()
void	writeToFile(long docId, String resource, File out)	Writes the specified resource in a file
void	writeToStream(long docId, String resource, OutputStream output)	Writes the specified resource in an output stream
void	writeToStream(long docId, String resource, OutputStream output, long start, long length)	Writes the specified resource in an output stream

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.logicaldoc.core.store.Storer

delete, delete, exists, getBytes, getParameterNames, getStream, getTotalSize, listResources, size, store

Constructor Detail

AbstractStorer

public AbstractStorer()

Method Detail

getConfig

public ContextProperties getConfig()

setManager

public void setManager(StorerManager manager)

setConfig

public void setConfig(ContextProperties config)

getId

public int getId()

Description copied from interface: Storer

The unique identifier

Specified by:

getId in interface Storer

Returns:

the storer identifier

setId

public void setId(int id)

Description copied from interface: Storer

Sets the unique identifier

Specified by:

setId in interface Storer

Parameters:

id - the storer identifier

compareTo

public int compareTo(Storer o)

Specified by:

compareTo in interface Comparable<Storer>

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

store

public void store(File file,
                  long docId,
                  String resource)
           throws IOException

Description copied from interface: Storer

Stores a file

Specified by:

store in interface Storer

Parameters:

file - the file to store

docId - identifier of the document

resource - name of the resource

Throws:

IOException - the content cannot be stored

See Also:

Storer.store(java.io.InputStream,long,java.lang.String)

getBytes

public byte[] getBytes(long docId,
                       String resource)
                throws IOException

Description copied from interface: Storer

Obtains the document's raw bytes for the specified resource

Specified by:

getBytes in interface Storer

Parameters:

docId - The document's identifier

resource - Name of the resource

Returns:

The document file's bytes

Throws:

IOException - cannot open the resource to get the bytes

writeToStream

public void writeToStream(long docId,
                          String resource,
                          OutputStream output,
                          long start,
                          long length)
                   throws IOException

Description copied from interface: Storer

Writes the specified resource in an output stream

Specified by:

writeToStream in interface Storer

Parameters:

docId - The document's identifier

resource - Name of the resource

output - The output stream

start - Index of the starting byte

length - Total packet length

Throws:

IOException - error writing the stream or reading the resource

writeToStream

public void writeToStream(long docId,
                          String resource,
                          OutputStream output)
                   throws IOException

Description copied from interface: Storer

Writes the specified resource in an output stream

Specified by:

writeToStream in interface Storer

Parameters:

docId - The document's identifier

resource - Name of the resource

output - The output stream

Throws:

IOException - error writing the stream or reading the resource

writeToFile

public void writeToFile(long docId,
                        String resource,
                        File out)
                 throws IOException

Description copied from interface: Storer

Writes the specified resource in a file

Specified by:

writeToFile in interface Storer

Parameters:

docId - The document identifier

resource - Name of the resource

out - File that will receive the resource's content

Throws:

IOException - error writing the file or reading the resource

getString

public String getString(long docId,
                        String resource)

Description copied from interface: Storer

Obtains the document's content as string for the specified resource

Specified by:

getString in interface Storer

Parameters:

docId - The document's identifier

resource - Name of the resource

Returns:

The document file's as string representation

getResourceName

public String getResourceName(Document doc,
                              String fileVersion,
                              String suffix)

Description copied from interface: Storer

Computes the resource name inside the container

Specified by:

getResourceName in interface Storer

Parameters:

doc - The document representation

fileVersion - The file version (use null for the latest version)

suffix - The file suffix (use null if you want the exact document file)

Returns:

The document's resource name

getResourceName

public String getResourceName(long docId,
                              String fileVersion,
                              String suffix)

Description copied from interface: Storer

Computes the resource name inside the container

Specified by:

getResourceName in interface Storer

Parameters:

docId - The document identifier

fileVersion - The file version (use null for the latest version)

suffix - The file suffix (use null if you want the exact document file)

Returns:

The document's resource name

getParameters

public Map<String,String> getParameters()

Description copied from interface: Storer

Returns the map of parameters

Specified by:

getParameters in interface Storer

Returns:

a map with settings setting_name - setting_value

test

public boolean test()

Description copied from interface: Storer

Tests if the storer can read and write

Specified by:

test in interface Storer

Returns:

if the storer can read and write

isEnabled

public boolean isEnabled()

Description copied from interface: Storer

Tests if the storer is enabled

Specified by:

isEnabled in interface Storer

Returns:

if the storer is enabled

toString

public String toString()

Overrides:

toString in class Object

init

public void init()

Description copied from interface: Storer

Initialization method

Specified by:

init in interface Storer

destroy

public void destroy()

Description copied from interface: Storer

Destroy method

Specified by:

destroy in interface Storer