org.apache.openjpa.lib.util
Class CodeFormat

java.lang.Object
  extended by org.apache.openjpa.lib.util.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 Summary
CodeFormat()
           
 
Method Summary
 CodeFormat afterSection()
          Append the given value to the internal buffer.
 CodeFormat append(boolean val)
          Append the given value to the internal buffer.
 CodeFormat append(byte val)
          Append the given value to the internal buffer.
 CodeFormat append(char val)
          Append the given value to the internal buffer.
 CodeFormat append(double val)
          Append the given value to the internal buffer.
 CodeFormat append(float val)
          Append the given value to the internal buffer.
 CodeFormat append(int val)
          Append the given value to the internal buffer.
 CodeFormat append(long val)
          Append the given value to the internal buffer.
 CodeFormat append(Object val)
          Append the given value to the internal buffer.
 CodeFormat append(short val)
          Append the given value to the internal buffer.
 void clear()
          Clear the internal code buffer.
 Object clone()
          Make a copy of this code format object with all the same formatting settings.
 CodeFormat closeBrace(int tabLevel)
          Append the given value to the internal buffer.
 CodeFormat closeParen()
          Append the given value to the internal buffer.
 CodeFormat endl()
          Append the given value to the internal buffer.
 CodeFormat endl(int num)
          Append the given value to the internal buffer.
 CodeFormat endl(int num, int tabs)
          Append the given value to the internal buffer.
 CodeFormat extendsDec(int tabLevel)
          Append the given value to the internal buffer.
 CodeFormat fieldName(String name)
          Append the given value to the internal buffer.
 String getAfterSection()
          Return {#getLinesBetweenSections} + 1 new line characters.
 boolean getBraceAtSameTabLevel()
          Whether to place braces at the same tab level as the code within the block.
 boolean getBraceOnSameLine()
          Whether to place opening braces on the same line as the block declaration, or on the next line.
 StringBuffer getBuffer()
          Return the internal code buffer.
 String getCloseBrace(int tabLevel)
          Close brace string.
 String getCloseParen()
          Close parentheses string.
 String getEndl()
          Return a new line character.
 String getEndl(int num)
          Return the given number of new line characters.
 String getEndl(int num, int tabs)
          Return the given number of new line characters, followed by the given tab level indentation.
 String getExtendsDec(int tabLevel)
          Extends declaration.
 String getFieldName(String fieldName)
          Return the field name for given suggested name, possibly adding leading underscore.
 String getImplementsDec(int tabLevel)
          Implements declaration.
 int getLinesBetweenSections()
          The number of empty lines between code sections.
 String getOpenBrace(int tabLevel)
          Open brace string.
 String getOpenParen(boolean methodOrIf)
          Open parentheses string.
 String getParens()
          Paired parentheses for empty method parameters.
 boolean getScoreBeforeFieldName()
          Whether to place an underscore before private field names.
 boolean getSpaceBeforeParen()
          Whether to place a space before parentheses.
 boolean getSpaceInParen()
          Whether to place a space within parentheses.
 String getTab()
          Tab string.
 String getTab(int tabLevel)
          Tab string.
 int getTabSpaces()
          The number of spaces to use for tabs; 0 means to use actual tab characters.
 String getThrowsDec(int tabLevel)
          Throws declaration.
 CodeFormat implementsDec(int tabLevel)
          Append the given value to the internal buffer.
 int length()
          Return the length of the internal buffer.
 CodeFormat openBrace(int tabLevel)
          Append the given value to the internal buffer.
 CodeFormat openParen(boolean methodOrIf)
          Append the given value to the internal buffer.
 CodeFormat parens()
          Append the given value to the internal buffer.
 void setBraceAtSameTabLevel(boolean braceAtSameTabLevel)
          Whether to place braces at the same tab level as the code within the block.
 void setBraceOnSameLine(boolean braceOnSameLine)
          Whether to place opening braces on the same line as the block declaration, or on the next line.
 void setLinesBetweenSections(int linesBetweenSections)
          The number of empty lines between sections.
 void setScoreBeforeFieldName(boolean scoreBeforeFieldName)
          Whether to place an underscore before private field names.
 void setSpaceBeforeParen(boolean spaceBeforeParen)
          Whether to place a space before parentheses.
 void setSpaceInParen(boolean spaceInParen)
          Whether to place a space within parentheses.
 void setTabSpaces(int tab)
          The number of spaces to use for tabs; 0 means to use actual tab characters.
 CodeFormat tab()
          Append the given value to the internal buffer.
 CodeFormat tab(int tabLevel)
          Append the given value to the internal buffer.
 CodeFormat throwsDec(int tabLevel)
          Append the given value to the internal buffer.
 String toString()
          Return the internal buffer as a string.
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

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

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)

endl

public CodeFormat endl(int num,
                       int tabs)
Append the given value to the internal buffer.

See Also:
getEndl(int, int)

afterSection

public CodeFormat afterSection()
Append the given value to the internal buffer.

See Also:
getAfterSection()

openParen

public CodeFormat openParen(boolean methodOrIf)
Append the given value to the internal buffer.

See Also:
getOpenParen(boolean)

closeParen

public CodeFormat closeParen()
Append the given value to the internal buffer.

See Also:
getCloseParen()

parens

public CodeFormat parens()
Append the given value to the internal buffer.

See Also:
getParens()

openBrace

public CodeFormat openBrace(int tabLevel)
Append the given value to the internal buffer.

See Also:
getOpenBrace(int)

closeBrace

public CodeFormat closeBrace(int tabLevel)
Append the given value to the internal buffer.

See Also:
getCloseBrace(int)

extendsDec

public CodeFormat extendsDec(int tabLevel)
Append the given value to the internal buffer.

See Also:
getExtendsDec(int)

implementsDec

public CodeFormat implementsDec(int tabLevel)
Append the given value to the internal buffer.

See Also:
getImplementsDec(int)

throwsDec

public CodeFormat throwsDec(int tabLevel)
Append the given value to the internal buffer.

See Also:
getThrowsDec(int)

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()

fieldName

public CodeFormat fieldName(String name)
Append the given value to the internal buffer.

See Also:
getFieldName(java.lang.String)

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


Copyright © 2006 Apache Software Foundation. All Rights Reserved.