19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed to the Apache Software Foundation (ASF) under one or more 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * contributor license agreements. See the NOTICE file distributed with 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this work for additional information regarding copyright ownership. 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The ASF licenses this file to You under the Apache License, Version 2.0 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (the "License"); you may not use this file except in compliance with 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the License. You may obtain a copy of the License at 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @author Rustem V. Rafikov 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @version $Revision: 1.3 $ 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage javax.imageio.spi; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.File; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.IOException; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport javax.imageio.stream.ImageInputStream; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The ImageInputStreamSpi abstract class is a service provider interface (SPI) 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for ImageInputStreams. 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @since Android 1.0 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic abstract class ImageInputStreamSpi extends IIOServiceProvider implements RegisterableService { 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The input class. 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected Class<?> inputClass; 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Instantiates a new ImageInputStreamSpi. 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected ImageInputStreamSpi() { 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new UnsupportedOperationException("Not supported yet"); 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Instantiates a new ImageInputStreamSpi. 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vendorName 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the vendor name. 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param version 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the version. 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param inputClass 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the input class. 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public ImageInputStreamSpi(String vendorName, String version, Class<?> inputClass) { 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(vendorName, version); 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.inputClass = inputClass; 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets an input Class object that represents class or interface that must 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be implemented by an input source. 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the input class. 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Class<?> getInputClass() { 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return inputClass; 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if the ImageInputStream can use a cache file. If this method 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * returns false, the value of the useCache parameter of 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * createInputStreamInstance will be ignored. The default implementation 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * returns false. 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true, if the ImageInputStream can use a cache file, false 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * otherwise. 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean canUseCacheFile() { 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; // -- def 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if the ImageInputStream implementation requires the use of a 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * cache file. The default implementation returns false. 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true, if the ImageInputStream implementation requires the use of 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a cache file, false otherwise. 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean needsCacheFile() { 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; // def 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates the ImageInputStream associated with this service provider. The 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * input object should be an instance of the class returned by the 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * getInputClass method. This method uses the specified directory for the 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * cache file if the useCache parameter is true. 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param input 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the input Object. 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param useCache 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the flag indicating if a cache file is needed or not. 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cacheDir 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the cache directory. 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the ImageInputStream. 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IOException 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if an I/O exception has occurred. 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public abstract ImageInputStream createInputStreamInstance(Object input, boolean useCache, 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project File cacheDir) throws IOException; 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates the ImageInputStream associated with this service provider. The 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * input object should be an instance of the class returned by getInputClass 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * method. This method uses the default system directory for the cache file, 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if it is needed. 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param input 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the input Object. 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the ImageInputStream. 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IOException 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if an I/O exception has occurred. 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public ImageInputStream createInputStreamInstance(Object input) throws IOException { 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return createInputStreamInstance(input, true, null); 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 132