Class Metadata

  • All Implemented Interfaces:
    java.util.Map

    public class Metadata
    extends SampMap
    Represents the application metadata associated with a SAMP client.
    Since:
    14 Jul 2008
    Author:
    Mark Taylor
    • Nested Class Summary

      • Nested classes/interfaces inherited from class java.util.AbstractMap

        java.util.AbstractMap.SimpleEntry<K extends java.lang.Object,​V extends java.lang.Object>, java.util.AbstractMap.SimpleImmutableEntry<K extends java.lang.Object,​V extends java.lang.Object>
      • Nested classes/interfaces inherited from interface java.util.Map

        java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object>
    • Field Summary

      Fields 
      Modifier and Type Field Description
      static java.lang.String DESCHTML_KEY
      Key for description of the application in HTML.
      static java.lang.String DESCTEXT_KEY
      Key for short description of the application in plain text.
      static java.lang.String DOCURL_KEY
      Key for the URL of a documentation web page.
      static java.lang.String ICONURL_KEY
      Key for the URL of an icon in png, gif or jpeg format.
      static java.lang.String NAME_KEY
      Key for application name.
    • Constructor Summary

      Constructors 
      Constructor Description
      Metadata()
      Constructs an empty Metadata map.
      Metadata​(java.util.Map map)
      Constructs a Metadata map based on a given map.
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      static Metadata asMetadata​(java.util.Map map)
      Returns a given map as a Metadata object.
      void check()
      Checks that this object is ready for use with the SAMP toolkit.
      java.lang.String getDescriptionHtml()
      Returns an HTML description of the application.
      java.lang.String getDescriptionText()
      Returns a short description of the application.
      java.net.URL getDocumentationUrl()
      Returns a URL for a documentation web page.
      java.net.URL getIconUrl()
      Returns a URL for a gif, png or jpeg icon identifying the application.
      java.lang.String getName()
      Returns the value for the application's name.
      void setDescriptionHtml​(java.lang.String html)
      Sets an HTML description of the application.
      void setDescriptionText​(java.lang.String txt)
      Sets a short description of the application.
      void setDocumentationUrl​(java.lang.String url)
      Sets a URL for a documentation web page.
      void setIconUrl​(java.lang.String url)
      Sets a URL for a gif, png or jpeg icon identifying the application.
      void setName​(java.lang.String name)
      Sets the value for the application's name.
      • Methods inherited from class java.util.AbstractMap

        clear, clone, containsKey, containsValue, equals, get, hashCode, isEmpty, keySet, putAll, remove, size, toString, values
      • Methods inherited from class java.lang.Object

        finalize, getClass, notify, notifyAll, wait, wait, wait
      • Methods inherited from interface java.util.Map

        compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll
    • Field Detail

      • NAME_KEY

        public static final java.lang.String NAME_KEY
        Key for application name.
        See Also:
        Constant Field Values
      • DESCTEXT_KEY

        public static final java.lang.String DESCTEXT_KEY
        Key for short description of the application in plain text.
        See Also:
        Constant Field Values
      • DESCHTML_KEY

        public static final java.lang.String DESCHTML_KEY
        Key for description of the application in HTML.
        See Also:
        Constant Field Values
      • ICONURL_KEY

        public static final java.lang.String ICONURL_KEY
        Key for the URL of an icon in png, gif or jpeg format.
        See Also:
        Constant Field Values
      • DOCURL_KEY

        public static final java.lang.String DOCURL_KEY
        Key for the URL of a documentation web page.
        See Also:
        Constant Field Values
    • Constructor Detail

      • Metadata

        public Metadata()
        Constructs an empty Metadata map.
      • Metadata

        public Metadata​(java.util.Map map)
        Constructs a Metadata map based on a given map.
        Parameters:
        map - map containing initial values for this object
    • Method Detail

      • setName

        public void setName​(java.lang.String name)
        Sets the value for the application's name.
        Parameters:
        name - value for NAME_KEY key
      • getName

        public java.lang.String getName()
        Returns the value for the application's name.
        Returns:
        value for NAME_KEY key
      • setDescriptionText

        public void setDescriptionText​(java.lang.String txt)
        Sets a short description of the application.
        Parameters:
        txt - value for DESCTEXT_KEY key
      • getDescriptionText

        public java.lang.String getDescriptionText()
        Returns a short description of the application.
        Returns:
        value for DESCTEXT_KEY key
      • setDescriptionHtml

        public void setDescriptionHtml​(java.lang.String html)
        Sets an HTML description of the application.
        Parameters:
        html - value for DESCHTML_KEY key
      • getDescriptionHtml

        public java.lang.String getDescriptionHtml()
        Returns an HTML description of the application.
        Returns:
        value for DESCHTML_KEY key
      • setIconUrl

        public void setIconUrl​(java.lang.String url)
        Sets a URL for a gif, png or jpeg icon identifying the application.
        Parameters:
        url - value for ICONURL_KEY key
      • getIconUrl

        public java.net.URL getIconUrl()
        Returns a URL for a gif, png or jpeg icon identifying the application.
        Returns:
        value for ICONURL_KEY key
      • setDocumentationUrl

        public void setDocumentationUrl​(java.lang.String url)
        Sets a URL for a documentation web page.
        Parameters:
        url - value for DOCURL_KEY key
      • getDocumentationUrl

        public java.net.URL getDocumentationUrl()
        Returns a URL for a documentation web page.
        Returns:
        value for DOCURL_KEY key
      • check

        public void check()
        Description copied from class: SampMap
        Checks that this object is ready for use with the SAMP toolkit. As well as calling SampUtils.checkMap(java.util.Map) (ensuring that all keys are Strings, and all values Strings, Lists or Maps), subclass-specific invariants may be checked. In the case that there's something wrong, an informative DataException will be thrown.
        Overrides:
        check in class SampMap
      • asMetadata

        public static Metadata asMetadata​(java.util.Map map)
        Returns a given map as a Metadata object.
        Parameters:
        map - map
        Returns:
        metadata