Class PGtokenizer


  • public class PGtokenizer
    extends java.lang.Object
    This class is used to tokenize the text output of org.postgres. It's mainly used by the geometric classes, but is useful in parsing any output from custom data types output from org.postgresql.
    See Also:
    PGbox, PGcircle, PGlseg, PGpath, PGpoint, PGpolygon
    • Field Summary

      Fields 
      Modifier and Type Field Description
      protected java.util.List<java.lang.String> tokens  
    • Constructor Summary

      Constructors 
      Constructor Description
      PGtokenizer​(java.lang.String string, char delim)
      Create a tokeniser.
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      int getSize()  
      java.lang.String getToken​(int n)  
      void remove​(java.lang.String l, java.lang.String t)
      This removes the lead/trailing strings from all tokens.
      static java.lang.String remove​(java.lang.String s, java.lang.String l, java.lang.String t)
      This removes the lead/trailing strings from a string.
      void removeAngle()
      Removes < and > from the beginning and end of all tokens.
      static java.lang.String removeAngle​(java.lang.String s)
      Removes < and > from the beginning and end of a string.
      void removeBox()
      Removes [ and ] from the beginning and end of all tokens.
      static java.lang.String removeBox​(java.lang.String s)
      Removes [ and ] from the beginning and end of a string.
      void removeCurlyBrace()
      Removes < and > from the beginning and end of all tokens.
      static java.lang.String removeCurlyBrace​(java.lang.String s)
      Removes curly braces { and } from the beginning and end of a string.
      void removePara()
      Removes ( and ) from the beginning and end of all tokens.
      static java.lang.String removePara​(java.lang.String s)
      Removes ( and ) from the beginning and end of a string.
      int tokenize​(java.lang.String string, char delim)
      This resets this tokenizer with a new string and/or delimiter.
      PGtokenizer tokenizeToken​(int n, char delim)
      This returns a new tokenizer based on one of our tokens.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • tokens

        protected java.util.List<java.lang.String> tokens
    • Constructor Detail

      • PGtokenizer

        public PGtokenizer​(java.lang.String string,
                           char delim)

        Create a tokeniser.

        We could have used StringTokenizer to do this, however, we needed to handle nesting of '(' ')' '[' ']' '<' and '>' as these are used by the geometric data types.

        Parameters:
        string - containing tokens
        delim - single character to split the tokens
    • Method Detail

      • tokenize

        public int tokenize​(java.lang.String string,
                            char delim)
        This resets this tokenizer with a new string and/or delimiter.
        Parameters:
        string - containing tokens
        delim - single character to split the tokens
        Returns:
        number of tokens
      • getSize

        public int getSize()
        Returns:
        the number of tokens available
      • getToken

        public java.lang.String getToken​(int n)
        Parameters:
        n - Token number ( 0 ... getSize()-1 )
        Returns:
        The token value
      • tokenizeToken

        public PGtokenizer tokenizeToken​(int n,
                                         char delim)

        This returns a new tokenizer based on one of our tokens.

        The geometric datatypes use this to process nested tokens (usually PGpoint).

        Parameters:
        n - Token number ( 0 ... getSize()-1 )
        delim - The delimiter to use
        Returns:
        A new instance of PGtokenizer based on the token
      • remove

        public static java.lang.String remove​(java.lang.String s,
                                              java.lang.String l,
                                              java.lang.String t)
        This removes the lead/trailing strings from a string.
        Parameters:
        s - Source string
        l - Leading string to remove
        t - Trailing string to remove
        Returns:
        String without the lead/trailing strings
      • remove

        public void remove​(java.lang.String l,
                           java.lang.String t)
        This removes the lead/trailing strings from all tokens.
        Parameters:
        l - Leading string to remove
        t - Trailing string to remove
      • removePara

        public static java.lang.String removePara​(java.lang.String s)
        Removes ( and ) from the beginning and end of a string.
        Parameters:
        s - String to remove from
        Returns:
        String without the ( or )
      • removePara

        public void removePara()
        Removes ( and ) from the beginning and end of all tokens.
      • removeBox

        public static java.lang.String removeBox​(java.lang.String s)
        Removes [ and ] from the beginning and end of a string.
        Parameters:
        s - String to remove from
        Returns:
        String without the [ or ]
      • removeBox

        public void removeBox()
        Removes [ and ] from the beginning and end of all tokens.
      • removeAngle

        public static java.lang.String removeAngle​(java.lang.String s)
        Removes < and > from the beginning and end of a string.
        Parameters:
        s - String to remove from
        Returns:
        String without the < or >
      • removeAngle

        public void removeAngle()
        Removes < and > from the beginning and end of all tokens.
      • removeCurlyBrace

        public static java.lang.String removeCurlyBrace​(java.lang.String s)
        Removes curly braces { and } from the beginning and end of a string.
        Parameters:
        s - String to remove from
        Returns:
        String without the { or }
      • removeCurlyBrace

        public void removeCurlyBrace()
        Removes < and > from the beginning and end of all tokens.