net.shibboleth.metadata.pipeline

Class FilesInDirectoryMultiOutputStrategy<T>

java.lang.Object

net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

net.shibboleth.metadata.pipeline.FilesInDirectoryMultiOutputStrategy<T>

Type Parameters:

T - the type of Item to operate on

All Implemented Interfaces:

MultiOutputSerializationStage.OutputStrategy<T>, net.shibboleth.utilities.java.support.component.Component, net.shibboleth.utilities.java.support.component.DestructableComponent, net.shibboleth.utilities.java.support.component.InitializableComponent

public class FilesInDirectoryMultiOutputStrategy<T>
extends net.shibboleth.utilities.java.support.component.AbstractInitializableComponent
implements MultiOutputSerializationStage.OutputStrategy<T>

An output strategy for use with the MultiOutputSerializationStage which generates individual files within a directory. The files are named by a combination of:

• an optional prefix string,
• each item's ItemId transformed by an optional Function,
• an optional suffix string.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private class	FilesInDirectoryMultiOutputStrategy.FileDestination Class implementing the returned MultiOutputSerializationStage.Destination objects.

Field Summary

Fields

Modifier and Type	Field and Description
private File	directory Directory into which to write files.
private Logger	log Class logger.
private String	namePrefix String to use as a prefix for file names generated by this strategy.
private String	nameSuffix String to use as a suffix for file names generated by this strategy.
private com.google.common.base.Function<String,String>	nameTransformer Function to use to transform the Item's ItemId.

Constructor Summary

Constructors

Constructor and Description
FilesInDirectoryMultiOutputStrategy()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	doDestroy()
protected void	doInitialize()
MultiOutputSerializationStage.Destination	getDestination(Item<T> item) Gets a MultiOutputSerializationStage.Destination to which an item should be serialized.
File	getDirectory() Gets the directory in use.
String	getNamePrefix() Gets the name prefix in use.
String	getNameSuffix() Gets the name suffix in use.
com.google.common.base.Function<String,String>	getNameTransformer() Gets the name transformer in use.
void	setDirectory(File dir) Sets the directory to use.
void	setNamePrefix(String prefix) Sets the name prefix to use.
void	setNameSuffix(String suffix) Sets the name suffix to use.
void	setNameTransformer(com.google.common.base.Function<String,String> transformer) Sets the name transformer to use.

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

destroy, initialize, isDestroyed, isInitialized

Methods inherited from class java.lang.Object

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

Field Detail

log

private final Logger log

Class logger.

namePrefix

@Nonnull
private String namePrefix

String to use as a prefix for file names generated by this strategy. Default value: empty string.

nameTransformer

@Nonnull
private com.google.common.base.Function<String,String> nameTransformer

Function to use to transform the Item's ItemId. Default: identity transform.

nameSuffix

@Nonnull
private String nameSuffix

String to use as a suffix for file names generated by this strategy. Default value: empty string.

directory

@NonnullAfterInit
private File directory

Directory into which to write files.

Constructor Detail

FilesInDirectoryMultiOutputStrategy

public FilesInDirectoryMultiOutputStrategy()

Method Detail

getNamePrefix

@Nonnull
public String getNamePrefix()

Gets the name prefix in use.

Returns:

the name prefix in use

setNamePrefix

public void setNamePrefix(@Nonnull
                 String prefix)

Sets the name prefix to use.

Parameters:

prefix - the name prefix to use

getNameTransformer

@Nonnull
public com.google.common.base.Function<String,String> getNameTransformer()

Gets the name transformer in use.

Returns:

the name transformer in use.

setNameTransformer

public void setNameTransformer(@Nonnull
                      com.google.common.base.Function<String,String> transformer)

Sets the name transformer to use.

Parameters:

transformer - the name transformer to use

getNameSuffix

@Nonnull
public String getNameSuffix()

Gets the name suffix in use.

Returns:

the name suffix in use

setNameSuffix

public void setNameSuffix(@Nonnull
                 String suffix)

Sets the name suffix to use.

Parameters:

suffix - the name suffix to use

getDirectory

@Nonnull
public File getDirectory()

Gets the directory in use.

Returns:

the directory in use

setDirectory

public void setDirectory(@Nonnull
                File dir)

Sets the directory to use.

Parameters:

dir - the directory to use

getDestination

public MultiOutputSerializationStage.Destination getDestination(Item<T> item)
                                                         throws StageProcessingException

Description copied from interface: MultiOutputSerializationStage.OutputStrategy

Gets a MultiOutputSerializationStage.Destination to which an item should be serialized.

Specified by:

getDestination in interface MultiOutputSerializationStage.OutputStrategy<T>

Parameters:

item - Item for which to generate a MultiOutputSerializationStage.Destination

Returns:

MultiOutputSerializationStage.Destination for the item

Throws:

StageProcessingException - if an output stream cannot be generated for the Item

doDestroy

protected void doDestroy()

Overrides:

doDestroy in class net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

doInitialize

protected void doInitialize()
                     throws net.shibboleth.utilities.java.support.component.ComponentInitializationException

Overrides:

doInitialize in class net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

Throws:

net.shibboleth.utilities.java.support.component.ComponentInitializationException