org.eclipse.jetty.server

Class PushBuilderImpl

java.lang.Object

org.eclipse.jetty.server.PushBuilderImpl

All Implemented Interfaces:

PushBuilder

public class PushBuilderImpl
extends Object
implements PushBuilder

Constructor Summary

Constructors

Constructor and Description
PushBuilderImpl(Request request, HttpFields fields, String method, String queryString, String sessionId, boolean conditional)

Method Summary

Modifier and Type	Method and Description
PushBuilder	addHeader(String name, String value) Add a header to be used for the push.
PushBuilder	conditional(boolean conditional) Set if the request is to be conditional.
PushBuilder	etag(String etag) Set the etag to be used for conditional pushes.
String	getEtag()
String	getHeader(String name)
Set<String>	getHeaderNames()
String	getLastModified()
String	getMethod()
String	getPath()
String	getQueryString()
String	getSessionId()
boolean	isConditional()
PushBuilder	lastModified(String lastModified) Set the last modified date to be used for conditional pushes.
PushBuilder	method(String method) Set the method to be used for the push.
PushBuilder	path(String path) Set the URI path to be used for the push.
void	push() Push a resource.
PushBuilder	queryString(String queryString) Set the query string to be used for the push.
PushBuilder	sessionId(String sessionId) Set the SessionID to be used for the push.
PushBuilder	setHeader(String name, String value) Set a header to be used for the push.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PushBuilderImpl

public PushBuilderImpl(Request request,
                       HttpFields fields,
                       String method,
                       String queryString,
                       String sessionId,
                       boolean conditional)

Method Detail

getMethod

public String getMethod()

Specified by:

getMethod in interface PushBuilder

See Also:

PushBuilder.getMethod()

method

public PushBuilder method(String method)

Description copied from interface: PushBuilder

Set the method to be used for the push. Defaults to GET.

Specified by:

method in interface PushBuilder

Parameters:

method - the method to be used for the push.

Returns:

this builder.

See Also:

PushBuilder.method(java.lang.String)

getQueryString

public String getQueryString()

Specified by:

getQueryString in interface PushBuilder

See Also:

PushBuilder.getQueryString()

queryString

public PushBuilder queryString(String queryString)

Description copied from interface: PushBuilder

Set the query string to be used for the push. Defaults to the requests query string. Will be appended to any query String included in a call to PushBuilder.path(String). This method should be used instead of a query in PushBuilder.path(String) when multiple PushBuilder.push() calls are to be made with the same query string, or to remove a query string obtained from the associated request.

Specified by:

queryString in interface PushBuilder

Parameters:

queryString - the query string to be used for the push.

Returns:

this builder.

See Also:

PushBuilder.queryString(java.lang.String)

getSessionId

public String getSessionId()

Specified by:

getSessionId in interface PushBuilder

See Also:

PushBuilder.getSessionId()

sessionId

public PushBuilder sessionId(String sessionId)

Description copied from interface: PushBuilder

Set the SessionID to be used for the push. The session ID will be set in the same way it was on the associated request (ie as a cookie if the associated request used a cookie, or as a url parameter if the associated request used a url parameter). Defaults to the requested session ID or any newly assigned session id from a newly created session.

Specified by:

sessionId in interface PushBuilder

Parameters:

sessionId - the SessionID to be used for the push.

Returns:

this builder.

See Also:

PushBuilder.sessionId(java.lang.String)

isConditional

public boolean isConditional()

Specified by:

isConditional in interface PushBuilder

See Also:

PushBuilder.isConditional()

conditional

public PushBuilder conditional(boolean conditional)

Description copied from interface: PushBuilder

Set if the request is to be conditional. If the request is conditional, any available values from PushBuilder.etag(String) or PushBuilder.lastModified(String) will be set in the appropriate headers. If the request is not conditional, then etag and lastModified values are ignored. Defaults to true if the associated request was conditional.

Specified by:

conditional in interface PushBuilder

Parameters:

conditional - true if the push request is conditional

Returns:

this builder.

See Also:

PushBuilder.conditional(boolean)

getHeaderNames

public Set<String> getHeaderNames()

Specified by:

getHeaderNames in interface PushBuilder

See Also:

PushBuilder.getHeaderNames()

getHeader

public String getHeader(String name)

Specified by:

getHeader in interface PushBuilder

See Also:

PushBuilder.getHeader(java.lang.String)

setHeader

public PushBuilder setHeader(String name,
                             String value)

Description copied from interface: PushBuilder

Set a header to be used for the push.

Specified by:

setHeader in interface PushBuilder

Parameters:

name - The header name to set

value - The header value to set

Returns:

this builder.

See Also:

PushBuilder.setHeader(java.lang.String, java.lang.String)

addHeader

public PushBuilder addHeader(String name,
                             String value)

Description copied from interface: PushBuilder

Add a header to be used for the push.

Specified by:

addHeader in interface PushBuilder

Parameters:

name - The header name to add

value - The header value to add

Returns:

this builder.

See Also:

PushBuilder.addHeader(java.lang.String, java.lang.String)

getPath

public String getPath()

Specified by:

getPath in interface PushBuilder

See Also:

PushBuilder.getPath()

path

public PushBuilder path(String path)

Description copied from interface: PushBuilder

Set the URI path to be used for the push. The path may start with "/" in which case it is treated as an absolute path, otherwise it is relative to the context path of the associated request. There is no path default and PushBuilder.path(String) must be called before every call to PushBuilder.push()

Specified by:

path in interface PushBuilder

Parameters:

path - the URI path to be used for the push, which may include a query string.

Returns:

this builder.

See Also:

PushBuilder.path(java.lang.String)

getEtag

public String getEtag()

Specified by:

getEtag in interface PushBuilder

See Also:

PushBuilder.getEtag()

etag

public PushBuilder etag(String etag)

Description copied from interface: PushBuilder

Set the etag to be used for conditional pushes. The etag will be used only if PushBuilder.isConditional() is true. Defaults to no etag. The value is nulled after every call to PushBuilder.push()

Specified by:

etag in interface PushBuilder

Parameters:

etag - the etag to be used for the push.

Returns:

this builder.

See Also:

PushBuilder.etag(java.lang.String)

getLastModified

public String getLastModified()

Specified by:

getLastModified in interface PushBuilder

See Also:

PushBuilder.getLastModified()

lastModified

public PushBuilder lastModified(String lastModified)

Description copied from interface: PushBuilder

Set the last modified date to be used for conditional pushes. The last modified date will be used only if PushBuilder.isConditional() is true. Defaults to no date. The value is nulled after every call to PushBuilder.push()

Specified by:

lastModified in interface PushBuilder

Parameters:

lastModified - the last modified date to be used for the push.

Returns:

this builder.

See Also:

PushBuilder.lastModified(java.lang.String)

push

public void push()

Description copied from interface: PushBuilder

Push a resource. Push a resource based on the current state of the PushBuilder. If PushBuilder.isConditional() is true and an etag or lastModified value is provided, then an appropriate conditional header will be generated. If both an etag and lastModified value are provided only an If-None-Match header will be generated. If the builder has a session ID, then the pushed request will include the session ID either as a Cookie or as a URI parameter as appropriate. The builders query string is merged with any passed query string. After initiating the push, the builder has its path, etag and lastModified fields nulled. All other fields are left as is for possible reuse in another push.

Specified by:

push in interface PushBuilder

See Also:

PushBuilder.push()