org.apache.clerezza.representation

Class Serializer

java.lang.Object

org.apache.clerezza.representation.Serializer

public class Serializer
extends Object

This singleton class provides a method serialize to transform a ImmutableGraph into serialized RDF forms. Functionality is delegated to registered SerializingProviders. Such SerializingProviders can be registered and unregistered, later registered SerializingProviders shadow previously registered providers for the same format. Note on synchronization: SerializingProviders must be able to handle concurrent requests.

Author:

mir

Constructor Summary

Constructors

Constructor and Description
Serializer() the constructor sets the singleton instance to allow instantiation by OSGi-DS.

Method Summary

Modifier and Type	Method and Description
protected void	activate(org.osgi.service.component.ComponentContext componentContext)
protected void	bindConfigurationAdmin(org.osgi.service.cm.ConfigurationAdmin configurationAdmin)
void	bindSerializingProvider(SerializingProvider provider) Registers a Serializing provider
protected void	deactivate(org.osgi.service.component.ComponentContext componentContext)
static Serializer	getInstance() This returns the singleton instance, if an instance has been previously created (e.g.
Set<String>	getSupportedFormats() Get a set of supported formats
void	serialize(OutputStream serializedGraph, Graph tc, String formatIdentifier) Serializes a ImmutableGraph into an OutputStream.
protected void	unbindConfigurationAdmin(org.osgi.service.cm.ConfigurationAdmin configurationAdmin)
void	unbindSerializingProvider(SerializingProvider provider) Unregister a Serializing provider

Methods inherited from class java.lang.Object

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

Constructor Detail

Serializer

public Serializer()

the constructor sets the singleton instance to allow instantiation by OSGi-DS. This constructor should not be called except by OSGi-DS, otherwise the static getInstance method should be used.

Method Detail

getInstance

public static Serializer getInstance()

This returns the singleton instance, if an instance has been previously created (e.g. by OSGi declarative services) this instance is returned, otherwise a new instance is created and providers are injected using the service provider interface (META-INF/services/)

Returns:

the singleton Serializer instance

activate

protected void activate(org.osgi.service.component.ComponentContext componentContext)

deactivate

protected void deactivate(org.osgi.service.component.ComponentContext componentContext)

serialize

public void serialize(OutputStream serializedGraph,
                      Graph tc,
                      String formatIdentifier)
               throws UnsupportedFormatException

Serializes a ImmutableGraph into an OutputStream. This delegates the processing to the provider registered for the specified format, if the formatIdentifier contains a ';'-character only the section before that character is used for choosing the provider.

Parameters:

serializedGraph - an outputStream into which the ImmutableGraph will be serialized

tc - the Graph to be serialized

formatIdentifier - a string specifying the serialization format (usually the MIME-type)

Throws:

UnsupportedFormatException

getSupportedFormats

public Set<String> getSupportedFormats()

Get a set of supported formats

Returns:

a set if stings identifying formats (usually the MIME-type)

bindSerializingProvider

public void bindSerializingProvider(SerializingProvider provider)

Registers a Serializing provider

Parameters:

provider - the provider to be registered

unbindSerializingProvider

public void unbindSerializingProvider(SerializingProvider provider)

Unregister a Serializing provider

Parameters:

provider - the provider to be unregistered

bindConfigurationAdmin

protected void bindConfigurationAdmin(org.osgi.service.cm.ConfigurationAdmin configurationAdmin)

unbindConfigurationAdmin

protected void unbindConfigurationAdmin(org.osgi.service.cm.ConfigurationAdmin configurationAdmin)