Docs for obtaining server port

This commit is contained in:
Dave Syer 2013-12-27 09:18:09 +00:00
parent 384dfc91e3
commit b558537ee6
1 changed files with 13 additions and 2 deletions

View File

@ -423,8 +423,7 @@ can be set with `server.port` (e.g. in `application.properties` or as
a System property). Thanks to relaxed binding of `Environment` values
you can also use `SERVER_PORT` (e.g. as an OS environment variable).
To scan for a free port (using OS natives to prevent clashes) use
`server.port=0`. To switch off the HTTP endpoints completely, but
To switch off the HTTP endpoints completely, but
still create a `WebApplicationContext`, use `server.port=-1` (this is
sometimes useful for testing).
@ -432,6 +431,18 @@ For more detail look at the
[`ServerProperties`](https://github.com/spring-projects/spring-boot/blob/master/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/web/ServerProperties.java?source=c)
source code.
## Use a Random Unassigned HTTP Port
To scan for a free port (using OS natives to prevent clashes) use
`server.port=0`.
## Discover the HTTP Port at Runtime
You can access the port the server is running on from log output or
from the `EmbeddedWebApplicationContext` via its
`EmbeddedServletContainer` (you can `@Autowired` an
`ApplicationContext` and downcast it to obtain the specific type).
## Change the HTTP Port or Address of the Actuator Endpoints
In a standalone application the Actuator HTTP port defaults to the