Page Speed Optimization Libraries  1.8.31.3
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines
Public Member Functions | Static Public Member Functions | Static Public Attributes | Protected Member Functions
net_instaweb::CommonFilter Class Reference

#include "common_filter.h"

Inheritance diagram for net_instaweb::CommonFilter:
net_instaweb::AddInstrumentationFilter net_instaweb::CriticalCssFilter net_instaweb::CriticalImagesBeaconFilter net_instaweb::CssInlineFilter net_instaweb::CssMoveToHeadFilter net_instaweb::CssOutlineFilter net_instaweb::DedupInlinedImagesFilter net_instaweb::DeferIframeFilter net_instaweb::DelayImagesFilter net_instaweb::DomainRewriteFilter net_instaweb::DomStatsFilter net_instaweb::FlushHtmlFilter net_instaweb::InsertDnsPrefetchFilter net_instaweb::InsertGAFilter net_instaweb::JsDeferDisabledFilter net_instaweb::JsDisableFilter net_instaweb::JsInlineFilter net_instaweb::JsOutlineFilter net_instaweb::LazyloadImagesFilter net_instaweb::MetaTagFilter net_instaweb::RedirectOnSizeLimitFilter net_instaweb::RewriteFilter net_instaweb::SplitHtmlBeaconFilter net_instaweb::SplitHtmlHelperFilter net_instaweb::UrlLeftTrimFilter

List of all members.

Public Member Functions

 CommonFilter (RewriteDriver *driver)
const GoogleUrl & base_url () const
 Getters.
const GoogleUrl & decoded_base_url () const
RewriteDriverdriver () const
HtmlElement * noscript_element () const
void InsertNodeAtBodyEnd (HtmlNode *data)
virtual void StartDocument ()
 Note: Don't overload these methods, overload the implementers instead!
virtual void StartElement (HtmlElement *element)
virtual void EndElement (HtmlElement *element)
virtual void Characters (HtmlCharactersNode *characters)
ResourcePtr CreateInputResource (const StringPiece &input_url)
void ResolveUrl (StringPiece input_url, GoogleUrl *out_url)
bool BaseUrlIsValid () const
bool DebugMode () const
bool CanAddPagespeedOnloadToImage (const HtmlElement &)
virtual void LogFilterModifiedContent ()
virtual
RewriteDriver::InlineAuthorizationPolicy 
AllowUnauthorizedDomain () const
virtual bool IntendedForInlining () const

Static Public Member Functions

static bool ExtractMetaTagDetails (const HtmlElement &element, const ResponseHeaders *headers, GoogleString *content, GoogleString *mime_type, GoogleString *charset)

Static Public Attributes

static const char kCreateResourceFailedDebugMsg []
 Debug message to be inserted when resource creation fails.

Protected Member Functions

ServerContextserver_context () const
const RewriteOptionsrewrite_options ()
virtual void StartDocumentImpl ()=0
virtual void StartElementImpl (HtmlElement *element)=0
virtual void EndElementImpl (HtmlElement *element)=0
virtual const char * LoggingId ()

Detailed Description

CommonFilter encapsulates useful functionality that many filters will want. All filters who want this functionality should inherit from CommonFilter and define the Helper methods rather than the main methods.

Currently, it stores whether we are in a <noscript> element (in which case, we should be careful about moving things out of this element).

The base-tag is maintained in the RewriteDriver, although it can be accessed via a convenience method here for historical reasons.


Member Function Documentation

Returns true if this filter allows domains not authorized by any pagespeed directive to be optimized. Filters that end up inlining content onto the HTML are almost the only ones that can safely do this.

Reimplemented in net_instaweb::CriticalCssBeaconFilter, net_instaweb::CriticalSelectorFilter, net_instaweb::CssInlineFilter, and net_instaweb::JsInlineFilter.

const GoogleUrl& net_instaweb::CommonFilter::base_url ( ) const

Getters.

URL of the requested HTML or resource.

Returns whether or not the base url is valid. This value will change as a filter processes the document. E.g. If there are url refs before the base tag is reached, it will return false until the filter sees the base tag. After the filter sees the base tag, it will return true.

Returns true if the image element is not in a <noscript> block and it has a) no onload attribute or b) an onload attribute exists with the value being equal to the CriticalImagesBeaconFilter::kImageOnloadCode.

virtual void net_instaweb::CommonFilter::Characters ( HtmlCharactersNode *  characters) [virtual]
ResourcePtr net_instaweb::CommonFilter::CreateInputResource ( const StringPiece &  input_url)

Creates an input resource with the url evaluated based on input_url which may need to be absolutified relative to base_url(). Returns NULL if the input resource url isn't valid, or can't legally be rewritten in the context of this page.

bool net_instaweb::CommonFilter::DebugMode ( ) const [inline]

Returns whether the current options specify the "debug" filter. If set, then other filters can annotate output HTML with HTML comments indicating why they did or did not do an optimization, using HtmlParse::InsertComment.

For rewritten resources, decoded_base_url() is the base of the original (un-rewritten) resource's URL.

static bool net_instaweb::CommonFilter::ExtractMetaTagDetails ( const HtmlElement &  element,
const ResponseHeaders *  headers,
GoogleString *  content,
GoogleString *  mime_type,
GoogleString *  charset 
) [static]

Utility function to extract the mime type and/or charset from a meta tag, either the HTML4 http-equiv form or the HTML5 charset form: element is the meta tag element to process. headers is optional: if provided it is checked to see if it already has a content type with the tag's value; if so, returns false. content is set to the content attribute's value, http-equiv form only. mime_type is set to the extracted mime type, if any. charset is the set to the extracted charset, if any. returns true if the details were extracted, false if not. If true is returned then content will be empty for the HTML5 charset form and non-empty for the HTML4 http-equiv form; also an http-equiv attribute with a blank mime type returns false as it's not a valid format.

Insert a node at the best available location in or near the closing body tag during EndDocument. This is useful for filters that want to insert scripts or summary data at the end of body, but need to wait until EndDocument to do so.

Tries to inject just before </body> if nothing else intervenes; otherwise tries to inject before </html> or, failing that, at the end of all content. This latter case still works in browsers, but breaks HTML validation (and is incredibly ugly). It can be necessitated by other post-</html> content, or by flushes in the body.

Note that if a subclass overloads the Characters function, it needs to call the parent implementation for this function to be correct.

virtual bool net_instaweb::CommonFilter::IntendedForInlining ( ) const [inline, virtual]

Returns true if the filter intends to inline the resource it fetches. This is to support AllowWhenInlining. Unlike AllowUnauthorizedDomain() this doesn't have security implications and is just used for performance tuning.

Reimplemented in net_instaweb::CriticalCssBeaconFilter, net_instaweb::CriticalSelectorFilter, net_instaweb::CssInlineFilter, and net_instaweb::JsInlineFilter.

Add this filter to the logged list of applied rewriters. The intended semantics of this are that it should only include filters that modified the content of the response to the request being processed. This class logs using Name(); subclasses may do otherwise.

virtual const char* net_instaweb::CommonFilter::LoggingId ( ) [inline, protected, virtual]

ID string used in logging. Inheritors should supply whatever short ID string they use.

Reimplemented in net_instaweb::RewriteFilter.

void net_instaweb::CommonFilter::ResolveUrl ( StringPiece  input_url,
GoogleUrl *  out_url 
)

Resolves input_url based on the driver's location and any base tag into out_url. If resolution fails, the resulting URL may be invalid.

virtual void net_instaweb::CommonFilter::StartDocumentImpl ( ) [protected, pure virtual]

The documentation for this class was generated from the following file:
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines