UrlFormatter (Gerrit Review Plugin API Documentation)

All Known Implementing Classes:

DefaultUrlFormatter
```
public interface UrlFormatter
```
Formats URLs to different parts of the Gerrit API and UI.
By default, these gerrit URLs are formed by adding suffixes to the web URL. The interface centralizes these conventions, and also allows introducing different, custom URL schemes.
Unfortunately, Gerrit operates in modes for which there is no canonical URL. This can be in standalone utilities that have no HTTP server (eg. index upgrade commands), in servers that run SSH only, or in a HTTP/SSH server that is accessed over SSH without canonical web URL configured.

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`default java.util.Optional<java.lang.String>`	`getChangeViewUrl(Project.NameKey project, Change.Id id)` Returns the URL for viewing a change.
`default java.util.Optional<java.lang.String>`	`getDocUrl(java.lang.String page, java.lang.String anchor)` Returns a URL pointing to a documentation page, at a given named anchor.
`default java.util.Optional<java.lang.String>`	`getRestUrl(java.lang.String suffix)` Returns a REST API URL for a given suffix (eg.
`default java.util.Optional<java.lang.String>`	`getSettingsUrl(java.lang.String section)` Returns a URL pointing to a section of the settings page.
`java.util.Optional<java.lang.String>`	`getWebUrl()` The canonical base URL where this Gerrit installation can be reached.

Method Detail

getWebUrl
```
java.util.Optional<java.lang.String> getWebUrl()
```
The canonical base URL where this Gerrit installation can be reached.
For the default implementations below to work, it must end in "/".

getChangeViewUrl

default java.util.Optional<java.lang.String> getChangeViewUrl(Project.NameKey project,
                                                              Change.Id id)

Returns the URL for viewing a change.

getSettingsUrl

default java.util.Optional<java.lang.String> getSettingsUrl(java.lang.String section)

Returns a URL pointing to a section of the settings page.

getDocUrl

default java.util.Optional<java.lang.String> getDocUrl(java.lang.String page,
                                                       java.lang.String anchor)

Returns a URL pointing to a documentation page, at a given named anchor.

getRestUrl

default java.util.Optional<java.lang.String> getRestUrl(java.lang.String suffix)

Returns a REST API URL for a given suffix (eg. "accounts/self/details")