Class CodeFormat

  • All Implemented Interfaces:
    Cloneable

    public final class CodeFormat
    extends Object
    implements Cloneable
    Encapsulates some common Java source code formatting options. The class can also be used as a buffer for formatted Java code.
    Author:
    Abe White
    • Constructor Detail

      • CodeFormat

        public CodeFormat()
    • Method Detail

      • getTabSpaces

        public int getTabSpaces()
        The number of spaces to use for tabs; 0 means to use actual tab characters. Defaults to 0.
      • setTabSpaces

        public void setTabSpaces​(int tab)
        The number of spaces to use for tabs; 0 means to use actual tab characters. Defaults to 0.
      • getSpaceBeforeParen

        public boolean getSpaceBeforeParen()
        Whether to place a space before parentheses. Defaults to false.
      • setSpaceBeforeParen

        public void setSpaceBeforeParen​(boolean spaceBeforeParen)
        Whether to place a space before parentheses. Defaults to false.
      • getSpaceInParen

        public boolean getSpaceInParen()
        Whether to place a space within parentheses. Defaults to false.
      • setSpaceInParen

        public void setSpaceInParen​(boolean spaceInParen)
        Whether to place a space within parentheses. Defaults to false.
      • getBraceOnSameLine

        public boolean getBraceOnSameLine()
        Whether to place opening braces on the same line as the block declaration, or on the next line. Defaults to same line.
      • setBraceOnSameLine

        public void setBraceOnSameLine​(boolean braceOnSameLine)
        Whether to place opening braces on the same line as the block declaration, or on the next line. Defaults to same line.
      • getBraceAtSameTabLevel

        public boolean getBraceAtSameTabLevel()
        Whether to place braces at the same tab level as the code within the block. Defaults to false.
      • setBraceAtSameTabLevel

        public void setBraceAtSameTabLevel​(boolean braceAtSameTabLevel)
        Whether to place braces at the same tab level as the code within the block. Defaults to false.
      • getScoreBeforeFieldName

        public boolean getScoreBeforeFieldName()
        Whether to place an underscore before private field names. Defaults to false.
      • setScoreBeforeFieldName

        public void setScoreBeforeFieldName​(boolean scoreBeforeFieldName)
        Whether to place an underscore before private field names. Defaults to false.
      • getLinesBetweenSections

        public int getLinesBetweenSections()
        The number of empty lines between code sections. Defaults to 1.
      • setLinesBetweenSections

        public void setLinesBetweenSections​(int linesBetweenSections)
        The number of empty lines between sections. Defaults to 1.
      • getEndl

        public String getEndl()
        Return a new line character.
      • getEndl

        public String getEndl​(int num)
        Return the given number of new line characters.
      • getEndl

        public String getEndl​(int num,
                              int tabs)
        Return the given number of new line characters, followed by the given tab level indentation.
      • getAfterSection

        public String getAfterSection()
        Return {#getLinesBetweenSections} + 1 new line characters.
      • getOpenParen

        public String getOpenParen​(boolean methodOrIf)
        Open parentheses string. Users can choose to place spaces before and within parentheses.
      • getCloseParen

        public String getCloseParen()
        Close parentheses string. Users can choose to place spaces within parentheses.
      • getParens

        public String getParens()
        Paired parentheses for empty method parameters. Users can choose to place spaces before parentheses.
      • getOpenBrace

        public String getOpenBrace​(int tabLevel)
        Open brace string. Users can choose to place braces on the same line, or on a new line, and can choose the indenting level.
        Parameters:
        tabLevel - the tab level of code within the brace
      • getCloseBrace

        public String getCloseBrace​(int tabLevel)
        Close brace string. Users can choose to place braces on the same line, or on a new line, and can choose the indenting level.
        Parameters:
        tabLevel - the tab level of code within the brace
      • getExtendsDec

        public String getExtendsDec​(int tabLevel)
        Extends declaration. Uses configuration of openBrace(int), but prints "extends" instead of a brace.
      • getImplementsDec

        public String getImplementsDec​(int tabLevel)
        Implements declaration. Uses configuration of openBrace(int), but prints "implements" instead of a brace.
      • getThrowsDec

        public String getThrowsDec​(int tabLevel)
        Throws declaration. Uses configuration of openBrace(int), but prints "throws" instead of a brace.
      • getTab

        public String getTab()
        Tab string. Users can choose to use spaces or tab characters.
      • getTab

        public String getTab​(int tabLevel)
        Tab string. Users can choose to use spaces or tab characters.
        Parameters:
        tabLevel - the number of tabs
      • getParametrizedType

        public String getParametrizedType​(String[] typenames)
        Returns parametrized type string for given type(s).
      • getFieldName

        public String getFieldName​(String fieldName)
        Return the field name for given suggested name, possibly adding leading underscore.
      • getBuffer

        public StringBuffer getBuffer()
        Return the internal code buffer.
      • append

        public CodeFormat append​(boolean val)
        Append the given value to the internal buffer.
      • append

        public CodeFormat append​(byte val)
        Append the given value to the internal buffer.
      • append

        public CodeFormat append​(char val)
        Append the given value to the internal buffer.
      • append

        public CodeFormat append​(double val)
        Append the given value to the internal buffer.
      • append

        public CodeFormat append​(float val)
        Append the given value to the internal buffer.
      • append

        public CodeFormat append​(int val)
        Append the given value to the internal buffer.
      • append

        public CodeFormat append​(long val)
        Append the given value to the internal buffer.
      • append

        public CodeFormat append​(short val)
        Append the given value to the internal buffer.
      • append

        public CodeFormat append​(Object val)
        Append the given value to the internal buffer.
      • endl

        public CodeFormat endl()
        Append the given value to the internal buffer.
        See Also:
        getEndl()
      • endl

        public CodeFormat endl​(int num)
        Append the given value to the internal buffer.
        See Also:
        getEndl(int)
      • parens

        public CodeFormat parens()
        Append the given value to the internal buffer.
        See Also:
        getParens()
      • tab

        public CodeFormat tab()
        Append the given value to the internal buffer.
        See Also:
        getTab()
      • tab

        public CodeFormat tab​(int tabLevel)
        Append the given value to the internal buffer.
        See Also:
        getTab()
      • clear

        public void clear()
        Clear the internal code buffer.
      • toString

        public String toString()
        Return the internal buffer as a string.
        Overrides:
        toString in class Object
      • length

        public int length()
        Return the length of the internal buffer.
      • clone

        public Object clone()
        Make a copy of this code format object with all the same formatting settings.
        Overrides:
        clone in class Object