feat: unchecked exceptions for start and stop functions

Hi, thanks for writing this library. I tried to use it because I needed this functionality, but had to give up and look at alternatives. But I can provide you some feedback:

1. in MockOAuth2Server, both start and shutdown throw checked exceptions. This is not a problem in Kotlin, but it is a major PITA in Java. having to wrap in try/catch all their use is not so great when writing tests

2. no JavaDocs on any of the methods in MockOAuth2Server, which unfortunately makes this library nearly unusable, unless one study its source code

[ybelMekk]

Hello again.

Good and good. yes it makes sense. But you can get the port by server.port()?

Could put the documentation issue in it own issue, and we call this something else 😃

[arcuri82]

Hi,

1 yes, just having alternative start/stop methods that do not throw checked exceptions (eg by wrapping them in RuntimeException) would be enough. Not sure though which names would be best for these new functions. Adding to this, would be also be good to have a method to start the mocked server on an ephemeral port, and then return the actual bound port. Right now could use start(0), but then it is unclear how to read back the bound port

2 sorry to say, but can’t really write documentation for an API I haven’t written… unless I study in details all the source code. Furthermore, it is also a matter of making sure that the generated jar for the JavaDocs gets created and uploaded on Maven Central (I have done it in Maven, but not much experience with Gradle…)