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

com.sas.services.publish
Interface HTMLFileInterface

All Superinterfaces:
com.sas.entities.EntityKeyInterface, com.sas.io.InputStreamProviderInterface, java.rmi.Remote
All Known Implementing Classes:
HTMLFile

public interface HTMLFileInterface
extends com.sas.io.InputStreamProviderInterface, com.sas.entities.EntityKeyInterface, java.rmi.Remote

The HTMLFileInterface provides a mechanism for setting and getting the attributes of a file contained within an HTML entry.

Files that implement HTMLFileInterface can be inserted into an HTML entry. HTMLEntryInterface is a container for various files that implement HTMLFileInterface. Within MVA SAS, the ODS HTML statement generates HTML files. The body file contains the results from the procedure. The contents file is a table of contents that links to the body file. The pages file is a table of pages that links to the body file. The frame file is a frame that displays the table of contents, the table of pages and the body file. The HTML entry provides a way to identify each of these files, and encapsulate them into one entry.

The HTML file is limited to just one role. One file should be designated as the main file for the HTML entry. The main file identifies which file in the HTML entry should be used as the starting point when browsing the HTML entry. The main file will have a role of MAIN_BODY_FILE or MAIN_FRAME_FILE. If a frame file exists, it should be designated as the main file; otherwise, the body file should be designated as the main file. All other files are considered companion files. The companion files are any files other than the main HTML file. The companion files can include, body, frame, contents and page files, as well as any miscellaneous files (such as HTML, GIF, JPG) needed by the HTML entry. Supported companion roles include FRAME_COMPANION, BODY_COMPANION, PAGE_COMPANION, CONTENTS_COMPANION, MISC_COMPANION.

Since:
1.0
See Also:
HTMLEntryInterface

Field Summary
static int BODY_COMPANION
          A companion body file.
static int CONTENTS_COMPANION
          A companion contents file.
static int FRAME_COMPANION
          A companion frame file.
static int MAIN_BODY_FILE
          The main body file.
static int MAIN_FRAME_FILE
          The main frame file.
static int MISC_COMPANION
          A miscellaneous companion file.
static int PAGE_COMPANION
          A companion page file.
 
Method Summary
 java.lang.String getEncoding()
          Returns the encoding of the file.
 java.io.InputStream getInputStream()
          Gets the input stream for this HTML or companion file.
 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 file.
 java.lang.String getName()
          Returns the name of the file.
 com.sas.io.RemoteInputStreamInterface getRemoteInputStream(java.lang.Object streamID)
          Deprecated. Use getInputStream() which now supports remote input streams.
 int getRole()
          Returns the role of this file.
 java.lang.String getURL()
          Returns the URL of the file.
 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
 void setEncoding(java.lang.String encoding)
          Sets the file encoding.
 void setMIMEType(java.lang.String mimeType)
          Sets the MIME type associated with this file.
 void setURL(java.lang.String url)
          Sets the URL of the file.
 

Field Detail

MAIN_BODY_FILE

static final int MAIN_BODY_FILE
The main body file.

See Also:
Constant Field Values

BODY_COMPANION

static final int BODY_COMPANION
A companion body file.

See Also:
Constant Field Values

FRAME_COMPANION

static final int FRAME_COMPANION
A companion frame file.

See Also:
Constant Field Values

CONTENTS_COMPANION

static final int CONTENTS_COMPANION
A companion contents file.

See Also:
Constant Field Values

PAGE_COMPANION

static final int PAGE_COMPANION
A companion page file.

See Also:
Constant Field Values

MISC_COMPANION

static final int MISC_COMPANION
A miscellaneous companion file.

See Also:
Constant Field Values

MAIN_FRAME_FILE

static final int MAIN_FRAME_FILE
The main frame file.

See Also:
Constant Field Values
Method Detail

getEncoding

java.lang.String getEncoding()
                             throws java.rmi.RemoteException,
                                    java.lang.IllegalStateException
Returns the encoding of the file.

Returns:
String The file encoding.
Throws:
java.rmi.RemoteException - If a network anomaly is encountered.
java.lang.IllegalStateException - If the package containing this entry is already closed.

setEncoding

void setEncoding(java.lang.String encoding)
                 throws java.lang.IllegalStateException,
                        java.rmi.RemoteException
Sets the file encoding. When an HTML entry is published, the encoding of the HTML is published as metadata along with the HTML entry. When published, the HTML file is parsed. If the charset= attribute is specified in the META tag, this encoding value will be used. If not found, the value specified on this method will be used. Otherwise, a default encoding of ISO-8859-1 will set set.

Parameters:
encoding - The encoding of the file.
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.

getURL

java.lang.String getURL()
                        throws java.rmi.RemoteException,
                               java.lang.IllegalStateException
Returns the URL of the file.

Returns:
String The URL for the file.
Throws:
java.rmi.RemoteException - If a network anomaly is encountered.
java.lang.IllegalStateException - If the package containing this entry is already closed.

setURL

void setURL(java.lang.String url)
            throws java.lang.IllegalStateException,
                   java.rmi.RemoteException
Sets the URL of the file.

Parameters:
url - The URL for the file.
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.

getName

java.lang.String getName()
                         throws java.rmi.RemoteException,
                                java.lang.IllegalStateException
Returns the name of the file.

Returns:
String The name of the file.
Throws:
java.rmi.RemoteException - If a network anomaly is encountered.
java.lang.IllegalStateException - If the package containing this entry is already closed.

getRole

int getRole()
            throws java.rmi.RemoteException,
                   java.lang.IllegalStateException
Returns the role of this file.

Returns:
int The role of this file. Supported roles include BODY_COMPANION, MAIN_BODY_FILE, MAIN_FRAME_FILE, FRAME_COMPANION, CONTENTS_COMPANION, PAGE_COMPANION and MISC_COMPANION.
Throws:
java.rmi.RemoteException - If a network anomaly is encountered.
java.lang.IllegalStateException - If the package containing this entry is already closed.

getMIMEType

java.lang.String getMIMEType()
                             throws java.rmi.RemoteException,
                                    java.lang.IllegalStateException
Returns the MIME type associated with this file. The user-specified MIME type is assigned when the file is published.

Returns:
String The MIME type associated with this file; can be null.
Throws:
java.rmi.RemoteException - If a network anomaly is encountered.
java.lang.IllegalStateException - If the package containing this entry is already closed.

setMIMEType

void setMIMEType(java.lang.String mimeType)
                 throws java.lang.IllegalStateException,
                        java.rmi.RemoteException
Sets the MIME type associated with this file.

Parameters:
mimeType - The MIME type associated with this file.
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.

getInputStream

java.io.InputStream getInputStream(java.lang.Object streamID)
                                   throws java.rmi.UnmarshalException,
                                          java.io.IOException,
                                          java.rmi.RemoteException,
                                          java.lang.IllegalStateException
Deprecated. Use getInputStream() which now supports remote input streams.

Gets the input stream for this HTML or companion file. 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
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 this file.
Throws:
java.rmi.UnmarshalException - If invoked on a remote object.
java.io.IOException - If an error occurs constructing the input stream.
java.rmi.RemoteException - If a network anomaly is encountered.
java.lang.IllegalStateException - If the package containing this entry is already closed.

getRemoteInputStream

com.sas.io.RemoteInputStreamInterface getRemoteInputStream(java.lang.Object streamID)
                                                           throws java.io.IOException,
                                                                  java.rmi.RemoteException,
                                                                  java.lang.IllegalStateException
Deprecated. Use getInputStream() which now supports remote input streams.

Get the remote input stream for the HTML or companion file. Because input streams are not remotable, distributed applications should use remote input streams.

Specified by:
getRemoteInputStream in interface com.sas.io.InputStreamProviderInterface
Parameters:
streamID - The stream description should be null; it will be ignored.
Returns:
RemoteInputStream The remote input stream that can be used for reading the contents of this file.
Throws:
java.io.IOException - If an error occurs constructing the remote input stream.
java.rmi.RemoteException - If a network anomaly is encountered.
java.lang.IllegalStateException - If the package containing this entry is already closed.

hasInputStream

java.lang.Object hasInputStream()
                                throws java.rmi.UnmarshalException,
                                       java.rmi.RemoteException
Deprecated.  this method no longer needed as getInputStream() will return an input stream that can be used in a remote environment

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

Specified by:
hasInputStream in interface com.sas.io.InputStreamProviderInterface
Returns:
Object non-null if getInputStream(java.lang.Object) would succeed; throws UnmarshalException if it would fail
Throws:
java.rmi.UnmarshalException - if invoked on a remote obejct
java.rmi.RemoteException - if a network anomaly is encountered.
java.lang.IllegalStateException - if this result package has already been closed.

getInputStream

java.io.InputStream getInputStream()
                                   throws java.io.IOException,
                                          java.rmi.RemoteException,
                                          java.lang.IllegalStateException
Gets the input stream for this HTML or companion file.

Returns:
The input stream that can be used for reading the contents of this file.
Throws:
java.io.IOException - If an error occurs constructing the input stream.
java.rmi.RemoteException - If a network anomaly is encountered.
java.lang.IllegalStateException - If the package containing this entry is already closed.

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




Copyright © 2009 SAS Institute Inc. All Rights Reserved.