/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* @author Rustem V. Rafikov
* @version $Revision: 1.3 $
*/
package javax.imageio;
import javax.imageio.stream.ImageInputStream;
import javax.imageio.stream.ImageOutputStream;
import javax.imageio.spi.*;
import org.apache.harmony.luni.util.NotImplementedException;
import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.util.Iterator;
import java.util.Arrays;
import java.awt.image.BufferedImage;
import java.awt.image.RenderedImage;
import java.net.URL;
public final class ImageIO {
private static final IIORegistry registry = IIORegistry.getDefaultInstance();
private ImageIO() {}
public static void scanForPlugins() throws NotImplementedException {
// TODO: implement
throw new NotImplementedException();
}
public static void setUseCache(boolean useCache) throws NotImplementedException {
// TODO: implement
throw new NotImplementedException();
}
public static boolean getUseCache() {
// TODO: implement
return false;
}
public static void setCacheDirectory(File cacheDirectory) throws NotImplementedException {
// TODO: implement
throw new NotImplementedException();
}
public static File getCacheDirectory() throws NotImplementedException {
// TODO: implement
//-- null indicates system-dep default temporary directory
return null;
}
public static ImageInputStream createImageInputStream(Object input)
throws IOException {
if (input == null) {
throw new IllegalArgumentException("input source cannot be NULL");
}
Iterator<ImageInputStreamSpi> it = registry.getServiceProviders(ImageInputStreamSpi.class, true);
while (it.hasNext()) {
ImageInputStreamSpi spi = it.next();
if (spi.getInputClass().isInstance(input)) {
return spi.createInputStreamInstance(input);
}
}
return null;
}
public static ImageOutputStream createImageOutputStream(Object output)
throws IOException {
if (output == null) {
throw new IllegalArgumentException("output destination cannot be NULL");
}
Iterator<ImageOutputStreamSpi> it = registry.getServiceProviders(ImageOutputStreamSpi.class, true);
while (it.hasNext()) {
ImageOutputStreamSpi spi = it.next();
if (spi.getOutputClass().isInstance(output)) {
// todo - use getUseCache and getCacheDir here
return spi.createOutputStreamInstance(output);
}
}
return null;
}
public static String[] getReaderFormatNames() throws NotImplementedException {
// TODO: implement
throw new NotImplementedException();
}
public static String[] getReaderMIMETypes() throws NotImplementedException {
// TODO: implement
throw new NotImplementedException();
}
public static Iterator<ImageReader> getImageReaders(Object input) {
if (input == null) {
throw new NullPointerException("input cannot be NULL");
}
Iterator<ImageReaderSpi> it = registry.getServiceProviders(ImageReaderSpi.class,
new CanReadFilter(input), true);
return new SpiIteratorToReadersIteratorWrapper(it);
}
public static Iterator<ImageReader> getImageReadersByFormatName(String formatName) {
if (formatName == null) {
throw new NullPointerException("format name cannot be NULL");
}
Iterator<ImageReaderSpi> it = registry.getServiceProviders(ImageReaderSpi.class,
new FormatFilter(formatName), true);
return new SpiIteratorToReadersIteratorWrapper(it);
}
public static Iterator<ImageReader> getImageReadersBySuffix(String fileSuffix) {
if (fileSuffix == null) {
throw new NullPointerException("suffix cannot be NULL");
}
Iterator<ImageReaderSpi> it = registry.getServiceProviders(ImageReaderSpi.class,
new SuffixFilter(fileSuffix), true);
return new SpiIteratorToReadersIteratorWrapper(it);
}
public static Iterator<ImageReader> getImageReadersByMIMEType(String MIMEType) throws NotImplementedException {
// TODO: implement
throw new NotImplementedException();
}
public static String[] getWriterFormatNames() throws NotImplementedException {
// TODO: implement
throw new NotImplementedException();
}
public static String[] getWriterMIMETypes() throws NotImplementedException {
// TODO: implement
throw new NotImplementedException();
}
public static Iterator<ImageWriter> getImageWritersByFormatName(String formatName) {
if (formatName == null) {
throw new NullPointerException("format name cannot be NULL");
}
Iterator<ImageWriterSpi> it = registry.getServiceProviders(ImageWriterSpi.class,
new FormatFilter(formatName), true);
return new SpiIteratorToWritersIteratorWrapper(it);
}
public static Iterator<ImageWriter> getImageWritersBySuffix(String fileSuffix) {
if (fileSuffix == null) {
throw new NullPointerException("suffix cannot be NULL");
}
Iterator<ImageWriterSpi> it = registry.getServiceProviders(ImageWriterSpi.class,
new SuffixFilter(fileSuffix), true);
return new SpiIteratorToWritersIteratorWrapper(it);
}
public static Iterator<ImageWriter> getImageWritersByMIMEType(String MIMEType) throws NotImplementedException {
// TODO: implement
throw new NotImplementedException();
}
public static ImageWriter getImageWriter(ImageReader reader) throws NotImplementedException {
// TODO: implement
throw new NotImplementedException();
}
public static ImageReader getImageReader(ImageWriter writer) throws NotImplementedException {
// TODO: implement
throw new NotImplementedException();
}
public static Iterator<ImageWriter> getImageWriters(ImageTypeSpecifier type,
String formatName) {
if (type == null) {
throw new NullPointerException("type cannot be NULL");
}
if (formatName == null) {
throw new NullPointerException("format name cannot be NULL");
}
Iterator<ImageWriterSpi> it = registry.getServiceProviders(ImageWriterSpi.class,
new FormatAndEncodeFilter(type, formatName), true);
return new SpiIteratorToWritersIteratorWrapper(it);
}
public static Iterator<ImageTranscoder> getImageTranscoders(ImageReader reader,
ImageWriter writer) throws NotImplementedException {
// TODO: implement
throw new NotImplementedException();
}
public static BufferedImage read(File input) throws IOException {
if (input == null) {
throw new IllegalArgumentException("input == null!");
}
ImageInputStream stream = createImageInputStream(input);
return read(stream);
}
public static BufferedImage read(InputStream input) throws IOException {
if (input == null) {
throw new IllegalArgumentException("input == null!");
}
ImageInputStream stream = createImageInputStream(input);
return read(stream);
}
public static BufferedImage read(URL input) throws IOException {
if (input == null) {
throw new IllegalArgumentException("input == null!");
}
InputStream stream = input.openStream();
BufferedImage res = read(stream);
stream.close();
return res;
}
public static BufferedImage read(ImageInputStream stream) throws IOException {
if (stream == null) {
throw new IllegalArgumentException("stream == null!");
}
Iterator<ImageReader> imageReaders = getImageReaders(stream);
if (!imageReaders.hasNext()) {
return null;
}
ImageReader reader = imageReaders.next();
reader.setInput(stream, false, true);
BufferedImage res = reader.read(0);
reader.dispose();
try {
stream.close();
} catch (IOException e) {
// Stream could be already closed, proceed silently in this case
}
return res;
}
public static boolean write(RenderedImage im,
String formatName,
ImageOutputStream output)
throws IOException {
if (im == null) {
throw new IllegalArgumentException("image cannot be NULL");
}
if (formatName == null) {
throw new IllegalArgumentException("format name cannot be NULL");
}
if (output == null) {
throw new IllegalArgumentException("output cannot be NULL");
}
Iterator<ImageWriter> it = getImageWriters(ImageTypeSpecifier.createFromRenderedImage(im), formatName);
if (it.hasNext()) {
ImageWriter writer = it.next();
writer.setOutput(output);
writer.write(im);
output.flush();
writer.dispose();
return true;
}
return false;
}
public static boolean write(RenderedImage im,
String formatName,
File output)
throws IOException {
if (output == null) {
throw new IllegalArgumentException("output cannot be NULL");
}
if (output.exists()) {
output.delete();
}
ImageOutputStream ios = createImageOutputStream(output);
boolean rt = write(im, formatName, ios);
ios.close();
return rt;
}
public static boolean write(RenderedImage im,
String formatName,
OutputStream output)
throws IOException {
if (output == null) {
throw new IllegalArgumentException("output cannot be NULL");
}
ImageOutputStream ios = createImageOutputStream(output);
boolean rt = write(im, formatName, ios);
ios.close();
return rt;
}
/**
* Filter to match spi by format name
*/
static class FormatFilter implements ServiceRegistry.Filter {
private String name;
public FormatFilter(String name) {
this.name = name;
}
public boolean filter(Object provider) {
ImageReaderWriterSpi spi = (ImageReaderWriterSpi) provider;
return Arrays.asList(spi.getFormatNames()).contains(name);
}
}
/**
* Filter to match spi by format name and encoding possibility
*/
static class FormatAndEncodeFilter extends FormatFilter {
private ImageTypeSpecifier type;
public FormatAndEncodeFilter(ImageTypeSpecifier type, String name) {
super(name);
this.type = type;
}
@Override
public boolean filter(Object provider) {
ImageWriterSpi spi = (ImageWriterSpi) provider;
return super.filter(provider) && spi.canEncodeImage(type);
}
}
/**
* Filter to match spi by suffix
*/
static class SuffixFilter implements ServiceRegistry.Filter {
private String suf;
public SuffixFilter(String suf) {
this.suf = suf;
}
public boolean filter(Object provider) {
ImageReaderWriterSpi spi = (ImageReaderWriterSpi) provider;
return Arrays.asList(spi.getFileSuffixes()).contains(suf);
}
}
/**
* Filter to match spi by decoding possibility
*/
static class CanReadFilter implements ServiceRegistry.Filter {
private Object input;
public CanReadFilter(Object input) {
this.input = input;
}
public boolean filter(Object provider) {
ImageReaderSpi spi = (ImageReaderSpi) provider;
try {
return spi.canDecodeInput(input);
} catch (IOException e) {
return false;
}
}
}
/**
* Wraps Spi's iterator to ImageWriter iterator
*/
static class SpiIteratorToWritersIteratorWrapper implements Iterator<ImageWriter> {
private Iterator<ImageWriterSpi> backend;
public SpiIteratorToWritersIteratorWrapper(Iterator<ImageWriterSpi> backend) {
this.backend = backend;
}
public ImageWriter next() {
try {
return backend.next().createWriterInstance();
} catch (IOException e) {
e.printStackTrace();
return null;
}
}
public boolean hasNext() {
return backend.hasNext();
}
public void remove() {
throw new UnsupportedOperationException("Use deregisterServiceprovider instead of Iterator.remove()");
}
}
/**
* Wraps spi's iterator to ImageReader iterator
*/
static class SpiIteratorToReadersIteratorWrapper implements Iterator<ImageReader> {
private Iterator<ImageReaderSpi> backend;
public SpiIteratorToReadersIteratorWrapper(Iterator<ImageReaderSpi> backend) {
this.backend = backend;
}
public ImageReader next() {
try {
return backend.next().createReaderInstance();
} catch (IOException e) {
e.printStackTrace();
return null;
}
}
public boolean hasNext() {
return backend.hasNext();
}
public void remove() {
throw new UnsupportedOperationException("Use deregisterServiceprovider instead of Iterator.remove()");
}
}
}