Overview | Package | Class | Tree | Deprecated | Index | Help
| © 2004 BEA Systems, Inc.
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## com.bea.content.manager.servlets.jsp.taglib
Class GetPropertyTag

    java.lang.Object
      javax.servlet.jsp.tagext.TagSupport
          com.bea.content.manager.servlets.jsp.taglib.BaseTag
              com.bea.content.manager.servlets.jsp.taglib.GetPropertyTag

All Implemented Interfaces:
  IterationTag, Serializable, Tag

public class GetPropertyTag
extends BaseTag

Tag to retrieve or print a property of a Node.

The Node must be set as an attribute of the page context with the id specified in this tag.

If the property is of type Property.BINARY and is a text document (eg. .txt, .html) then the document will be printed. If the BINARY property is not a document (eg. .gif, .pdf) then ShowBinaryServlet should be used.

If the property name is not specified the primary property will be used, if defined.

If a resultId is defined then it will be set with the value(s) of the Property. If there are multiple values then it will be set as a Collection. If the resultId is not set then the value(s) will be printed

If the following standard properties are used as the property name then the corresponding value from the Node will be returned.

- cm_nodeName
- cm_path
- cm_createdBy
- cm_modifiedBy
- cm_createdDate
- cm_modifiedDate

  See Also:
    Serialized Form

  Field Summary
  `protected String` | `baseHref` The BASE HREF to use.
  `protected int` | `blockSize` The block size to read the data in.
  `protected String` | `conversionType` The conversion type.
  `protected String` | `dateFormat` The date format to use.
  `protected String` | `defValue` The default value to print if the property is not found, or if the property does not contain a value.
  `protected int` | `endIndex` The index at which we should stop reading.
  `protected boolean` | `isMultiple` If this is true then a Collection will be returned as the resultId, if false then an Object will be returned that may be cast to the appropriate Property type.
  `protected String` | `name` The name of the property to print.
  `protected Node` | `node` The Node to use.
  `protected String` | `numFormat` The number format to use.
  `protected Property` | `property` The Property to use.
  `protected String` | `resultId` The id of the script variable to put the result into.
  `protected String` | `resultType` The Type of the result.
  `protected int` | `startIndex` The index at which we should start reading.
  `protected int` | `transactionTimeout` The streaming of the data directly to the jsp page is wrapped in a transaction to cover the situation where the back-end system is transactional (like a database) and the InputStream retrieved is tied to that transactional resource (like a BlobInputStream).

  Fields inherited from class com.bea.content.manager.servlets.jsp.taglib.BaseTag
  `cacheId, cacheScope, cacheTimeout, failOnError, useCache`

  Fields inherited from class javax.servlet.jsp.tagext.TagSupport
  `id, pageContext`

  Fields inherited from interface javax.servlet.jsp.tagext.IterationTag
  `EVAL_BODY_AGAIN`

  Fields inherited from interface javax.servlet.jsp.tagext.Tag
  `EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE`

  Constructor Summary
  `GetPropertyTag()`

  Method Summary
  `String` | `convert(String in)` Convert a string with the current convertType.
  `static String` | `convert(String conversionType, String in)` Convert a string according to the specified convertType.
  `protected int` | `doBinary(BinaryValue binaryValue)`
  `protected int` | `doNonBinary(Collection values)`
  `int` | `doStartTag()` Start the tag.
  `String` | `getBaseHref()` Get the value of `baseHref`.
  `String` | `getBlockSize()` Get the value of `blockSize` as a String.
  `String` | `getConversionType()` Get the value of `conversionType`.
  `String` | `getDateFormat()` Get the `date format` to use.
  `String` | `getDefault()` Get the `default` value.
  `String` | `getEndIndex()` Get the value of `endIndex` as a String.
  `String` | `getIsMultiple()` Get the value of `isMultiple`.
  `String` | `getName()` Get the value of `name`.
  `Node` | `getNode()` Get the Node to use.
  `String` | `getNumFormat()` Get the `number format` to use.
  `Collection` | `getPropertyValues()`
  `URL` | `getRequestBaseHref(HttpServletRequest request)` Gets the request base href.
  `String` | `getResultId()` Get the `resultId`.
  `String` | `getResultType()` Get the `resultId`.
  `URL` | `getServerBaseHref(HttpServletRequest request)` Gets the servers BaseHref.
  `String` | `getStartIndex()` Get the value of `startIndex` as a String.
  `String` | `getTransactionTimeout()` Get the value of `transactionTimeout`
  `void` | `print(String s)` Print the String to the JspWriter.
  `void` | `println(String s)` Println the String to the JspWriter.
  `void` | `release()` Release the tag.
  `void` | `setAttribute(Collection values)` Sets the given values on the pageContext.
  `void` | `setBaseHref(String v)` Set the value of `baseHref`.
  `void` | `setBlockSize(String v)` Set the value of `blockSize`.
  `void` | `setConversionType(String conversionType)` Sets the value of `conversionType`.
  `void` | `setDateFormat(String s)` Set the `date format` to use.
  `void` | `setDefault(String v)` Set the `default` value.
  `void` | `setEndIndex(int endIndex)` Set the value of `endIndex`.
  `void` | `setEndIndex(String v)` Set the value of `endIndex`.
  `void` | `setIsMultiple(boolean b)` Set the value of `isMultiple`.
  `void` | `setIsMultiple(String s)` Set the value of `isMultiple`.
  `void` | `setName(String v)` Set the value of `name`.
  `void` | `setNode(Node node)` Set the node to use.
  `void` | `setNumFormat(String s)` Set the `number format` to use.
  `void` | `setResultId(String resultId)` Set the `resultId`.
  `void` | `setResultType(String resultType)` Set the `resultType`.
  `void` | `setStartIndex(int startIndex)` Set the value of `startIndex`.
  `void` | `setStartIndex(String v)` Set the value of `startIndex`.
  `void` | `setTransactionTimeout(String timeout)` Set the value of `transactionTimeout`
  `String` | `toString(Calendar cal)` Convert a Calendar to our date format.
  `String` | `toString(Number n)` Convert a number to our date format.
  `String` | `toString(Object obj)` Convert an Object to a string with our current formatting.

  Methods inherited from class com.bea.content.manager.servlets.jsp.taglib.BaseTag
  `getCacheId, getCacheScope, getCacheTimeout, getFailOnError, getHttpSession, getUseCache, getUserId, setCacheId, setCacheScope, setCacheTimeout, setCacheTimeout, setFailOnError, setFailOnError, setUseCache, setUseCache, toDictionary`

  Methods inherited from class javax.servlet.jsp.tagext.TagSupport
  `doAfterBody, doEndTag, findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue`

  Methods inherited from class java.lang.Object
  `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

  Field Detail

  ### baseHref

      protected String baseHref

    The BASE HREF to use.

    The content's identifier will be appended automatically to this.

  ### blockSize

      protected int blockSize

    The block size to read the data in. Defaults to 2048.

  ### conversionType

      protected String conversionType

    The conversion type. Can be either "html", "url", or anything else for no conversion. See ContentHelper.toHtml() for an explanation of how html will be converted. See ContentHelper.pathInfoEncode() for an explanation of how a conversion type of "url" for a "cm_path" property is converted. For a conversion type of "url" that isn't for the "cm_path" property, the url will be encoded in "UTF-8" if supported. If it isn't supported then the default encoding will be used.

  ### dateFormat

      protected String dateFormat

    The date format to use.

  ### defValue

      protected String defValue

    The default value to print if the property is not found, or if the property does not contain a value.

  ### endIndex

      protected int endIndex

    The index at which we should stop reading.

  ### isMultiple

      protected boolean isMultiple

    If this is true then a Collection will be returned as the resultId, if false then an Object will be returned that may be cast to the appropriate Property type. The default is False.

  ### name

      protected String name

    The name of the property to print.

  ### node

      protected Node node

    The Node to use.

  ### numFormat

      protected String numFormat

    The number format to use.

  ### property

      protected Property property

    The Property to use.

  ### resultId

      protected String resultId

    The id of the script variable to put the result into. If the resultId isn't set then the property will be written to the PageContext.

  ### resultType

      protected String resultType

    The Type of the result. May only be set when isMultiple = False.

  ### startIndex

      protected int startIndex

    The index at which we should start reading. Defaults to 0.

  ### transactionTimeout

      protected int transactionTimeout

    The streaming of the data directly to the jsp page is wrapped in a transaction to cover the situation where the back-end system is transactional (like a database) and the InputStream retrieved is tied to that transactional resource (like a BlobInputStream). If this attribute is set (not -1) then the timeout on the transaction is set to this value (in sec).

  Constructor Detail

  ### GetPropertyTag

      public GetPropertyTag()

  Method Detail

  ### convert

      public String convert(String in)

    Convert a string with the current convertType.

  ### convert

      public static String convert(String conversionType,
                                   String in)

    Convert a string according to the specified convertType.

    Parameters:
      `conversionType` - "html", "url", or anything else for no encoding.
      `in` - the string
    Returns:
      the converted string.

  ### doBinary

      protected int doBinary(BinaryValue binaryValue)
                      throws JspTagException

    Throws:
      `JspTagException`

  ### doNonBinary

      protected int doNonBinary(Collection values)
                         throws JspTagException

    Throws:
      `JspTagException`

  ### doStartTag

      public int doStartTag()
                     throws JspException

    Start the tag.

    Throws:
      `JspException`

  ### getBaseHref

      public String getBaseHref()

    Get the value of `baseHref`.

  ### getBlockSize

      public String getBlockSize()

    Get the value of `blockSize` as a String.

  ### getConversionType

      public String getConversionType()

    Get the value of `conversionType`.

  ### getDateFormat

      public String getDateFormat()

    Get the `date format` to use.

  ### getDefault

      public String getDefault()

    Get the `default` value.

  ### getEndIndex

      public String getEndIndex()

    Get the value of `endIndex` as a String.

  ### getIsMultiple

      public String getIsMultiple()

    Get the value of `isMultiple`.

  ### getName

      public String getName()

    Get the value of `name`.

  ### getNode

      public Node getNode()

    Get the Node to use.

  ### getNumFormat

      public String getNumFormat()

    Get the `number format` to use.

  ### getPropertyValues

      public Collection getPropertyValues()
                                   throws JspTagException

    Throws:
      `JspTagException`

  ### getRequestBaseHref

      public URL getRequestBaseHref(HttpServletRequest request)
                             throws MalformedURLException

    Gets the request base href.

    Throws:
      `MalformedURLException`

  ### getResultId

      public String getResultId()

    Get the `resultId`.

  ### getResultType

      public String getResultType()

    Get the `resultId`.

  ### getServerBaseHref

      public URL getServerBaseHref(HttpServletRequest request)
                            throws MalformedURLException

    Gets the servers BaseHref. If it is a regular http request (http, https, ftp) against the standard ports then just return it.

    Throws:
      `MalformedURLException`

  ### getStartIndex

      public String getStartIndex()

    Get the value of `startIndex` as a String.

  ### getTransactionTimeout

      public String getTransactionTimeout()

    Get the value of `transactionTimeout`

  ### print

      public void print(String s)

    Print the String to the JspWriter.

  ### println

      public void println(String s)

    Println the String to the JspWriter.

  ### release

      public void release()

    Release the tag.

    Specified by:
      `release` in interface `Tag`
    Overrides:
      `release` in class `BaseTag`

  ### setAttribute

      public void setAttribute(Collection values)

    Sets the given values on the pageContext.

  ### setBaseHref

      public void setBaseHref(String v)

    Set the value of `baseHref`.

  ### setBlockSize

      public void setBlockSize(String v)

    Set the value of `blockSize`.

  ### setConversionType

      public void setConversionType(String conversionType)

    Sets the value of `conversionType`.

  ### setDateFormat

      public void setDateFormat(String s)

    Set the `date format` to use.

  ### setDefault

      public void setDefault(String v)

    Set the `default` value.

  ### setEndIndex

      public void setEndIndex(int endIndex)

    Set the value of `endIndex`.

  ### setEndIndex

      public void setEndIndex(String v)

    Set the value of `endIndex`.

  ### setIsMultiple

      public void setIsMultiple(boolean b)

    Set the value of `isMultiple`.

  ### setIsMultiple

      public void setIsMultiple(String s)

    Set the value of `isMultiple`.

  ### setName

      public void setName(String v)

    Set the value of `name`.

  ### setNode

      public void setNode(Node node)

    Set the node to use.

  ### setNumFormat

      public void setNumFormat(String s)

    Set the `number format` to use.

  ### setResultId

      public void setResultId(String resultId)

    Set the `resultId`.

  ### setResultType

      public void setResultType(String resultType)

    Set the `resultType`.

  ### setStartIndex

      public void setStartIndex(int startIndex)

    Set the value of `startIndex`.

  ### setStartIndex

      public void setStartIndex(String v)

    Set the value of `startIndex`.

  ### setTransactionTimeout

      public void setTransactionTimeout(String timeout)

    Set the value of `transactionTimeout`

  ### toString

      public String toString(Calendar cal)
                      throws JspTagException

    Convert a Calendar to our date format.

    Throws:
      `JspTagException` - thrown on conversion failure when failOnError is true.

  ### toString

      public String toString(Number n)
                      throws JspTagException

    Convert a number to our date format.

    Throws:
      `JspTagException` - thrown on conversion failure when failOnError is true.

  ### toString

      public String toString(Object obj)
                      throws JspTagException

    Convert an Object to a string with our current formatting.

    Throws:
      `JspTagException` - thrown on conversion failure when failOnError is true.
    See Also:
      `getDefault()`, `toString(java.util.Calendar)`, `toString(java.lang.Number)`

  Overview | Package | Class | Tree | Deprecated | Index | Help
  | © 2004 BEA Systems, Inc.
  PREV CLASS NEXT CLASS | FRAMES NO FRAMES
  SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

  Copyright © 2004 BEA Systems, Inc. All Rights Reserved