tapestry-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r972137 - in /websites/production/tapestry/content: cache/main.pageCache https.html
Date Wed, 11 Nov 2015 21:19:52 GMT
Author: buildbot
Date: Wed Nov 11 21:19:52 2015
New Revision: 972137

Log:
Production update by buildbot for tapestry

Modified:
    websites/production/tapestry/content/cache/main.pageCache
    websites/production/tapestry/content/https.html

Modified: websites/production/tapestry/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.

Modified: websites/production/tapestry/content/https.html
==============================================================================
--- websites/production/tapestry/content/https.html (original)
+++ websites/production/tapestry/content/https.html Wed Nov 11 21:19:52 2015
@@ -125,7 +125,7 @@ public class ProcessOrder
     configuration.add(MetaDataConstants.SECURE_PAGE, "true");
 }
 </pre>
-</div></div><p>With no colon, the meta data applies to the entire application
(including any component libraries used in the application).</p><h2 id="HTTPS-BaseURLSupport">Base
URL Support</h2><p>When Tapestry switches back and forth between secure and unsecure
mode, it must create a full URL (rather than a relative URL) that identifies the protocol,
server host name and perhaps even a port number.</p><p>That can be a stumbling
point, especially the server host name. In a cluster, behind a fire wall, the server host
name available to Tapestry, via the <code>HttpServletRequest.getServerName()</code>
method, is often <em>not</em> the server name the client web browser sees ...
instead it is the name of the internal server behind the firewall. The firewall server has
the correct name from the web browser's point of view.</p><p>Because of this,
Tapestry includes a hook to allow you to override how these default URLs are created: the
BaseURLSource service.</p><p>The default implementatio
 n is based on just the getServerName() method; it's often not the correct choice even for
development.</p><p>Fortunately, it is very easy to override this implementation.
Here's an example of an override that uses the default port numbers that the <a  class="external-link"
href="http://jetty.codehaus.org/jetty/" rel="nofollow">Jetty servlet container</a>
uses for normal HTTP (port 8080) and for secure HTTPS (port 8443):</p><div class="code
panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+</div></div><p>With no colon, the meta data applies to the entire application
(including any component libraries used in the application).</p><h2 id="HTTPS-BaseURLSupport">Base
URL Support</h2><p>When Tapestry switches back and forth between secure and unsecure
mode, it must create a full URL (rather than a relative URL) that identifies the protocol,
server host name and perhaps even a port number.</p><p>That can be a stumbling
point, especially the server host name. In a cluster, behind a fire wall, the server host
name available to Tapestry, via the <code>HttpServletRequest.getServerName()</code>
method, is often <em>not</em> the server name the client web browser sees ...
instead it is the name of the internal server behind the firewall. The firewall server has
the correct name from the web browser's point of view.</p><p>Because of this,
Tapestry includes a hook to allow you to override how these default URLs are created: the
BaseURLSource service.</p><p>The default implementatio
 n is based on just the getServerName() method; it's often not the correct choice even for
development.</p><p>Fortunately, it is very easy to override this implementation.
Here's an example of an override that uses the default port numbers that the <a  class="external-link"
href="http://www.eclipse.org/jetty/" rel="nofollow">Jetty servlet container</a> uses
for normal HTTP (port 8080) and for secure HTTPS (port 8443):</p><div class="code
panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
 <pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">  
 public static void contributeServiceOverride(MappedConfiguration&lt;Class,Object&gt;
configuration)
     {
         BaseURLSource source = new BaseURLSource()
@@ -143,7 +143,7 @@ public class ProcessOrder
         configuration.add(BaseURLSource.class, source);
     }
 </pre>
-</div></div><p>This override is hardcoded to generate URLs for localhost;
as such you might use it for development but certainly not in production.</p><h2
id="HTTPS-DevelopmentMode">Development Mode</h2><p>When working in development
mode, the Secure annotation is ignored. This is controlled by the tapestry.secure-enabled
<a  href="configuration.html">configuration symbol</a>.</p><h2 id="HTTPS-ApplicationServerConfiguration">Application
Server Configuration</h2><p>Setting up HTTPS support varies from application server
to application server.</p><ul><li>Jetty:<ul><li><a  class="external-link"
href="http://docs.codehaus.org/display/JETTY/How+to+configure+SSL" rel="nofollow">Jetty
6</a></li></ul></li><li>Tomcat:<ul><li><a  class="external-link"
href="http://tomcat.apache.org/tomcat-6.0-doc/ssl-howto.html">Version 6.0</a></li><li><a
 class="external-link" href="http://tomcat.apache.org/tomcat-5.5-doc/ssl-howto.html">Version
5.5</a></li></ul></li></ul></div>
+</div></div><p>This override is hardcoded to generate URLs for localhost;
as such you might use it for development but certainly not in production.</p><h2
id="HTTPS-DevelopmentMode">Development Mode</h2><p>When working in development
mode, the Secure annotation is ignored. This is controlled by the tapestry.secure-enabled
<a  href="configuration.html">configuration symbol</a>.</p><h2 id="HTTPS-ApplicationServerConfiguration">Application
Server Configuration</h2><p>Setting up HTTPS support varies from application server
to application server.</p><ul><li>Jetty:<ul><li><a  class="external-link"
href="https://wiki.eclipse.org/Jetty/Howto/Configure_SSL" rel="nofollow">Versions 7, 8
or 9</a></li></ul></li><li>Tomcat:<ul><li><a
 class="external-link" href="http://tomcat.apache.org/tomcat-6.0-doc/ssl-howto.html">Version
6.0</a></li><li><a  class="external-link" href="http://tomcat.apache.org/tomcat-5.5-doc/ssl-howto.html">Version
5.5</a></li></ul></li></ul></div>
       </div>
 
       <div class="clearer"></div>



Mime
View raw message