On receiving a request, the SiteContextPipelineServlet
examines each request URL in order to determine which site to associate it with. This process comprises the following steps:
Iterate over an array of
SiteContextRuleFilter
components, or rule filters, which are set on theSiteContextPipelineServlet
propertyruleFilters
.Call each rule filter’s
filter()
method until a site ID is returned for that request.If none of these rule filters returns a site ID, call the rule filter that is set on the
DefaultRuleFilter
property, DefaultSiteRuleFilter.If no rule filter returns a site ID, the
SiteContextPipelineServlet
stops processing and passes on the request to the next servlet in the request pipeline.
Errors
If a site ID is determined, but the SiteContextPipelineServlet
cannot find a site configuration that corresponds to the site ID, it logs a warning, stops processing, and passes on the request to the next servlet in the request pipeline.