java/cewolf-1.0/src/site/brief.html
author František Kučera <franta-hg@frantovo.cz>
Sat, 28 Feb 2009 21:31:02 +0100
changeset 1 639991d0808a
permissions -rw-r--r--
Rozbalená knihovna verze 1.0
     1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
     2 <html>
     3 <head>
     4   <title></title>
     5   <meta name="author" content="Guido Laures">
     6   <link href="cewolf.css" rel="stylesheet" type="text/css">
     7 </head>
     8 <body>
     9 <h1>Introduction</h1>
    10 <p class="Body"> Cewolf can be used inside a Servlet/JSP based web
    11 application to embed complex graphical charts of all kinds (e.g. line,
    12 pie, bar chart, plots, etc.) into a web page. Therefore it provides a
    13 full featured tag library to define all properties of the chart (colors,
    14 strokes, legend, etc.). Thus the JSP which embedds the chart is not
    15 polluted with any java code. Everything is described with XML conform
    16 tags. </p>
    17 <p> Cewolf is based on <a
    18  href="http://www.object-refinery.com/jfreechart/">JFreeChart</a> and
    19 uses it's rendering engine to render the final chart image into the
    20 clients response stream. No files are created on server side. Everything
    21 is based on lightweight session objects and dynamic data analysis.
    22 Cewolf consists of one servlet which handles the chart rendering and a
    23 taglibrary which translates the chart definition included in the JSP
    24 into an HTML img tag which consults the rendering servlet for retrieval
    25 of the appropriate chart. </p>
    26 <p> Simce the project has been funded in the middle of 2002 there have
    27 been <b>more then 150.000 page views and 16.000 downloads</b>
    28 (Sourceforge activity max: &gt;99,7%). </p>
    29 <p>
    30 <table border="1" cellpadding="5">
    31   <tbody>
    32     <tr>
    33       <th class="featureGroup">Fully free and open</th>
    34       <th class="featureGroup">100% Java compliant</th>
    35     </tr>
    36     <tr>
    37       <td valign="top">
    38       <ul>
    39         <li>LGPL license</li>
    40         <li>no charges</li>
    41         <li>no restrictions</li>
    42         <li>Support on <a
    43  href="http://sourceforge.net/projects/cewolf">SourceForge Forums</a></li>
    44         <li>short development and upgrade circles</li>
    45       </ul>
    46       </td>
    47       <td valign="top">
    48       <ul>
    49         <li>no usage of native libraries</li>
    50         <li>should run in every J2EE compliant server or servlet
    51 container</li>
    52         <li>extensive usage of available open source projects</li>
    53       </ul>
    54       </td>
    55     </tr>
    56     <tr>
    57       <th class="featureGroup">Full featured Chart Tag Library</th>
    58       <th class="featureGroup">Huge number of different Charts</th>
    59     </tr>
    60     <tr>
    61       <td valign="top">
    62       <ul>
    63         <li>no java coding inside the JSP needed</li>
    64         <li>XML description of a chart</li>
    65         <li>design time validation of chart tags</li>
    66         <li>extensive <a href="taglib.html">tag documentation</a></li>
    67       </ul>
    68       </td>
    69       <td valign="top">
    70       <ul>
    71         <li>Line [XY]</li>
    72         <li>[3D] Pie</li>
    73         <li>[3D] Horizonal Bar</li>
    74         <li>[3D] Vertical [XY] Bar</li>
    75         <li>[3D] Stacked Vertical Bar</li>
    76         <li>Area [XY]</li>
    77         <li>Scatter Plot</li>
    78         <li>Candlestick</li>
    79         <li>High Low</li>
    80         <li>Gantt</li>
    81         <li>Meter</li>
    82         <li>Overlaid</li>
    83         <li>Combined</li>
    84       </ul>
    85       </td>
    86     </tr>
    87   </tbody>
    88 </table>
    89 </p>
    90 <p> </p>
    91 <h1>Example</h1>
    92 <p> You can simply define a chart by including a chart tag into your JSP
    93 like this: </p>
    94 <pre>&lt;cewolf:chart <br>    id="XYChart"<br>    type="xy"<br>    title="XYChart" <br>    &lt;cewolf:gradient&gt;<br>        &lt;cewolf:point x="0" y="0" color="#FFFFFF"/&gt;<br>        &lt;cewolf:point x="0" y="300" color="#C8C8C8"/&gt;<br>    &lt;/cewolf:gradient&gt;<br>    &lt;cewolf:data&gt;<br>        &lt;cewolf:producer id="xyData"/&gt;<br>    &lt;/cewolf:data&gt;<br>&lt;/cewolf:chart&gt;<br>&lt;cewolf:img chartid="XYChart" renderer="cewolf" width="400" height="300"/&gt;<br></pre>
    95 <p> This results in a rendered chart like this: </p>
    96 <img alt="examplechart" src="img/examplexy.png">
    97 <p> As you can see only the view is defined in the JSP page. The model
    98 is produced by a so called DataProducer which must be available in the
    99 pageContext of the JSP. </p>
   100 <a href="http://sourceforge.net" target="new" height="30"><img
   101  src="http://sourceforge.net/sflogo.php?group_id=57282&amp;type=5"
   102  height="30" border="0" alt="SourceForge Logo"></a>
   103 </body>
   104 </html>