|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.restlet.Uniform
org.restlet.Restlet
org.restlet.Router
org.restlet.VirtualHost
public class VirtualHost
Router of calls from Server connectors to Restlets. The attached Restlets are
typically Applications.
A virtual host is defined along three properties:
Request.getHostRef()
: the URI of the host that received the request. Note that
the same IP address can correspond to multiple domain names and therefore receive
request with different "hostRef" URIs.Request.getResourceRef()
: the URI of the target resource of the request. If
this reference is relative, then it is based on the "hostRef", otherwise it is
maintained as received. This difference is useful for resources identified by
URNs or for Web proxies or Web caches.Response.getServerInfo()
: the information about the server
connector receiving the requests such as it IP address and port number.Pattern
)
that must match the domain name, port, scheme for references or IP address and
port number for server information. The default values match everything.
Pattern
,
Wikipedia -
Virtual Hosting,
Apache - Virtual
HostingField Summary |
---|
Fields inherited from class org.restlet.Router |
---|
BEST, CUSTOM, FIRST, LAST, NEXT, RANDOM |
Constructor Summary | |
---|---|
VirtualHost()
Constructor. |
|
VirtualHost(Context context)
Constructor. |
|
VirtualHost(Context context,
String hostDomain,
String hostPort,
String hostScheme,
String resourceDomain,
String resourcePort,
String resourceScheme,
String serverAddress,
String serverPort)
Constructor. |
Method Summary | |
---|---|
protected Route |
createRoute(String uriPattern,
Restlet target)
Creates a new route for the given URI pattern and target. |
String |
getHostDomain()
Returns the hostRef host domain to match. |
String |
getHostPort()
Returns the hostRef host port to match. |
String |
getHostScheme()
Returns the hostRef scheme to match. |
static String |
getIpAddress(String domain)
Returns the IP address of a given domain name. |
static String |
getLocalHostAddress()
Returns the local host IP address. |
static String |
getLocalHostName()
Returns the local host name. |
String |
getName()
Returns the display name. |
String |
getResourceDomain()
Returns the resourceRef host domain to match. |
String |
getResourcePort()
Returns the resourceRef host port to match. |
String |
getResourceScheme()
Returns the resourceRef scheme to match. |
String |
getServerAddress()
Returns the listening server address. |
String |
getServerPort()
Returns the listening server port. |
void |
setHostDomain(String hostDomain)
Sets the hostRef host domain to match. |
void |
setHostPort(String hostPort)
Sets the hostRef host port to match. |
void |
setHostScheme(String hostScheme)
Sets the hostRef scheme to match. |
void |
setName(String name)
Sets the display name. |
void |
setResourceDomain(String resourceDomain)
Sets the resourceRef host domain to match. |
void |
setResourcePort(String resourcePort)
Sets the resourceRef host port to match. |
void |
setResourceScheme(String resourceScheme)
Sets the resourceRef scheme to match. |
void |
setServerAddress(String serverAddress)
Sets the listening server address. |
void |
setServerPort(String serverPort)
Sets the listening server port. |
Methods inherited from class org.restlet.Router |
---|
attach, attach, attach, attachDefault, attachDefault, detach, getCustom, getDefaultRoute, getFinderClass, getMaxAttempts, getNext, getRequiredScore, getRetryDelay, getRoutes, getRoutingMode, handle, setDefaultRoute, setFinderClass, setMaxAttempts, setRequiredScore, setRetryDelay, setRoutingMode |
Methods inherited from class org.restlet.Restlet |
---|
getContext, getLogger, init, isStarted, isStopped, setContext, start, stop |
Methods inherited from class org.restlet.Uniform |
---|
delete, delete, get, get, handle, head, head, options, options, post, post, put, put |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public VirtualHost()
public VirtualHost(Context context)
context
- The context.public VirtualHost(Context context, String hostDomain, String hostPort, String hostScheme, String resourceDomain, String resourcePort, String resourceScheme, String serverAddress, String serverPort)
context
- The context.hostDomain
- The hostRef host domain pattern to match.hostPort
- The hostRef host port pattern to match.hostScheme
- The hostRef scheme protocol pattern to match.resourceDomain
- The resourceRef host domain pattern to match.resourcePort
- The resourceRef host port pattern to match.resourceScheme
- The resourceRef scheme protocol pattern to match.serverAddress
- The listening server address pattern to match.serverPort
- The listening server port pattern to match.Method Detail |
---|
public static String getIpAddress(String domain)
domain
- The domain name.
public static String getLocalHostAddress()
public static String getLocalHostName()
protected Route createRoute(String uriPattern, Restlet target)
Router
createRoute
in class Router
uriPattern
- The URI pattern that must match the relative part of the
resource URI.target
- The target Restlet to attach.
public String getHostDomain()
public String getHostPort()
public String getHostScheme()
public String getName()
public String getResourceDomain()
public String getResourcePort()
public String getResourceScheme()
public String getServerAddress()
public String getServerPort()
public void setHostDomain(String hostDomain)
hostDomain
- The hostRef host domain to match.public void setHostPort(String hostPort)
hostPort
- The hostRef host port to match.public void setHostScheme(String hostScheme)
hostScheme
- The hostRef scheme to match.public void setName(String name)
name
- The display name.public void setResourceDomain(String resourceDomain)
resourceDomain
- The resourceRef host domain to match.public void setResourcePort(String resourcePort)
resourcePort
- The resourceRef host port to match.public void setResourceScheme(String resourceScheme)
resourceScheme
- The resourceRef scheme to match.public void setServerAddress(String serverAddress)
serverAddress
- The listening server address.public void setServerPort(String serverPort)
serverPort
- The listening server port.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |