xmlgraphics-commons 2.3

org.apache.xmlgraphics.image.writer
Class ImageWriterRegistry

java.lang.Object
  extended by org.apache.xmlgraphics.image.writer.ImageWriterRegistry

public final class ImageWriterRegistry
extends java.lang.Object

Registry for ImageWriter implementations.


Constructor Summary
ImageWriterRegistry()
          Default constructor.
ImageWriterRegistry(java.util.Properties preferredOrder)
          Special constructor.
 
Method Summary
static ImageWriterRegistry getInstance()
           
 ImageWriter getWriterFor(java.lang.String mime)
          Returns an ImageWriter that can be used to encode an image to the requested MIME type.
 void register(ImageWriter writer)
          Registers a new ImageWriter implementation in the registry.
 void register(ImageWriter writer, int priority)
          Registers a new ImageWriter implementation with the associated priority in the registry.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ImageWriterRegistry

public ImageWriterRegistry()
Default constructor. The default preferred order for the image writers is loaded from the resources.


ImageWriterRegistry

public ImageWriterRegistry(java.util.Properties preferredOrder)
Special constructor. The preferred order for the image writers can be specified as a Map (for example a Properties file). The entries of the Map consists of fully qualified class or package names as keys and integer numbers as values. Zero (0) is the default priority.

Parameters:
preferredOrder - the map of order properties used to order the plug-ins
Method Detail

getInstance

public static ImageWriterRegistry getInstance()
Returns:
a singleton instance of the ImageWriterRegistry.

register

public void register(ImageWriter writer,
                     int priority)
Registers a new ImageWriter implementation with the associated priority in the registry. Higher priorities get preference over lower priorities.

Parameters:
writer - the ImageWriter instance to register.
priority - the priority of the writer in the registry.
See Also:
register(ImageWriter)

register

public void register(ImageWriter writer)
Registers a new ImageWriter implementation in the registry. If an ImageWriter for the same target MIME type has already been registered, it is placed in an array based on priority.

Parameters:
writer - the ImageWriter instance to register.

getWriterFor

public ImageWriter getWriterFor(java.lang.String mime)
Returns an ImageWriter that can be used to encode an image to the requested MIME type.

Parameters:
mime - the MIME type of the desired output format
Returns:
a functional ImageWriter instance handling the desired output format or null if none can be found.

xmlgraphics-commons 2.3

Copyright 1999-2018 The Apache Software Foundation. All Rights Reserved.