org.apache.jackrabbit.vault.fs

Class SerializerArtifact

java.lang.Object

AbstractArtifact

org.apache.jackrabbit.vault.fs.SerializerArtifact

All Implemented Interfaces:

Artifact, Dumpable, ExportArtifact

public class SerializerArtifact
extends AbstractArtifact
implements ExportArtifact

Implements an output artifact that is based on a serializer, i.e. the preferred access method is AccessType.SPOOL

Constructor Summary

Constructors

Constructor and Description
SerializerArtifact(Artifact parent, String name, String ext, ArtifactType type, Serializer serializer, long lastModified) Constructs a new artifact that is based on a content serializer.

Method Summary

Modifier and Type	Method and Description
long	getContentLength() Returns the length of the serialized data if it's known without doing the actual serialization.
String	getContentType() Returns the content type of the serialized data or null if the type is not known or cannot be determined.
VaultInputSource	getInputSource() Returns an input source to the contents of this artifact.
InputStream	getInputStream() Returns the input stream to the contents of this artifact.
long	getLastModified() Returns the last modified date or 0 if not known.
AccessType	getPreferredAccess() Returns the preferred access value for this artifact.
SerializationType	getSerializationType() Returns the serialization type of this artifact.
void	spool(OutputStream out) Writes the content to the given output stream and closes it afterwards.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.jackrabbit.vault.fs.api.Artifact

getExtension, getPlatformPath, getRelativePath, getType

Methods inherited from interface org.apache.jackrabbit.vault.fs.api.Dumpable

dump

Constructor Detail

SerializerArtifact

public SerializerArtifact(Artifact parent,
                          String name,
                          String ext,
                          ArtifactType type,
                          Serializer serializer,
                          long lastModified)

Constructs a new artifact that is based on a content serializer.

Parameters:

parent - the parent artifact

name - the name of the artifact

ext - the extension of the artifact

type - the type of the artifact

serializer - the serializer to use for the content

lastModified - the last modified date

Throws:

IllegalArgumentException - if the type is not suitable.

Method Detail

getPreferredAccess

public AccessType getPreferredAccess()

Returns the preferred access value for this artifact.

Specified by:

getPreferredAccess in interface Artifact

Returns:

always AccessType.SPOOL

getSerializationType

public SerializationType getSerializationType()

Returns the serialization type of this artifact.

Specified by:

getSerializationType in interface Artifact

Returns:

the serialization type of this artifact.

spool

public void spool(OutputStream out)
           throws IOException,
                  RepositoryException

Writes the content to the given output stream and closes it afterwards. This is the preferred method to use for output-artifacts.

Specified by:

spool in interface Artifact

Parameters:

out - the output stream to spool to

Throws:

IOException - if an I/O error occurs

RepositoryException - if a repository error occurs

getInputStream

public InputStream getInputStream()
                           throws IOException,
                                  RepositoryException

Returns the input stream to the contents of this artifact. This is the preferred method to use for input-artifacts.

Specified by:

getInputStream in interface Artifact

Returns:

a input stream to the contents of this artifact.

Throws:

IOException - if an I/O error occurs

RepositoryException - if a repository error occurs

getInputSource

public VaultInputSource getInputSource()
                                throws IOException,
                                       RepositoryException

Returns an input source to the contents of this artifact. This is also preferred for AccessType.STREAM.

Specified by:

getInputSource in interface Artifact

Returns:

an input source.

Throws:

IOException - if an I/O error occurs.

RepositoryException - of a repository error occurs.

getContentType

public String getContentType()

Returns the content type of the serialized data or null if the type is not known or cannot be determined.

Specified by:

getContentType in interface Artifact

Returns:

the content type or null.

getContentLength

public long getContentLength()

Returns the length of the serialized data if it's known without doing the actual serialization.

Specified by:

getContentLength in interface Artifact

Returns:

the length or -1 if the length cannot be determined.

getLastModified

public long getLastModified()

Returns the last modified date or 0 if not known.

Specified by:

getLastModified in interface Artifact

Returns:

the last modified date or 0