public abstract class SipApplicationRouterProvider extends Object
This class is used by the SIP Servlet container to load and instanciate the application router.
The application router must be packaged in accordance with the rules specified in the Service Provider document.
Specifically, the jar file containing the application router implementation must include
META-INF/services/javax.servlet.sip.ar.spi.SipApplicationRouterProvider file.
The contents of the file indicate the name of the concrete public subclass of the SipApplicationRouterProvider class.
The concrete subclass must have a no-arg public constructor.
As specified by the Service Provider framework, the providers may be installed by :
1. Including the provider jar in the system classpath
2. Including the provider jar in the extension class path
3. Container-specific means
The example below shows an app router provider implementation installed in the system classpath
(i.e. the first approach from the three options discussed above).
public class AcmeAppRouter implements SipApplicationRouter {
[...]
}
public class AcmeAppRouterProvider extends SipApplicationRouterProvider {
private final AcmeAppRouter appRouter = new AcmeAppRouter();
public AcmeAppRouterProvider() {
}
public SipApplicationRouter getSipApplicationRouter() {
return appRouter;
}
}
The AcmeAppRouter is then packaged in a jar file and prepended to the system class path.
The SIP servlet container can look up the application router in a manner outlined below.
SipApplicationRouter getSipApplicationRouter() {
Iterator ps = Service.providers(SipApplicationRouterProvider.class);
while (ps.hasNext()) {
SipApplicationRouterProvider p = (SipApplicationRouterProvider)ps.next();
return p.getSipApplicationRouter();
}
return null;
}
Since the SIP servlet specification allows for only one application router to be active at any given time,
the container selects the first provider available in the system classpath.
Instead of relying on classpath order, the specification also defines a system property
which instructs the container to load a given provider.
The javax.servlet.sip.ar.spi.SipApplicationRouterProvider system property can be used to override
loading behavior and force a specific provider implementation to be used.
For portability reasons, containers that provide their own deployment mechanism
for the application router SHOULD obey the system property, if specified by the deployer.
| Constructor and Description |
|---|
SipApplicationRouterProvider() |
| Modifier and Type | Method and Description |
|---|---|
abstract SipApplicationRouter |
getSipApplicationRouter()
Retrieve an instance of the application router created by this provider
|
public abstract SipApplicationRouter getSipApplicationRouter()
Copyright © 2016. All rights reserved.