summaryrefslogtreecommitdiffstats
path: root/axiom/include/axiom_mime_part.h
blob: e4cfc36e33307933218999a95706db63f0a1f51d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
/*
 * 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 AXIOM_MIME_PART_H
#define AXIOM_MIME_PART_H

/**
 * @file axiom_mime_part.h
 * @brief axis2 mime_part interface
 */

#include <axutil_utils.h>
#include <axutil_error.h>
#include <axutil_utils_defines.h>
#include <axutil_env.h>
#include <axutil_allocator.h>
#include <axutil_string.h>
#include <axutil_array_list.h>

#ifdef __cplusplus
extern "C"
{
#endif

    typedef struct axiom_mime_part_t axiom_mime_part_t;
    
    
    /* An enum to keep different mime_part types */

    typedef enum axiom_mime_part_type_t
    {

        /** Char buffer */
        AXIOM_MIME_PART_BUFFER = 0,
        
        /* A file */
        AXIOM_MIME_PART_FILE,

        /* User specified callback */
        AXIOM_MIME_PART_CALLBACK,
        
        /* unknown type*/
        AXIOM_MIME_PART_UNKNOWN
        
    } axiom_mime_part_type_t;
    
    struct axiom_mime_part_t
    {
        /* This is when the mime part is a buffer.
         * This will be null when the part is a file */
        axis2_byte_t *part;

        /* This is to keep file name when the part is a file
         * NULL when the part is a buffer */
        axis2_char_t *file_name;

        /* Size of the part. In the case of buffer this is 
         * the buffer size and in the case of file this is 
           the file size */
        size_t part_size;

        /* This is one from the above defined enum */
        axiom_mime_part_type_t type;

        /* This is required in the case of the callback */
        void *user_param;
    };




    AXIS2_EXTERN const axis2_char_t *AXIS2_CALL
    axiom_mime_part_get_content_type_for_mime(
        const axutil_env_t * env,
        axis2_char_t * boundary,
        axis2_char_t * content_id,
        axis2_char_t * char_set_encoding,
        const axis2_char_t * soap_content_type);

    
    /**
     * Creates mime_part struct
     * @return pointer to newly created mime_part
     */
    
    AXIS2_EXTERN axiom_mime_part_t *AXIS2_CALL 
    axiom_mime_part_create(
        const axutil_env_t *env);

    /* This method will create the output part 
     * list.*/

    AXIS2_EXTERN axutil_array_list_t  *AXIS2_CALL
    axiom_mime_part_create_part_list(
        const axutil_env_t *env,
        axis2_char_t *soap_body,
        axutil_array_list_t *binary_node_list,
        axis2_char_t *boundary,
        axis2_char_t *content_id,
        axis2_char_t *char_set_encoding,
        const axis2_char_t *soap_content_type);


    AXIS2_EXTERN void AXIS2_CALL
    axiom_mime_part_free(
        axiom_mime_part_t *mime_part,
        const axutil_env_t *env);

    


    /** @} */

#ifdef __cplusplus
}
#endif
#endif                          /* AXIOM_MIME_PART_H */