Class WEnvironment

Direct Known Subclasses:

public class WEnvironment extends Object
A class that captures information on the application environment.

The environment provides information on the client, and gives access to startup arguments.

Usage example:

 WEnvironment env = WApplication.instance().environment();

 // read an application startup argument
 // (passed as argument in the URL or POST'ed to the application).
 if (!env.getParameterValues("login").isEmpty()) {
 String login = env.getParameterValues("login").get(0);

 // Check for JavaScript/AJAX availability before using JavaScript-only
 // widgets
 WTextArea textEdit;
 if (!env.isAjax())
 textEdit = new WTextEdit(); // provide an HTML text editor
 textEdit = new WTextArea(); // fall-back to a plain old text area.

  • Field Details

    • timeZoneName_

      protected String timeZoneName_
    • redirectSecret_

      protected String redirectSecret_
  • Method Details

    • getJavaScriptWtScope

      public static String getJavaScriptWtScope()
      Wt's JavaScript scope.
    • getParameterMap

      public Map<String,String[]> getParameterMap()
      Parameters passed to the application.

      Arguments passed to the application, either in the URL for a http GET, or in both the URL and data submitted in a http POST.

      See Also:
    • getParameterValues

      public String[] getParameterValues(String name)
      Returns values for a query parameter.

      Returns an empty list if the parameter was not defined.

      One or more values may be associated with a single argument.

      For example a JWt application foo.wt started as http://.../foo.wt?hello=Hello&hello=World will result in both values "Hello" and "World" to be associated with the argument "hello".

      See Also:
    • getParameter

      public String getParameter(String name)
      Returns a single value for a query parameter.

      Returns the first value for a parameter, or null if the parameter is not found.

      See Also:
    • getCookies

      public Map<String,String> getCookies()
      Returns the cookies from the environment.

      This returns all cookies that were present in initial request for the application. Cookies set with WApplication#setCookie() are not taken into consideration.

      Cookies allow you to persist information across sessions, but note that not all clients may support cookies or may some clients may be configured to block cookies.

      See Also:
    • getCookie

      public String getCookie(String cookieName)
      Returns a cookie value.

      Returns 0 if no value was set for the given cookie.

      See Also:
    • getHeaderValue

      public String getHeaderValue(String name)
      Returns a header value.

      Returns a header value, or an empty string if the header was present.

    • supportsCookies

      public boolean supportsCookies()
      Returns whether the browser has enabled support for cookies.

      When the user disables cookies during the visit of the page, this value is not updated.

      See Also:
    • hasJavaScript

      public boolean hasJavaScript()
      Returns whether the browser has enabled support for JavaScript.

      This is the same as hasAjax(): JWt only considers using JavaScript when it has detected AJAX support.

      See Also:
    • hasAjax

      public boolean hasAjax()
      Returns whether the browser has enabled support for AJAX.

      Without support for JavaScript/AJAX, JWt will still be able to serve the application, but with one considerable limitation: only the WTimer.timeout(), WInteractWidget.clicked(), WApplication.internalPathChanged(), and WAbstractArea.clicked() signals (and any derived signals) will generate events.

      Every event will cause the complete page to be rerendered.

      See Also:
    • hasWebGL

      public boolean hasWebGL()
      Returns whether the browser has support for WebGL.

      Support for WebGL is required for client-side rendering of WGLWidget.

    • getScreenWidth

      public int getScreenWidth()
      Returns the horizontal resolution of the client's screen.

      Returns -1 if screen width is not known.

      See Also:
    • getScreenHeight

      public int getScreenHeight()
      Returns the vertical resolution of the client's screen.

      Returns -1 if screen height is not known.

      See Also:
    • getDpiScale

      public double getDpiScale()
      Returns the browser-side DPI scaling factor.

      Internet Explorer scales all graphics, fonts and other elements on high-density screens to make them readable. This is controlled by the DPI setting of the display. If all goes well, you do not have to worry about this scaling factor. Unfortunately, not all elements are scaled appropriately. The scaling factor is supposed to be used only internally in JWt and is in this interface for informational purposes.

      See Also:
    • getLocale

      public Locale getLocale()
      Returns the preferred language indicated in the request header.

      The language is parsed from the HTTP Accept-Language field, if present. If not, the locale is empty.

      If multiple languages are present, the one with the highest "q"uality is assumed, and if a tie is present, the first one is taken.

      See Also:
    • getTimeZoneOffset

      public Duration getTimeZoneOffset()
      Returns the time zone offset as reported by the client.

      This returns the time offset that the client has relative to UTC. A positive value thus means that the local time is ahead of UTC.

      This requires JavaScript support.

    • getTimeZoneName

      public String getTimeZoneName()
      Returns the time zone name as reported by the client.

      Note: This requires JavaScript support and is only supported by browsers that implement the JavaScript Internationalization API. No version of Internet Explorer supports this, but modern browsers do. If not supported, this will return the empty string.

    • getHostName

      public String getHostName()
      Returns the server host name that is used by the client.

      The hostname is the unresolved host name with optional port number, which the browser used to connect to the application.


      • localhost:8080

      For HTTP 1.1 requests, this information is fetched from the HTTP Host header. If JWt is configured behind a reverse proxy, then the last entry in the HTTP X-Forwarded-Host header field is used instead (to infer the name of the reverse proxy instead).

      For HTTP 1.0 requests, the HTTP Host header is not required. When not present, the server host name is inferred from the configured server name, which defaults to the DNS name.

    • getUrlScheme

      public String getUrlScheme()
      Returns the URL scheme used for the current request ("http" or "https").
    • getUserAgent

      public String getUserAgent()
      Returns the user agent.

      The user agent, as reported in the HTTP User-Agent field.

      See Also:
    • getReferer

      public String getReferer()
      Returns the referer.

      The referer, as reported in the HTTP Referer field.

    • getAccept

      public String getAccept()
      Returns the accept header.

      The accept header, as reported in the HTTP Accept field.

    • agentIsSpiderBot

      public boolean agentIsSpiderBot()
      Returns if the user agent is a (known) indexing spider bot.

      Note: currently the list of know bots is quite small. This method is used internally to render the web application for optimal indexing by bots:

      • there is no detection for JavaScript, instead the application is directly served assuming no JavaScript support.
      • session information is omitted from the Urls.
      • no sessions are created (they are immediately stopped after the request has been handled).
      • auto-generated id and name attributes are omitted from DOM nodes. In this way, the generated page is always exactly the same.
    • getServerSignature

      public String getServerSignature()
      Returns the web server signature.

      The value of the CGI variable SERVER_SIGNATURE.

      Example: <address>Apache Server at localhost Port 80</address>.

    • getServerSoftware

      public String getServerSoftware()
      Returns the web server software.

      The value of the CGI variable SERVER_SOFTWARE.

      Example: "Apache"

    • getServerAdmin

      public String getServerAdmin()
      Returns the email address of the server admin.

      The value of the CGI variable SERVER_ADMIN.

      Example: "root@localhost"

    • getClientAddress

      public String getClientAddress()
      Returns the IP address of the client.

      The (most likely) IP address of the client that is connected to this session.

      This is taken to be the first public address that is given in the Client-IP header, or in the X-Forwarded-For header (in case the client is behind a proxy). If none of these headers is present, the remote socket IP address is used.

    • getInternalPath

      public String getInternalPath()
      Returns the initial internal path.

      This is the internal path with which the application was started.

      For an application deployed at "/stuff/app.wt", the following URL indicates an internal path "/this/there":


      See Also:
    • getDeploymentPath

      public String getDeploymentPath()
      Returns the deployment path.

      This is the path at which the application is deployed.

      See Also:
    • getLibraryVersion

      public static String getLibraryVersion()
      Returns the version of the JWt library.

      Example: "1.99.2"

    • getCgiValue

      public String getCgiValue(String varName)
      Returns a raw CGI environment variable.

      Retrieves the value for the given CGI environment variable (like "SSL_CLIENT_S_DN_CN"), if it is defined, otherwise an empty string.

      See Also:
    • getContentType

      public HtmlContentType getContentType()
      The type of the content provided to the browser.

      This is here for backwards compatibility, but the implementation now alwasy returns HTML5.

    • getAgent

      public UserAgent getAgent()
      Returns the user agent type.

      This returns an interpretation of the getUserAgent(). It should be used only for user-agent specific work-arounds (as a last resort).

      See Also:
    • agentIsIE

      public boolean agentIsIE()
      Returns whether the user agent is Microsoft Internet Explorer.

      See Also:
    • agentIsIElt

      public boolean agentIsIElt(int version)
      Returns whether the user agent is an older version of IE.

      Returns whether the agent is an IE version older than the given version.

      See Also:
    • agentIsIEMobile

      public boolean agentIsIEMobile()
      Returns whether the user agent is Internet Explorer Mobile.

      Returns also true when the agent is Internet Explorer 5 or older.

      See Also:
    • agentIsOpera

      public boolean agentIsOpera()
      Returns whether the user agent is Opera.

      See Also:
    • agentIsWebKit

      public boolean agentIsWebKit()
      Returns whether the user agent is WebKit-based.

      Webkit-based browsers include Safari, Chrome, Arora and Konquerer browsers.

      See Also:
    • agentIsMobileWebKit

      public boolean agentIsMobileWebKit()
      Returns whether the user agent is Mobile WebKit-based.

      Mobile Webkit-based browsers include the Android Mobile WebKit and the iPhone Mobile WebKit browsers.

      See Also:
    • agentIsSafari

      public boolean agentIsSafari()
      Returns whether the user agent is Safari.

      See Also:
    • agentIsChrome

      public boolean agentIsChrome()
      Returns whether the user agent is Chrome.

      See Also:
    • agentIsGecko

      public boolean agentIsGecko()
      Returns whether the user agent is Gecko-based.

      Gecko-based browsers include Firefox.

      See Also:
    • getServer

      public WtServlet getServer()
      Returns the servlet.

      This returns the servlet environment of this session.

    • isInternalPathUsingFragments

      public boolean isInternalPathUsingFragments()
      Returns whether internal paths are implemented using URI fragments.

      This may be the case for older non-HTML5 browsers which do not support HTML5 History APIs.

    • supportsCss3Animations

      public boolean supportsCss3Animations()
      Returns whether this agent supports CSS3 animations.
    • isTest

      public boolean isTest()
      Returns whether this is a mocked test environment.