
// Copyright (c) 2000 Oracle Corporation
package oracle.portal.provider.v1;

/**
 * Second extension to the MutablePortlet interface.  First extension
 * was (mis)named MutableMobilePortlet.  Extensions are created when
 * new meta data is added to preserve compatibility with existing
 * portlet implementations (that implement the base interfaces).
 */
public interface MutablePortletXtra2 extends PortletXtra2, MutableMobilePortlet {

    /**
     * Sets the short title for the portlet.  A short title is a name
     *  identifying the portlet and is used by the portal when there is
     *  limited real estate.  For example the short title is used when
     *  rendering the mobile link to a portlet.
     *
     * @param the short title of the portlet.
     */
    public void setShortTitle(String title);

    /**
     * Sets the portlet's mobile settings.
     * The flags values are defined by the <code>MobileFlags</code> interface.
     *
     * @param the portlet's mobile setting in a bitwise flag
     */
    public void setMobileFlags(long flags);

    /**
     * Sets the portlet's mobile settings. The flags values are defined by the
     * <code>MobileFlags</code> interface.
     * This form allows you to set the flags as a string.
     * The string can either be the (case insensitive) delimited
     * names of the flags or the number itself (as a String).  E.g.
     * passing "MOBILE_ONLY | EXTERNAL_SHOW" is the same as
     * passing the string "3" to the method.
     *
     *
     * @param the portlet's mobile setting in a bitwise flag
     */
    public void setMobileFlags(String flags) throws IllegalArgumentException;

    /**
     * Controls whether this Portlet is capable of rendering content for link
     * mode.
     *
     * This method is equivalent to <code>setShowLinkMode()</code> in
     * <code>MutableMobilePortlet</code> It was added to make the naming of
     * this method consistent with the other SHOW accessors.
     *
     * @param value boolean flag.
     */
    public void setShowLink(boolean value);
    
    /**
     * Controls whether this Portlet is capable of rendering content for link
     * mode.
     *
     * This method is equivalent to <code>setShowLinkMode()</code> in
     * <code>MutableMobilePortlet</code> It was added to make the naming of
     * this method consistent with the other SHOW accessors.
     *
     * @param value String representing a boolean.
     */
    public void setShowLink(String value);



}

 