Berlioz path

The path used by Berlioz to match URLs against a URI pattern to determine which service it corresponds to.

General case

Berlioz ignores the scheme, host and port which are used by the application server for the transport layer. It also ignores the query part (parameters) which are used by the matching service, as well as the fragment part.

When using the standard mapping, it is simply the path within the application without the file extension.

For example, if the user requests the URL below:

http://localhost:8099/user/jsmith.html?action=refresh#details
\___________________/\__________/\___/ \____________________/
      ignored            path     ext         ignored

Berlioz will only attempt to match /user/jsmith again the URI pattern.

Java

In Java, the Berlioz path can be returned from the ContentRequest object, using the getBerliozPath() method.

For example:

public void process(ContentRequest req, XMLWritable xml) throws IOException {
    String path = req.getBerliozPath();
}

Other configurations

Application prefix

In some cases, the Berlioz application is mapped to a specific prefix within the application server (also known as the context path in Java Servlets). That prefix is ignored.

For example, if the user requests URL below, and the context path is '/oauth':

http://localhost:8099/oauth/user/jsmith.html?action=refresh#details
\___________________/\____/\__________/\___/ \____________________/
      ignored        prefix    path     ext         ignored

Berlioz will only attempt to match /user/jsmith again the URI pattern.

Berlioz prefix

When Berlioz is not configured to use the standard mapping and uses a prefix instead of a file extension, that prefix is also ignored.

For example, if the user requests URL below and Berlioz used the prefix '/html' instead of the file extension:

http://localhost:8099/html/user/jsmith?action=refresh#details
\___________________/\____/\__________/\____________________/
      ignored        prefix    path          ignored

Berlioz will only attempt to match /user/jsmith again the URI pattern.

Created on 10 December 2015 , last edited on 08 January 2016 at 13:49