Controls when and how lines gets wrapped.
Lets you control the general line wrapping options.
Lets you control the general line wrapping options.
Wrap lines
Enables or disables the automatic line wrapping.
Line length
Lets you specify the maximum line length. Jalopy tries (more or less) to limit
each line within the given length.
Deep indent
Specifies the length after which a gap will be identified as "deep indented".
Jalopy tries to avoid these kind of gaps and will force a line break or apply
another indentation scheme, if this size is exceeded.
Example 4.65. Deep indent size (60) not exceeded
| |
protected static synchronized File getANewDestinationFile(File dest, |
| String packageName,
| String filename) |
|----------------- the gap ---------------------------|throws IOException |
{ | |
} | |
| |
60 79
|
Example 4.66. Deep indent size (50) exeeded
| |
protected static synchronized File getANewDestinationFile(File dest, |
| String packageName,
| String filename) |
|----------------- the gap ---------------------------|throws IOException |
{ | |
} | |
| |
50 79
|
Lets you fine-control the wrapping behaviour.
Wrap after left parenthesis
Lets you control the wrapping behaviour for statement and expression lists.
If left disabled, the first line break will be preferably inserted
behind the first parameter or expression and only occurs after the left
parenthesis if the maximum line length would be exceeded. Example 4.67. Wrap after left parenthesis (disabled)
|
appServerReferencesVector.add(new AppServerReference(
"RemoteApplicationManager", |
poa.create_reference_with_id( |
"RemoteApplicationManager".getBytes(), |
RemoteApplicationManagerHelper.id()))); |
|
|
Otherwise the line break will always occur behind the left parenthesis.
Example 4.68. Wrap after left parenthesis (enabled)
appServerReferencesVector.add(
new AppServerReference(
"RemoteApplicationManager",
poa.create_reference_with_id(
"RemoteApplicationManager".getBytes(),
RemoteApplicationManagerHelper.id())));
|
This switch affects the output style of method/constructor declarations and
calls, creator statements and if-else, for,
while and do-while blocks.
As per default, the wrapped lines will be indended using
Standard indentation, but you
may want to apply another indentation scheme. See
Section 4.3.3.1.1, “Policy” for more information.
Wrap before right parenthesis
Forces a line break before the right parenthesis of parameter or expression lists.
The parenthesis will be intended according to the current indentation level.
Only takes action if at least one parameter/expression was indeed wrapped.
This switch affects the output style of method/constructor declarations and
calls, creator statements and if-else, for,
while and do-while blocks.
Example 4.69. Right parenthesis (disabled)
public void severalParameters(String one,
int two,
String three,
StringObject four,
AnotherObject five) {
}
|
Example 4.70. Right parenthesis (enabled)
public void severalParameters(String one,
int two,
String three,
StringObject four,
AnotherObject five
) {
}
|
Both switches combined, looks like the following example:
Example 4.71. Left and right parenthesis
appServerReferencesVector.add(
new AppServerReference(
"RemoteApplicationManager",
poa.create_reference_with_id(
"RemoteApplicationManager".getBytes(),
RemoteApplicationManagerHelper.id()
)
)
);
|
For blocks the output may go like this:
Example 4.72. Left and right parenthesis (wrapped)
if (
"pick".equals(m.getName()) && m.isStatic() && m.isPublic()
) {
pickFound = true;
}
else if (
"pick".equals(m.getName()) && m.isStatic() && m.isPublic()
) {
pickFound = true;
}
|
Wrap grouping parentheses
Lets you control the wrapping behaviour for grouping parentheses. If enabled,
linebreaks are inserted after left and before right parentheses of grouped
expressions to let the expression(s) stand out.
Example 4.73. Grouping parentheses (standard indented)
if (
!((bankverbindung instanceof ObjectValue)
|| (bankverbindung instanceof PrimitiveValue))
) {
throw new RuntimeException();
}
|
Example 4.74. Wrapped grouping parentheses (standard indented)
if (
!(
(bankverbindung instanceof ObjectValue)
|| (bankverbindung instanceof TkPrimitiveValue)
)
) {
throw new RuntimeException();
}
|
Wrap after assignments
Lets you control the way wrapping takes action for assignments. If left disabled,
line wrapping preferably occurs as part of the expression printing. Otherwise
wrapping will be performed right after the assignment.
Example 4.75. Don't wrap after assignment
this.interessentenNr = new InteressentenNr(
Fachschluesselerzeugung.createService()
.getNeuerFachschluessel(
FachschluesselerzeugungService.FACHSCHLUESSEL_KZ_INTERESSENT
)
);
|
Example 4.76. Wrap after assignment
this.interessentenNr =
new InteressentenNr(
Fachschluesselerzeugung.createService()
.getNeuerFachschluessel(
FachschluesselerzeugungService.FACHSCHLUESSEL_KZ_INTERESSENT
)
);
|
Line wrapping will often occur with statements that consist of several (possibly long)
expressions. Here you specify whether line wrapping should occur
before or after the expression operator.
Wrap before operators
If enabled, lines will be wrapped before the operator. The operator will be
printed with the continuation line.
Example 4.77. Wrap before operators
if ((condition1 && condition2)
|| (condition3 && condition4)
|| !(condition5 && condition6))
{
doSomethingAboutIt();
}
|
Wrap after operators
If enabled, lines will be wrapped after the operator.
Example 4.78. Wrap after operators
if ((condition1 && condition2) ||
(condition3 && condition4) ||
!(condition5 && condition6))
{
doSomethingAboutIt();
}
|
If you happen to use Sun Brace styling, you might want to enable
continuation indentation
to let the statement body stand out.
Lets you choose the statements/expressions that are to be wrapped always.
For certain cases, the need may arise to force line wrapping to achieve a
consistent, uniform look. If you enable any of the following switches, line wrapping
will occur for the specified cases no matter whether you have enabled general
line wrapping or not.
Before extends keyword
Forces a line break before the extends keyword of a class/interface declaration.
Example 4.79. Class/Interface extends keyword
public interface Channel extends Puttable, Takable
{
...
}
|
Example 4.80. Class/Interface extends keyword (wrapped)
public interface Channel
extends Puttable, Takable
{
...
}
|
You can control the space printed before the keyword with the
Extends Indent setting.
If you leave the switch disabled, the clause will be printed with
standard indentation.
After extends types
Forces a line wrap after each type name of the extended classes.
Example 4.81. Class/Interface extends types
public interface Channel extends Puttable, Takable
{
...
}
|
Example 4.82. Class/Interface extends types (wrapped)
public interface Channel extends Puttable,
Takable
{
...
}
|
Before implements keyword
Forces a line break before the implements keyword of a class declaration.
Example 4.83. implements keyword
public class SynchronizedBoolean implements Comparable, Cloneable
{
...
}
|
Example 4.84. implements keyword (wrapped)
public class SynchronizedBoolean
implements Comparable, Cloneable
{
...
}
|
You can control the space printed before the keyword with the
Implements Indent setting.
If you leave the switch disabled, the clause will be printed with
standard indentation.
After implements types
Forces a line wrap after each type name of the implemented classes.
Example 4.85. Class implements types
public class SynchronizedBoolean implements Comparable, Cloneable
{
...
}
|
Example 4.86. Class implements types (wrapped)
public class SynchronizedBoolean implements Comparable,
Cloneable
{
...
}
|
Before throws keyword
Forces a line break before the throws keyword of a method/constructor declaration.
Example 4.87. throws keyword
private File getDestinationFile(File dest, String packageName,
String filename) throws IOException
{
...
}
|
Example 4.88. throws keyword (wrapped)
private File getDestinationFile(File dest, String packageName,
String filename)
throws IOException
{
...
}
|
You can control the space printed before the keyword with the
Throws Indent setting. If you
leave the switch disabled, Jalopy tries to align the throws clause with the
method/constructor parameters as with the above example. If no alignment is
possible, the clause will be printed with
standard indentation.
After throws types
Forces a line wrap after each type name of the throws clause of a method/constructor declaration.
Example 4.89. throws types
private File getDestinationFile(File dest, String packageName,
String filename)
throws IOException, FooException
{
...
}
|
Example 4.90. throws types (wrapped)
private File getDestinationFile(File dest, String packageName,
String filename)
throws IOException,
FooException
{
...
}
|
Example 4.91. throws types (standard indented)
private static final File getDestinationFile(File dest, String packageName,
String filename)
throws IOException,
FooException
{
...
}
|
Method Def parameters
Forces a line wrap after each parameter of a method or constructor declaration.
Example 4.92. Method declaration parameters
public static File create(File file, File directory, int backupLevel)
throws IOException
{
...
}
|
Example 4.93. Method declaration parameters (wrapped)
public static File create(File file,
File directory,
int backupLevel)
throws IOException
{
...
}
|
Method Call chains
Forces a line wrap after each chained method call.
Example 4.94. Chained Method Call
message.format(ERROR_SOURCE_ADDRESS).param (m_session.getAimName()).send();
|
Example 4.95. Chained Method Call (wrapped)
message.format(ERROR_SOURCE_ADDRESS)
.param (m_session.getAimName())
.send();
|
Method Call parameters
Forces a line wrap after each parameter of a method call.
Example 4.96. Method call
doSomething();
_userDatabase.addUser("Name", encryptPassword("password", _secretKey),
"123 fake address");
doSomethingElse();
|
Example 4.97. Method call (wrapped)
doSomething();
_userDatabase.addUser("Name",
encryptPassword("password",
_secretKey),
"123 fake address");
doSomethingElse();
|
Method Call parameters if nested
Forces a line wrap after each parameter of a method call if at least one
parameter is a method call itself. This option can prove especially useful if
one prefers to nest method calls as parameters rather than adding local
variables just to hold those parameters.
Example 4.98. Method call if nested (wrapped)
doSomething();
_userDatabase.addUser("Name",
encryptPassword("password", _secretKey),
"123 fake address");
doSomethingElse();
|
Ternary expression question mark (?)
Forces a line wrap after the first operand.
Example 4.99. Ternary expression question mark (deep indented)
String comma = spaceAfterComma
? COMMA_SPACE : COMMA;
|
Indentation for consecutive lines depends on the used indenatation policy.
You may further want to use continuation indentation.
Ternary expression colon (:)
Forces a line wrap after the second operand.
Example 4.100. Ternary expression colon
String comma = spaceAfterComma ? COMMA_SPACE
: COMMA;
|
If both switches are disabled, ternary expressions are printed in one line (if everything fits in one line, that is).
Example 4.101. Ternary expressions
String comma = spaceAfterComma ? COMMA_SPACE : COMMA;
|
If both switches are enabled, you can force a style like the following:
Example 4.102. Ternary expressions (continued)
String comma = spaceAfterComma
? COMMA_SPACE
: COMMA;
|
Labels
Forces a line wrap after labels.
Example 4.103. Label
// advance to the first CLASS_DEF or INTERFACE_DEF
LOOP: for (AST child = tree.getFirstChild();
child != null;
child = child.getNextSibling())
{
switch (child.getType())
{
case JavaTokenTypes.CLASS_DEF :
case JavaTokenTypes.INTERFACE_DEF :
next = child;
break LOOP;
default :
break;
}
}
|
Example 4.104. Label (wrapped)
// advance to the first CLASS_DEF or INTERFACE_DEF
LOOP:
for (AST child = tree.getFirstChild();
child != null;
child = child.getNextSibling())
{
switch (child.getType())
{
case JavaTokenTypes.CLASS_DEF :
case JavaTokenTypes.INTERFACE_DEF :
next = child;
break LOOP;
default :
break;
}
}
|
4.3.4.2.2. Wrap always when exceed
Lets you force wrapping for all parameter or expressions if
the parameter or expression list would otherwise exceed the maximal line length.
If you enable any of the following switches, line wrapping
may occur for the specified cases no matter whether you have enabled general
line wrapping or not.
After extends types
Forces a line wrap after each type name of the extends clause of a
class/interface declaration if the whole clause does not fit in one line.
Example 4.105. Extends types wrapped as needed (standard indented)
public interface VeryImportantInterface |
extends LeastImportantInterface, LessImportantInterface, |
ImportantInterface |
} |
... |
} |
|
Example 4.106. Extends types wrapping forced (standard indented)
public interface VeryImportantInterface |
extends LeastImportantInterface, |
LessImportantInterface, |
ImportantInterface |
} |
... |
} |
|
After implements types
Forces a line wrap after each type name of the implements clause of a
class/interface declaration if the whole clause does not fit in one line.
Example 4.107. Implements types wrapped as needed (standard indented)
public class ImportantClass |
implements ImportantInterface, Serializable, Comparable, |
Cloneable |
} |
... |
} |
|
Example 4.108. Implements types wrapping forced (standard indented)
public class ImportantClass |
implements ImportantInterface, |
Serializable, |
Comparable, |
Cloneable |
} |
... |
} |
|
After throws types
Forces a line wrap after each type name of the throws clause of a
method/constructor declaration if the whole clause does not fit in one line.
Example 4.109. Throws types wrapped as needed (deep indented)
private File getDestinationFile(File dest, String packageName, |
String filename) |
throws IOException, FooException, |
FooBarException |
{ |
... |
} |
|
Example 4.110. Throws types wrapping forced (deep indented)
private File getDestinationFile(File dest, String packageName, |
String filename) |
throws IOException, |
FooException, |
FooBarException |
{ |
... |
} |
|
After parameters/expressions
If enabled, this switch will cause all parameters/expressions to be
wrapped, if and only if the first parameter/expression of the list has been
wrapped.
Example 4.111. Expression list (all wrapped)
if (
"pick".equals(m.getName()) &&
m.isStatic() &&
m.isPublic()
) {
pickFound = true;
}
else if (
"pick".equals(m.getName()) &&
m.isStatic() &&
m.isPublic()
) {
pickFound = true;
}
|
Lets you control miscellaneous wrapping settings. Contains options to control the wrapping for arrays. Wrap as needed Enabling this options means array elements will be wrapped so that they
will be limited within the current line length setting. Example 4.112. Wrap as needed
String[] constraints = { |
"patternPanel.top=form.top", "patternPanel.hcenter=form.hcenter", |
"okButton.top=patternPanel.bottom+20", |
"okButton.right=form.hcenter-10", "cancelButton.vcenter=10", |
"cancelButton.left=10" |
}; |
|
Wrap after element Forces a newline after every n-th element. Example 4.113. Wrap after element 1
String[] constraints = { |
"patternPanel.top=form.top", |
"patternPanel.hcenter=form.hcenter", |
"okButton.top=patternPanel.bottom+20", |
"okButton.right=form.hcenter-10", |
"cancelButton.vcenter=10", |
"cancelButton.left=10" |
}; |
|
Example 4.114. Wrap after element 2
String[] constraints = { |
"patternPanel.top=form.top", "patternPanel.hcenter=form.hcenter",
"okButton.top=patternPanel.bottom+20", "okButton.right=form.hcenter-10",
"cancelButton.vcenter=10", "cancelButton.left=10" |
}; |
|
If both options are left disabled, the array elements will be printed in one
line, right after the left curly brace.
|