package-summary.html

Geotools是一个开源的Java GIS工具包,可利用它来开发符合标准的地理信息系统。Geotools提供了OGC(Open Geospatial Consortium)规范的一个实现来作为他们的

 
  This is very similiar to StyleAttributeExtractor, but with these differences:
     a) it doesnt the count the <PropertyName> tag in the <Geometry> 
     b) it doesnt count anything in the <TextSymbolizer>'s <Priority> tag
     c) it doesnt count anything in the <TextSymbolizer>'s <Label> tag
     
     The reasons for this are because these fields are ALWAYS taken directly from the
     feature, not from the style.
     
     </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../org/geotools/styling/StyleBuilder.html" title="class in org.geotools.styling">StyleBuilder</A></B></TD>
<TD>An utility class designed to ease style building by convinience methods.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../org/geotools/styling/StyledLayerDescriptorImpl.html" title="class in org.geotools.styling">StyledLayerDescriptorImpl</A></B></TD>
<TD>Holds styling information (from a StyleLayerDescriptor document).
 
 </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../org/geotools/styling/StyledLayerImpl.html" title="class in org.geotools.styling">StyledLayerImpl</A></B></TD>
<TD>DOCUMENT ME!</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../org/geotools/styling/StyleFactoryFinder.html" title="class in org.geotools.styling">StyleFactoryFinder</A></B></TD>
<TD>&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../org/geotools/styling/StyleFactoryImpl.html" title="class in org.geotools.styling">StyleFactoryImpl</A></B></TD>
<TD>Factory for creating Styles. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../org/geotools/styling/StyleImpl.html" title="class in org.geotools.styling">StyleImpl</A></B></TD>
<TD>DOCUMENT ME!</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../org/geotools/styling/TextMarkImpl.html" title="class in org.geotools.styling">TextMarkImpl</A></B></TD>
<TD>DOCUMENT ME!</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../org/geotools/styling/TextSymbolizerImpl.html" title="class in org.geotools.styling">TextSymbolizerImpl</A></B></TD>
<TD>Provides a Java representation of an SLD TextSymbolizer that defines how
 text symbols should be rendered.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../org/geotools/styling/UserLayerImpl.html" title="class in org.geotools.styling">UserLayerImpl</A></B></TD>
<TD>DJB: on inlinefeature support:
 The inline features also lets you "sort of" make your WMS into a WFS-T.

</TD>
</TR>
</TABLE>
&nbsp;

<P>

<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=2><FONT SIZE="+2">
<B>Exception Summary</B></FONT></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../org/geotools/styling/StyleFactoryCreationException.html" title="class in org.geotools.styling">StyleFactoryCreationException</A></B></TD>
<TD>An exception that can be thrown by the StyleFactory if it fails to create
 the  implementation of the StyleFactory. </TD>
</TR>
</TABLE>
&nbsp;

<P>
<A NAME="package_description"><!-- --></A><H2>
Package org.geotools.styling Description
</H2>

<P>
Allows for symbolization of geospatial data.
  <p>
  For many of us in geotools *this* is the reason we came along for the ride -
  a pretty picture. The contents of this package are adapted from the
  <A HREF="http://portal.opengeospatial.org/files/?artifact_id=1188">OpenGIS&reg; Styled Layer Descriptor</A>
  specification v1.0.0.
  </p>
  <h2>Conformance to SLD 1.0.0</h2>
  <p>
  We may experiment with our own (or SLD 1.1) ideas but will mark such
  experiments for you. This is only an issue of you are considering writing out
  these objects for interoptability with other systems.
  </p>
  <p>
  General stratagy for supporting multiple SLD versions (and experiments):
  <ul>
  <li>These interfaces will reflect the current published specification
 <li>Our implementations will be <b>BIGGER</b> and more capabile then any
  one specification
  <li>We cannot defined explicit interfaces tracking each version until we
  move to Java 5 (perferably GeoAPI would hold these anyways)
  <li>We can provided javadocs indicating extentions, and isolate these using
  the normal java convention: TextSymbolizer and TextSymbolizer2 (In short you
  will have to go out of your way to work with a hack or experiment, you won't
  depend on one by accident)
  <li>We can use Factories (aka SLD1Factory and SLD1_1Factory and SEFactory)
  to support the creation of conformant datastructures. Code (such as user
  interfaces) can be parameratized with these factories when they need to
  confirm to an exact version supported by an individual service. We hope that
  specifications are always adative, and will be forced to throw unsupported
  exceptions when functionality is removed from a specification.
  </ul>
  </p>
  <h2>Care and Feeding of Style Objects</h2>
  <p>
  SLD is an XML specification, the definition of objects capturing this information,
  the binding of objects to these XML documents, and the provision of events
  on object modification all need to be accounted for.
  <p>
  <h4>StyleFactory</h4>
  As with all geotools work construction of styling constructs is handled by a
  <i>Factory</i>(GOF). Quickly a <i>Factory</i> is used when working with interfaces,
  anything that would of been a constructor is set up as an <i>create</i> method.
  <pre><code>
  StyleFactory factory = StyleFactoryFinder.createStyleFactory();
  StyleLayerDescriptor sld = factory.createStyleLayerDescriptor();
  // an empty sld document
  sld.setTitle("Basic Black");
  sld.setAbstract("Grayscale style suitable for use with photocopiers");
  </code>
  </pre>
  <p>
  When creating a complex data structure direct use of a Factory is a pain.
  Which leads us to the next section.
  <p>
  Notes:
  <ul>
  <li>At this time one implementation of StyleFactory is available, this will
  not provide true in the future (as SLD experiments, and code generation
  are brought to bare on future specifications).
  </ul>
  
  <h4>StyleBuilder</h4>
  <p>
  When constructing a complex data structure, such as an SLD document, the use
  of a Factory is a bit of a pain. That is where <i>StyleBuilder</i> is brought
  to bare. A <i>Builder</i> is simply a class that help you construct a complicated
  data structure, for a make involved/interesting example of a builder have a look
  at the graph package.
  <p>
  <pre><code>
  
  </code></pre>
  
  <h2>Example</h2>
  The following code example has been borrowed from the geotools website,
  for additional examples (and advice) please consult the user documentation.
  <P>
  <pre><code>
    private Style buildStyle() throws Exception {
        StyleBuilder sb = new StyleBuilder();
        FilterFactory ff = sb.getFilterFactory();
        Style style = sb.createStyle();
        style.setName("MyStyle");

        // "testPoint" feature type style
        Mark testMark = sb.createMark(sb.attributeExpression("name"),
                sb.createFill(Color.RED, 0.5), null);
        Graphic graph = sb.createGraphic(null, new Mark[] { testMark }, null,
                sb.literalExpression(1), sb.attributeExpression("size"),
                sb.attributeExpression("rotation"));
        style.addFeatureTypeStyle(sb.createFeatureTypeStyle("testPoint",
                new Symbolizer[] { sb.createPointSymbolizer(graph) }));

        // "labelPoint" feature type style
        AnchorPoint anchorPoint = sb.createAnchorPoint(sb.attributeExpression("X"),
                sb.attributeExpression("Y"));
        PointPlacement pointPlacement = sb.createPointPlacement(anchorPoint, null,
                sb.literalExpression(0));
        TextSymbolizer textSymbolizer = sb.createTextSymbolizer(sb.createFill(Color.BLACK),
                new Font[] { sb.createFont("Lucida Sans", 10), sb.createFont("Arial", 10) },
                sb.createHalo(), sb.attributeExpression("name"), pointPlacement, null);
        Mark circle = sb.createMark(StyleBuilder.MARK_CIRCLE, Color.RED);
        Graphic graph2 = sb.createGraphic(null, circle, null, 1, 4, 0);
        PointSymbolizer pointSymbolizer = sb.createPointSymbolizer(graph2);
        style.addFeatureTypeStyle(sb.createFeatureTypeStyle("labelPoint",
                new Symbolizer[] { textSymbolizer, pointSymbolizer }));

        return style;
    }<code></pre>
  </P>
  <h3>References</h2>
  The following links will be of interest:
  <ul>
  <li>SLD 1.0.0
  <li>Design Patterns, GOF
  </ul>
<P>

<P>
<DL>
<DT><B>Since:</B></DT>
  <DD>GeoTools 2.0</DD>
<DT><B>Author:</B></DT>
  <DD>Ian Turton, CCG, James Macgill, CCG, Jody Garnett, Refractions Research</DD>
</DL>
<HR>


<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Package</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <FONT CLASS="NavBarFont1">Class</FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-use.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../org/geotools/renderer/style/package-summary.html"><B>PREV PACKAGE</B></A>&nbsp;
&nbsp;<A HREF="../../../org/geotools/styling/visitor/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="package-summary.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>

</FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>
Copyright &copy; 1996-2007 <a href="http://www.geotools.org">Geotools</a>. All Rights Reserved.
</BODY>
</HTML>