Package com.orchestranetworks.rest.util

Interface URIInfoUtility

public interface URIInfoUtility

This class provides useful methods to generate URI specific to EBX®.

These methods automatically take into account EBX® server's configuration and current context such as REST proxy configuration and REST Forward modes.

Since:

5.9.0

See Also:

• SessionContext.getURIInfoUtility()

Method Summary

Modifier and Type	Method	Description
URIBuilderForBuiltin	createBuilderForBuiltin(CategoryVersion aCategoryVersion)	Creates a URI builder useful for generating URIs or URLs for the EBX® built-in REST services.
URIBuilderForResource	createBuilderForResource()	Creates a URI builder for generating URIs or URLs for resources packaged with the current module.
URIBuilderForResource	createBuilderForResource(String aModuleName)	Creates a URI builder for generating URIs or URLs for resources packaged with a specified module.
UriBuilder	createBuilderForRESTApplication()	Creates a URI builder for generating URIs or URLs for REST services associated to the current REST application.
UriBuilder	createBuilderForServer()	Creates a URI builder for generating URIs or URLs for resources hosted by the current server.
URI	getBaseURIForBuiltin()	Returns the EBX® built-in REST services base URI.
URI	getBaseURIForRESTApplication()	Returns the REST application base URI for the current application.
URI	getBaseURIForServer()	Returns the server base URI.

Method Details

createBuilderForBuiltin

URIBuilderForBuiltin createBuilderForBuiltin(CategoryVersion aCategoryVersion)
                                      throws IllegalArgumentException

Creates a URI builder useful for generating URIs or URLs for the EBX® built-in REST services.

The builder is initialized with the built-in data services base URI. The data services base URI is automatically initialized by the REST Toolkit depending on the current request.

Parameters:

aCategoryVersion - the service category version

Throws:

IllegalArgumentException - if aCategoryVersion is null

See Also:

• built-in REST services URL

createBuilderForResource

URIBuilderForResource createBuilderForResource()
                                        throws ModuleNotFoundException

Creates a URI builder for generating URIs or URLs for resources packaged with the current module.

Throws:

ModuleNotFoundException

See Also:

• createBuilderForResource(String)

createBuilderForResource

URIBuilderForResource createBuilderForResource(String aModuleName)
                                        throws ModuleNotFoundException

Creates a URI builder for generating URIs or URLs for resources packaged with a specified module.

Parameters:

aModuleName - the specified module name, if null or empty, the current module is used

Throws:

ModuleNotFoundException - the module is not registered

createBuilderForRESTApplication

UriBuilder createBuilderForRESTApplication()

Creates a URI builder for generating URIs or URLs for REST services associated to the current REST application.

The base path is the one specified by the annotation ApplicationPath defined on the class extending RESTApplicationAbstract.

Overriding already provided values is not supported and must be avoided.

See Also:

• Application definitions

createBuilderForServer

UriBuilder createBuilderForServer()

Creates a URI builder for generating URIs or URLs for resources hosted by the current server.

The builder is initialized using the getBaseURIForServer() method.

Overriding already provided values is not supported and must be avoided.

getBaseURIForBuiltin

URI getBaseURIForBuiltin()

Returns the EBX® built-in REST services base URI.

Since:

5.9.17

See Also:

• createBuilderForBuiltin(CategoryVersion)

getBaseURIForRESTApplication

URI getBaseURIForRESTApplication()

Returns the REST application base URI for the current application.

See Also:

• createBuilderForRESTApplication()

getBaseURIForServer

URI getBaseURIForServer()

Returns the server base URI.

See Also:

• createBuilderForServer()