CodeFormat (OpenJPA Parent POM 3.1.0 API)

java.lang.Object
- 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

Constructors
Constructor and Description

CodeFormat()

Constructors
Constructor and Description
`CodeFormat()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`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`	`getParametrizedType(String[] typenames)` Returns parametrized type string for given type(s).
`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
  - 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)
  - 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

Class CodeFormat

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

CodeFormat

Method Detail

getTabSpaces

setTabSpaces

getSpaceBeforeParen

setSpaceBeforeParen

getSpaceInParen

setSpaceInParen

getBraceOnSameLine

setBraceOnSameLine

getBraceAtSameTabLevel

setBraceAtSameTabLevel

getScoreBeforeFieldName

setScoreBeforeFieldName

getLinesBetweenSections

setLinesBetweenSections

getEndl

getEndl

getEndl

getAfterSection

getOpenParen

getCloseParen

getParens

getOpenBrace

getCloseBrace

getExtendsDec

getImplementsDec

getThrowsDec

getTab

getTab

getParametrizedType

getFieldName

getBuffer

append

append

append

append

append

append

append

append

append

endl

endl

endl

afterSection

openParen

closeParen

parens

openBrace

closeBrace

extendsDec

implementsDec

throwsDec

tab

tab

fieldName

clear

toString

length

clone