gov/nasa/worldwind/wms/Capabilities.java

   1 /*
   2 Copyright (C) 2001, 2006 United States Government
   3 as represented by the Administrator of the
   4 National Aeronautics and Space Administration.
   5 All Rights Reserved.
   6 */
   7 package gov.nasa.worldwind.wms;
   8
   9 import gov.nasa.worldwind.util.Logging;
  10 import org.w3c.dom.*;
  11
  12 import javax.xml.XMLConstants;
  13 import javax.xml.xpath.*;
  14 import java.util.*;
  15 import java.util.logging.Level;
  16
  17 /**
  18  * @author tag
  19  * @version $Id: Capabilities.java 3601 2007-11-21 03:23:23Z tgaskins $
  20  */
  21 public abstract class Capabilities
  22 {
  23     protected Document doc;
  24     protected Element service;
  25     protected Element capability;
  26     protected XPath xpath;
  27
  28     public static Capabilities parse(Document doc)
  29     {
  30         XPathFactory xpFactory = XPathFactory.newInstance();
  31         XPath xpath = xpFactory.newXPath();
  32
  33         SimpleNamespaceContext nsc = new SimpleNamespaceContext();
  34         nsc.addNamespace(XMLConstants.DEFAULT_NS_PREFIX, "http://www.opengis.net/wms");
  35         xpath.setNamespaceContext(new SimpleNamespaceContext());
  36
  37         try
  38         {
  39             String version = xpath.evaluate(altPaths("*/@wms:version"), doc);
  40             if (version == null || version.length() == 0)
  41                 return null;
  42
  43             if (version.compareTo("1.3") < 0)
  44                 return new CapabilitiesV111(doc, xpath);
  45             else
  46                 return new CapabilitiesV130(doc, xpath);
  47         }
  48         catch (XPathExpressionException e)
  49         {
  50             Logging.logger().log(Level.SEVERE, "WMS.ParsingError", e);
  51             return null;
  52         }
  53     }
  54
  55     protected Capabilities(Document doc, XPath xpath)
  56     {
  57         this.doc = doc;
  58         this.xpath = xpath;
  59
  60         try
  61         {
  62             this.service = (Element) this.xpath.evaluate(altPaths("*/wms:Service"), doc, XPathConstants.NODE);
  63             if (this.service == null)
  64             {
  65                 Logging.logger().severe("WMS.NoServiceElement");
  66                 throw new IllegalArgumentException(Logging.getMessage("WMS.NoServiceElement"));
  67             }
  68
  69             this.capability = (Element) this.xpath.evaluate(altPaths("*/wms:Capability"), doc, XPathConstants.NODE);
  70             if (this.capability == null)
  71             {
  72                 Logging.logger().severe("WMS.NoCapabilityElement");
  73                 throw new IllegalArgumentException(Logging.getMessage("WMS.NoCapabilityElement"));
  74             }
  75         }
  76         catch (XPathExpressionException e)
  77         {
  78             Logging.logger().log(Level.SEVERE, "WMS.ParsingError", e);
  79         }
  80     }
  81
  82     private static String altPaths(String path)
  83     {
  84         return path != null ? path + "|" + path.replaceAll("wms:", "") : null;
  85     }
  86
  87     protected String getText(String path)
  88     {
  89         return this.getText(null, path);
  90     }
  91
  92     protected String getText(Element context, String path)
  93     {
  94         try
  95         {
  96             return this.xpath.evaluate(altPaths(path), context != null ? context : doc);
  97         }
  98         catch (XPathExpressionException e)
  99         {
 100             return null;
 101         }
 102     }
 103
 104     protected String[] getTextArray(Element context, String path)
 105     {
 106         try
 107         {
 108             NodeList nodes = (NodeList) this.xpath.evaluate(altPaths(path), context != null ? context : doc,
 109                 XPathConstants.NODESET);
 110             if (nodes == null || nodes.getLength() == 0)
 111                 return null;
 112
 113             String[] strings = new String[nodes.getLength()];
 114             for (int i = 0; i < nodes.getLength(); i++)
 115             {
 116                 strings[i] = nodes.item(i).getTextContent();
 117             }
 118             return strings;
 119         }
 120         catch (XPathExpressionException e)
 121         {
 122             return null;
 123         }
 124     }
 125
 126     protected String[] getUniqueText(Element context, String path)
 127     {
 128         String[] strings = this.getTextArray(context, path);
 129         if (strings == null)
 130             return null;
 131
 132         ArrayList<String> sarl = new ArrayList<String>();
 133         for (String s : strings)
 134         {
 135             if (!sarl.contains(s))
 136                 sarl.add(s);
 137         }
 138
 139         return sarl.toArray(new String[1]);
 140     }
 141
 142     protected Element getElement(Element context, String path)
 143     {
 144         try
 145         {
 146             Node node = (Node) this.xpath.evaluate(altPaths(path), context != null ? context : doc,
 147                 XPathConstants.NODE);
 148             if (node == null)
 149                 return null;
 150
 151             return node instanceof Element ? (Element) node : null;
 152         }
 153         catch (XPathExpressionException e)
 154         {
 155             return null;
 156         }
 157     }
 158
 159     protected Element[] getElements(Element context, String path)
 160     {
 161         try
 162         {
 163             NodeList nodes = (NodeList) this.xpath.evaluate(altPaths(path), context != null ? context : doc,
 164                 XPathConstants.NODESET);
 165             if (nodes == null || nodes.getLength() == 0)
 166                 return null;
 167
 168             Element[] elements = new Element[nodes.getLength()];
 169             for (int i = 0; i < nodes.getLength(); i++)
 170             {
 171                 Node node = nodes.item(i);
 172                 if (node instanceof Element)
 173                     elements[i] = (Element) node;
 174             }
 175             return elements;
 176         }
 177         catch (XPathExpressionException e)
 178         {
 179             return null;
 180         }
 181     }
 182
 183     public Element[] getUniqueElements(Element context, String path, String uniqueTag)
 184     {
 185         Element[] elements = this.getElements(context, path);
 186         if (elements == null)
 187             return null;
 188
 189         HashMap<String, Element> styles = new HashMap<String, Element>();
 190         for (Element e : elements)
 191         {
 192             String name = this.getText(e, uniqueTag);
 193             if (name != null)
 194                 styles.put(name, e);
 195         }
 196
 197         return styles.values().toArray(new Element[1]);
 198     }
 199
 200     private HashMap<Element, Layer> namedLayerElements = new HashMap<Element, Layer>();
 201     private HashMap<String, Layer> namedLayers = new HashMap<String, Layer>();
 202
 203     private void fillLayerList()
 204     {
 205         if (this.namedLayers.size() == 0)
 206         {
 207             Element[] nels = this.getElements(this.capability, "descendant::wms:Layer[wms:Name]");
 208             if (nels == null || nels.length == 0)
 209                 return;
 210
 211             for (Element le : nels)
 212             {
 213                 String name = this.getLayerName(le);
 214                 if (name != null)
 215                 {
 216                     Layer layer = new Layer(le);
 217                     this.namedLayers.put(name, layer);
 218                     this.namedLayerElements.put(le, layer);
 219                 }
 220             }
 221         }
 222     }
 223
 224     public Element[] getNamedLayers()
 225     {
 226         if (this.namedLayerElements.size() == 0)
 227             this.fillLayerList();
 228
 229         return this.namedLayerElements.keySet().toArray(new Element[this.namedLayerElements.size()]);
 230     }
 231
 232     public Element getLayerByName(String layerName)
 233     {
 234         if (this.namedLayers.size() == 0)
 235             this.fillLayerList();
 236
 237         Layer l = this.namedLayers.get(layerName);
 238         return l != null ? l.element : null;
 239     }
 240
 241     // ********* Document Items ********* //
 242
 243     public String getVersion()
 244     {
 245         return this.getText("*/@wms:version");
 246     }
 247
 248     public String getUpdateSequence()
 249     {
 250         return this.getText("*/@wms:updateSequence");
 251     }
 252
 253     // ********* Service Items ********* //
 254
 255     public String getAbstract()
 256     {
 257         return this.getText(this.service, "wms:Abstract");
 258     }
 259
 260     public String getAccessConstraints()
 261     {
 262         return this.getText(this.service, "wms:AccessConstraints");
 263     }
 264
 265     public String getContactOrganization()
 266     {
 267         return this.getText(
 268             this.service, "wms:ContactInformation/wms:ContactPersonPrimary/wms:ContactOrganization");
 269     }
 270
 271     public String getContactPerson()
 272     {
 273         return this.getText(
 274             this.service, "wms:ContactInformation/wms:ContactPersonPrimary/wms:ContactPerson");
 275     }
 276
 277     public String getFees()
 278     {
 279         return this.getText(this.service, "wms:Fees");
 280     }
 281
 282     public String[] getKeywordList()
 283     {
 284         return this.getTextArray(this.service, "wms:KeywordList/wms:Keyword");
 285     }
 286
 287     public String getLayerLimit()
 288     {
 289         return this.getText(this.service, "wms:LayerLimit");
 290     }
 291
 292     public String getMaxWidth()
 293     {
 294         return this.getText(this.service, "wms:MaxWidth");
 295     }
 296
 297     public String getMaxHeight()
 298     {
 299         return this.getText(this.service, "wms:MaxHeight");
 300     }
 301
 302     public String getName()
 303     {
 304         return this.getText(this.service, "wms:Name");
 305     }
 306
 307     public String getTitle()
 308     {
 309         return this.getText(this.service, "wms:Title");
 310     }
 311
 312     // ********* Capability Items ********* //
 313
 314     public String getOnlineResource()
 315     {
 316         return this.getText(this.capability, "wms:OnlineResource/@xlink:href");
 317     }
 318
 319     public String[] getGetCapabilitiesFormats()
 320     {
 321         return this.getTextArray(this.capability,
 322             "wms:Request/wms:GetCapabilities/wms:Format");
 323     }
 324
 325     public String getGetCapabilitiesRequestGetURL()
 326     {
 327         return this.getText(this.capability,
 328             "wms:Request/wms:GetCapabilities/wms:DCPType/wms:HTTP/wms:Get/wms:OnlineResource/@xlink:href");
 329     }
 330
 331     public String getGetCapabilitiesRequestPostURL()
 332     {
 333         return this.getText(this.capability,
 334             "wms:Request/wms:GetCapabilities/wms:DCPType/wms:HTTP/wms:Post/wms:OnlineResource/@xlink:href");
 335     }
 336
 337     public String[] getExceptionFormats()
 338     {
 339         return this.getTextArray(this.capability, "wms:Exception/wms:Format");
 340     }
 341
 342     public String getFeatureInfoRequestGetURL()
 343     {
 344         return this.getText(this.capability,
 345             "wms:Request/wms:GetFeatureInfo/wms:DCPType/wms:HTTP/wms:Get/wms:OnlineResource/@xlink:href");
 346     }
 347
 348     public String getFeatureInfoRequestPostURL()
 349     {
 350         return this.getText(this.capability,
 351             "wms:Request/wms:GetFeatureInfo/wms:DCPType/wms:HTTP/wms:Post/wms:OnlineResource/@xlink:href");
 352     }
 353
 354     public String[] getGetMapFormats()
 355     {
 356         return this.getTextArray(this.capability,
 357             "wms:Request/wms:GetMap/wms:Format");
 358     }
 359
 360     public String getGetMapRequestGetURL()
 361     {
 362         return this.getText(this.capability,
 363             "wms:Request/wms:GetMap/wms:DCPType/wms:HTTP/wms:Get/wms:OnlineResource/@xlink:href");
 364     }
 365
 366     public String getGetMapRequestPostURL()
 367     {
 368         return this.getText(this.capability,
 369             "wms:Request/wms:GetMap/wms:DCPType/wms:HTTP/wms:Post/wms:OnlineResource/@xlink:href");
 370     }
 371
 372     public String getVendorSpecificCapabilities()
 373     {
 374         return this.getText(this.capability, "wms:VendorSpecificCapabilities");
 375     }
 376
 377     public Element getLayer()
 378     {
 379         return this.getElement(this.capability, "wms:Layer");
 380     }
 381
 382     // ********* Layer Items ********* //
 383
 384     protected static class Layer
 385     {
 386         protected HashMap<Element, Style> styleElements = new HashMap<Element, Style>();
 387         protected final Element element;
 388         protected Layer layer;
 389         protected String name;
 390         protected String title;
 391
 392         public Layer(Element element)
 393         {
 394             this.element = element;
 395         }
 396     }
 397
 398     public String getLayerAbstract(Element layer)
 399     {
 400         return this.getText(layer, "wms:Abstract");
 401     }
 402
 403     public String getLayerAttributionTitle(Element layer)
 404     {
 405         return this.getText(layer, "ancestor-or-self::wms:Layer/wms:Attribution/wms:Title");
 406     }
 407
 408     public String getLayerAttributionURL(Element layer)
 409     {
 410         return this.getText(layer, "ancestor-or-self::wms:Layer/wms:Attribution/wms:OnlineResource/@xlink:href");
 411     }
 412
 413     public String getLayerAttributionLogoFormat(Element layer)
 414     {
 415         return this.getText(layer, "ancestor-or-self::wms:Layer/wms:Attribution/wms:LogoURL/wms:Format");
 416     }
 417
 418     public String getLayerAttributionLogoHeight(Element layer)
 419     {
 420         return this.getText(layer, "ancestor-or-self::wms:Layer/wms:Attribution/wms:LogoURL/@wms:height");
 421     }
 422
 423     public String getLayerAttributionLogoURL(Element layer)
 424     {
 425         return this.getText(layer,
 426             "ancestor-or-self::wms:Layer/wms:Attribution/wms:LogoURL/wms:OnlineResource/@xlink:href");
 427     }
 428
 429     public String getLayerAttributionLogoWidth(Element layer)
 430     {
 431         return this.getText(layer, "ancestor-or-self::wms:Layer/wms:Attribution/wms:LogoURL/@wms:width");
 432     }
 433
 434     public Element[] getLayerAuthorityURLs(Element layer)
 435     {
 436         return this.getUniqueElements(layer, "ancestor-or-self::wms:Layer/wms:AuthorityURL", "@wms:type");
 437     }
 438
 439     public abstract BoundingBox[] getLayerBoundingBoxes(Element layer);
 440
 441     public String getLayerCascaded(Element layer)
 442     {
 443         return this.getText(layer, "ancestor-or-self::wms:Layer/@cascaded");
 444     }
 445
 446     public String[] getLayerCRS(Element layer)
 447     {
 448         return this.getUniqueText(layer, "ancestor-or-self::wms:Layer/wms:CRS");
 449     }
 450
 451     public String getLayerDataURLFormat(Element layer)
 452     {
 453         return this.getText(layer, "wms:DataURL/wms:Format");
 454     }
 455
 456     public String getLayerDataURL(Element layer)
 457     {
 458         return this.getText(layer, "wms:DataURL/wms:OnlineResource/@xlink:href");
 459     }
 460
 461     public Element[] getLayerDimensions(Element layer)
 462     {
 463         Element[] dims = this.getElements(layer, "ancestor-or-self::wms:Layer/wms:Dimension");
 464
 465         if (dims == null || dims.length == 0)
 466             return null;
 467
 468         ArrayList<Element> uniqueDims = new ArrayList<Element>();
 469         ArrayList<String> dimNames = new ArrayList<String>();
 470         for (Element e : dims)
 471         {
 472             // Filter out dimensions with same name.
 473             // Keep all those with a null name, even though wms says they're invalid. Let the app decide.
 474             String name = this.getDimensionName(e);
 475             if (name != null && dimNames.contains(name))
 476                 continue;
 477
 478             uniqueDims.add(e);
 479             dimNames.add(name);
 480         }
 481
 482         return uniqueDims.toArray(new Element[uniqueDims.size()]);
 483     }
 484
 485     public Element[] getLayerExtents(Element layer)
 486     {
 487         Element[] extents = this.getElements(layer, "ancestor-or-self::wms:Layer/wms:Extent");
 488
 489         if (extents == null || extents.length == 0)
 490             return null;
 491
 492         ArrayList<Element> uniqueExtents = new ArrayList<Element>();
 493         ArrayList<String> extentNames = new ArrayList<String>();
 494         for (Element e : extents)
 495         {
 496             // Filter out dimensions with same name.
 497             // Keep all those with a null name, even though wms says they're invalid. Let the app decide.
 498             String name = this.getDimensionName(e);
 499             if (name != null && extentNames.contains(name))
 500                 continue;
 501
 502             uniqueExtents.add(e);
 503             extentNames.add(name);
 504         }
 505
 506         return uniqueExtents.toArray(new Element[uniqueExtents.size()]);
 507     }
 508
 509     public abstract BoundingBox getLayerGeographicBoundingBox(Element layer);
 510
 511     public String getLayerFeatureListFormat(Element layer)
 512     {
 513         return this.getText(layer, "wms:FeatureListURL/wms:Format");
 514     }
 515
 516     public String getLayerFeatureListURL(Element layer)
 517     {
 518         return this.getText(layer, "wms:FeatureListURL/wms:OnlineResource/@xlink:href");
 519     }
 520
 521     public String getLayerFixedHeight(Element layer)
 522     {
 523         return this.getText(layer, "ancestor-or-self::wms:Layer/@fixedHeight");
 524     }
 525
 526     public String getLayerFixedWidth(Element layer)
 527     {
 528         return this.getText(layer, "ancestor-or-self::wms:Layer/@fixedWidth");
 529     }
 530
 531     public Element[] getLayerIdentifiers(Element layer)
 532     {
 533         return this.getUniqueElements(layer, "wms:Identifier", "wms:authority");
 534     }
 535
 536     public String[] getLayerKeywordList(Element layer)
 537     {
 538         return this.getTextArray(layer, "wms:KeywordList/wms:Keyword");
 539     }
 540
 541     public abstract String getLayerMaxScaleDenominator(Element layer);
 542
 543     public Element[] getLayerMetadataURLs(Element layer)
 544     {
 545         return this.getElements(layer, "wms:MetadataURL");
 546     }
 547
 548     public abstract String getLayerMinScaleDenominator(Element layer);
 549
 550     public String getLayerName(Element layerElement)
 551     {
 552         Layer layer = this.namedLayerElements.get(layerElement);
 553         return layer != null && layer.name != null ? layer.name : this.getText(layerElement, "wms:Name");
 554     }
 555
 556     public String getLayerNoSubsets(Element layer)
 557     {
 558         return this.getText(layer, "ancestor-or-self::wms:Layer/@noSubsets");
 559     }
 560
 561     public String getLayerOpaque(Element layer)
 562     {
 563         return this.getText(layer, "ancestor-or-self::wms:Layer/@opaque");
 564     }
 565
 566     public String getLayerQueryable(Element layer)
 567     {
 568         return this.getText(layer, "ancestor-or-self::wms:Layer/@queryable");
 569     }
 570
 571     public String[] getLayerSRS(Element layer)
 572     {
 573         return this.getUniqueText(layer, "ancestor-or-self::wms:Layer/wms:SRS");
 574     }
 575
 576     public Element[] getLayerStyles(Element layerElement)
 577     {
 578         Layer layer = this.namedLayerElements.get(layerElement);
 579         if (layer == null)
 580             return null;
 581
 582         if (layer.styleElements != null)
 583             return layer.styleElements.keySet().toArray(new Element[1]);
 584
 585         Element[] styleElements = this.getUniqueElements(layerElement, "ancestor-or-self::wms:Layer/wms:Style", "Name");
 586         if (styleElements == null)
 587             return null;
 588
 589         layer.styleElements = new HashMap<Element, Style>();
 590         for (Element se : styleElements)
 591         {
 592             Style style = new Style(se, layer);
 593             layer.styleElements.put(se, style);
 594             this.styleElements.put(se, style);
 595         }
 596
 597         return layer.styleElements.keySet().toArray(new Element[1]);
 598     }
 599
 600     public Element[] getLayerSubLayers(Element layer)
 601     {
 602         return this.getElements(layer, "wms:Layer");
 603     }
 604
 605     public String getLayerTitle(Element layerElement)
 606     {
 607         Layer layer = this.namedLayerElements.get(layerElement);
 608         if (layer == null)
 609             return null;
 610
 611         return layer.title != null ? layer.title : (layer.title = this.getText(layerElement, "wms:Title"));
 612     }
 613
 614     public Element getLayerStyleByName(Element layerElement, String styleName)
 615     {
 616         Layer layer = this.namedLayerElements.get(layerElement);
 617         if (layer == null)
 618             return null;
 619
 620         if (layer.styleElements == null || layer.styleElements.size() == 0)
 621         {
 622             // Initialize the layer's style list.
 623             this.getLayerStyles(layerElement);
 624             if (layer.styleElements == null || layer.styleElements.size() == 0)
 625                 return null;
 626         }
 627
 628         Collection<Style> styles = layer.styleElements.values();
 629         for (Style s : styles)
 630         {
 631             if (s != null && s.equals(styleName))
 632                 return s.element;
 633         }
 634
 635         return null;
 636     }
 637
 638     // ********* Style Items ********* //
 639
 640     protected HashMap<Element, Style> styleElements = new HashMap<Element, Style>();
 641
 642     protected static class Style
 643     {
 644         protected final Layer layer;
 645         protected final Element element;
 646         protected String name;
 647         protected String title;
 648
 649         public Style(Element element, Layer layer)
 650         {
 651             this.element = element;
 652             this.layer = layer;
 653         }
 654     }
 655
 656     public String getStyleAbstract(Element styleElement)
 657     {
 658         return this.getText(styleElement, "wms:Abstract");
 659     }
 660
 661     public String getStyleLegendFormat(Element styleElement)
 662     {
 663         return this.getText(styleElement, "wms:LegendURL/wms:Format");
 664     }
 665
 666     public String getStyleLegendHeight(Element styleElement)
 667     {
 668         return this.getText(styleElement, "wms:LegendURL/@height");
 669     }
 670
 671     public String getStyleLegendURL(Element styleElement)
 672     {
 673         return this.getText(styleElement, "wms:LegendURL/wms:OnlineResource/@xlink:href");
 674     }
 675
 676     public String getStyleLegendWidth(Element styleElement)
 677     {
 678         return this.getText(styleElement, "wms:LegendURL/@width");
 679     }
 680
 681     public String getStyleName(Element styleElement)
 682     {
 683         Style style = this.styleElements.get(styleElement);
 684         return style != null && style.title != null ? style.title : this.getText(styleElement, "wms:Name");
 685     }
 686
 687     public String getStyleName(Element layerElement, Element styleElement)
 688     {
 689         Layer layer = this.namedLayerElements.get(layerElement);
 690         if (layer == null || layer.styleElements == null)
 691             return this.getStyleName(layerElement, styleElement);
 692
 693         Style style = layer.styleElements.get(styleElement);
 694
 695         return style != null && style.name != null ? style.title : this.getText(styleElement, "wms:Name");
 696     }
 697
 698     public String getStyleSheetURLFormat(Element styleElement)
 699     {
 700         return this.getText(styleElement, "wms:StyleSheetURL/wms:Format");
 701     }
 702
 703     public String getStyleSheetURL(Element styleElement)
 704     {
 705         return this.getText(styleElement, "wms:StyleSheetURL/wms:OnlineResource/@xlink:href");
 706     }
 707
 708     public String getStyleTitle(Element styleElement)
 709     {
 710         Style style = this.styleElements.get(styleElement);
 711         return style != null && style.title != null ? style.title : this.getText(styleElement, "wms:Title");
 712     }
 713
 714     public String getStyleTitle(Element layerElement, Element styleElement)
 715     {
 716         Layer layer = this.namedLayerElements.get(layerElement);
 717         if (layer == null || layer.styleElements == null)
 718             return this.getStyleTitle(styleElement);
 719
 720         Style style = this.styleElements.get(styleElement);
 721         return style != null && style.title != null ? style.title : this.getText(styleElement, "wms:Title");
 722     }
 723
 724     public String getStyleURL(Element styleElement)
 725     {
 726         return this.getText(styleElement, "wms:StyleURL/wms:OnlineResource/@xlink:href");
 727     }
 728
 729     public String getStyleURLFormat(Element styleElement)
 730     {
 731         return this.getText(styleElement, "wms:StyleURL/wms:Format");
 732     }
 733
 734     // ********* Authority Items ********* //
 735
 736     public String getAuthorityName(Element authority)
 737     {
 738         return this.getText(authority, "@wms:name");
 739     }
 740
 741     public String getAuthorityURL(Element authority)
 742     {
 743         return this.getText(authority, "wms:OnlineResource/@xlink:href");
 744     }
 745
 746     // ********* Identifier Items ********* //
 747
 748     public String getIdentifier(Element identifier)
 749     {
 750         return this.getText(identifier, ".");
 751     }
 752
 753     public String getIdentifierAuthority(Element identifier)
 754     {
 755         return this.getText(identifier, "@wms:authority");
 756     }
 757
 758     // ********* Metadata Items ********* //
 759
 760     public String getMetadataFormat(Element metadata)
 761     {
 762         return this.getText(metadata, "wms:Format");
 763     }
 764
 765     public String getMetadataURL(Element metadata)
 766     {
 767         return this.getText(metadata, "wms:OnlineResource/@xlink:href");
 768     }
 769
 770     public String getMetadataType(Element metadata)
 771     {
 772         return this.getText(metadata, "@wms:type");
 773     }
 774
 775     // ********* EX_GeographicBoundingBox Items ********* //
 776
 777     public String getWestBoundLongitude(Element bbox)
 778     {
 779         return this.getText(bbox, "wms:westBoundLongitude");
 780     }
 781
 782     public String getEastBoundLongitude(Element bbox)
 783     {
 784         return this.getText(bbox, "wms:eastBoundLongitude");
 785     }
 786
 787     public String getSouthBoundLatitude(Element bbox)
 788     {
 789         return this.getText(bbox, "wms:southBoundLatitude");
 790     }
 791
 792     public String getNorthBoundLatitude(Element bbox)
 793     {
 794         return this.getText(bbox, "wms:northBoundLatitude");
 795     }
 796
 797     // ********* BoundingBox Items ********* //
 798
 799     public String getBoundingBoxCRS(Element bbox)
 800     {
 801         return this.getText(bbox, "@wms:CRS");
 802     }
 803
 804     public String getBoundingBoxMinx(Element bbox)
 805     {
 806         return this.getText(bbox, "@wms:minx");
 807     }
 808
 809     public String getBoundingBoxMiny(Element bbox)
 810     {
 811         return this.getText(bbox, "@wms:miny");
 812     }
 813
 814     public String getBoundingBoxMaxx(Element bbox)
 815     {
 816         return this.getText(bbox, "@wms:maxx");
 817     }
 818
 819     public String getBoundingBoxMaxy(Element bbox)
 820     {
 821         return this.getText(bbox, "@wms:maxy");
 822     }
 823
 824     public String getBoundingBoxResx(Element bbox)
 825     {
 826         return this.getText(bbox, "@wms:resx");
 827     }
 828
 829     public String getBoundingBoxResy(Element bbox)
 830     {
 831         return this.getText(bbox, "@wms:resy");
 832     }
 833
 834     public String getBoundingBoxSRS(Element bbox)
 835     {
 836         return this.getText(bbox, "@wms:SRS");
 837     }
 838
 839     // ********* Dimension Items ********* //
 840
 841     public String getDimensionName(Element dimension)
 842     {
 843         return this.getText(dimension, "@wms:name");
 844     }
 845
 846     public String getDimensionUnits(Element dimension)
 847     {
 848         return this.getText(dimension, "@wms:units");
 849     }
 850
 851     public String getDimensionUnitSymbol(Element dimension)
 852     {
 853         return this.getText(dimension, "@wms:unitSymbol");
 854     }
 855
 856     public String getDimensionDefault(Element dimension)
 857     {
 858         return this.getText(dimension, "@wms:default");
 859     }
 860
 861     public String getDimensionMultipleValues(Element dimension)
 862     {
 863         return this.getText(dimension, "@wms:multipleValues");
 864     }
 865
 866     public String getDimensionNearestValue(Element dimension)
 867     {
 868         return this.getText(dimension, "@wms:nearestValue");
 869     }
 870
 871     public String getDimensionCurrent(Element dimension)
 872     {
 873         return this.getText(dimension, "@wms:current");
 874     }
 875
 876     public String getDimensionExtent(Element dimension)
 877     {
 878         return this.getText(dimension, ".");
 879     }
 880
 881     // ********* Extent Items, wms 1.1 only ********* //
 882
 883     public String getExtentName(Element dimension)
 884     {
 885         return this.getText(dimension, "@wms:name");
 886     }
 887
 888     public String getExtentDefault(Element dimension)
 889     {
 890         return this.getText(dimension, "@wms:default");
 891     }
 892
 893     public String getExtentMultipleValues(Element dimension)
 894     {
 895         return this.getText(dimension, "@wms:multipleValues");
 896     }
 897
 898     public String getExtentNearestValue(Element dimension)
 899     {
 900         return this.getText(dimension, "@wms:nearestValue");
 901     }
 902
 903     public String getExtentCurrent(Element dimension)
 904     {
 905         return this.getText(dimension, "@wms:current");
 906     }
 907
 908     public String getExtentText(Element dimension)
 909     {
 910         return this.getText(dimension, ".");
 911     }
 912 }