I've a Spring application that expose restful endpoints through @RequestMapping annotation in Controller classes.
I wish that were logged into the console, at server startup, all the endpoints of all the application's controller.
I use a tomcat server and log4j for logging.
Thanks.
For those who use spring-boot:
In the latest spring-boot release (since v2.1), they changed the mapping default log level (as specified in the Release Notes here).
Add one of the following properties to application.properties file:
logging.level.web=TRACElogging.level.org.springframework.web=TRACESample Console Output:
2018-12-12 11:16:51.793 TRACE 11868 --- [ restartedMain] s.w.s.m.m.a.RequestMappingHandlerMapping
c.n.c.MyController:
{POST /users}: addUser(User)
{DELETE /users}: deleteUser(User)
{PUT /users}: updateUser(User)
{GET /users/{id}}: getUserById(String)
{GET /users}: getUsers()
{GET /users_static}: getUsersStaticList()
2018-12-12 11:16:51.795 TRACE 11868 --- [ restartedMain] s.w.s.m.m.a.RequestMappingHandlerMapping
o.s.b.a.w.s.e.BasicErrorController:
{ /error}: error(HttpServletRequest)
{ /error, produces [text/html]}: errorHtml(HttpServletRequest,HttpServletResponse)
In log4J, add the info log level for
org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping class.
With the level INFO :
log4j.category.org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping=INFO
You should have this kind of information (lines are truncated):
2016-11-15 23:34:30.040 INFO 10156 --- [ main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/api/contacts/{id}],methods=[GET],produces=[application/json]}" o
2016-11-15 23:34:30.040 INFO 10156 --- [ main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/api/contacts/{id}],methods=[DELETE],produces=[application/json]}
2016-11-15 23:34:30.040 INFO 10156 --- [ main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/api/contacts],methods=[POST],consumes=[application/json],produce
2016-11-15 23:34:30.040 INFO 10156 --- [ main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/api/contacts/{id}],methods=[PUT],consumes=[application/json],pro
2016-11-15 23:34:30.040 INFO 10156 --- [ main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/api/contacts],methods=[GET],produces=[application/json]}" onto p
2016-11-15 23:34:30.040 INFO 10156 --- [ main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/api/contacts/search],methods=[GET],params=[group-id],produces=[a
UPDATE
Since Spring MVC 5.1/Spring Boot 2, the logging strategy has changed.
Now very few information are logged with the INFO level, the DEBUG level provides more information but it is not detailed.
Only the TRACE level will provide detail information.
Here is the changelog (emphasis is mine) :
Logging revision:
Spring's JCL bridge can be detected by standard Commons Logging.
Less noise on info, readable debug logs, details at trace level.
So change the logging configuration in this way to list all mappings :
Log4J properties way :
log4j.category.org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping=TRACE
Logback way :
<logger level="TRACE" name="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"/>
To add to the previous answer in Spring Boot there is the Actuator that among other things is exposing a dedicated Endpoint called mappings accessible under /mappings.
Since Spring 5.3.5, it's possible to use a special dedicated hidden Logger for logging the endpoints mapping, without overhead of logging all requests processing.
<Logger name="_org.springframework.web.servlet.HandlerMapping.Mappings" level="debug" additivity = "false">
This feature was introduced in https://github.com/spring-projects/spring-framework/issues/26539
