*** This class provides Binary Compatibility only, not Source Compatibility ***

com.sas.services.publish
Class ViewerEntry

com.sas.services.publish.ViewerEntry

All Implemented Interfaces:

com.sas.entities.EntityKeyInterface, com.sas.io.InputStreamProviderInterface, com.sas.io.ReaderProviderInterface, EntryInterface, ViewerEntryInterface, java.io.Serializable, java.rmi.Remote

public class ViewerEntry
implements ViewerEntryInterface

Represents a viewer entry that can then be added to a result package for publishing. In the MVA Publishing Framework, a viewer is a custom-written template that contains HTML tags for formatting result set package content for view-only transports, such as e-mail. The viewer file is applied to the package during package publishing. A viewer file is particularly useful for rendering a SAS data set in a tabular format for viewing in e-mail. Also, it is useful for streaming dynamic information in the form of a binary file or a URL for inclusion in an electronic newsletter format.

The viewer is not used for rendering purposes in the Java Publishing Framework, but viewer entries can be published and retrieved.

See Constructing a Result Package to Publish for an example of how this class is used.

Since:

1.0

See Also:

Serialized Form

Field Summary

Fields inherited from class com.sas.services.publish.AbstractEntry

BINARY_COMPAT_VERSION, CATALOG_COMPAT_VERSION, DATASET_COMPAT_VERSION, DEFAULT_ENTRY_VERSION, HTML_COMPAT_VERSION, MDDB_COMPAT_VERSION, NESTEDPACKAGE_COMPAT_VERSION, REFERENCE_COMPAT_VERSION, SQLVIEW_COMPAT_VERSION, TEXT_COMPAT_VERSION, VIEWER_COMPAT_VERSION

Fields inherited from interface com.sas.services.publish.ViewerEntryInterface

HTML_VIEWER, TEXT_VIEWER

Constructor Summary

	ViewerEntry() Creates a default instance.
protected	ViewerEntry(java.lang.Class theClass) Creates a new text file entry exporting a remote object using RMI socket factories appropriate for the specified class.
	ViewerEntry(java.io.File file, int viewerType) Creates a viewer entry.
	ViewerEntry(java.io.InputStream inputStream, java.lang.String name, int viewerType) Creates a viewer entry.

Method Summary

protected void	closeEntry() Remove any temporary files needed for inputstream re-use and mark this entry as closed.
void	consumeStream() Consume and close the input stream provided on the constructor.
protected void	finalize() At finalize time, cleanup temporary files if necessary.
java.lang.String	getEncoding() Returns the encoding of the viewer.
java.io.InputStream	getInputStream() Gets the input stream for this binary file entry.
java.io.InputStream	getInputStream(java.lang.Object streamID) Deprecated. Use getInputStream()which now supports remote input streams.
java.lang.String	getMIMEType() Returns the MIME type associated with this viewer entry.
java.lang.String	getName() Returns the name of the file.
java.io.Reader	getReader() Gets reader for the text file entry.
java.io.Reader	getReader(java.lang.Object readerID) Deprecated. Use getReader()which now supports remote readers.
com.sas.io.RemoteInputStreamInterface	getRemoteInputStream(java.lang.Object streamID) Deprecated. Use getInputStream()which now supports remote input streams.
com.sas.io.RemoteReaderInterface	getRemoteReader(java.lang.Object readerID) Deprecated. Use getReader()which now supports remote readers.
int	getViewerType() Returns the type of viewer, HTML or text.
java.lang.Object	hasInputStream() Deprecated. this method no longer needed as getInputStream() will return an input stream that can be used in a remote environment
java.lang.Object	hasReader() Deprecated. this method no longer needed as getReader() will return a reader that can be used in a remote environment
void	setEncoding(java.lang.String encoding) Sets the viewer encoding.
void	setMIMEType(java.lang.String mimeType) Sets the MIME associated with this file entry.

Methods inherited from class com.sas.services.publish.AbstractEntry

getDescription, getEntityKey, getNameValuePairs, getURL, isClosed, isReadOnly, sameEntity, setClosed, setDescription, setEntityKey, setNameValuePairs, setRead, throwExceptionIfClosed

Methods inherited from interface com.sas.services.publish.EntryInterface

getDescription, getNameValuePairs, getURL, isReadOnly, setDescription, setNameValuePairs

Constructor Detail

ViewerEntry

public ViewerEntry()
            throws java.rmi.RemoteException

Creates a default instance. This constructor should not be used and is only provided since the compiler was previously providing a default public constructor. Use ViewerEntry(File file, int viewerType)or ViewerEntry(InputStream inputStream, String name, int viewerType) instead.

Throws:

java.rmi.RemoteException - If a network anomaly is encountered.

ViewerEntry

protected ViewerEntry(java.lang.Class theClass)
               throws java.rmi.RemoteException

Creates a new text file entry exporting a remote object using RMI socket factories appropriate for the specified class.

Parameters:

theClass - The class to use when determine which RMI socket factories are to be used when exporting a remote object.

Throws:

java.rmi.RemoteException - If a network anomaly is encountered.

ViewerEntry

public ViewerEntry(java.io.File file,
                   int viewerType)
            throws java.lang.IllegalArgumentException,
                   java.rmi.RemoteException

Creates a viewer entry. When the viewer file is published, the file name is used as the name. If a different name is preferred, use the constructor that takes the input stream and the name of the entry.

Parameters:

file - The viewer file.

viewerType - The type of viewer. Valid types include HTML_VIEWERor TEXT_VIEWER.

There is no default MIME type. To set the MIME type for the entry, use setMIMEType(java.lang.String).

Throws:

java.lang.IllegalArgumentException - If a null file or an an invalid viewer type is specified.

java.rmi.RemoteException - If a network anomaly is encountered.

ViewerEntry

public ViewerEntry(java.io.InputStream inputStream,
                   java.lang.String name,
                   int viewerType)
            throws java.lang.IllegalArgumentException,
                   java.rmi.RemoteException

Creates a viewer entry. When the viewer file is published, the input stream will be consumed until end-of-file.

Parameters:

inputStream - The input stream of the viewer file.

name - The name of the viewer entry. This name will be used as the name of the entry when publishing the package.

viewerType - The type of viewer. Valid types include HTML_VIEWERor TEXT_VIEWER.

There is no default MIME type. To set the MIME type for the entry, use setMIMEType(java.lang.String).

Throws:

java.lang.IllegalArgumentException - If a null input stream, a null name, or an invalid viewer type is specified.

java.rmi.RemoteException - If a network anomaly is encountered.

Method Detail

getName

public java.lang.String getName()
                         throws java.rmi.RemoteException,
                                TransportException,
                                java.lang.IllegalStateException

Returns the name of the file.

Specified by:

getName in interface ViewerEntryInterface

Returns:

String The name of the file.

Throws:

java.lang.IllegalStateException - if the result package containing this entry has already been closed.

TransportException - If the transport encounters an error getting the name of the file.

java.rmi.RemoteException - If a network anomaly is encountered.

getMIMEType

public java.lang.String getMIMEType()
                             throws java.rmi.RemoteException,
                                    TransportException,
                                    java.lang.IllegalStateException

Returns the MIME type associated with this viewer entry. The user-specified MIME type is assigned when the viewer entry is published.

Specified by:

getMIMEType in interface ViewerEntryInterface

Returns:

String The MIME type associated with this file; can be null.

Throws:

java.lang.IllegalStateException - if the result package containing this entry has already been closed.

TransportException - If the transport encounters an error getting the MIME type.

java.rmi.RemoteException - If a network anomaly is encountered.

setMIMEType

public void setMIMEType(java.lang.String mimeType)
                 throws java.lang.IllegalStateException,
                        java.rmi.RemoteException

Sets the MIME associated with this file entry.

Specified by:

setMIMEType in interface ViewerEntryInterface

Parameters:

mimeType - The MIME type associated with this file entry.

Throws:

java.lang.IllegalStateException - If the entry is read only or if the package containing this entry has already been closed.

java.rmi.RemoteException - If a network anomaly is encountered.

getViewerType

public int getViewerType()
                  throws java.rmi.RemoteException,
                         TransportException,
                         java.lang.IllegalStateException

Returns the type of viewer, HTML or text.

Specified by:

getViewerType in interface ViewerEntryInterface

Returns:

int The type of viewer. Supported viewer types include HTML_VIEWERor TEXT_VIEWER.

Throws:

java.lang.IllegalStateException - if the result package containing this entry has already been closed.

TransportException - If the transport encounters an error getting the viewer type.

java.rmi.RemoteException - If a network anomaly is encountered

getEncoding

public java.lang.String getEncoding()
                             throws java.rmi.RemoteException,
                                    java.lang.IllegalStateException

Returns the encoding of the viewer. If this is a text viewer, the text viewer may be in a different encoding. This method provides the text encoding, so that it can be used when creating readers to read the text viewer. If this is an HTML viewer, this identifies the encoding of the HTML file.

Specified by:

getEncoding in interface ViewerEntryInterface

Returns:

String The encoding of the viewer; can be null.

Throws:

java.lang.IllegalStateException - if the result package containing this entry has already been closed.

java.rmi.RemoteException - If a network anomaly is encountered.

setEncoding

public void setEncoding(java.lang.String encoding)
                 throws java.lang.IllegalStateException,
                        java.rmi.RemoteException

Sets the viewer encoding.

If this is a text viewer, the encoding is used when constructing the Reader that is returned by getReader and getRemoteReader, and it is used to publish the viewer.

If this is an HTML viewer, the encoding of the HTML viewer is published as metadata along with the viewer entry. When published, the HTML viewer is parsed. If the charset= attribute is specified in the META tag, this encoding value will be used. If not found, the value set using this method will be used. Otherwise, a default encoding will be determined.

Specified by:

setEncoding in interface ViewerEntryInterface

Parameters:

encoding - The encoding for this viewer.

Throws:

java.lang.IllegalStateException - If the entry is read only or if the result package containing this entry has already been closed.

java.rmi.RemoteException - If a network anomaly is encountered

getInputStream

public java.io.InputStream getInputStream()
                                   throws java.rmi.RemoteException,
                                          java.io.IOException,
                                          java.lang.IllegalStateException

Gets the input stream for this binary file entry.

Specified by:

getInputStream in interface ViewerEntryInterface

Returns:

The input stream that can be used for reading the contents of the binary file entry.

Throws:

java.lang.IllegalStateException - if the result package containing this entry has already been closed.

java.io.IOException - If an error occurs constructing the input stream.

java.rmi.RemoteException - If a network anomaly is encountered.

getReader

public java.io.Reader getReader()
                         throws java.lang.IllegalStateException,
                                java.rmi.RemoteException,
                                java.io.IOException

Gets reader for the text file entry.

Specified by:

getReader in interface ViewerEntryInterface

Returns:

The reader that can be used for reading the contents of the text file entry.

Throws:

java.rmi.UnmarshalException - If invoked on a remote object.

java.lang.IllegalStateException - if the result package containing this entry has already been closed.

java.io.IOException - If an error occurs constructing the input stream.

java.rmi.RemoteException - If a network anomaly is encountered.

getInputStream

public java.io.InputStream getInputStream(java.lang.Object streamID)
                                   throws java.rmi.RemoteException,
                                          java.io.IOException,
                                          java.lang.IllegalStateException,
                                          java.rmi.UnmarshalException

Deprecated. Use getInputStream()which now supports remote input streams.

Gets the input stream for this binary file entry. Because input streams are not remotable, this method will throw a RemoteException if it is invoked on a remote object. Distributed applications should utilize getRemoteInputStream(java.lang.Object)in order to obtain the input stream.

Specified by:

getInputStream in interface com.sas.io.InputStreamProviderInterface

Specified by:

getInputStream in interface ViewerEntryInterface

Parameters:

streamID - The stream description should be null; it will be ignored.

Returns:

The input stream that can be used for reading the contents of the binary file entry.

Throws:

java.rmi.UnmarshalException - If invoked on a remote object.

java.lang.IllegalStateException - if the result package containing this entry has already been closed.

java.io.IOException - If an error occurs constructing the input stream.

java.rmi.RemoteException - If a network anomaly is encountered.

getRemoteInputStream

public com.sas.io.RemoteInputStreamInterface getRemoteInputStream(java.lang.Object streamID)
                                                           throws java.lang.IllegalStateException,
                                                                  com.sas.io.ChainedIOException,
                                                                  java.rmi.RemoteException

Deprecated. Use getInputStream()which now supports remote input streams.

Get the HTML viewer as a remote input stream. If your application runs in a distributed environment, it is suggested that you use RemoteInputStream. InputStreams are not remote objects.

Specified by:

getRemoteInputStream in interface com.sas.io.InputStreamProviderInterface

Specified by:

getRemoteInputStream in interface ViewerEntryInterface

Parameters:

streamID - The stream description should be null ;it will be ignored.

Returns:

RemoteInputStream The file as a remote input stream.

Throws:

java.lang.IllegalStateException - If the package has already been closed or if this is a text viewer. Text viewers support readers. HTML viewers support input streams.

com.sas.io.ChainedIOException - If an I/O error occurs obtaining the input stream.

java.rmi.RemoteException - If a network anomaly is encountered.

getReader

public java.io.Reader getReader(java.lang.Object readerID)
                         throws java.lang.IllegalStateException,
                                java.rmi.RemoteException,
                                java.io.IOException

Deprecated. Use getReader()which now supports remote readers.

Gets reader for the text file entry. Because readers are not remotable, this method will throw a RemoteException if it is invoked on a remote object. Distributed applications should utilize getRemoteReader(java.lang.Object) in order to obtain the reader.

Specified by:

getReader in interface com.sas.io.ReaderProviderInterface

Specified by:

getReader in interface ViewerEntryInterface

Parameters:

readerID - The reader description should be null; it will be ignored.

Returns:

The reader that can be used for reading the contents of the text file entry.

Throws:

java.rmi.UnmarshalException - If invoked on a remote object.

java.lang.IllegalStateException - if the result package containing this entry has already been closed.

java.io.IOException - If an error occurs constructing the input stream.

java.rmi.RemoteException - If a network anomaly is encountered.

getRemoteReader

public com.sas.io.RemoteReaderInterface getRemoteReader(java.lang.Object readerID)
                                                 throws java.lang.IllegalStateException,
                                                        com.sas.io.ChainedIOException,
                                                        java.rmi.RemoteException

Deprecated. Use getReader()which now supports remote readers.

Get the a remote reader. Because the Reader class is not a remotable, distributed applications should use a RemoteReader.

Specified by:

getRemoteReader in interface com.sas.io.ReaderProviderInterface

Specified by:

getRemoteReader in interface ViewerEntryInterface

Parameters:

readerID - The reader description should be null ;it will be ignored.

Returns:

RemoteReader The file as a remote Reader.

Throws:

java.lang.IllegalStateException - If the result package has already been closed or of this is an HTML viewer. Text viewers support readers. HTML viewers support input streams.

com.sas.io.ChainedIOException - If the transport encounters an I/O error obtaining the reader.

java.rmi.RemoteException - If a network anomaly is encountered.

hasInputStream

public java.lang.Object hasInputStream()
                                throws java.rmi.UnmarshalException,
                                       java.rmi.RemoteException,
                                       java.lang.IllegalStateException

Deprecated. this method no longer needed as getInputStream() will return an input stream that can be used in a remote environment

Check if getInputStream(Object streamID)will succeed. See getInputStream(Object streamID)to determine whether this method should be used.

Specified by:

hasInputStream in interface com.sas.io.InputStreamProviderInterface

Specified by:

hasInputStream in interface ViewerEntryInterface

Returns:

non-null if getInputStream(java.lang.Object) would succeed; throws UnmarshalException if it would fail

Throws:

java.rmi.UnmarshalException - if invoked on a remote object

java.lang.IllegalStateException - if the result package containing this entry has already been closed.

java.rmi.RemoteException - if a network I/O error occurs.

hasReader

public java.lang.Object hasReader()
                           throws java.rmi.UnmarshalException,
                                  java.rmi.RemoteException,
                                  java.lang.IllegalStateException

Deprecated. this method no longer needed as getReader() will return a reader that can be used in a remote environment

Check if getReader(java.lang.Object)will succeed. See getReader(java.lang.Object)to determine whether this method should be used.

Specified by:

hasReader in interface com.sas.io.ReaderProviderInterface

Specified by:

hasReader in interface ViewerEntryInterface

Returns:

non-null if getReader(java.lang.Object) would succeed; throws UnmarshalException if it would fail

Throws:

java.rmi.UnmarshalException - if invoked on a remote object

java.rmi.RemoteException - if a network I/O error occurs.

java.lang.IllegalStateException - if the result package containing this entry has already been closed.

consumeStream

public void consumeStream()
                   throws java.io.IOException,
                          java.rmi.RemoteException,
                          java.lang.IllegalStateException

Consume and close the input stream provided on the constructor. If an input stream is provided on the entry's constructor, then it does not get consumed until the package is published. This method may be invoked to force the stream to get consumed and closed immediately instead of waiting until the publish occurs.

Throws:

java.lang.IllegalStateException - If the package containing this entry is already closed.

java.io.IOException - If an error occurs constructing the input stream.

java.rmi.RemoteException - If a network anomaly is encountered.

closeEntry

protected void closeEntry()

Remove any temporary files needed for inputstream re-use and mark this entry as closed.

finalize

protected void finalize()
                 throws java.lang.Throwable

At finalize time, cleanup temporary files if necessary.

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable

*** This class provides Binary Compatibility only, not Source Compatibility ***