Examples of org.geoserver.wms.GetLegendGraphicRequest

org.geoserver.wms.GetLegendGraphicRequest

Holds the parsed parameters for a GetLegendGraphic WMS request.

The GET parameters of the GetLegendGraphic operation are defined as follows (from SLD 1.0 spec, ch.12):

Parameter Required Description
VERSION Required Version as required by OGC interfaces.
REQUEST Required Value must be GetLegendRequest .
LAYER Required Layer for which to produce legend graphic. A layergroup can be specified, too. In this case, STYLE and RULE parameters can have multiple values (separated by commas), one for each of the group layers.
STYLE Optional Style of layer for which to produce legend graphic. If not present, the default style is selected. The style may be any valid style available for a layer, including non-SLD internally-defined styles. A list of styles separated by commas can be used to specify styles for single layers of a layergroup. To override default style only for some layers leave empty the not overridden ones in the list (ex. style1,,style3,style4 to use default style for layer 2).
FEATURETYPE Optional Feature type for which to produce the legend graphic. This is not needed if the layer has only a single feature type.
RULE Optional Rule of style to produce legend graphic for, if applicable. In the case that a style has multiple rules but no specific rule is selected, then the map server is obligated to produce a graphic that is representative of all of the rules of the style. A list of rules separated by commas can be used to specify rules for single layers of a layergroup. To specify rule only for some layers leave empty the not overridden ones in the list (ex. rule1,,rule3,rule4 to not specify rule for layer 2).
SCALE Optional In the case that a RULE is not specified for a style, this parameter may assist the server in selecting a more appropriate representative graphic by eliminating internal rules that are outof- scope. This value is a standardized scale denominator, defined in Section 10.2
SLD Optional This parameter specifies a reference to an external SLD document. It works in the same way as the SLD= parameter of the WMS GetMap operation.
SLD_BODY Optional This parameter allows an SLD document to be included directly in an HTTP-GET request. It works in the same way as the SLD_BODY= parameter of the WMS GetMap operation.
FORMAT Required This gives the MIME type of the file format in which to return the legend graphic. Allowed values are the same as for the FORMAT= parameter of the WMS GetMap request.
WIDTH Optional This gives a hint for the width of the returned graphic in pixels. Vector-graphics can use this value as a hint for the level of detail to include.
HEIGHT Optional This gives a hint for the height of the returned graphic in pixels.
LANGUAGE Optional Permits to have internationalized text in legend output.
EXCEPTIONS Optional This gives the MIME type of the format in which to return exceptions. Allowed values are the same as for the EXCEPTIONS= parameter of the WMS GetMap request.
TRANSPARENT Optional true if the legend image background should be transparent. Defaults to false.

There's also a custom {@code STRICT} parameter that defaults to {@code true} and controls whetherthe mandatory parameters are to be checked. This is useful mainly to be able of requesting a legend graphic for no layer in particular, so the LAYER parameter can be omitted.

The GetLegendGraphic operation itself is optional for an SLD-enabled WMS. It provides a general mechanism for acquiring legend symbols, beyond the LegendURL reference of WMS Capabilities. Servers supporting the GetLegendGraphic call might code LegendURL references as GetLegendGraphic for interface consistency. Vendorspecific parameters may be added to GetLegendGraphic requests and all of the usual OGC-interface options and rules apply. No XML-POST method for GetLegendGraphic is presently defined.

@author Gabriel Roldan @version $Id$

     * Tests that the legend graphic is produced for multiple layers
     * with vector and coverage layers.
     */
    @org.junit.Test    
  public void testMultipleLayersWithVectorAndCoverage() throws Exception {        
        GetLegendGraphicRequest req = new GetLegendGraphicRequest();
        
        int titleHeight = getTitleHeight(req);
        
        FeatureTypeInfo ftInfo = getCatalog().getFeatureTypeByName(
                MockData.ROAD_SEGMENTS.getNamespaceURI(), MockData.ROAD_SEGMENTS.getLocalPart());
        List<FeatureType> layers=new ArrayList<FeatureType>();
        layers.add(ftInfo.getFeatureType());
        
        CoverageInfo cInfo = getCatalog().getCoverageByName("world");
        assertNotNull(cInfo);


        GridCoverage coverage = cInfo.getGridCoverage(null, null);
        try {
          SimpleFeatureCollection feature;
          feature = FeatureUtilities.wrapGridCoverage((GridCoverage2D) coverage);
          layers.add(feature.getSchema());
          
          req.setLayers(layers);
          
          List<Style> styles=new ArrayList<Style>();
          Style style1= getCatalog().getStyleByName(
                  MockData.ROAD_SEGMENTS.getLocalPart()).getStyle();
          styles.add(style1);
          
          Style style2= getCatalog().getStyleByName("rainfall").getStyle();
          styles.add(style2);
          req.setStyles(styles);
          
          this.legendProducer.buildLegendGraphic(req);
  
          BufferedImage image = this.legendProducer.buildLegendGraphic(req);

View Full Code Here

     * with vector and coverage layers, when coverage is not visible
     * at current scale.
     */    
    @org.junit.Test
    public void testMultipleLayersWithVectorAndInvisibleCoverage() throws Exception {        
        GetLegendGraphicRequest req = new GetLegendGraphicRequest();
        req.setScale(1000);
        int titleHeight = getTitleHeight(req);
        
        FeatureTypeInfo ftInfo = getCatalog().getFeatureTypeByName(
                MockData.ROAD_SEGMENTS.getNamespaceURI(), MockData.ROAD_SEGMENTS.getLocalPart());
        List<FeatureType> layers=new ArrayList<FeatureType>();
        layers.add(ftInfo.getFeatureType());
        
        CoverageInfo cInfo = getCatalog().getCoverageByName("world");
        assertNotNull(cInfo);


        GridCoverage coverage = cInfo.getGridCoverage(null, null);
        try {
          SimpleFeatureCollection feature;
          feature = FeatureUtilities.wrapGridCoverage((GridCoverage2D) coverage);
          layers.add(feature.getSchema());
          
          req.setLayers(layers);
          
          List<Style> styles=new ArrayList<Style>();
          Style style1= getCatalog().getStyleByName(
                  MockData.ROAD_SEGMENTS.getLocalPart()).getStyle();
          styles.add(style1);
          
          styles.add(readSLD("InvisibleRaster.sld"));
          
          
          req.setStyles(styles);
          
          this.legendProducer.buildLegendGraphic(req);
  
          BufferedImage image = this.legendProducer.buildLegendGraphic(req);

View Full Code Here

          }
      }
    }


  public void testMixedGeometry() throws Exception {
        GetLegendGraphicRequest req = new GetLegendGraphicRequest();
    
        SimpleFeatureTypeBuilder builder = new SimpleFeatureTypeBuilder();
        builder.setName("MIXEDGEOMETRY");
        builder.setNamespaceURI("test");
        builder.setDefaultGeometry("GEOMETRY");
        CoordinateReferenceSystem crs = CRS.decode("EPSG:4326");
        builder.setCRS(crs);
    
        GeometryFactory geometryFactory = new GeometryFactory();
    
        AttributeType at = new AttributeTypeImpl(new NameImpl("ID"), String.class,
                false, false, Collections.EMPTY_LIST, null, null);
        builder.add(new AttributeDescriptorImpl(at, new NameImpl("ID"), 0, 1,
                false, null));
    
        GeometryType gt = new GeometryTypeImpl(new NameImpl("GEOMETRY"),
                Geometry.class, crs, false, false, Collections.EMPTY_LIST, null,
                null);
    
        builder.add(new GeometryDescriptorImpl(gt, new NameImpl("GEOMETRY"), 0, 1,
                false, null));
    
        FeatureType fType = builder.buildFeatureType();
        List<FeatureType> layers = new ArrayList<FeatureType>();
        layers.add(fType);
    
        req.setLayers(layers);
    
        List<Style> styles = new ArrayList<Style>();
        req.setStyles(styles);
    
        styles.add(readSLD("MixedGeometry.sld"));
    
        this.legendProducer.buildLegendGraphic(req);

View Full Code Here

    /**
     * Tests that symbols are not bigger than the requested icon size.
     */
    @org.junit.Test
    public void testSymbolContainedInIcon() throws Exception {
        GetLegendGraphicRequest req = new GetLegendGraphicRequest();
    
        FeatureTypeInfo ftInfo = getCatalog()
                .getFeatureTypeByName(MockData.MPOINTS.getNamespaceURI(),
                        MockData.MPOINTS.getLocalPart());
    
        List<FeatureType> layers = new ArrayList<FeatureType>();
        layers.add(ftInfo.getFeatureType());
        req.setLayers(layers);
    
        List<Style> styles = new ArrayList<Style>();
        req.setStyles(styles);
    
        styles.add(readSLD("BigSymbol.sld"));
    
        BufferedImage image = this.legendProducer.buildLegendGraphic(req);

View Full Code Here

     * Tests that symbols are not bigger than the requested icon size, also
     * if an expression is used for the symbol Size.
     */
    @org.junit.Test
    public void testSymbolContainedInIconUsingExpression() throws Exception {
        GetLegendGraphicRequest req = new GetLegendGraphicRequest();
    
        FeatureTypeInfo ftInfo = getCatalog()
                .getFeatureTypeByName(MockData.MPOINTS.getNamespaceURI(),
                        MockData.MPOINTS.getLocalPart());
    
        List<FeatureType> layers = new ArrayList<FeatureType>();
        layers.add(ftInfo.getFeatureType());
        req.setLayers(layers);
    
        List<Style> styles = new ArrayList<Style>();
        req.setStyles(styles);
    
        styles.add(readSLD("SymbolExpression.sld"));
    
        BufferedImage image = this.legendProducer.buildLegendGraphic(req);

View Full Code Here

    /**
     * Tests that symbols relative sizes are proportional.
     */
    @org.junit.Test
    public void testProportionalSymbolSize() throws Exception {
        GetLegendGraphicRequest req = new GetLegendGraphicRequest();
        
        FeatureTypeInfo ftInfo = getCatalog()
                .getFeatureTypeByName(MockData.MPOINTS.getNamespaceURI(),
                        MockData.MPOINTS.getLocalPart());
    
        List<FeatureType> layers = new ArrayList<FeatureType>();
        layers.add(ftInfo.getFeatureType());
        req.setLayers(layers);
    
        List<Style> styles = new ArrayList<Style>();
        req.setStyles(styles);
    
        styles.add(readSLD("ProportionalSymbols.sld"));
    
        BufferedImage image = this.legendProducer.buildLegendGraphic(req);

View Full Code Here

    /**
     * Tests that symbols relative sizes are proportional also if using uoms.
     */
    @org.junit.Test
    public void testProportionalSymbolSizeUOM() throws Exception {
        GetLegendGraphicRequest req = new GetLegendGraphicRequest();
        
        FeatureTypeInfo ftInfo = getCatalog()
                .getFeatureTypeByName(MockData.MPOINTS.getNamespaceURI(),
                        MockData.MPOINTS.getLocalPart());
    
        List<FeatureType> layers = new ArrayList<FeatureType>();
        layers.add(ftInfo.getFeatureType());
        req.setLayers(layers);
    
        List<Style> styles = new ArrayList<Style>();
        req.setStyles(styles);
    
        styles.add(readSLD("ProportionalSymbolsUOM.sld"));
    
        BufferedImage image = this.legendProducer.buildLegendGraphic(req);

View Full Code Here

     * Tests that symbols relative sizes are proportional also if using uoms
     * in some Symbolizer and not using them in others.
     */
    @org.junit.Test
    public void testProportionalSymbolSizePartialUOM() throws Exception {
        GetLegendGraphicRequest req = new GetLegendGraphicRequest();
        
        req.setScale(RendererUtilities.calculatePixelsPerMeterRatio(10, Collections.EMPTY_MAP));
        
        FeatureTypeInfo ftInfo = getCatalog()
                .getFeatureTypeByName(MockData.MPOINTS.getNamespaceURI(),
                        MockData.MPOINTS.getLocalPart());
    
        List<FeatureType> layers = new ArrayList<FeatureType>();
        layers.add(ftInfo.getFeatureType());
        req.setLayers(layers);
    
        List<Style> styles = new ArrayList<Style>();
        req.setStyles(styles);
    
        styles.add(readSLD("ProportionalSymbolsPartialUOM.sld"));
    
        BufferedImage image = this.legendProducer.buildLegendGraphic(req);

View Full Code Here

    /**
     * Tests that minSymbolSize legend option is respected.
     */
    @org.junit.Test
    public void testMinSymbolSize() throws Exception {
        GetLegendGraphicRequest req = new GetLegendGraphicRequest();
        
        FeatureTypeInfo ftInfo = getCatalog()
                .getFeatureTypeByName(MockData.MPOINTS.getNamespaceURI(),
                        MockData.MPOINTS.getLocalPart());
    
        Map<String,String> options = new HashMap<String,String>();
        options.put("minSymbolSize", "10");
        req.setLegendOptions(options);
        
        List<FeatureType> layers = new ArrayList<FeatureType>();
        layers.add(ftInfo.getFeatureType());
        req.setLayers(layers);
    
        List<Style> styles = new ArrayList<Style>();
        req.setStyles(styles);
    
        styles.add(readSLD("ProportionalSymbols.sld"));
    
        BufferedImage image = this.legendProducer.buildLegendGraphic(req);

View Full Code Here

    /**
     * Tests that minSymbolSize legend option is respected.
     */
    @org.junit.Test
    public void testInternationalizedLabels() throws Exception {
        GetLegendGraphicRequest req = new GetLegendGraphicRequest();
        
        Map<String,String> options = new HashMap<String,String>();
        options.put("forceLabels", "on");
        req.setLegendOptions(options);
        
        FeatureTypeInfo ftInfo = getCatalog()
                .getFeatureTypeByName(MockData.MPOINTS.getNamespaceURI(),
                        MockData.MPOINTS.getLocalPart());
    
        
        List<FeatureType> layers = new ArrayList<FeatureType>();
        layers.add(ftInfo.getFeatureType());
        req.setLayers(layers);
    
        List<Style> styles = new ArrayList<Style>();
        req.setStyles(styles);
    
        styles.add(readSLD("Internationalized.sld"));
    
        BufferedImage image = this.legendProducer.buildLegendGraphic(req);
        int noLocalizedWidth = image.getWidth();        
        
        
        req.setLocale(Locale.ITALIAN);
        image = this.legendProducer.buildLegendGraphic(req);
        // test that using localized labels we get a different label than when not using it
        int itWidth = image.getWidth();
        assertTrue(itWidth != noLocalizedWidth);
        
        req.setLocale(Locale.ENGLISH);
        image = this.legendProducer.buildLegendGraphic(req);
        // test that using localized labels we get a different label than when not using it
        int enWidth = image.getWidth();
        assertTrue(enWidth != noLocalizedWidth);
        assertTrue(enWidth != itWidth);

View Full Code Here

0 1 2 3 4

TOP

Related Classes of org.geoserver.wms.GetLegendGraphicRequest

org.geoserver.geofence.GeofenceAccessManager

org.geoserver.monitor.ows.MonitorCallbackTest

org.geoserver.wms.capabilities.LegendSampleImpl

org.geoserver.wms.decoration.LegendDecoration

org.geoserver.wms.dynamic.legendgraphic.DynamicGetLegendGraphicDispatcherCallback

org.geoserver.wms.legendgraphic.AbstractGetLegendGraphicResponse

org.geoserver.wms.legendgraphic.AbstractLegendGraphicOutputFormatTest

org.geoserver.wms.legendgraphic.GetLegendGraphicKvpReader

org.geoserver.wms.legendgraphic.GetLegendGraphicKvpReaderTest

org.geoserver.wms.web.data.AbstractStylePage

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.

Parameter	Required	Description
VERSION	Required	Version as required by OGC interfaces.
REQUEST	Required	Value must be GetLegendRequest .
LAYER	Required	Layer for which to produce legend graphic. A layergroup can be specified, too. In this case, STYLE and RULE parameters can have multiple values (separated by commas), one for each of the group layers.
STYLE	Optional	Style of layer for which to produce legend graphic. If not present, the default style is selected. The style may be any valid style available for a layer, including non-SLD internally-defined styles. A list of styles separated by commas can be used to specify styles for single layers of a layergroup. To override default style only for some layers leave empty the not overridden ones in the list (ex. style1,,style3,style4 to use default style for layer 2).
FEATURETYPE	Optional	Feature type for which to produce the legend graphic. This is not needed if the layer has only a single feature type.
RULE	Optional	Rule of style to produce legend graphic for, if applicable. In the case that a style has multiple rules but no specific rule is selected, then the map server is obligated to produce a graphic that is representative of all of the rules of the style. A list of rules separated by commas can be used to specify rules for single layers of a layergroup. To specify rule only for some layers leave empty the not overridden ones in the list (ex. rule1,,rule3,rule4 to not specify rule for layer 2).
SCALE	Optional	In the case that a RULE is not specified for a style, this parameter may assist the server in selecting a more appropriate representative graphic by eliminating internal rules that are outof- scope. This value is a standardized scale denominator, defined in Section 10.2
SLD	Optional	This parameter specifies a reference to an external SLD document. It works in the same way as the SLD= parameter of the WMS GetMap operation.
SLD_BODY	Optional	This parameter allows an SLD document to be included directly in an HTTP-GET request. It works in the same way as the SLD_BODY= parameter of the WMS GetMap operation.
FORMAT	Required	This gives the MIME type of the file format in which to return the legend graphic. Allowed values are the same as for the FORMAT= parameter of the WMS GetMap request.
WIDTH	Optional	This gives a hint for the width of the returned graphic in pixels. Vector-graphics can use this value as a hint for the level of detail to include.
HEIGHT	Optional	This gives a hint for the height of the returned graphic in pixels.
LANGUAGE	Optional	Permits to have internationalized text in legend output.
EXCEPTIONS	Optional	This gives the MIME type of the format in which to return exceptions. Allowed values are the same as for the EXCEPTIONS= parameter of the WMS GetMap request.
TRANSPARENT	Optional	`true` if the legend image background should be transparent. Defaults to `false`.