|
||||||||||
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 |