Examples of ae.com.sun.imageio.stream.StreamFinalizer

ae.com.sun.imageio.stream.StreamFinalizer

Small class to assist in properly closing an ImageInputStream instance prior to garbage collection. The ImageInputStreamImpl class defines a finalize() method, but in a number of its public subclasses (e.g. FileImageInputStream) we override the finalize() method to be empty for performance reasons, and instead rely on the Disposer mechanism for closing/disposing resources. This is fine when one of these classes is instantiated directly (e.g. new FileImageInputStream()) but in the unlikely case where a user defines their own subclass of one of those streams, we need some way to get back to the behavior of ImageInputStreamImpl, which will call close() as part of finalization. Typically an Image{Input,Output}Stream will construct an instance of StreamFinalizer in its constructor if it detects that it has been subclassed by the user. The ImageInputStream instance will hold a reference to the StreamFinalizer, and the StreamFinalizer will hold a reference back to the ImageInputStream from which it was created. When both are no longer reachable, the StreamFinalizer.finalize() method will be called, which will take care of closing down the ImageInputStream. Clearly this is a bit of a hack, but it will likely only be used in the rarest of circumstances: when a user has subclassed one of the public stream classes. (It should be no worse than the old days when the public stream classes had non-empty finalize() methods.)

        disposerRecord = new CloseableDisposerRecord(raf);
        if (getClass() == FileImageInputStream.class) {
            disposerReferent = new Object();
            Disposer.addRecord(disposerReferent, disposerRecord);
        } else {
            disposerReferent = new StreamFinalizer(this);
        }
    }

        disposerRecord = new StreamDisposerRecord(cacheFile, cache);
        if (getClass() == FileCacheImageInputStream.class) {
            disposerReferent = new Object();
            Disposer.addRecord(disposerReferent, disposerRecord);
        } else {
            disposerReferent = new StreamFinalizer(this);
        }
    }

        disposerRecord = new CloseableDisposerRecord(raf);
        if (getClass() == FileImageOutputStream.class) {
            disposerReferent = new Object();
            Disposer.addRecord(disposerReferent, disposerRecord);
        } else {
            disposerReferent = new StreamFinalizer(this);
        }
    }

        disposerRecord = new StreamDisposerRecord(cache);
        if (getClass() == MemoryCacheImageInputStream.class) {
            disposerReferent = new Object();
            Disposer.addRecord(disposerReferent, disposerRecord);
        } else {
            disposerReferent = new StreamFinalizer(this);
        }
    }

Examples of ae.com.sun.imageio.stream.StreamFinalizer

Related Classes of ae.com.sun.imageio.stream.StreamFinalizer