/*
    * $Id$
    *
    * Licensed to the Apache Software Foundation (ASF) under one
    * or more contributor license agreements.  See the NOTICE file
    * distributed with this work for additional information
    * regarding copyright ownership.  The ASF licenses this file
    * to you under the Apache License, Version 2.0 (the
    * "License"); you may not use this file except in compliance
   * with the License.  You may obtain a copy of the License at
   *
   *  http://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing,
   * software distributed under the License is distributed on an
   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
   * KIND, either express or implied.  See the License for the
   * specific language governing permissions and limitations
   * under the License.
   */
  package org.apache.struts.chain.contexts;
  
  import java.util.Map;
  
  import org.apache.commons.chain.web.jakarta.WebContext;
  import org.apache.struts.Globals;
  import org.apache.struts.config.ModuleConfig;
  
  /**
   * Provide a Subclass of ActionContextBase which is understood to be wrapping
   * an instance of {@link WebContext}.
   */
  public class WebActionContext extends ActionContextBase {
  
      /**
       * Instantiate this composite by wrapping an instance of WebContext.
       *
       * @param context The WebContext to wrap
       */
      public WebActionContext(WebContext context) {
          super(context);
      }
  
      /**
       * Provide the wrapped WebContext for this composite.
       *
       * @return The wrapped WebContext
       */
      protected WebContext webContext() {
          return (WebContext) this.getBaseContext();
      }
  
      public void release() {
          super.release();
      }
  
      // -------------------------------
      // WebContext property wrappers
      // -------------------------------
  
      /**
       * Return an immutable Map that maps header names to the first (or only)
       * header value (as a String).
       *
       * @return A immutable Map of web request header names
       */
      public Map<String, String> getHeader() {
          return webContext().getHeader();
      }
  
      /**
       * Return an immutable Map that maps header names to the set of all values
       * specified in the request (as a String array). Header names must be
       * matched in a case-insensitive manner.
       *
       * @return An immutable Map of web request header values
       */
      public Map<String, String[]> getHeaderValues() {
          return webContext().getHeaderValues();
      }
  
      /**
       * Return an immutable Map that maps context application initialization
       * parameters to their values.
       *
       * @return An immutable Map of web context initialization parameters
       */
      public Map<String, String> getInitParam() {
          return webContext().getInitParam();
      }
  
      /**
       * Return a map whose keys are {@code String} request parameter names and
       * whose values are {@code String} values.
       *
       * <p>For parameters which were submitted with more than one value, only
       * one value will be returned, as if one called
       * {@code ServletRequest.getParameter(String)}.</p>
       *
      * @return A map of web request parameters
      */
     public Map<String, String> getParam() {
         return webContext().getParam();
     }
 
     /**
      * Return a map whose keys are {@code String} request parameter names and
      * whose values are {@code String[]} values.
      *
      * @return A map of web request parameter values (as an array)
      */
     public Map<String, String[]> getParamValues() {
         return webContext().getParamValues();
     }
 
     public Map<String, Object> getApplicationScope() {
         return webContext().getApplicationScope();
     }
 
     public Map<String, Object> getRequestScope() {
         return webContext().getRequestScope();
     }
 
     public Map<String, String[]> getParameterMap() {
         return getParamValues();
     }
 
     public Map<String, Object> getSessionScope() {
         return webContext().getSessionScope();
     }
 
     // ISSUE: AbstractSelectModule set the precedent of doing this at the
     // "web context" level instead of the ServletWebContext level.
     // Consider whether that's how we want to do it universally for other
     // manipulations of the RequestScope or not...
     public void setModuleConfig(ModuleConfig moduleConfig) {
         super.setModuleConfig(moduleConfig);
         this.getRequestScope().put(Globals.MODULE_KEY, moduleConfig);
     }
 
     /**
      * @see org.apache.struts.chain.contexts.ActionContext#getModuleConfig()
      */
     public ModuleConfig getModuleConfig() {
         ModuleConfig mc = super.getModuleConfig();
 
         if (mc == null) {
             mc = (ModuleConfig) this.getRequestScope().get(Globals.MODULE_KEY);
         }
 
         return mc;
     }
 
     // ISSUE:  AbstractSelectModule set the precedent of doing this at the
     // "web context" level instead of the ServletWebContext level.  Consider
     // whether that's how we want to do it universally for other manipulations
     // of the RequestScope or not...
     public void setCancelled(Boolean cancelled) {
         super.setCancelled(cancelled);
 
         // historic semantics of "isCancelled" are to consider any non-null
         // value in the request under Globals.CANCEL_KEY as "yes, this was
         // cancelled."
         if ((cancelled != null) && cancelled.booleanValue()) {
             this.getRequestScope().put(Globals.CANCEL_KEY, cancelled);
         } else {
             this.getRequestScope().remove(Globals.CANCEL_KEY);
         }
     }
 
     public Boolean getCancelled() {
         Boolean cancelled = super.getCancelled();
 
         if (cancelled == null) {
             cancelled =
                 (Boolean) this.getRequestScope().get(Globals.CANCEL_KEY);
         }
 
         return cancelled;
     }
 }