Save This Page
Home » axis2-1.5-src » org.apache » axis2 » deployment » [javadoc | source]
org.apache.axis2.deployment
public class: WarBasedAxisConfigurator [javadoc | source]
java.lang.Object
   org.apache.axis2.deployment.DeploymentEngine
      org.apache.axis2.deployment.WarBasedAxisConfigurator

All Implemented Interfaces:
    AxisConfigurator, DeploymentConstants

Processes the init parameters for the AxisServlet. This allows the location of the axis2.xml and the module repository to be different from the default locations. The init parameters support alternate file, or URL values for both of these.
Field Summary
public static final  String PARAM_AXIS2_XML_PATH    The name of the init parameter (axis2.xml.path) that can be used to override the default location for the axis2.xml file. When both this init parameter, and the axis2.xml.url init parameters are not specified in the axis servlet init-parameter, the default location of ${app}/WEB-INF/conf/axis2.xml is used. The value of this path is interpreted as a file system absolute path. This parameter takes precedence over the axis2.xml.url init parameter. 
public static final  String PARAM_AXIS2_XML_URL    The name of the init parameter (axis2.xml.url) that when specified indicates the axis2.xml should be loaded using the URL specified as the value of this init parameter. If the axis2.xml.path init parameter is present, this init parameter has no effect. 
public static final  String PARAM_AXIS2_REPOSITORY_PATH    The name of the init parameter (axis2.repository.path) that when specified indicates the path to the 
public static final  String PARAM_AXIS2_REPOSITORY_URL    The name of the init parameter (axis2.repository.url) that when specified indicates the url to be used 
Fields inherited from org.apache.axis2.deployment.DeploymentEngine:
webLocationString,  scheduler,  hotUpdate,  hotDeployment,  wsToDeploy,  wsToUnDeploy,  axisConfig,  configContext,  repoListener,  servicesPath,  servicesDir,  modulesPath,  modulesDir,  serviceDeployer,  moduleDeployer
Constructor:
 public WarBasedAxisConfigurator(ServletConfig servletConfig) throws DeploymentException 
    Default constructor for configurator. This determines the axis2.xml file to be used from the init parameters for the AxisServlet in the web.xml. The order of initialization is according the the following precedence:
    • If the parameter axis2.xml.path is present, the value is webapp relative path to be used as the location to the axis2.xml file.
    • Otherwise, if the parameter axis2.xml.url is present, the URL is used as the location to the axis2.xml file.
    • Otherwise, when both of the above init parameters are not present, file is attempted to be loaded from <repo>/WEB-INF/axis2.xml.
    • When none of the above could be found, the axis2.xml is loaded from the classpath resource, the value of DeploymenConstants.AXIS2_CONFIGURATION_RESOURCE.
    Parameters:
    servletConfig - the ServletConfig object from the AxisServlet. This method is called from the init() of the AxisServlet.
Method from org.apache.axis2.deployment.WarBasedAxisConfigurator Summary:
engageGlobalModules,   getAxisConfiguration,   loadServices,   setConfigContext
Methods from org.apache.axis2.deployment.DeploymentEngine:
addNewModule,   addServiceGroup,   addWSToDeploy,   addWSToUndeploy,   buildModule,   buildService,   buildServiceGroup,   cleanup,   doDeploy,   engageModules,   fillServiceGroup,   getAxisConfig,   getAxisServiceName,   getDeployer,   getDeployerForExtension,   getDeployers,   getFileList,   getModule,   getModuleDeployer,   getModulesDir,   getRepoListener,   getRepositoryDir,   getRepositoryPath,   getServiceDeployer,   getServicesDir,   getWebLocationString,   isHotUpdate,   loadDefaultMessageReceiver,   loadFromClassPath,   loadRepository,   loadRepositoryFromURL,   loadServiceGroup,   loadServices,   loadServicesFromUrl,   populateAxisConfiguration,   populateService,   prepareRepository,   setClassLoaders,   setConfigContext,   setDeployers,   setDeploymentFeatures,   setExtensionToDeployerMappingMap,   setWebLocationString,   startSearch,   unDeploy
Methods from java.lang.Object:
equals,   getClass,   hashCode,   notify,   notifyAll,   toString,   wait,   wait,   wait
Method from org.apache.axis2.deployment.WarBasedAxisConfigurator Detail:
 public  void engageGlobalModules() throws AxisFault 
 public AxisConfiguration getAxisConfiguration() throws AxisFault 
    Gets the axis configuration object by loading the repository. The order of initialization is according the the following precedence:
    • If the parameter axis2.repository.path is present, this folder is used as the location to the repository.
    • Otherwise, if the parameter axis2.repository.url is present, the URL is used as the location to the repository.
    • Otherwise, when both of the above init parameters are not present, the web applications WEB-INF folder is used as the folder for the repository.
 public  void loadServices() 
    Loads the services within the repository. When the axis2.repository.path init parameter was present, we just call loadServices() in the deployment engine.
    When the axis2.repository.url init parameter was present we load services from the respective URL value of the init parameter.
    Otherwise, try to load the services from the /WEB-INF folder within the web application.
 public  void setConfigContext(ConfigurationContext configContext)