Figure 2.49. Configure Sorting Order of Methods

For methods, you can specify sorting by modifiers, name, parameter count, Java Bean pattern, regular expression pattern or custom ordering. Enable the check box for each criteria that should be significant and use the Up and Down buttons to specify the order in which the criteria should be applied. To further refine the way sorting is applied for modifiers, select the “Modifiers” entry and press the Edit... button to define what modifiers should be significant and adjust their order.

public final void setName(String first, String second) {
    ...
}

In the above example, the access modifier would be “public final”, the name “setName” and parameter count '2';.

Bean Pattern

Bean pattern refers to the JavaBeans specification naming convention that requires accessor and mutator methods to begin with either the set, get or is prefixes.

Figure 2.50. Configure Sorting Order of JavaBeans Methods

You can control the order in which JavaBeans methods and ordinary methods appear by selecting the entry and press the Edit... button. Adjust the order of the different elements in the list component of the new dialog and press Apply. The Ordinary method entry refers to all non-Bean methods.

Group methods with similar names

Normally bean pattern sorting means that all methods of one type (getters, boolean getters, setters, ordinary methods) are grouped together according to the specified order. Enabling this option causes all methods with similar names to be grouped together, i.e. bean methods and ordinary methods may be mixed, but all bean methods for one property stay together.

Similar methods are determined by stripping the bean prefix and comparing the resulting method names. Similar methods are grouped together according to the specified order (getters, boolean getters, setters, ordinary methods).

Since 1.5

public void aaaaaa() {}

public void bbbbbb() {}

public void cccccc() {}

public Object getAaaaaa() {}

public Object getBbbbbb() {}

public Object getCccccc() {}

public boolean isAaaaaa() {}

public boolean isBbbbbb() {}

public boolean isCccccc() {}

public void setAaaaaa() {}

public void setBbbbbb() {}

public void setCccccc() {}

public void aaaaaa() {}

public Object getAaaaaa() {}

public boolean isAaaaaa() {}

public void setAaaaaa() {}

public void bbbbbb() {}

public Object getBbbbbb() {}

public boolean isBbbbbb() {}

public void setBbbbbb() {}

public void cccccc() {}

public Object getCccccc() {}

public boolean isCccccc() {}

public void setCccccc() {}

Keep bean methods together

Grouping similar methods will let you group all bean methods for one property together, but the bean methods are otherwise still mixed with ordinary methods. If you instead prefer to have all bean methods grouped together, you can enable this option to build one large block with all bean methods.

Since 1.8

public void aaaaaa() {}

public Object getAaaaaa() {}

public boolean isAaaaaa() {}

public void setAaaaaa() {}

public void bbbbbb() {}

public Object getBbbbbb() {}

public boolean isBbbbbb() {}

public void setBbbbbb() {}

public void cccccc() {}

public Object getCccccc() {}

public boolean isCccccc() {}

public void setCccccc() {}

public Object getAaaaaa() {}

public boolean isAaaaaa() {}

public void setAaaaaa() {}

public Object getBbbbbb() {}

public boolean isBbbbbb() {}

public void setBbbbbb() {}

public Object getCccccc() {}

public boolean isCccccc() {}

public void setCccccc() {}

public void aaaaaa() {}

public void bbbbbb() {}

public void cccccc() {}

Regular expression

Lets you define arbitrary regular expressions to match method signatures to specify absolute positions for specific methods.

Figure 2.51. Configure Regular Expression Sorting

Matching is performed against a simplified signature: only modifiers, return type and method name are used.

public boolean equals(Object rOther) {
    ...
}

The above method declaration would yield the following signature: public boolean equals

Add...

To add a new regular expression, press the Add... button.

Figure 2.52. Add Regular Expression

Enter the regular expression into the Regex text field and press the Apply... button to apply the addition. If you want to test the regular expression before you submit it, enter a test string in the String field and press the Test button to perform pattern matching.

Remove

To remove an existing regular expression, select the expression you want to remove and press the Remove button.

Change...

To change an existing regular expression, select the expression you want to change and press the Change... button.

Figure 2.53. Change Regular Expression

Adjust the regular expression in the Regex text field and press the Apply... button to apply the change. If you want to test the regular expression before you submit it, enter a test string in the String field and press the Test button to perform pattern matching.

Custom Sort Order

As it might not always be sufficient to rely on method signature information alone, developers can take total control over method ordering using special Javadoc tags.

In order to have methods grouped by purpose, check the Custom entry in the upper list of the dialog, move it to the top and utilize two custom Javadoc tags in your method commentary. In your method declaration comments, you need to add the Javadoc standalone tag @jalopy.group followed by a logical group name. This name can be freely chosen and defines the group a method belongs to.

 /**
  * Returns the value of the Foo property.
  *
  * @jalopy.group  Accessors
  */
  public int getFoo () {
      ...
  }

Then you specify the order of methods with the @jalopy.group-order (you can use @jalopy.group_order to circumvent a bug in the Sun 1.4.2 Javadoc implementation) in the class or interface Javadoc comment. Simply place all group names defined with @jalopy.group tags in the desired order here and all methods will be sorted accordingly.

There is no special requirement on how the logical group names should be written, but it is good practice to separate them by commas.

 /**
  * I want methods ordered by value provided in the @jalopy.group tag of
  * each method in this order. If the method doesn’t have a @jalopy.group tag,
  * fall back on project defaults.
  *
  * @jalopy.group-order  Constructors,Queries,Accessors
  */
class Foo {
    ...
}

This works recursively for all methods of a compilation unit, i.e. for inner classes Jalopy first checks the inner class declaration comment and if no @jalopy.group-order tag can be found, it recursively searches all parent class/interface declarations of the unit. A group name not only defines the sorting order, but is used for separator comments also (Refer to the section called “Comments” for more information on this feature).

Please note that all methods that have no custom group information associated are placed below the ones with grouping tags. Within each group the methods are sorted according to the normal criteria (access modifier, name, parameter count).

Since 1.1

//~ Queries ------------------------------------------------------------

/**
  * This method gets object by primary key
  *
  * @param  inConn  db conn
  * @param  inPK    the primary key
  *
  * @jalopy.group  Queries
  */
public static MyClass getByPK (Connection inConn, Long inPK) {
    ...
}

...

//~ Accessors ------------------------------------------------------------

/**
  * This method returns the Name property.
  *
  * @jalopy.group  Accessors
  */
public String getName (Connection inConn, String inLoginName) {
    ...
}

Class, interface, enum and annotation declarations can be sorted according to access modifier and/or name.

Figure 2.54. Configure Sorting Order of Classes, Interfaces and Enums

To further refine the way sorting is applied for access modifiers, select the Access Modifier entry, press the Edit... button, configure what modifiers should be significant and adjust the order in which testing should be applied.

protected abstract class AbstractPage {
    ...
}

In the above example, the modifiers would be “protected abstract” and the name “AbstractPage”.

Lets you define what modifiers should be significant when sorting by modifier and in which order the declarations should be sorted. The position of the Modifiers entry in the parent dialog defines when the modifiers are compared to determine the order of two declarations. E.g. if you want to sort by modifier first, Modifiers must be the topmost entry in the parent dialog.

Figure 2.55. Configure Sorting Order of Modifiers

Select the check box of each access modifier that should be used to determine the order of declarations and use the Up and Down buttons to define the order in which the declarations should be sorted.

For example, if you want to place all static methods together above the other ones, you would check the “static” modifier and move it to the top of the list.

class Foo {

    public static void x() {}

    static void y() {}

    public void c() {}

    public void d() {}

    protected void b() {}

    private void a() {}
}

But if you only want to have the methods sorted by access modifier, just check the four access modifiers and specify the order in which the declarations are to be sorted, e.g. private, package protected, protected and public.

class Foo {

    private void a() {}

    static void y() {}

    protected void b() {}

    public void c() {}
    
    public void d() {}

    public static void x() {}
}