Site Identification

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:

  1. Iterate over an array of SiteContextRuleFilter components, or rule filters, which are set on the SiteContextPipelineServlet property ruleFilters.

  2. Call each rule filter’s filter() method until a site ID is returned for that request.

  3. If none of these rule filters returns a site ID, call the rule filter that is set on the DefaultRuleFilter property, DefaultSiteRuleFilter.

  4. 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.