org.apache.clerezza.utils.imageprocessing

Class ImageReaderService

java.lang.Object

org.apache.clerezza.utils.imageprocessing.ImageReaderService

All Implemented Interfaces:

ImageReader

@Service(value=ImageReaderService.class)
@Reference(name="imageReaders",
           referenceInterface=ImageReader.class,
           cardinality=MANDATORY_MULTIPLE,
           policy=STATIC,
           strategy=LOOKUP)
public class ImageReaderService
extends Object
implements ImageReader

This service dynamically provides the registered ImageReader with the highest service ranking.

Author:

daniel

Constructor Summary

Constructors

Constructor and Description
ImageReaderService()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	activate(org.osgi.service.component.ComponentContext context) Called when this component is enabled (when this services references are satisfied and this service is referenced by some other service).
protected void	deactivate(org.osgi.service.component.ComponentContext context) Called when this component is disabled (when this services references are not satisfied or this service is not referenced by some other service).
BufferedImage	getBufferedImage(File file) Creates a BufferedImage from an File.
BufferedImage	getBufferedImage(InputStream in) Creates a BufferedImage from an InputStream.
BufferedImage	getBufferedImage(URL url) Creates a BufferedImage from a URL.
ImageReader	getImageReader() Returns the ImageReader with the highest service ranking.

Methods inherited from class java.lang.Object

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

Constructor Detail

ImageReaderService

public ImageReaderService()

Method Detail

getImageReader

public ImageReader getImageReader()

Returns the ImageReader with the highest service ranking. In case of a tie, the service with the lower service id (in general the service that got registered first) is returned.

Returns:

an ImageReader service instance

getBufferedImage

public BufferedImage getBufferedImage(File file)
                               throws IOException

Creates a BufferedImage from an File.

This method delegates to the ImageReader service with the highest service ranking. In case of a tie the service with the lowest service id is used.

Specified by:

getBufferedImage in interface ImageReader

Parameters:

file - the image file.

Returns:

a BufferedImage containing the data of the specified image.

Throws:

IOException

getBufferedImage

public BufferedImage getBufferedImage(InputStream in)
                               throws IOException

Creates a BufferedImage from an InputStream.

This method delegates to the ImageReader service with the highest service ranking. In case of a tie the service with the lowest service id is used.

Specified by:

getBufferedImage in interface ImageReader

Parameters:

in - a stream from which the image data can be read.

Returns:

a BufferedImage containing the data of the specified image.

Throws:

IOException

getBufferedImage

public BufferedImage getBufferedImage(URL url)
                               throws IOException

Creates a BufferedImage from a URL.

This method delegates to the ImageReader service with the highest service ranking. In case of a tie the service with the lowest service id is used.

Specified by:

getBufferedImage in interface ImageReader

Parameters:

url - the location of the image described as a URL.

Returns:

a BufferedImage containing the data of the specified image.

Throws:

IOException

activate

@Activate
protected void activate(org.osgi.service.component.ComponentContext context)

Called when this component is enabled (when this services references are satisfied and this service is referenced by some other service).

Parameters:

context - the component context.

deactivate

@Deactivate
protected void deactivate(org.osgi.service.component.ComponentContext context)

Called when this component is disabled (when this services references are not satisfied or this service is not referenced by some other service).

Parameters:

context - the component context.