You are viewing a plain text version of this content. The canonical link for it is here.
Posted to fop-commits@xmlgraphics.apache.org by pb...@apache.org on 2003/01/20 15:51:12 UTC

cvs commit: xml-fop/src/documentation/content/design/alt.design/properties PropertyConsts-class.html

pbwest      2003/01/20 06:51:12

  Added:       src/documentation/content/design/alt.design/properties
                        PropertyConsts-class.html
  Log:
  Code documentation
  
  Revision  Changes    Path
  1.1                  xml-fop/src/documentation/content/design/alt.design/properties/PropertyConsts-class.html
  
  Index: PropertyConsts-class.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
  <html>
    <head>
      <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
      <title>PropertyConsts Description</title>
      <style type= "text/css" >
        span.codeDisplay {font:italic bold}
        body {
            font-family: Verdana, Helvetica, sans-serif;
        }
  
        .note { border: solid 1px #7099C5; background-color: #f0f0ff; }
        .note .label { background-color: #7099C5; color: #ffffff; }
        .content {
            padding: 5px 5px 5px 10px;
            font : Verdana, Helvetica, sans-serif;  font-size : 90%;
        }
      </style>
    </head>
    <body marginheight="0" marginwidth="0" topmargin="0" leftmargin="0"
          text="#000000" bgcolor="#FFFFFF">
      <div class="content">
        <h1>PropertyConsts Description</h1>
        <p>
          <font size="-2">by&nbsp;Peter B. West</font>
        </p>
        <ul class="minitoc">
          <li>
            <a href="#N10014">Introduction</a>
          </li>
        </ul>
        
        <a name="N10014"></a>
        <h3>Introduction</h3>
        <p>
          
          <a href="javascript:parent.displayCode(
             'PropertyConsts.html#PropertyConstsClass'
          )">This class</a>, and the singleton object which is <a
          href="javascript:parent.displayCode(
          'PropertyConsts.html#pconsts' )">generated by the static
          initializer</a>, is essentially a repository of
          &lt;property&gt; class instances and the static data from
          those classes of <span
          class="codefrag">org.apache.fop.fo.property</span>.
          The heart of this class is the method <a href=
          "javascript:parent.displayCode(
          'PropertyConsts.html#setupProperty' )"><span class="codefrag"
          >setupProperty</span ></a>.  Whenever access to the data or
          methods of a property class is required, this method in the
          singleton must be called to ensure that an instance of the
          property exists and that the static data from that instance
          has been extracted.
        </p>
  
        <div class="frame note">
          <div class="label">Note</div>
          <div class="content">
            An alternative to this requirement would be to pre-load all
            of the individual property classes during the system
            initialization phase.  This is not done currently because of
            the start-up expense of the required class loading for over
            three hundred classes, and the relatively low added expense
            of checking for the existence of a property instance before
            every access.  Given that FOP is increasingly used in a
            server environment, it may prove acceptable in the long run
            to change to pre-loading.
          </div>
        </div>
  
        <p>
          The class name is generated and stored in the <a
          href="javascript:parent.displayCode(
          'PropertyConsts.html#classNames' )"><span class="codefrag"
          >classNames</span ></a> array; a class instance is generated
          from the name and stored in the <a
          href="javascript:parent.displayCode(
          'PropertyConsts.html#classes' )"><span class="codefrag"
          >classes</span ></a> array; and an instance of the class is
          generated from the class object and stored in the <a
          href="javascript:parent.displayCode(
          'PropertyConsts.html#properties' )"><span class="codefrag"
          >properties</span ></a> array.
        </p>
  
        <p>
          The other data gathering facilities and access methods of this
          class will be examined in conjunction with the various types
          of property classes.
        </p>
  
        <p>
          <strong>Previous:</strong> <a href = "classes-overview.html"
          >Property classes overview</a>
        </p>
        <p>
          <strong>Next:</strong> <a href= "simple-properties.html"
                                    >Simple property classes</a>
        </p>
      </div>
      <table summary="footer" cellspacing="0" cellpadding="0"
             width="100%" height="20" border="0">
          <tr>
            <td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="../../skin/images/spacer.gif"><a href="../../skin/images/label.gif"></a><a href="../../skin/images/page.gif"></a><a href="../../skin/images/chapter.gif"></a><a href="../../skin/images/chapter_open.gif"></a><a href="../../skin/images/current.gif"></a><a href="../..//favicon.ico"></a></td>
          </tr>
          <tr>
            <td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright &copy;
                1999-2002&nbsp;The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!--
                  document.write(" - "+"Last Published: " + document.lastModified);
                  //  --></script></font></td>
          </tr>
          <tr>
            <td align="left" bgcolor="#CFDCED" class="logos"></td><td align="right" bgcolor="#CFDCED" class="logos"></td>
          </tr>
      </table>
    </body>
  </html>
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: fop-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: fop-cvs-help@xml.apache.org