com.bea.p13n.content
Class ContentHelper

java.lang.Object
  com.bea.p13n.content.ContentHelper

public class ContentHelper

extends Object

Helper class for dealing with Content, ContentManagers, and the possible subclasses.

Field Summary

static String	DEF_CONTENT_HOME Deprecated. Use DEF_CONTENT_MANAGER_HOME instead.
static String	DEF_CONTENT_MANAGER_HOME Deprecated. The default ContentManagerHome name.
static boolean	DEF_CONTENT_READONLY Deprecated. No longer needed.
static String	DEF_CONTENT_SCHEMA_HOME Deprecated. Use PropertySetManager and ejb-refs instead.
static String	DEF_DOCUMENT_HOME Deprecated. Use DEF_DOCUMENT_MANAGER_HOME instead.
static String	DEF_DOCUMENT_MANAGER_HOME Deprecated. The default DocumentManagerHome name.
static String	DEF_DOCUMENT_SCHEMA_HOME Deprecated. Use PropertySetManager and ejb-refs instead.
static boolean	USE_SOFT_HASH_MAP Deprecated. No longer needed.

Constructor Summary

ContentHelper()
Deprecated.

Method Summary

static Content[]	getContent(String homeName, Search s) Deprecated. Return an array of Content from the ContentManager at the given name.
static Content[]	getContent(String homeName, Search s) Deprecated. Use new Search instead
static Content[]	getContent(String homeName, Search s, boolean readOnly) Deprecated. Use getContent(String, Search) instead.
static Content[]	getContent(String homeName, Search s, boolean readOnly) Deprecated. Use new content expressions and getContent(String, Search) instead.
static Enumeration	getContentFromManager(String homeName, EJBHome home, Search s) Deprecated. use getContentManager(homeName, home).getContent(s) instead.
static Enumeration	getContentFromManager(String homeName, EJBHome home, Search s) Deprecated. use new content search and getContentManager(homeName, home).getContent(s) instead.
static Enumeration	getContentFromManager(String homeName, EJBHome home, Search s, boolean readOnly) Deprecated. Use getContentManager(homeName, home).getContent(s);
static Enumeration	getContentFromManager(String homeName, EJBHome home, Search s, boolean readOnly) Deprecated. Use new content expressions and getContentManager(homeName, home).getContent(s);
static Collection	getContentIds(String homeName, Search s) Deprecated. Return an rray of Content from the ContentManager or ContentHome at the given name.
static int	getContentLength(long docSize, int bytesLen) Deprecated. Return the correct content length.
static ContentManager	getContentManager(String homeName) Deprecated. Get a ContentManager from a JNDI home name.
static ContentManager	getContentManager(String homeName, EJBHome home) Deprecated. Get a ContentManager from an EJBHome.
static String	pathInfoEncode(String pathInfo) Deprecated. Correctly URLEncode a path-info string.
static Content[]	toArray(Enumeration e) Deprecated. Turn an Enumeration of Content into an array.
static String	toHTML(String in) Deprecated. Convert an arbitrary string to HTML which will display as the original string intended.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEF_CONTENT_HOME

public static final String DEF_CONTENT_HOME

Deprecated. Use DEF_CONTENT_MANAGER_HOME instead.

The default ContentHome name (always null).

DEF_CONTENT_MANAGER_HOME

public static final String DEF_CONTENT_MANAGER_HOME

Deprecated.

The default ContentManagerHome name.

This points to "java:comp/env/ejb/ContentManager", which is the closest <ejb-ref>'ed ContentManager home. The <ejb-ref> should be configured either in your EJB ejb-jar.xml deployment descriptor or in your webapp's web.xml deployment descriptor.

See Also:

Constant Field Values

DEF_CONTENT_READONLY

public static final boolean DEF_CONTENT_READONLY

Deprecated. No longer needed.

The default readonly flag for getting Content.

See Also:

Constant Field Values

DEF_CONTENT_SCHEMA_HOME

public static final String DEF_CONTENT_SCHEMA_HOME

Deprecated. Use PropertySetManager and ejb-refs instead.

The default Content SchemaHome name.

See Also:

Constant Field Values

DEF_DOCUMENT_HOME

public static final String DEF_DOCUMENT_HOME

Deprecated. Use DEF_DOCUMENT_MANAGER_HOME instead.

The default DocumentHome name (always null).

DEF_DOCUMENT_MANAGER_HOME

public static final String DEF_DOCUMENT_MANAGER_HOME

Deprecated.

The default DocumentManagerHome name.

This points to "java:comp/env/ejb/DocumentManager", which is the closest <ejb-ref>'ed DocumentManager home. The <ejb-ref> should be configured either in your EJB ejb-jar.xml deployment descriptor or in your webapp's web.xml deployment descriptor.

See Also:

Constant Field Values

DEF_DOCUMENT_SCHEMA_HOME

public static final String DEF_DOCUMENT_SCHEMA_HOME

Deprecated. Use PropertySetManager and ejb-refs instead.

The default Document SchemaHome name.

See Also:

Constant Field Values

USE_SOFT_HASH_MAP

public static boolean USE_SOFT_HASH_MAP

Deprecated. No longer needed.

Should caches use a SoftHashMap or not (always false).

Constructor Detail

ContentHelper

public ContentHelper()

Deprecated.

Method Detail

getContent

public static Content[] getContent(String homeName,
                                   Search s)
                            throws NamingException,
                                   RemoteException,
                                   FinderException,
                                   IllegalArgumentException

Deprecated.

Return an array of Content from the ContentManager at the given name.

If homeName points to a home for a ContentManager (or subclass), then the home's create() method will be invoked and the ContentManager's getContent() method will be used. The resulting enumeration will be put into an array.

Throws:

NamingException - thrown if home cannot be found.

RemoteException - thrown on communications error.

FinderException - thrown on error in findBySearchParams (never thrown)

IllegalArgumentException - thrown on any other error.

See Also:

getContentManager(java.lang.String)

getContent

public static Content[] getContent(String homeName,
                                   Search s)
                            throws NamingException,
                                   RemoteException,
                                   FinderException,
                                   IllegalArgumentException

Deprecated. Use new Search instead

Return an array of Content from the ContentManager at the given name.

If homeName points to a home for a ContentManager (or subclass), then the home's create() method will be invoked and the ContentManager's getContent() method will be used. The resulting enumeration will be put into an array.

Throws:

NamingException - thrown if home cannot be found.

RemoteException - thrown on communications error.

FinderException - thrown on error in findBySearchParams (never thrown)

IllegalArgumentException - thrown on any other error.

See Also:

getContentManager(java.lang.String), Search

getContent

public static Content[] getContent(String homeName,
                                   Search s,
                                   boolean readOnly)
                            throws NamingException,
                                   RemoteException,
                                   FinderException,
                                   IllegalArgumentException

Deprecated. Use getContent(String, Search) instead.

Return an array of Content from the ContentManager or ContentHome at the given name.

If homeName points to a home for a ContentManager (or subclass), then the home's create() method will be invoked and the ContentManager's getContent() method will be used. If homeName points to a home for Content (or subclasses), then it's findBySearchParams() method will used. The resulting enumeration will be put into an array.

Throws:

NamingException - thrown if home cannot be found.

RemoteException - thrown on communications error.

FinderException - thrown on error in findBySearchParams

IllegalArgumentException - thrown on any other error.

See Also:

getContent(java.lang.String, com.bea.p13n.content.expression.Search)

getContent

public static Content[] getContent(String homeName,
                                   Search s,
                                   boolean readOnly)
                            throws NamingException,
                                   RemoteException,
                                   FinderException,
                                   IllegalArgumentException

Deprecated. Use new content expressions and getContent(String, Search) instead.

Return an array of Content from the ContentManager or ContentHome at the given name.

If homeName points to a home for a ContentManager (or subclass), then the home's create() method will be invoked and the ContentManager's getContent() method will be used. If homeName points to a home for Content (or subclasses), then it's findBySearchParams() method will used. The resulting enumeration will be put into an array.

Throws:

NamingException - thrown if home cannot be found.

RemoteException - thrown on communications error.

FinderException - thrown on error in findBySearchParams

IllegalArgumentException - thrown on any other error.

See Also:

getContent(java.lang.String, com.bea.p13n.content.expression.Search)

getContentFromManager

public static Enumeration getContentFromManager(String homeName,
                                                EJBHome home,
                                                Search s)
                                         throws RemoteException,
                                                IllegalArgumentException

Deprecated. use getContentManager(homeName, home).getContent(s) instead.

Search for content from a ContentManager.

Parameters:

homeName - the JNDI home name (used for errors).

home - the EJBHome of the ContentManager.

s - the search parameters.

Returns:

the Enumeration of Content which match the search.

Throws:

RemoteException

IllegalArgumentException

See Also:

getContentManager(java.lang.String, javax.ejb.EJBHome)

getContentFromManager

public static Enumeration getContentFromManager(String homeName,
                                                EJBHome home,
                                                Search s)
                                         throws RemoteException,
                                                IllegalArgumentException

Deprecated. use new content search and getContentManager(homeName, home).getContent(s) instead.

Search for content from a ContentManager.

Parameters:

homeName - the JNDI home name (used for errors).

home - the EJBHome of the ContentManager.

s - the search parameters.

Returns:

the Enumeration of Content which match the search.

Throws:

RemoteException

IllegalArgumentException

See Also:

getContentManager(java.lang.String, javax.ejb.EJBHome)

getContentFromManager

public static Enumeration getContentFromManager(String homeName,
                                                EJBHome home,
                                                Search s,
                                                boolean readOnly)
                                         throws RemoteException,
                                                IllegalArgumentException

Deprecated. Use getContentManager(homeName, home).getContent(s);

Search for content from a ContentManager.

Parameters:

homeName - the JNDI home name (used for errors).

home - the EJBHome of the ContentManager.

s - the search parameters.

readOnly - the read-only flag (ignored).

Returns:

the Enumeration of Content which match the search.

Throws:

RemoteException

IllegalArgumentException

See Also:

getContentManager(java.lang.String, javax.ejb.EJBHome)

getContentFromManager

public static Enumeration getContentFromManager(String homeName,
                                                EJBHome home,
                                                Search s,
                                                boolean readOnly)
                                         throws RemoteException,
                                                IllegalArgumentException

Deprecated. Use new content expressions and getContentManager(homeName, home).getContent(s);

Search for content from a ContentManager.

Parameters:

homeName - the JNDI home name (used for errors).

home - the EJBHome of the ContentManager.

s - the search parameters.

readOnly - the read-only flag (ignored).

Returns:

the Enumeration of Content which match the search.

Throws:

RemoteException

IllegalArgumentException

See Also:

getContentManager(java.lang.String, javax.ejb.EJBHome)

getContentIds

public static Collection getContentIds(String homeName,
                                       Search s)
                                throws NamingException,
                                       RemoteException,
                                       FinderException,
                                       IllegalArgumentException

Deprecated.

Return an rray of Content from the ContentManager or ContentHome at the given name.

If homeName points to a home for a ContentManager (or subclass), then the home's create() method will be invoked and the ContentManager's getContentIds() method will be used.

Throws:

NamingException - thrown if home cannot be found.

RemoteException - thrown on communications error.

FinderException - thrown on error in findBySearchParams (never thrown)

IllegalArgumentException - thrown on any other error.

See Also:

getContentManager(java.lang.String)

getContentLength

public static int getContentLength(long docSize,
                                   int bytesLen)

Deprecated.

Return the correct content length. Since the getContent() method of Document does not guarentee that the resulting array will be the correct size (it might be larger), this method will tell what the actual number of bytes to use from that array is.

Parameters:

docSize - the value doc.getSize().

bytesLen - the length of the doc.getContent() array.

Returns:

the number of bytes in the content array which are valid.

See Also:

Document.getContent()

getContentManager

public static ContentManager getContentManager(String homeName)
                                        throws NamingException,
                                               CreateException,
                                               RemoteException,
                                               IllegalArgumentException

Deprecated.

Get a ContentManager from a JNDI home name.

Parameters:

homeName - the original home name.

Returns:

a ContentManager instance.

Throws:

NamingException - thrown on a lookup error.

CreateException - thrown on a creation error.

RemoteException - thrown on an error.

IllegalArgumentException - thrown on an invalid ejb home.

See Also:

getContentManager(java.lang.String, javax.ejb.EJBHome)

getContentManager

public static ContentManager getContentManager(String homeName,
                                               EJBHome home)
                                        throws CreateException,
                                               RemoteException,
                                               IllegalArgumentException

Deprecated.

Get a ContentManager from an EJBHome.

Parameters:

homeName - the original home name.

home - the EJBHome.

Returns:

a ContentManager instance.

Throws:

CreateException - thrown on a creation error.

RemoteException - thrown on an error.

IllegalArgumentException - thrown on an invalid ejb home.

pathInfoEncode

public static String pathInfoEncode(String pathInfo)

Deprecated.

Correctly URLEncode a path-info string.

This can be used to pass a contentId as Path-Info to the ShowDocServlet.

This will url encode the pathInfo, but will leave "/"'s alone.

toArray

public static Content[] toArray(Enumeration e)

Deprecated.

Turn an Enumeration of Content into an array.

Parameters:

e - the Enumeration.

Returns:

an array of the Content objects.

Throws:

ClassCastException - thrown if the objects in the Enumeration aren't Content objects.

toHTML

public static String toHTML(String in)

Deprecated.

Convert an arbitrary string to HTML which will display as the original string intended.

This will replace the characters '&', '"', '<', and '>' with '&amp;', &quot;', '&lt;', and '&gt;', respectively.