Questions? Don’t hesitate to ask. We love to help!

Lets you control the general line wrapping options.

Figure 2.38. Wrapping settings page

Wrap lines

Enables or disables automatic line wrapping. When enabled, Jalopy tries to keep lines within the maximal line length and breaks statements across lines when necessary.

Line length

Lets you specify the maximal line length. Jalopy tries (more or less—depending on the used indentation scheme) to limit each line within the given length.

if ((condition1 && condition2)
    || (condition3 && condition4)
    || !(condition5 && condition6)) {
    doSomethingAboutIt();
}

if ((condition1 && condition2) ||
    (condition3 && condition4) ||
    !(condition5 && condition6)) {
    doSomethingAboutIt();
}

void test( String rName,
           boolean rPendandic ) {
    ...
}

void test( String rName, boolean rPendandic ) {
    ...
}

void test( String rName,
           boolean rPendandic ) {
    ...
}

obj.method1( test,
             test2,
             test3 );

obj.method1( test, test2, test3 );

obj.method1( test,
             test2,
             test3 );

if ((condition1 && condition2)
    || (condition3 && condition4)
    || !(condition5 && condition6))
{
    ...
}

if ((condition1 && condition2) || (condition3 && condition4) ||
    !(condition5 && condition6))
{
    ...
}

if ((condition1 && condition2) ||
    (condition3 && condition4) ||
    !(condition5 && condition6))
{
    ...
}

query = "select a.prop_text, "
        + "       a.contest_title, "
        + "  from contest a "
        + "  where a.language_code = b.language_code "
        + "    and b.bob = c.bob "
        + "    and a.x = ? "
        + "  order by a.bob, "
        + "           c.language";

query = "select a.prop_text, " + "       a.contest_title, " +
    "  from contest a "  + "  where a.language_code = b.language_code " +
    "    and b.bob = c.bob " + "    and a.x = ? " + "  order by a.bob, " +
    "           c.language";

query = "select a.prop_text, " +
    "       a.contest_title, " +
    "  from contest a " +
    "  where a.language_code = b.language_code " +
    "    and b.bob = c.bob " +
    "    and a.x = ? " +
    "  order by a.bob, " +
    "           c.language";

String[] foo = new String[]
    {
        "foo",
    };

String[] bar = new String[]
    {
        "bar",
        "car",
    };

String[] foo = new String[] { "foo", };

String[] bar = new String[] { "bar", "car", };

String[] foo = new String[]
    {
        "foo",
    };

String[] bar = new String[]
    {
        "bar",
        "car",
    };

String[] foo = new String[] { "foo", };

String[] bar = new String[]
    { //J:KEEP
        "bar",
        "car",
    };

String firstSymbol = eraseNonBreakingSpaceFromSymbol(
    symbol1, symbol2);

String firstSymbol = eraseNonBreakingSpaceFromSymbol(symbol1,
                                                     symbol2);

String firstSymbol = eraseNonBreakingSpaceFromSymbol(
        symbol1, symbol2);

String query = "select a.prop_text, "
               + "       a.contest_title, "
               + "  from contest a "
               + "  where a.language_code = b.language_code ";

String name = "Walther"
              + getNick();

String query = "select a.prop_text, "
               + "       a.contest_title, "
               + "  from contest a "
               + "  where a.language_code = b.language_code ";

String name = "Walther" + getNick();

if (conditionOne &&                                |
    ("foo".equals(aStr) || "bar".equals(aStr))     |
  doSomething();                                   |

boolean conditionTwo = "foo".equals(aStr);         |
boolean conditionThree = "bar".equals(aStr);       |
                                                   |
if (conditionOne &&                                |
    (conditionTwo || conditionThree))              |
  doSomething();                                   |

                                                   |
if (conditionOne && (conditionTwo || conditionThree))
  doSomething();                                   |

this.customerNumber = new CustomerNumber(
                                         ServiceManager.createService());

this.customerNumber = new CustomerNumber(ServiceManager.createService());

nuMBeans =
     NuvegaPropertiesHandler.getNNuvegaArrayProperty(
         NuvegaProperties.PROPERTIES_FILE_NUVEGA_BEAN_NAME);

nuMBeans = NuvegaPropertiesHandler.getNNuvegaArrayProperty(
         NuvegaProperties.PROPERTIES_FILE_NUVEGA_BEAN_NAME);

failed(output, "a" + "b", null,                           |
        "Failed to open prefs: " + e.getMessage());       | 
                                                          |

failed(output, "a" + "b", null, "Failed to open prefs: "  |
       + e.getMessage());                                 |
                                                          |

failed(output, "a" + "b",                                 |
       "Failed to open prefs: " + e.getMessage());        |
                                                          |

Lets you configure the line wrapping behavior for individual elements.

Figure 2.39. Wrapping options

Jalopy supports different wrapping strategies that can be applied to individual elements as required. To configure wrapping for a specific element, locate the element in the tree and select the current strategy. A pop-up menu will open that lets you change the strategy. The preview instantly reflects any change so you can easily recognize what the impact of a different strategy would be. The current available strategies are:

Never wrap

Disables wrapping for a specific element altogether. Please note that disabling wrapping might lead to long lines that exceed the maximal line length and should therefore preferably only be used with certain elements to avoid line wrapping at specific positions.

                                                        |
import com.mycompanyname.myprojectname.mypackagename.MyClassName;
                                                        |

import com.mycompanyname.myprojectname.mypackagename    |
    .MyClassName;                                       |

Wrap when necessary

Only wraps when otherwise the maximal line length limit would be exceeded. One could refer to this policy as lower level or late line wrapping. This strategy favors the use of horizontal space and leads to compact code, but might make certain constructs difficult to read because there is sometimes no clear visual boundary between elements when used exclusively.

String value = "xxxxxxxxxxxxxxxxxxxxxxx" + "xxxxxxxxxxxxx"         |
    + "xxxxxxxxxxxxx";                                             |

String value =                                                     |
    "xxxxxxxxxxxxxxxxxxxxxxx" + "xxxxxxxxxxxxx" + "xxxxxxxxxxxxx"; |

Wrap when exceed

Wraps if an element would not fit completely into the current line. Think of it as higher level or early line wrapping. This is probably the most balanced strategy when available that combines very readable results with moderate vertical space requirements.

interface Testable extends Transferable, Recordable, |
    Playable, Immutable, Serializable {              |
}                                                    |

interface Testable                                   |
    extends Transferable, Recordable, Playable,      |
         Immutable, Serializable {                   |
}                                                    |

Wrap all when first wrapped

Forces a line break for all related elements (like declaration parameters) if the first element has been wrapped. This leads to very uniform and readable code at the expense of higher vertical space requirements.

while (                                                   |
    "picker".equals(xxxxxxxxxxxxxxxxxxxxxxxxxx.getName()) |
        && m.isStatic() && m.isPublic() && m.isFinal()) { |
   ...                                                    |
}                                                         |

while (                                                   |
    "picker".equals(xxxxxxxxxxxxxxxxxxxxxxxxxx.getName()) |
        && m.isStatic()                                   |
        && m.isPublic()                                   |
        && m.isFinal()) {                                 |
   ...                                                    |
}                                                         |

Wrap all when exceed

Similar to Wrap all when first wrapped, but forces a line break for all related elements (like declaration parameters), if the whole element would not fit into the current line.

_userDatabase.addUser(                                      |
    "John", "Doo", encryptPassword("password", secretKey),  |
    "123 Nashville", "Surgrass");                           |

_userDatabase.addUser(                                      |
    "John",                                                 |
    "Doo",                                                  |
    encryptPassword("password", secretKey),                 |
    "123 Nashville",                                        |
    "Surgrass");                                            |

Force wrap

Always wraps a specific element or elements (like call arguments). This can be useful to ensure a consistent style e.g. for chained calls or parameter lists, but also to force line breaks at unusual positions that would normally not be considered during line wrapping.

public static int foo() {
    ...
}

public static int
foo() {
    ...
}

Please note that not all strategies apply to all elements, and therefore you might be presented with a different set of strategies for each element. Below you find all currently available elements listed along with some short examples of the output with different wrapping strategies.

Import declaration

For import declarations you can choose whether they should be wrapped along the dots if otherwise the maximal line length would be exceeded or not at all.

Since 1.4

                                                        |
import com.mycompanyname.myprojectname.mypackagename.MyClassName;
                                                        |

import com.mycompanyname.myprojectname.mypackagename    |
    .MyClassName;                                       |

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Before declaration keyword

Lets you choose to force a line break before class, interface enum and @interface keywords or disable line wrapping completely.

Since 1.4

public class FooBar {
    ...
}

public
class FooBar {
    ...
}

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

After class keyword

Lets you force a line break after the class keyword or disable line wrapping altogether.

Since 1.3

public class FooBar {
    ...
}

public class
FooBar {
    ...
}

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Before extends keyword

Lets you either force a line break before the extends keyword of class/interface/enum declarations, only print a line break if the extends clause would not completely fit into one line, or print a line break only if the extends clause would otherwise exceed the maximal line length. Only wrapping when absolutely necessary will require the least vertical space and yield the most compact code, but readability might be affected.

interface InterfaceWithAHugeAndSillyName        |
    extends Amicable, Adorable {                |
    ...                                         |
}                                               |

Enforcing a line break before the keyword if the complete clause would not fit into one line, provides a good balance between readability and space requirements.

                                                   |
interface Testable extends Transferable, Recordable,
    Playable {                                     |
    ...                                            |
}                                                  |

interface Testable                                 |
    extends Transferable, Recordable, Playable {   |
    ...                                            |
}                                                  |

Always enforcing a line break before the keyword might be a viable strategy to achieve the most consistent behavior at the expense of slightly higher vertical space requirements.

interface Enyoyable extends Amicable, Adorable { |
    ...                                          |
}                                                |

interface Enyoyable                              |
    extends Amicable, Adorable {                 |
    ...                                          |
}                                                |

You can control the space printed before the keyword via the indentation settings. See “Extends indent size” for more information. For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

After extends types

Lets you configure the wrapping behavior for the type names of extended classes.

public interface Channel extends Puttable, Takable {
    ...
}

public interface Channel extends Puttable,
                                 Takable {
    ...
}

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Before implements keyword

Forces a line break before the implements keyword of a class declaration.

public class SynchronizedBoolean implements Comparable, Cloneable {
    ...
}

public class SynchronizedBoolean
    implements Comparable, Cloneable {
    ...
}

You can control the space printed before the keyword via the indentation settings. See “Implements indent size” for more information. For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

After implements types

Forces a line wrap after each type name of the implemented classes.

public class SynchronizedBoolean implements Comparable, Cloneable {
    ...
}

public class SynchronizedBoolean implements Comparable,
                                            Cloneable {
    ...
}

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Before throws keyword

Forces a line break before the throws keyword of a method/constructor declaration.

private File getDestinationFile(File dest, String packageName,
                                String filename) throws IOException {
    ...
}

private File getDestinationFile(File dest, String packageName,
                                String filename)
                         throws IOException {
    ...
}

You can control the space printed before the keyword via the indentation settings. See “Throws indent size” for more information. For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

After throws keyword

Forces a line break after the throws keyword.

Since 1.3

public void foo()
    throws FooException,
        BarException {
    ...
}

public void foo()
    throws
        FooException,
        BarException {
    ...
}

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

After throws types

Forces a line wrap after each type name of the throws clause of a method/constructor declaration.

private File getDestinationFile(File dest, String packageName,
                                String filename)
                         throws IOException, FooException {
    ...
}

private static final File getDestinationFile(File dest, String packageName,
                                             String filename)
    throws IOException,
        FooException {
    ...
}

private File getDestinationFile(File dest, String packageName,
                                String filename)
                         throws IOException,
                                FooException {
    ...
}

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

After enum constant

When enabled, forces a line break after each enum constant of an enum declaration.

Since 1.2

public enum Season {
    WINTER, SPRING, SUMMER, FALL
}

public enum Season {
    WINTER,
    SPRING,
    SUMMER,
    FALL
}

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Before field name

Forces a line wrap before the name of an instance field declaration. Please note that this option does not apply for multi-variables.

Since 1.2

private int _count = 0

private int
_count = 0

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

After multi variable type

When enabled, a line break will be printed after the type identifier of the declaration.

Since 1.0

BigInteger q = null, p = null, g = null;

BigInteger
    q = null, p = null, g = null;

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

After multi variable declarator

When enabled, each declaration of a multi-variable declaration gets always printed on a new line. Otherwise, wrapping only occurs when necessary.

Since 1.0

BigInteger q = null, p = null, g = null;

BigInteger q = null,
           p = null,
           g = null;

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Before method name

Forces a line wrap before the name of a method or constructor declaration.

Since 1.0.3

public static int foo()
{
    ...
}

public static int
foo()
{
    ...
}

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Parameters

Forces a line break after each parameter of a method or constructor declaration.

public static File create(File file, File directory, int backupLevel)
                   throws IOException {
    ...
}

public static File create(File file,
                          File directory,
                          int backupLevel)
                   throws IOException {
    ...
}

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Chained method call

Lets you either force a line break before each call chain, preferably print a line break before a call chain if the whole call cannot be printed in just one line, only print a line break before a call chain when absolutely necessary to avoid breaking the line length limit, or disable line wrapping before call chains altoghether.

Strictly enforcing a line break before each call chain is the simplest strategy, and leads to very uniform and easy to read code, but has the highest vertical space requirements.

buf.append("xxxxxxxxxxxxxxx")
   .append("xxxxx")
   .insert(0, "xxxxxxxxxxxxxx")
   .append("xxx")
   .insert(0, "xxx");

Wrapping all chains when the whole expression would not fit into one line, provides the best compromise between enhanced readability and vertical space requirements.

method("setName").withParameterTypes(String.class)            |
                 .in(person)                                  |
                 .invoke("Luke");                             |
                                                              |
field("name").ofType(String.class).in(person).set("Anakin");  |

Preferably wrapping before the call chain if the whole chain cannot be printed in one line, is the most sensible approach if you want a more compact, yet readable result.

buf.append("xxxxxxxxxxxxxxx").append("xxxxx")
   .insert(0, "xxxxxxxxxxxxxx").append("xxx").insert(0, "xxx");

Simply wrapping when necessary is not recommended as it favors wrapping on the lower level. Code is often even more compact, but readability might be compromised.

buf.append("xxxxxxxxxxxxxxx").append("xxxxx").insert(0,
    "xxxxxxxxxxxxxx").append("xxx").insert(0, "xxx");

Disable wrapping for chained calls might lead to code lines crossing the line length limit, but naturally requires the least vertical space.

                                                                   |
message.format(ERROR_SOURCE_ADDRESS).param(m_session.getAimName()).send();
                                                                   |
buf.append("xxxxxxxxxxxxxxx").append("xxxxx").insert(0,            |
    "xxxxxxxxxxxxxx").append("AAA").insert(0, "xxx");              |

Disabling wrapping before call chains altogether, only makes a difference for calls without arguments. Otherwise, wrapping may still happen within the argument list, as you can see in the above example.

You can control the indentation for chained method calls with either “Indent dotted expressions” or “Align chained method calls”. For enhanced readability, it’s probably best to have chained calls aligned. Otherwise wrapped calls will be indented with the current indentation strategy.

buf.append("xxxxxxxxxxxxxxx")
    .append("xxxxx")
    .insert(0, "xxxxxxxxxxxxxx")
    .append("xxx")
    .insert(0, "xxx");

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Nested chained method call

Lets you either force a line break before each nested call chain, preferably print a line break before a call chain if the whole call cannot be printed in just one line, only print a line break before a call chain when absolutely necessary to avoid breaking the line length limit, or disable line wrapping before nested call chains altogether.

Since 1.6

Strictly enforcing a line break before each nested call chain is the simplest strategy, and leads to very uniform and easy to read code, but has the highest vertical space requirements.

mix(new DrinkBuilder().add("tequila")
                      .withRocks()
                      .withSalt()
                      .drink());

Wrapping all chains when the whole expression would not fit into one line, provides the best compromise between enhanced readability and vertical space requirements.

mix(new DrinkBuilder().add("tequila")                     |
                      .withRocks()                        |
                      .withSalt()                         |
                      .drink());                          |
                                                          |
mix(new DrinkBuilder().add("juice").withRocks().drink()); |

Preferably wrapping before a call chain if the whole chain cannot be printed in one line, is the most sensible approach if you want a more compact, yet readable result.

mix(new DrinkBuilder().withIce()
                      .drink("special flavored spiced rum",
                          50));

Simply wrapping when necessary is not recommended as it favors wrapping on the lower level. Code is often even more compact, but readability might be compromised.

mix(new DrinkBuilder().withIce().drink(
        "special flavored spiced rum", 50));

Disable wrapping for chained calls might lead to lines crossing the line length limit, but naturally requires the least vertical space. Wrapping may still happen within the argument list.

                                                  |
mix(new DrinkBuilder().add("juice").withRocks().drink());
                                                  |

You can control the indentation for chained method calls with either “Indent dotted expressions” or Section 2.8.8.2.3, “Nested chained method calls”. For enhanced readability, it’s probably best to have chained calls aligned. Otherwise wrapped calls will be indented with the current indentation strategy.

Please note that you can control the alignment for chained method calls with the Section 2.8.8.2.3, “Nested chained method calls” option. For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

message.format(ERROR_SOURCE_ADDRESS).param (m_session.getAimName()).send();

message.format(ERROR_SOURCE_ADDRESS)
       .param (m_session.getAimName())
       .send();

Call arguments

Forces a line break after each argument of a method call.

doSomething();
_userDatabase.addUser("Name", encryptPassword("password", _secretKey),
                      "123 fake address");
doSomethingElse();

doSomething();
_userDatabase.addUser("Name",
                      encryptPassword("password",
                                      _secretKey),
                      "123 fake address");
doSomethingElse();

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Nested call arguments

Forces a line wrap after each argument of a method call if at least one argument is a method call itself. This option can prove especially useful if one prefers to nest method calls as arguments rather than adding local variables just to hold those arguments.

doSomething();
_userDatabase.addUser("Name",
                      encryptPassword("password", _secretKey),
                      "123 fake address");
doSomethingElse();

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Marker annotation

Lets you control the wrapping behavior of marker annotations. Marker annotations are annotations with no elements, e.g. @Preliminary. There are four strategies you can choose from:

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Since 1.1

@Preliminary public class TimeTravel {
    ...
}

@Preliminary
public class TimeTravel {
    ...
}

public @Preliminary class TimeTravel {
    ...
}

Parameter marker annotation

Lets you control the wrapping behavior of marker annotations that appear within declaration parameters. There are two strategies you can choose from:

The second strategy only makes sense when using one of the endline indentation strategies. Otherwise line wrapping will preferably happen after the left parenthesis when necessary.

Since 1.9.3

public Result find(@Name String rName) {
    ...
}

                                      |
public Result find(@Name              |
                   String rName) {    |
    ...                               |
}                                     |

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

After left parenthesis

Lets you control the wrapping behavior of the left parenthesis of normal and single-member annotations. You can avoid a line break altogether, only print a line break if the annotation would otherwise exceed the maximal line length, or print a line break whenever an annotation takes more than just one line.

Never wrapping is the best choice when using Section 2.8.8.1.1, “Strict Endline”, but with the other indentation strategies it depends on your preference and the annotations you use whether a line break is desirable. If you don’t want to disable wrapping for annotations altogether, it is recommended to allow a line break after the left parenthesis.

Since 1.9.2

@WebService(name = "com.company.FooDemoService",             |
            targetNamespace = "com.foo.demo")                |
public interface Foo {                                       |
    @WebResult(targetNamespace = "com.company.jaxws.space.order")
    public Receipt placeOrder(Order order);                  |
}                                                            |

@WebService(name = "com.company.FooDemoService",             |
    targetNamespace = "com.foo.demo")                        |
public interface Foo {                                       |
    @WebResult(targetNamespace = "com.company.jaxws.space.order")
    public Receipt placeOrder(Order order);                  |
}                                                            |

Wrapping after the left parenthesis often provides more horizontal space and therefore can keep your annotations within the maximal line limit. When using anything other than Section 2.8.8.1.1, “Strict Endline” you probably want to at least enable this strategy if the line length limit is important.

@WebService(name = "com.company.FooDemoService",             |
            targetNamespace = "com.foo.demo")                |
public interface Foo {                                       |
    @WebResult(                                              |
        targetNamespace = "com.company.jaxws.space.order")   |
    public Receipt placeOrder(Order order);                  |
}                                                            |

Wrap when exceed is the most aggressive strategy that will preferably issue a line break after the left parentheses whenever the annotation will take more than one line. This works best when using “Standard indentation”, but might be desirable otherwise as well. But please note that because of backward compatibility constraints “Wrap before right parenthesis” must be enabled then.

@WebService(                                                 |
    name = "com.company.FooDemoService",                     |
    targetNamespace = "com.foo.demo")                        |
public interface Foo {                                       |
    @WebResult(                                              |
        targetNamespace = "com.company.jaxws.space.order")   |
    public Receipt placeOrder(Order order);                  |
}                                                            |

@WebService(                                                 |
            name = "com.company.FooDemoService",             |
            targetNamespace = "com.foo.demo")                |
public interface Foo {                                       |
    @WebResult(                                              |
        targetNamespace = "com.company.jaxws.space.order")   |
    public Receipt placeOrder(Order order);                  |
}                                                            |

Annotation members

Lets you control the wrapping behavior of the member expressions of normal annotations. You can disable wrapping altogether, only wrap after a member element when really necessary, or force line wrapping after each element. Never wrapping can easily lead to long lines which exceeded the maximal line length, but this might be acceptable.

Since 1.5

                                                                |
@WebService(name="FooDemoService", targetNamespace="com.foo.Namespace")
public class BitTwiddle {                                       | 
}                                                               |

Please note that for nested annotations, wrapping might still happen depending on your parentheses preferences. If you want to disable wrapping for annotations altogether, you need to set the parentheses options to "Never wrap" as well.

@Author(                                                        |
    @Name(first = "Joe", last = "Hacker", location = "Redmond") |
)                                                               |
public class BitTwiddle { ... }                                 |

If the line length limit it important, you should at least enable "Wrap when necessary". This ensures that a line break will occur after an annotation member whenever the next annotation would exceed the maximal line length.

@WebService(name = "FooDemoService",                            |
    targetNamespace = "com.foo.demo.Namespace")                 |
                                                                |
public class BitTwiddle { ... }                                 |

Taking to the extreme, you can enforce a line break after each annotation member. This takes more vertical space, but leads to very unified and readable code. Probably best to allow wrapping after the left parentheses when not using Section 2.8.8.1.1, “Strict Endline”.

@WebService(                                                      |
    name = "FooService",                                          |
    namespace = "com.foo.Namespace")                              |
public class BitTwiddle { ... }                                   |

@Author(
    @Name(
        first = "Joe",
        last = "Hacker"
    )
)
public class BitTwiddle { }

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Before right parenthesis

Lets you control the wrapping behavior of the right parenthesis of normal and single-member annotations. You can avoid a line break altogether, only print a line break if the annotation would otherwise exceed the maximal line length, or print a line break whenever an annotation takes more than just one line.

Never wrapping is a good choice from an aesthetical point of view and should suffice for most needs. Only if you are anal about the maximal line length limit, you really should select another strategy.

Since 1.9.2

@WebService(name = "com.company.FooDemoService",             |
            targetNamespace = "com.foo.demo")                |
public interface Foo {                                       |
    @WebResult(targetNamespace = "com.company.jaxws.space.order")
    public Receipt placeOrder(Order order);                  |
}

@WebService(name = "com.company.FooDemoService",             |
    targetNamespace = "com.foo.demo")                        |
public interface Foo {                                       |
    @WebResult(targetNamespace = "com.company.jaxws.space.order")
    public Receipt placeOrder(Order order);                  |
}

Wrapping before the right parenthesis should be required only on very rare occasions, because preferably a line break should happen after the left parenthesis. But if you absolutely strive to keep lines within the maximal line length limit, you should enable this strategy.

@WebResult(targetNamespace = "com.company.project.as.jaxws.space.order"|
)                                                                      |
public interface Foo { }                                               |

In case you prefer to let annotation members stand out, you can enable "Wrap when exceed". This way, a line break will be printed before the right parenthesis whenever the annotation list takes more than just one line to print and a line break has been printed after the left parenthesis. You might want to enable the corresponding strategy for the left parenthesis option if you like such a style.

@WebService(
    name = "com.company.FooDemoService",
    targetNamespace = "com.foo.demo"
)

Operators

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Chained index operator

Lets you specify whether wrapping along the dots of chained index operators should be disabled.

Since 1.0

String value = objects[i].names[j]
    .first[k];

String value =
    objects[i].names[j].first[k];

Note how in the above example wrapping does not occur along the dots of the index operator, but right after the assignment! For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Ternary question

Forces a line wrap after the first operand.

String comma = spaceAfterComma
               ? COMMA_SPACE : COMMA;

Indentation for consecutive lines depends on the used indentation scheme. See Section 2.8.8.1.1, “Strategies” for more information. You may further want to use continuation indentation. For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Ternary colon

Forces a line wrap after the second operand.

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

String comma = spaceAfterComma ? COMMA_SPACE : COMMA;

If both switches are enabled, you can force a style like the following:

String comma = spaceAfterComma
    ? COMMA_SPACE
    : COMMA;

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Qualifiers

Lets you specify whether wrapping along the dots of qualifiers should be disabled.

Since 1.0

com.company.project
.MethodName.methodCall();

com.company.project.MethodName
.methodCall();

Note how in the above example, wrapping does not occur along the dots of the qualifier, but before the method call! For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Dotted expression

Lets you specify whether wrapping along dotted expressions should be disabled. This option covers all dotted expressions not handled by the more specific options for chained method calls, index operators or qualifiers (see above). The option is enabled by default for compatibility reasons. If you’re serious about the maximal line length limit, we recommend to disable the option.

Since 1.5

boolean test = ((com.foo.highfly.test.internal.Foo) container)     |
    .transportDebugFlag;                                           |
                                                                   |

boolean test =                                                     |
    ((com.foo.highfly.test.internal.Foo) container).transportDebugFlag;
                                                                   |

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

After assignment

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 whenever the expression cannot be printed in just one line.

this.interessentenNr = new InteressentenNr(
        Fachschluesselerzeugung.createService()
        .getNeuerFachschluessel(
            FachschluesselerzeugungService.FACHSCHLUESSEL_KZ_INTERESSENT
        )
    );

this.interessentenNr =
    new InteressentenNr(
        Fachschluesselerzeugung.createService()
        .getNeuerFachschluessel(
            FachschluesselerzeugungService.FACHSCHLUESSEL_KZ_INTERESSENT
        )
    );

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

After return

Lets you control the wrapping behavior for return statements. When enabled, a line break is inserted after the return statement when the expression would exceed the maximal line length.

Since 1.2.1

return ((getKey() == null) ? (other.getKey() == null)           |
                           : getKey().equals(other.getKey()));  |

return                                                          |
    ((getKey() == null) ? (other.getKey() == null)              |
                        : getKey().equals(other.getKey()));     |

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

After left parenthesis

Lets you control the wrapping behavior for parameter, statement and expression lists. When 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 maximal line length would be otherwise exceeded.

appServerReferencesVector.add(new AppServerReference(
        "RemoteApplicationManager",
        poa.create_reference_with_id(
            "RemoteApplicationManager".getBytes(),
            RemoteApplicationManagerHelper.id())));

When enabled, the line break will always occur behind the left parenthesis when the list parameters, arguments or expressions cannot be printed in just one line.

appServerReferencesVector.add(
    new AppServerReference(
        "RemoteApplicationManager",
        poa.create_reference_with_id(
            "RemoteApplicationManager".getBytes(),
            RemoteApplicationManagerHelper.id())));

This option affects the output style of method/constructor declarations and calls, creator calls and if-else, for, while and do-while blocks. As per default, the wrapped lines will be indented using standard indentation, but you may want to apply another indentation scheme. See Section 2.8.8.1.1, “Strategies” for more information. For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Before right parenthesis

Prints a line break before the right parenthesis of parameter or expression lists when at least one parameter/expression was wrapped. The parenthesis will be intended according to the current indentation level. This switch affects the output style of method/constructor declarations and calls, creator calls and if-else, for, while and do-while blocks.

public void severalParameters(String one,
                              int two,
                              String three,
                              StringObject four,
                              AnotherObject five) {
}

public void severalParameters(String one,
                              int two,
                              String three,
                              StringObject four,
                              AnotherObject five
) {
}

Both switches combined, looks like the following example:

appServerReferencesVector.add(
    new AppServerReference(
        "RemoteApplicationManager",
        poa.create_reference_with_id(
            "RemoteApplicationManager".getBytes(),
            RemoteApplicationManagerHelper.id()
        )
    )
);

For blocks the output may go like this:

if (
    "pick".equals(m.getName()) && m.isStatic() && m.isPublic()
) {
    pickFound = true;
} else if (
    "pick".equals(m.getName()) && m.isStatic() && m.isPublic()
) {
    pickFound = true;
}

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Grouping parentheses

Lets you control the wrapping behavior for grouping parentheses. When enabled, line breaks are inserted after left and before right parentheses of grouped expressions to let the expression(s) stand out.

if (
    !((bankverbindung instanceof ObjectValue)
    || (bankverbindung instanceof PrimitiveValue))
) {
    throw new RuntimeException();
}

if (
    !(
        (bankverbindung instanceof ObjectValue)
        || (bankverbindung instanceof TkPrimitiveValue)
    )
) {
    throw new RuntimeException();
}

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Type parameter

When enabled, type parameters of parametrized (generic) types are wrapped, when necessary.

Since 1.4

                                                                      |
private final Map<Short, String> example = new HashMap<Short, String>();
                                                                      |

                                                                      |
private final Map<Short, String> example = new HashMap<Short,         |
                                                       String>();     |
                                                                      |

Please note that with Endline indentation enabled, wrapping only happens if both type parameter names are either not single-lettered or contain one ore more bounds.

                                                     |
public class Test<A, B extends Comparable<B> & Cloneable> {
}                                                    |

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Labels

Forces a line wrap after labels.

// 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;
            }
        }

// 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;
            }
        }

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Registry Keys

Forces line wrapping after assignments of public constants that are defined in a class whose name ends with the “Registry” suffix.

Since 1.7

class FooRegistry {
    public final static boolean ALLOW_FAKE_FOOS = "com.company.layer.Foo";
}

class FooRegistry {
    public final static boolean ALLOW_FAKE_FOOS =
        "com.company.layer.Foo";
}

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

After parameters/expressions

When 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.

if (
    "pick".equals(m.getName()) &&
    m.isStatic() &&
    m.isPublic()
) {
    pickFound = true;
} else if (
    "pick".equals(m.getName()) &&
    m.isStatic() &&
    m.isPublic()
) {
    pickFound = true;
}

For general information about the available wrapping strategies, please refer to the wrapping strategies overview.

Contains options to control the wrapping behavior for arrays.

Figure 2.40. Arrays settings page

Wrap as needed

Enabling this option means cause line breaks to be inserted, whenever an element would otherwise exceed the maximal line length limit.

String[] s = new String[] {              |
    "first", "second", "third", "fourth",|
    "fifth", "sixth", "seventh",         |
    "eighth", "ninth", "tenth",          |
};                                       |

Wrap all when exceed

Forces a line break after every array element when all elements would not fit into the current line limit.

Since 1.7

String[] s = new String[] {                                           |
    "first", "second", "third", "fourth", "fifth", "sixth", "seventh",|
};                                                                    |

String[] s = new String[] {                                           |
    "first",                                                          |
    "second",                                                         |
    "third",                                                          |
    "fourth",                                                         |
    "fifth",                                                          |
    "sixth",                                                          |
    "seventh",                                                        |
    "eighth",                                                         |
};                                                                    |

Wrap after element

Forces a line break after every n-th element.

String[] s = new String[] {    |
    "first",                   |
    "second",                  |
    "third",                   |
    "fourth",                  |
    "fifth",                   |
    "sixth",                   |
    "seventh",                 |
    "eighth",                  |
    "ninth",                   |
    "tenth",                   |
};

Please note that no checking is done regarding the maximal line length limit which might easily lead to lines exceeding the maximal line length when you set n to something bigger than '1'.

String[] s = new String[] {    |
    "first", "second", "third",|
    "fourth", "fifth", "sixth",|
    "seventh", "eighth", "ninth",
    "tenth",                   |
}                              |

If neither option is enabled, the array elements will be printed in one line, right after the left curly brace, i.e. automatic line wrapping will be disabled.

Please note that you can further customize the wrapping behavior for arrays with the following options: