From 0425aadc78680e53000fd0108b540d6eca048516 Mon Sep 17 00:00:00 2001 From: gmcdonald Date: Sat, 13 Feb 2010 01:32:03 +0000 Subject: Moving axis svn, part of TLP move INFRA-2441 git-svn-id: http://svn.apache.org/repos/asf/axis/axis2/c/core/trunk@909681 13f79535-47bb-0310-9956-ffa450edef68 --- include/axis2_ctx.h | 147 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 147 insertions(+) create mode 100644 include/axis2_ctx.h (limited to 'include/axis2_ctx.h') diff --git a/include/axis2_ctx.h b/include/axis2_ctx.h new file mode 100644 index 0000000..0165ae3 --- /dev/null +++ b/include/axis2_ctx.h @@ -0,0 +1,147 @@ + +/* +* 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. +*/ + +#ifndef AXIS2_CTX_H +#define AXIS2_CTX_H + +/** + * @defgroup axis2_context Context Hierarchy + * @ingroup axis2 + * @{ + * @} + */ + +/** + * @defgroup axis2_ctx context + * @ingroup axis2_context + * context is the base struct of all the context related structs. This struct + * encapsulates the common operations and data for all context types. All the + * context types, configuration, service group, service and operation has the + * base of type context. + * @{ + */ + +/** + * @file axis2_ctx.h + */ + +#include +#include +#include +#include + +#ifdef __cplusplus +extern "C" +{ +#endif + + /** Type name for struct axis2_ctx */ + typedef struct axis2_ctx axis2_ctx_t; + + /** + * Creates a context struct. + * @param env pointer to environment struct + * @return pointer to newly created context + */ + AXIS2_EXTERN axis2_ctx_t *AXIS2_CALL + axis2_ctx_create( + const axutil_env_t * env); + + /** + * Sets a property with the given key. + * @param ctx pointer to context struct + * @param env pointer to environment struct + * @param key key string to store the property with + * @param value pointer to property to be stored, context assumes the + * ownership of the property + * @return AXIS2_SUCCESS on success, else AXIS2_FAILURE + */ + AXIS2_EXTERN axis2_status_t AXIS2_CALL + axis2_ctx_set_property( + struct axis2_ctx *ctx, + const axutil_env_t * env, + const axis2_char_t * key, + axutil_property_t * value); + + /** + * Gets the property with the given key. + * @param ctx pointer to context struct + * @param env pointer to environment struct + * @param key key string + * @return pointer to property struct corresponding to the given key + */ + AXIS2_EXTERN axutil_property_t *AXIS2_CALL + axis2_ctx_get_property( + const axis2_ctx_t * ctx, + const axutil_env_t * env, + const axis2_char_t * key); + + /** + * Gets the non-persistent map of properties. + * @param ctx pointer to context struct + * @param env pointer to environment struct + * @return pointer to the hash map which stores the non-persistent + * properties + */ + AXIS2_EXTERN axutil_hash_t *AXIS2_CALL + axis2_ctx_get_property_map( + const axis2_ctx_t * ctx, + const axutil_env_t * env); + + /** + * Gets all properties stored within context. + * @param ctx pointer to context struct + * @param env pointer to environment struct + * @return pointer to hash table containing all properties + */ + AXIS2_EXTERN axutil_hash_t *AXIS2_CALL + axis2_ctx_get_all_properties( + const axis2_ctx_t * ctx, + const axutil_env_t * env); + + /** + * Frees context struct. + * @param ctx pointer to context struct + * @param env pointer to environment struct + * @return void + */ + AXIS2_EXTERN void AXIS2_CALL + axis2_ctx_free( + axis2_ctx_t * ctx, + const axutil_env_t * env); + + /** + * Sets non-persistent map of properties. + * @param ctx pointer to context struct + * @param env pointer to environment struct + * @param map pointer to hash map, context assumes ownership of the map + * @return AXIS2_SUCCESS on success, else AXIS2_FAILURE + */ + AXIS2_EXTERN axis2_status_t AXIS2_CALL + axis2_ctx_set_property_map( + struct axis2_ctx *ctx, + const axutil_env_t * env, + axutil_hash_t * map); + + /** @} */ + +#ifdef __cplusplus +} +#endif + +#endif /* AXIS2_CTX_H */ -- cgit v1.1-32-gdbae