diff --git a/jetty-spdy/spdy-http-server/src/main/java/org/eclipse/jetty/spdy/server/http/ReferrerPushStrategy.java b/jetty-spdy/spdy-http-server/src/main/java/org/eclipse/jetty/spdy/server/http/ReferrerPushStrategy.java index 21788699fd3..c76bc888c79 100644 --- a/jetty-spdy/spdy-http-server/src/main/java/org/eclipse/jetty/spdy/server/http/ReferrerPushStrategy.java +++ b/jetty-spdy/spdy-http-server/src/main/java/org/eclipse/jetty/spdy/server/http/ReferrerPushStrategy.java @@ -38,21 +38,21 @@ import org.eclipse.jetty.util.log.Log; import org.eclipse.jetty.util.log.Logger; /** - *

A SPDY push strategy that auto-populates push metadata based on referrer URLs.

A typical request for a main - * resource such as index.html is immediately followed by a number of requests for associated resources. - * Associated resource requests will have a Referer HTTP header that points to index.html, which is - * used to link the associated resource to the main resource.

However, also following a hyperlink generates a - * HTTP request with a Referer HTTP header that points to index.html; therefore a proper value for + *

A SPDY push strategy that auto-populates push metadata based on referrer URLs.

A typical request for a main + * resource such as {@code index.html} is immediately followed by a number of requests for associated resources. + * Associated resource requests will have a {@code Referer} HTTP header that points to {@code index.html}, which is + * used to link the associated resource to the main resource.

However, also following a hyperlink generates a + * HTTP request with a {@code Referer} HTTP header that points to {@code index.html}; therefore a proper value for * {@link #setReferrerPushPeriod(int)} has to be set. If the referrerPushPeriod for a main resource has elapsed, - * no more associated resources will be added for that main resource.

This class distinguishes associated main + * no more associated resources will be added for that main resource.

This class distinguishes associated main * resources by their URL path suffix and content type. CSS stylesheets, images and JavaScript files have * recognizable URL path suffixes that are classified as associated resources. The suffix regexs can be configured by * constructor argument

*

When CSS stylesheets refer to images, the CSS image request will have the CSS stylesheet as referrer. This - * implementation will push also the CSS image.

The push metadata built by this implementation is limited by the + * implementation will push also the CSS image.

The push metadata built by this implementation is limited by the * number of pages of the application itself, and by the {@link #setMaxAssociatedResources(int)} max associated resources} * parameter. This parameter limits the number of associated resources per each main resource, so that if a main - * resource has hundreds of associated resources, only up to the number specified by this parameter will be pushed.

+ * resource has hundreds of associated resources, only up to the number specified by this parameter will be pushed. */ public class ReferrerPushStrategy implements PushStrategy {