modules/core/description/svc_grp.c

/*
 * Copyright 2004,2005 The Apache Software Foundation.
 *
 * Licensed 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.
 */

#include <axis2_svc_grp.h>
#include <axis2_conf_ctx.h>

/**
 * @brief Service group struct impl
 * Axis2 Service group impl
 */
typedef struct axis2_svc_grp_impl
{
    /** base service group with operations */
    axis2_svc_grp_t svc_grp;
    /** service group name */
    axis2_char_t *svc_grp_name;
    /** map of services */
    axis2_hash_t *svcs;
    /** to store service group modules QNames */
    axis2_array_list_t *module_qnames;
    /** to store module ref at deploy time parsing */
    axis2_conf_t *parent;
    /** list of module references */
    axis2_array_list_t *module_list;
}
axis2_svc_grp_impl_t;

#define AXIS2_INTF_TO_IMPL(svc_grp) ((axis2_svc_grp_impl_t *)svc_grp)

axis2_status_t AXIS2_CALL
axis2_svc_grp_free(
    axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env);

axis2_status_t AXIS2_CALL
axis2_svc_grp_set_name(
    axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    const axis2_char_t *name);

const axis2_char_t *AXIS2_CALL
axis2_svc_grp_get_name(
    const axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env);

axis2_status_t AXIS2_CALL
axis2_svc_grp_add_svc(
    axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    axis2_svc_t *svc);

axis2_svc_t *AXIS2_CALL
axis2_svc_grp_get_svc(
    const axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    const axis2_qname_t *svc_name);

axis2_hash_t *AXIS2_CALL
axis2_svc_grp_get_all_svcs(
    const axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env);

axis2_status_t AXIS2_CALL
axis2_svc_grp_remove_svc(
    axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    const axis2_qname_t *svc_name);

axis2_status_t AXIS2_CALL
axis2_svc_grp_add_param(
    axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    axis2_param_t *param);

axis2_param_t *AXIS2_CALL
axis2_svc_grp_get_param(
    const axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    const axis2_char_t *name);

axis2_array_list_t *AXIS2_CALL
axis2_svc_grp_get_all_params(
    const axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env);

axis2_bool_t AXIS2_CALL
axis2_svc_grp_is_param_locked(
    axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    const axis2_char_t *param_name);

axis2_status_t AXIS2_CALL
axis2_svc_grp_add_module_qname(
    axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    const axis2_qname_t *module_qname);

axis2_conf_t *AXIS2_CALL
axis2_svc_grp_get_parent(
    const axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env);

axis2_status_t AXIS2_CALL
axis2_svc_grp_set_parent(
    axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    axis2_conf_t *parent);

axis2_status_t AXIS2_CALL
axis2_svc_grp_engage_module(
    axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    const axis2_qname_t *module_name);

axis2_array_list_t *AXIS2_CALL
axis2_svc_grp_get_all_module_qnames(
    const axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env);

axis2_status_t AXIS2_CALL
axis2_svc_grp_add_module_ref(
    axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    const axis2_qname_t *moduleref);

axis2_array_list_t *AXIS2_CALL
axis2_svc_grp_get_all_module_refs(
    const axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env);

axis2_svc_grp_ctx_t *AXIS2_CALL
axis2_svc_grp_get_svc_grp_ctx(
    const axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    axis2_conf_ctx_t *parent);

AXIS2_EXTERN axis2_svc_grp_t *AXIS2_CALL
axis2_svc_grp_create(
    const axis2_env_t *env)
{
    axis2_svc_grp_impl_t *svc_grp_impl = NULL;
    AXIS2_ENV_CHECK(env, NULL);
    svc_grp_impl = (axis2_svc_grp_impl_t *)
            AXIS2_MALLOC(env->allocator, sizeof(axis2_svc_grp_impl_t));

    if (NULL == svc_grp_impl)
    {
        AXIS2_ERROR_SET(env->error, AXIS2_ERROR_NO_MEMORY, AXIS2_FAILURE);
        return NULL;
    }

    svc_grp_impl->svc_grp.param_container = NULL;
    svc_grp_impl->module_qnames = NULL;
    svc_grp_impl->svcs = NULL;
    svc_grp_impl->svc_grp.ops = NULL;
    svc_grp_impl->parent = NULL;
    svc_grp_impl->svc_grp_name = NULL;
    svc_grp_impl->module_list = NULL;

    svc_grp_impl->svc_grp.param_container =  axis2_param_container_create(env);
    if (NULL == svc_grp_impl->svc_grp.param_container)
    {
        axis2_svc_grp_free(&(svc_grp_impl->svc_grp), env);
        AXIS2_ERROR_SET(env->error, AXIS2_ERROR_NO_MEMORY, AXIS2_FAILURE);
        return NULL;
    }

    svc_grp_impl->module_qnames = axis2_array_list_create(env, 20);
    if (NULL == svc_grp_impl->module_qnames)
    {
        axis2_svc_grp_free(&(svc_grp_impl->svc_grp), env);
        AXIS2_ERROR_SET(env->error, AXIS2_ERROR_NO_MEMORY, AXIS2_FAILURE);
        return NULL;
    }

    svc_grp_impl->module_list = axis2_array_list_create(env, 0);
    if (NULL == svc_grp_impl->module_list)
    {
        axis2_svc_grp_free(&(svc_grp_impl->svc_grp), env);
        AXIS2_ERROR_SET(env->error, AXIS2_ERROR_NO_MEMORY, AXIS2_FAILURE);
        return NULL;
    }

    svc_grp_impl->svcs = axis2_hash_make(env);
    if (NULL == svc_grp_impl->svcs)
    {
        axis2_svc_grp_free(&(svc_grp_impl->svc_grp), env);
        AXIS2_ERROR_SET(env->error, AXIS2_ERROR_NO_MEMORY, AXIS2_FAILURE);
        return NULL;
    }

    svc_grp_impl->svc_grp.ops = AXIS2_MALLOC(env->allocator,
            sizeof(axis2_svc_grp_ops_t));
    if (NULL == svc_grp_impl->svc_grp.ops)
    {
        AXIS2_FREE(env->allocator, svc_grp_impl);
        AXIS2_ERROR_SET(env->error, AXIS2_ERROR_NO_MEMORY, AXIS2_FAILURE);
        return NULL;
    }

    svc_grp_impl->svc_grp.ops->free = axis2_svc_grp_free;
    svc_grp_impl->svc_grp.ops->set_name = axis2_svc_grp_set_name;
    svc_grp_impl->svc_grp.ops->get_name = axis2_svc_grp_get_name;
    svc_grp_impl->svc_grp.ops->add_svc = axis2_svc_grp_add_svc;
    svc_grp_impl->svc_grp.ops->get_svc = axis2_svc_grp_get_svc;
    svc_grp_impl->svc_grp.ops->get_all_svcs = axis2_svc_grp_get_all_svcs;
    svc_grp_impl->svc_grp.ops->remove_svc = axis2_svc_grp_remove_svc;
    svc_grp_impl->svc_grp.ops->add_param = axis2_svc_grp_add_param;
    svc_grp_impl->svc_grp.ops->get_param = axis2_svc_grp_get_param;
    svc_grp_impl->svc_grp.ops->get_all_params = axis2_svc_grp_get_all_params;
    svc_grp_impl->svc_grp.ops->is_param_locked = axis2_svc_grp_is_param_locked;
    svc_grp_impl->svc_grp.ops->add_module_qname = axis2_svc_grp_add_module_qname;
    svc_grp_impl->svc_grp.ops->get_parent = axis2_svc_grp_get_parent;
    svc_grp_impl->svc_grp.ops->set_parent = axis2_svc_grp_set_parent;
    svc_grp_impl->svc_grp.ops->engage_module = axis2_svc_grp_engage_module;
    svc_grp_impl->svc_grp.ops->get_all_module_qnames = axis2_svc_grp_get_all_module_qnames;
    svc_grp_impl->svc_grp.ops->add_module_ref = axis2_svc_grp_add_module_ref;
    svc_grp_impl->svc_grp.ops->get_all_module_refs = axis2_svc_grp_get_all_module_refs;
    svc_grp_impl->svc_grp.ops->get_svc_grp_ctx = axis2_svc_grp_get_svc_grp_ctx;

    return &(svc_grp_impl->svc_grp);
}

AXIS2_EXTERN axis2_svc_grp_t *AXIS2_CALL
axis2_svc_grp_create_with_conf(
    const axis2_env_t *env,
    axis2_conf_t *conf)
{
    axis2_svc_grp_impl_t *svc_grp_impl = NULL;

    AXIS2_ENV_CHECK(env, NULL);
    AXIS2_PARAM_CHECK(env->error, conf, NULL);

    svc_grp_impl = (axis2_svc_grp_impl_t *) axis2_svc_grp_create(env);
    if (svc_grp_impl)
        svc_grp_impl->parent = conf;

    return &(svc_grp_impl->svc_grp);

}

axis2_status_t AXIS2_CALL
axis2_svc_grp_free(
    axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env)
{
    axis2_svc_grp_impl_t *svc_grp_impl = NULL;

    AXIS2_ENV_CHECK(env, AXIS2_FAILURE);

    svc_grp_impl = AXIS2_INTF_TO_IMPL(svc_grp);

    if (svc_grp->ops)
    {
        AXIS2_FREE(env->allocator, svc_grp->ops);
        svc_grp->ops = NULL;
    }

    if (svc_grp->param_container)
    {
        AXIS2_PARAM_CONTAINER_FREE(svc_grp->param_container,
                env);
        svc_grp->param_container = NULL;
    }

    if (svc_grp_impl->svc_grp_name)
    {
        AXIS2_FREE(env->allocator, svc_grp_impl->svc_grp_name);
        svc_grp_impl->svc_grp_name = NULL;
    }

    if (svc_grp_impl->svcs)
    {
        /* services are freed by arch_file_data */
        axis2_hash_free(svc_grp_impl->svcs, env);
        svc_grp_impl->svcs = NULL;
    }

    if (svc_grp_impl->module_qnames)
    {
        AXIS2_ARRAY_LIST_FREE(svc_grp_impl->module_qnames, env);
        svc_grp_impl->module_qnames = NULL;
    }

    if (svc_grp_impl->module_list)
    {
        AXIS2_ARRAY_LIST_FREE(svc_grp_impl->module_list, env);
        svc_grp_impl->module_list = NULL;
    }

    if (svc_grp_impl)
    {
        AXIS2_FREE(env->allocator, svc_grp_impl);
        svc_grp_impl = NULL;
    }
    return AXIS2_SUCCESS;
}

axis2_status_t AXIS2_CALL
axis2_svc_grp_set_name(
    axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    const axis2_char_t *name)
{
    axis2_svc_grp_impl_t *svc_grp_impl = NULL;

    AXIS2_ENV_CHECK(env, AXIS2_FAILURE);
    svc_grp_impl = AXIS2_INTF_TO_IMPL(svc_grp);

    if (svc_grp_impl->svc_grp_name)
        AXIS2_FREE(env->allocator, svc_grp_impl->svc_grp_name);
    svc_grp_impl->svc_grp_name = AXIS2_STRDUP(name, env);
    if (!svc_grp_impl->svc_grp_name)
    {
        AXIS2_ERROR_SET(env->error, AXIS2_ERROR_NO_MEMORY, AXIS2_FAILURE);
        return AXIS2_FAILURE;
    }

    return AXIS2_SUCCESS;
}

const axis2_char_t *AXIS2_CALL
axis2_svc_grp_get_name(
    const axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env)
{
    AXIS2_ENV_CHECK(env, NULL);

    return AXIS2_INTF_TO_IMPL(svc_grp)->svc_grp_name;
}

axis2_status_t AXIS2_CALL
axis2_svc_grp_add_svc(
    axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    axis2_svc_t *svc)
{
    axis2_svc_grp_impl_t *svc_grp_impl = NULL;
    axis2_phase_resolver_t *handler_resolver = NULL;
    axis2_status_t status = AXIS2_FAILURE;
    const axis2_qname_t *svc_qname = NULL;
    axis2_char_t *svc_name = NULL;

    AXIS2_ENV_CHECK(env, AXIS2_FAILURE);
    AXIS2_PARAM_CHECK(env->error, svc, AXIS2_FAILURE);

    svc_grp_impl = AXIS2_INTF_TO_IMPL(svc_grp);

    if (!svc_grp_impl->svcs)
    {
        svc_grp_impl->svcs = axis2_hash_make(env);
        if (!svc_grp_impl->svcs)
            return AXIS2_FAILURE;
    }
    svc_qname = AXIS2_SVC_GET_QNAME(svc, env);
    svc_name = AXIS2_QNAME_TO_STRING(svc_qname, env);
    axis2_hash_set(svc_grp_impl->svcs, svc_name, AXIS2_HASH_KEY_STRING, svc);

    handler_resolver = axis2_phase_resolver_create_with_config_and_svc(env,
            svc_grp_impl->parent, svc);

    if (NULL == handler_resolver)
    {
        /* remove the previously added service */
        axis2_hash_set(svc_grp_impl->svcs, svc_name, AXIS2_HASH_KEY_STRING,
                NULL);

        return AXIS2_FAILURE;
    }

    status = AXIS2_PHASE_RESOLVER_BUILD_CHAINS(handler_resolver, env);
    if (AXIS2_SUCCESS != status)
    {
        /* remove the previously added service */
        axis2_hash_set(svc_grp_impl->svcs, svc_name, AXIS2_HASH_KEY_STRING, NULL);
        AXIS2_PHASE_RESOLVER_FREE(handler_resolver, env);
        return status;
    }

    status = AXIS2_SVC_SET_LAST_UPDATE(svc, env);
    if (AXIS2_SUCCESS != status)
    {
        /* remove the previously added service */
        axis2_hash_set(svc_grp_impl->svcs, svc_name, AXIS2_HASH_KEY_STRING, NULL);
        AXIS2_PHASE_RESOLVER_FREE(handler_resolver, env);
        return status;
    }

    status = AXIS2_SVC_SET_PARENT(svc, env, svc_grp);
    if (AXIS2_SUCCESS != status)
    {
        /* remove the previously added service */
        axis2_hash_set(svc_grp_impl->svcs, svc_name, AXIS2_HASH_KEY_STRING, NULL);
        AXIS2_PHASE_RESOLVER_FREE(handler_resolver, env);
        return status;
    }

    AXIS2_PHASE_RESOLVER_FREE(handler_resolver, env);
    return status;
}

axis2_svc_t *AXIS2_CALL
axis2_svc_grp_get_svc(
    const axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    const axis2_qname_t *qname)
{
    axis2_svc_grp_impl_t *svc_grp_impl = NULL;
    axis2_char_t *name = NULL;

    AXIS2_ENV_CHECK(env, NULL);
    AXIS2_PARAM_CHECK(env->error, qname, NULL);
    svc_grp_impl = AXIS2_INTF_TO_IMPL(svc_grp);

    name = AXIS2_QNAME_TO_STRING(qname, env);
    return (axis2_svc_t *) axis2_hash_get(svc_grp_impl->svcs, name,
            AXIS2_HASH_KEY_STRING);
}

axis2_hash_t *AXIS2_CALL
axis2_svc_grp_get_all_svcs(
    const axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env)
{
    AXIS2_ENV_CHECK(env, NULL);
    return AXIS2_INTF_TO_IMPL(svc_grp)->svcs;
}

axis2_status_t AXIS2_CALL
axis2_svc_grp_remove_svc(
    axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    const axis2_qname_t *svc_qname)
{
    axis2_svc_t *svc = NULL;
    axis2_char_t *svc_name = NULL;

    AXIS2_ENV_CHECK(env, AXIS2_FAILURE);
    AXIS2_PARAM_CHECK(env->error, svc_name, AXIS2_FAILURE);

    svc = axis2_svc_grp_get_svc(svc_grp, env, svc_qname);

    svc_name = AXIS2_QNAME_TO_STRING(svc_qname, env);
    axis2_hash_set(AXIS2_INTF_TO_IMPL(svc_grp)->svcs, svc_name,
            AXIS2_HASH_KEY_STRING, NULL);

    return AXIS2_SUCCESS;
}

axis2_status_t AXIS2_CALL
axis2_svc_grp_add_param(
    axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    axis2_param_t *param)
{
    AXIS2_ENV_CHECK(env, AXIS2_FAILURE);
    AXIS2_PARAM_CHECK(env->error, param, AXIS2_FAILURE);

    if (AXIS2_TRUE == axis2_svc_grp_is_param_locked(svc_grp, env,
            AXIS2_PARAM_GET_NAME(param, env)))
    {
        AXIS2_ERROR_SET(env->error,
                AXIS2_ERROR_PARAMETER_LOCKED_CANNOT_OVERRIDE, AXIS2_FAILURE);
        return AXIS2_FAILURE;
    }
    else
    {
        return AXIS2_PARAM_CONTAINER_ADD_PARAM(svc_grp->param_container, env, param);
    }

    return AXIS2_FAILURE;
}

axis2_param_t *AXIS2_CALL
axis2_svc_grp_get_param(
    const axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    const axis2_char_t *name)
{
    axis2_param_t *param = NULL;
    axis2_svc_grp_impl_t *svc_grp_impl = NULL;

    AXIS2_ENV_CHECK(env, NULL);
    AXIS2_PARAM_CHECK(env->error, name, NULL);
    svc_grp_impl = AXIS2_INTF_TO_IMPL(svc_grp);

    param = AXIS2_PARAM_CONTAINER_GET_PARAM(svc_grp->param_container, env, name);
    if (param == NULL && svc_grp_impl->parent)
    {
        param = AXIS2_CONF_GET_PARAM(svc_grp_impl->parent, env, name);
    }
    return param;
}

axis2_array_list_t *AXIS2_CALL
axis2_svc_grp_get_all_params(
    const axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env)
{
    AXIS2_ENV_CHECK(env, NULL);

    return AXIS2_PARAM_CONTAINER_GET_PARAMS(svc_grp->param_container, env);
}

axis2_bool_t AXIS2_CALL
axis2_svc_grp_is_param_locked(
    axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    const axis2_char_t *param_name)
{
    axis2_bool_t locked = AXIS2_FALSE;
    axis2_conf_t *parent = NULL;
    axis2_param_t *param = NULL;
    axis2_bool_t ret = AXIS2_FALSE;

    AXIS2_ENV_CHECK(env, AXIS2_FALSE);
    AXIS2_PARAM_CHECK(env->error, param_name, AXIS2_FALSE);

    parent = axis2_svc_grp_get_parent(svc_grp, env);
    /* checking the locked value of parent */
    if (parent)
    {
        locked =  AXIS2_CONF_IS_PARAM_LOCKED(parent, env, param_name);
    }
    if (AXIS2_TRUE == locked)
    {
        ret = AXIS2_TRUE;
    }
    param = axis2_svc_grp_get_param(svc_grp, env, param_name);
    if (param && AXIS2_TRUE == AXIS2_PARAM_IS_LOCKED(param, env))
    {
        ret = AXIS2_TRUE;
    }
    else
    {
        ret = AXIS2_FALSE;
    }
    return ret;
}

axis2_status_t AXIS2_CALL
axis2_svc_grp_add_module_qname(
    axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    const axis2_qname_t *module_qname)
{
    AXIS2_ENV_CHECK(env, AXIS2_FAILURE);

    return AXIS2_ARRAY_LIST_ADD(AXIS2_INTF_TO_IMPL(svc_grp)->module_qnames, env,
            module_qname);
}

axis2_conf_t *AXIS2_CALL
axis2_svc_grp_get_parent(
    const axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env)
{
    AXIS2_ENV_CHECK(env, NULL);

    return AXIS2_INTF_TO_IMPL(svc_grp)->parent;
}

axis2_status_t AXIS2_CALL
axis2_svc_grp_set_parent(
    axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    axis2_conf_t *parent)
{
    axis2_svc_grp_impl_t *svc_grp_impl = NULL;

    AXIS2_ENV_CHECK(env, AXIS2_FAILURE);
    AXIS2_PARAM_CHECK(env->error, parent, AXIS2_FAILURE);

    svc_grp_impl = AXIS2_INTF_TO_IMPL(svc_grp);
    if (svc_grp_impl->parent)
        AXIS2_CONF_FREE(svc_grp_impl->parent, env);
    svc_grp_impl->parent = parent;
    return AXIS2_SUCCESS;
}

axis2_status_t AXIS2_CALL
axis2_svc_grp_engage_module(
    axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    const axis2_qname_t *module_name)
{
    axis2_svc_grp_impl_t *svc_grp_impl = NULL;
    int i = 0;
    axis2_status_t status = AXIS2_FAILURE;
    axis2_qname_t *modu = NULL;
    axis2_char_t *modu_local = NULL;
    axis2_char_t *module_name_local = NULL;
    axis2_hash_t *svc_map = NULL;
    axis2_phase_resolver_t *phase_resolver = NULL;
    axis2_module_desc_t *module = NULL;

    int size = 0;

    AXIS2_ENV_CHECK(env, AXIS2_FAILURE);
    AXIS2_PARAM_CHECK(env->error, module_name, AXIS2_FAILURE);

    svc_grp_impl = AXIS2_INTF_TO_IMPL(svc_grp);
    size = AXIS2_ARRAY_LIST_SIZE(svc_grp_impl->module_qnames, env);
    if (AXIS2_TRUE != AXIS2_ERROR_GET_STATUS_CODE(env->error))
    {
        return AXIS2_FAILURE;
    }
    for (i = 0; size; i++)
    {
        modu = AXIS2_ARRAY_LIST_GET(svc_grp_impl->module_qnames, env, i);
        modu_local = AXIS2_QNAME_GET_LOCALPART(modu, env);
        module_name_local = AXIS2_QNAME_GET_LOCALPART(module_name, env);
        if (0 == AXIS2_STRCMP(modu_local, module_name_local))
        {
            AXIS2_ERROR_SET(env->error,
                    AXIS2_ERROR_MODULE_ALREADY_ENGAGED_TO_SVC_GRP, AXIS2_FAILURE);
            return AXIS2_FAILURE;
        }
    }

    svc_map = axis2_svc_grp_get_all_svcs(svc_grp, env);
    if (NULL == svc_map)
    {
        return AXIS2_FAILURE;
    }

    phase_resolver = axis2_phase_resolver_create_with_config(env, svc_grp_impl->
            parent);

    if (NULL == phase_resolver)
    {
        return AXIS2_FAILURE;
    }

    module = AXIS2_CONF_GET_MODULE(svc_grp_impl->parent, env, module_name);
    if (module)
    {
        axis2_svc_t *axis_svc = NULL;
        axis2_hash_index_t *index = NULL;

        index = axis2_hash_first(svc_map, env);
        while (index)
        {
            void *v = NULL;
            /* engage in per each service */
            axis2_hash_this(index, NULL, NULL, &v);
            axis_svc = (axis2_svc_t *) v;
            status = AXIS2_PHASE_RESOLVER_ENGAGE_MODULE_TO_SVC(phase_resolver,
                    env, axis_svc, module);
            if (!status)
            {
                if (phase_resolver)
                {
                    AXIS2_PHASE_RESOLVER_FREE(phase_resolver, env);
                }
                return status;
            }
            index = axis2_hash_next(env, index);
        }
    }
    if (phase_resolver)
    {
        AXIS2_PHASE_RESOLVER_FREE(phase_resolver, env);
    }

    return axis2_svc_grp_add_module_qname(svc_grp, env, module_name);
}

axis2_array_list_t *AXIS2_CALL
axis2_svc_grp_get_all_module_qnames(
    const axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env)
{
    AXIS2_ENV_CHECK(env, NULL);

    return AXIS2_INTF_TO_IMPL(svc_grp)->module_qnames;
}

axis2_status_t AXIS2_CALL
axis2_svc_grp_add_module_ref(
    axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    const axis2_qname_t *moduleref)
{
    axis2_svc_grp_impl_t *svc_grp_impl = NULL;

    AXIS2_ENV_CHECK(env, AXIS2_FAILURE);
    AXIS2_PARAM_CHECK(env->error, moduleref, AXIS2_FAILURE);

    svc_grp_impl = AXIS2_INTF_TO_IMPL(svc_grp);
    if (!svc_grp_impl->module_list)
    {
        svc_grp_impl->module_list = axis2_array_list_create(env, 0);
        if (!svc_grp_impl->module_list)
            return AXIS2_FAILURE;
    }
    return AXIS2_ARRAY_LIST_ADD(svc_grp_impl->module_list, env, moduleref);
}

axis2_array_list_t *AXIS2_CALL
axis2_svc_grp_get_all_module_refs(
    const axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env)
{
    AXIS2_ENV_CHECK(env, NULL);

    return AXIS2_INTF_TO_IMPL(svc_grp)->module_list;
}

axis2_svc_grp_ctx_t *AXIS2_CALL
axis2_svc_grp_get_svc_grp_ctx(
    const axis2_svc_grp_t *svc_grp,
    const axis2_env_t *env,
    axis2_conf_ctx_t *parent)
{
    axis2_svc_grp_ctx_t *svc_grp_ctx = NULL;

    AXIS2_ENV_CHECK(env, NULL);
    AXIS2_PARAM_CHECK(env->error, parent, NULL);

    svc_grp_ctx = axis2_svc_grp_ctx_create(env, (axis2_svc_grp_t *) svc_grp, parent);
    if (!svc_grp_ctx)
    {
        return NULL;
    }
    return svc_grp_ctx;
}