org.springframework.core.io Documentation Differences

This file contains all the changes in documentation in the package org.springframework.core.io as colored differences. Deletions are shown like this, and additions are shown like this.

If no deletions or additions are shown in an entry, the HTML tags will be what has changed. The new HTML tags are shown in the differences. If no documentation existed, and then some was added in a later version, this change is noted in the appropriate class pages of differences, but the change is not shown on this page. Only changes in existing text are shown here. Similarly, documentation which was inherited from another class or interface is not shown here.

Note that an HTML error in the new documentation may cause the display of other documentation changes to be presented incorrectly. For instance, failure to close a <code> tag will cause all subsequent paragraphs to be displayed differently.

This implementation checksreads the entire InputStream to calculate the content length. of the underlyingSubclasses will almost Filealways be able to provide a more optimal version of this, ife.g. checking a File availablelength. @see #getFilegetInputStream() @throws IllegalStateException if .getInputStream() returns null.

This implementation always throwsreturns IllegalStateExceptionnull, assuming that thethis resource type does not have a filename.

Resource implementation for class path resources. Uses either a given ClassLoader or a given Class for loading resources.

Supports resolution as java.io.File if the class path resource resides in the file system, but not for resources in a JAR. Always supports resolution as URL. @author Juergen Hoeller @author Sam Brannen @since 28.12.2003 @see java.lang.ClassLoader#getResourceAsStream(String) @see java.lang.Class#getResourceAsStream(String)

This implementation checksreturns the length of the underlying File, 's if availablelength. @see #getFile()

Return an InputStream.

It is expected that each call creates a fresh stream.

This requirement is particularly important when you consider an API such as JavaMail, which needs to be able to read the stream multiple times when creating mail attachments. For such a use case, it is required that each getInputStream() call returns a fresh stream. @return the input stream for the underlying resource (must not be {@code null}) @throws IOException if the stream could not be opened @see org.springframework.mail.javamail.MimeMessageHelper#addAttachment(String, InputStreamSource)

ReturnDetermine a filename for this resource, i.e. typically the last part of the path: for example, "myfile.txt".

Returns null if this type of resource does not have a filename.

VFS based Resource implementation. Supports the corresponding VFS API versions on JBoss AS 5.x as well as 6.x and 7.x. @author Ales Justin @author Juergen Hoeller @author Costin Leau @since 3.0 @see org.jboss.virtual.VirtualFile @see org.jboss.vfs.VirtualFile