Examples of BaseURLSource

• org.apache.tapestry.services.BaseURLSource
  Used when switching between normal/insecure (HTTP) and secure (HTTPS) mode. When a switch occurs, it is no longer possible to use relative URLs, instead absolute URLs must be generated. The default implementation of this is simple-minded: it just tacks the correct scheme in front of {@link org.apache.tapestry.services.Request#getServerName()}. In production, behind a firewall, it is often necessary to do a bit more, since getServerName() will often be the name of the internal server (not visible to the client web browser), and a hard-coded name of a server that is visible to the web browser is needed. Further, in testing, non-default ports are often used. In those cases, an overriding contribution to the {@link org.apache.tapestry.services.Alias} service will allow a customimplementation to supercede the default version.
• org.apache.tapestry5.services.BaseURLSource
  Used when switching between normal/insecure (HTTP) and secure (HTTPS) mode. When a switch occurs, it is no longer possible to use just paths, instead absolute URLs (including the scheme, hostname and possibly port) must be generated. The default implementation of this is simple-minded: it just tacks the correct scheme in front of {@link org.apache.tapestry5.services.Request#getServerName()}. In production, behind a firewall, it is often necessary to do a bit more, since getServerName() will often be the name of the internal server (not visible to the client web browser), and a hard-coded name of a server that is visible to the web browser is needed. Further, in testing, non-default ports are often used. In those cases, an overriding contribution to the {@link ServiceOverride} service will allow a custom implementation to supercede the default version. You may alsocontribute application specific values for the following {@link org.apache.tapestry5.SymbolConstants}: {@link org.apache.tapestry5.SymbolConstants#HOSTNAME}, {@link org.apache.tapestry5.SymbolConstants#HOSTPORT} and {@link org.apache.tapestry5.SymbolConstants#HOSTPORT_SECURE} to alter the behavior of the default BaseURLSource implementation. The default values for the SymbolConstants require {@link org.apache.tapestry5.services.Request} context to be available. If you contribute specific values for the specified SymbolConstants, it's safe to use the default implementation of this service outside of request context, for example in a batch job. For {@link org.apache.tapestry5.SymbolConstants#HOSTNAME}, a value starting with a dollar sign ($) will be resolved using {@link java.lang.System#getenv()} - contributing "$HOSTNAME" for {@link org.apache.tapestry5.SymbolConstants#HOSTNAME}is the most sensible choice for a dynamic value that doesn't use {@link org.apache.tapestry5.services.Request#getServerName()}.

Examples of org.apache.tapestry5.services.BaseURLSource