Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Part of 5.0 and used by the GenUIne adminCentralObservedManager that discovers REST endpoints at runtime configured in modules. Done.

REST design considerations

About HTTP Methods:

  • GET and POST are supported by all browsers, the rest are quirky to say the least
  • PUT would be nice for create
  • DELETE would be nice for delete
  • IPSecurity filter blocks all but GET and POST
  • Some frameworks simluate methods using a query param named _method

REST Module infrastructure

RestEndpointManager is an ObservedManager that observes changes in /modules/<modules/rest-endpoints and discovers them runtime. They're exposed to the outside world at .magnolia/rest/*

The requests are processed by RestEndpointServlet

Exceptions are logged by RestExceptionMapper, HTTP 500 is returned (the exception stack trace is not returned).

The endpoints are not accessible unless the session is logged in. A 401 is sent by SecurityFilter (with the login page).

REST endpoint taxonomy:

AdminCentral

...