Improve formatting of method will lot of parameters and with exception

[murdos]

Source:

    public LoggingConfiguration(@Value("${spring.application.name}") String appName,
        @Value("${server.port}") String serverPort,
        JHipsterProperties jHipsterProperties,
        ObjectMapper mapper)
        throws JsonProcessingException {
        // ...
    }

Formatted with prettier 0.4.0:

    public LoggingConfiguration(
        @Value("${spring.application.name}") String appName,
        @Value("${server.port}") String serverPort,
        JHipsterProperties jHipsterProperties,
        ObjectMapper mapper
    )
        throws JsonProcessingException {
        // ...
    }

I'm not really sure what the result should be, but the position of ) after the last parameter is a bit strange in regards to the exception.
Maybe:

    public LoggingConfiguration(
        @Value("${spring.application.name}") String appName,
        @Value("${server.port}") String serverPort,
        JHipsterProperties jHipsterProperties,
        ObjectMapper mapper
    ) throws JsonProcessingException {
        // ...
    }

[clementdessoude]

I agree with you. I am struggling with one case: how would you format the following ?

public void test() throws Exception1, Exception2, Exception3, Exception4, Exception5, Exception6 {}

Option 1:

public void test() 
    throws Exception1, Exception2, Exception3, Exception4, Exception5, Exception6 {}

Option 2:

public void test() throws 
    Exception1, Exception2, Exception3, Exception4, Exception5, Exception6 {}

Option 3:

public void test() throws Exception1, 
    Exception2, 
    Exception3, 
    Exception4, 
    Exception5, 
    Exception6 {}

Option 4:

public void test() throws 
    Exception1, 
    Exception2, 
    Exception3, 
    Exception4, 
    Exception5, 
    Exception6 {}

Option 5:

public void test() throws Exception1, Exception2, Exception3, Exception4, Exception5, Exception6 {}

[clementdessoude]

Does this formatting looks good ?

class T {
  public void test(String one, String one, String one, String one, String one, String one) {

  }

  public void test(String one, String one, String one, String one, String one, String one) throws Exception, Exception, Exception {

  }

  public void test(String one, String one, String one, String one, String one, String one) throws Exception {

  }

  public void test(String one, String one) throws Exception, Exception, Exception, Exception {

  }

  public void test() throws Exception1, Exception2, Exception3, Exception4, Exception5, Exception6 {

  }

  public void test(String one, String one) throws Exception {

  }
}

into

class T {

  public void test(
    String one,
    String one,
    String one,
    String one,
    String one,
    String one
  ) {}

  public void test(
    String one,
    String one,
    String one,
    String one,
    String one,
    String one
  ) throws Exception, Exception, Exception {}

  public void test(
    String one,
    String one,
    String one,
    String one,
    String one,
    String one
  ) throws Exception {}

  public void test(String one, String one) throws
    Exception,
    Exception,
    Exception,
    Exception {}

  public void test() throws
    Exception1,
    Exception2,
    Exception3,
    Exception4,
    Exception5,
    Exception6 {}

  public void test(String one, String one) throws Exception {}
}

[NoahTheDuke]

Outside perspective: Black (the Python formatter) does it like the prettier 0.4.0 example, so even if it doesn’t look great, it has precedence in the “code formatting” community.

[murdos]

Sorry @clement26695 for the (very) late reply...

The best option IMO is to keep throws on the same line as the (first) exception(s), as in Option 1, because it's more readable (you don't have to look after the throws keyword that might be "hidden" at the end of the previous line) :

public void test() throws Exception1, Exception2 {}

public void test() 
    throws Exception1, Exception2, Exception3, Exception4, Exception5 {}

public void test(
    String one,
    String one,
    String one,
    String one,
    String one,
    String one
  ) throws Exception1, Exception2, Exception3, Exception4, Exception5 {}

This is consistent with how IntelliJ and Spotless (so probably Eclipse too) wrap the throws keyword:

I'm just puzzled on the way to handle a long list of exceptions:

Option A

public void test() 
    throws Exception1, Exception2, Exception3, Exception4, Exception5, Exception6,
    Exception7 {}

public void test(
    String one,
    String one,
    String one,
    String one,
    String one,
    String one
  ) throws Exception1, Exception2, Exception3, Exception4, Exception5, Exception6,
    Exception7 {}

or

Option B

public void test() 
    throws Exception1, 
    Exception2, 
    Exception3, 
    Exception4, 
    Exception5, 
    Exception6,
    Exception7 {}

public void test(
    String one,
    String one,
    String one,
    String one,
    String one,
    String one
  ) throws Exception1, 
    Exception2, 
    Exception3, 
    Exception4, 
    Exception5, 
    Exception6,
    Exception7 {}

Option B is probably more consistent with the Prettier style.

[benjavalero]

Just to confirm. The throws would have a double indent? If not, we would have the body of the method at the same indent label, for instance (with 0.4.0):

public OAuth1AccessToken getAccessToken(OAuth1RequestToken requestToken, String oauthVerifier)
    throws AuthenticationException {
    try {
        [...]
    }
}

[murdos]

Just to confirm. The throws would have a double indent? If not, we would have the body of the method at the same indent label, for instance (with 0.4.0):

In my proposal, it would have a simple indent. I don't think it's a problem if we the same indent level for body and throws

[jhaber]

👍 the Option B style proposed here looks good to me #286 (comment)

[digorydoo]

How about this:

public void one() throws Exc {
    doIt();
}

public void two(
    int someLongishArgument,
    int someOtherArgument
) throws Exc1, Exc2 {
    doIt();
}

public void three()
throws
    SomeWeirdExcpetion,
    SomeOtherWeirdException,
    SomeRatherRareException,
    SomeObscureException
{
    doIt();
}

public void four(
    int someLongishArgument,
    int someOtherArgument
) throws
    SomeWeirdExcpetion,
    SomeOtherWeirdException,
    SomeRatherRareException,
    SomeObscureException
{
    doIt();
}