summaryrefslogtreecommitdiffstats
path: root/xdocs/docs/faq.html
blob: 4b6216c5062444f424c5f48c3f4da1417eaaa063 (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
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!--
   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.
-->
<html><head><title>Apache Axis2/C - FAQ</title>

</head>

<body>
<h1>Apache Axis2/C Frequently Asked Questions</h1>
<p>Mentioned below are a list of Frequently Asked Questions
appearing on Axis2/C <a href="http://axis.apache.org/axis2/c/core/mail-lists.html">mailing
lists</a>, and Forums.</p>
<p>For questions not appearing below, or for any further
clarifications please do not hesitate to contact the Apache Axis2/C
user mailing list: <a href="mailto:c-user@axis.apache.org">c-user@axis.apache.org</a>
(Subscription details are available on the <a href="http://axis.apache.org/axis2/c/core/mail-lists.html">Axis2
site</a>.) Please
remember to prefix the subject with [Axis2].</p>
<p style="margin-bottom: 0in;"><br />
</p>
<a name="0_contents"></a>
<h2>Contents</h2>
<ol>
<li><a href="#1_introduction">Introduction</a>
<ol>
<li><a href="#faq_1_1">What is Axis2/C?</a></li>
<li><a href="#faq_1_2">Licensing</a></li>
<li><a href="#faq_1_3">How can I obtain
Axis2/C?</a></li>
<li><a href="#faq_1_4">How can I get involved?</a></li>
</ol>
</li>
<li><a href="#2_support">Support</a>
<ol>
<li><a href="#faq_2_1">Does Axis2/C support
code generation?</a></li>
<li><a href="#faq_2_2">Does Axis2/C support
SSL?</a></li>
<li><a href="#faq_2_3">Does Axis2/C support
compression?</a></li>
<li><a href="#faq_2_4">Does Axis2/C support
SOAP Session management?</a></li>
<li><a href="#faq_2_5">Can I use Axis2/C with
a proxy?</a></li>
<li><a href="#faq_2_6">Does Axis2/C work on my platform?</a></li>
</ol>
</li>
<li><a href="#3_how_to">How to?</a>
<ol>
<li><a href="#faq_3_1">How can I enable the
Guththila parser?</a></li>
<li><a href="#faq_3_2">How do I turn off MTOM
globally?</a></li>
<li><a href="#faq_3_3">How can I use Axis2/C
with C++?</a></li>
<li><a href="#faq_3_4">How could I secure SOAP
messages?</a></li>
</ol>
</li>
<li><a href="#4_why_do">Why do?</a>
<ol>
<li><a href="#faq_4_1">Why do I get an
"Unresolved external symbol" error?</a></li>
<li><a href="#faq_4_2">Why can't I run the
samples?</a></li>
<li><a href="#faq_4_3">libxml2 is installed
but I get "libxml2 not found"?</a></li>
</ol>
</li>
</ol>
<p style="margin-bottom: 0in;"><br />
</p>

<h2>1. Introduction</h2>
<p></p>

<h3>1.1 What is Axis2/C?</h3>
<p>Apache Axis2/C is a web services engine implemented in the C
programming language based around the Axis2 architecture. Axis2/C can
be used to provide and consume web services. It has been implemented
with portablity and the ability to embed and could readily be used as a
web services enabler for other software.</p>

<h3>1.2 Licensing</h3>
<p>Apache Axis2/C is released under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache 2.0
License</a>, a copy of the License is found in the LICENSE file
found in your distribution. Apache Axis2/C also depends on several
other projects of which licensing information are also included in the
LICENSE file.</p>

<h3>1.3 How can I obtain Axis2/C?</h3>
<p>Apache Axis2/C can be freely downloaded at the <a href="http://axis.apache.org/axis2/c/core/download.cgi">Axis2/C
Download Page</a> or at any other mirror. Please note that
Axis2/C source and binary packages are tailor made to suit specific
classes of operating systems. Please make sure to choose the one that
best fits your requirement as well as your operating system.</p>

<h3>1.4 How can I get involved?</h3>
<p>Apache Axis2/C is a result of a highly involved list of apache
committers, developers, as well as a keen group of users. For more
information on our team, and how to get involved, please visit our <a href="http://axis.apache.org/axis2/c/core/team-list.html">Team Page</a>.</p>
<p style="margin-bottom: 0in;"><br />
</p>

<h2>2. Support</h2>
<p></p>

<h3>2.1 Does Axis2/C support code generation?</h3>
<p>Yes, Axis2/C supports code generation using the WSDL2C tool.
Information on how to use this tool can be found in our <a href="http://axis.apache.org/axis2/c/core/docs/axis2c_manual.html#wsdl2c">documentation</a>.</p>

<h3>2.2 Does Axis2/C support SSL?</h3>
<p>Yes, Axis2/C supports SSL enabled communication. More
information can be found in our <a href="http://axis.apache.org/axis2/c/core/docs/axis2c_manual.html#ssl_client">documentation</a>.</p>

<h3>2.3 Does Axis2/C support compression?</h3>
<p>Axis2/C itself does not support compression. If you are using
mod_axis2 and the Apache HTTP server, you can also mod_deflate for
compression. Also, you can enable compression by using libcurl as the
http sender on the client side.</p>

<h3>2.4 Does Axis2/C support SOAP Session management?</h3>
<p>No, there is no support for SOAP Sessions in Axis2/C.</p>

<h3>2.5 Can I use Axis2/C with a proxy?</h3>
<p>Yes. This requires a few changes to the axis2.xml file.
Information about this can be found in our <a href="http://axis.apache.org/axis2/c/core/docs/axis2c_manual.html#proxy">documentation</a>.</p>
<a id="faq_2_6"></a><h3>2.6 Does Axis2/C work on my platform?</h3>
<p>Currently Axis2/C has been ported to following platforms.<br>
1. Linux based distributions(Debian, Ubuntu, Redhat Linux etc...,) <br>
2. Sun Solaris 10(intel) <br>
3. Mac OS X <br>
4. Microsoft Windows<br>
Patches are welcome! 
<p style="margin-bottom: 0in;"><br />
</p>

<h2>3. How to?</h2>
<p></p>

<h3>3.1 How can I enable the Guththila parser?</h3>
<p>In Windows you have to put the <code>ENABLE_GUTHTHILA =
1</code> in the <code>build/win32/configure.in</code>
file. In Linux you have to specify the configuration option <code>--enable-guththila=yes</code>.
In a Microsoft Visual Studion Project (VC Project) this is little bit
difficult. You have to add the guththila project to the existing
Axis2/C solution. Then in the axis2_parser project, we have to remove
the libxml wrapper files and add the guththila_wrapper files. Also in
the axis2_parser project we have to change the include files and linker
input files (libs) to corresponding guththila files (<code>guththila.lib</code>
and <code>guththila/include</code>).</p>

<h3>3.2 How do I turn off MTOM globally?</h3>
<p>MTOM can be disabled by commenting out the following line from
your axis2.xml.
(<code>&lt;parameter name="enableMTOM"
locked="false"&gt;true&lt;/parameter&gt;</code>)</p>

<h3>3.3 How can I use Axis2/C with C++?</h3>
<p>Just add the following code to your C source files and then
use a C++ compiler.
</p>
<pre> #ifdef __cplusplus <br /> extern "C"{<br /> #endif<br /> /* YOUR C CODE HERE */<br /> #ifdef __cplusplus<br /> }<br /> #endif<br /></pre>

<h3>3.4 How could I secure SOAP messages?</h3>
<p>To secure SOAP messages, you need to engage <a href="http://axis.apache.org/axis2/c/rampart/">Apache Rampart/C</a>
as a module, which can be downloaded from <a href="http://axis.apache.org/axis2/c/rampart/download.cgi">here</a>.
Please refer the <a href="http://axis.apache.org/axis2/c/rampart/docs/installationguide.html">installation
guide</a> and <a href="http://axis.apache.org/axis2/c/rampart/docs/configurations.html">configuration
guide</a> for more details.</p>
<p style="margin-bottom: 0in;"><br />
</p>

<h2>4. Why do?</h2>
<p></p>

<h3>4.1 Why do I get an "Unresolved external symbol" error?</h3>
<p>Make sure that your <code>AXIS2C_HOME/lib</code>
directory is added to your <code>PATH</code> Environment
Variable.</p>

<h3>4.2 Why can't I run the samples?</h3>
<p>This is usually because the <code>AXIS2C_HOME</code>
Environment Variable is not set to the correct path. Make sure that it
is set to your Axis2/C installation path.</p>

<h3>4.3 libxml2 is installed but I get "libxml2 not found"?</h3>
<p>Make sure that you have installed the libxml2-dev packages.</p>
<p style="margin-bottom: 0in;">1. If you are using a
Debian based system run<br />&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; $ apt-get install libxml2-dev<br />
</p>
<p style="margin-bottom: 0in;">2. If you are
using a RedHat/Fedora based system run<br />
&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; $ yum install
libxml2-dev<br />
</p><p style="margin-bottom: 0in;">3. If you install libxml2 from source
you will not get this error<br />
<br />
</p>
<div class="clear">
<hr /></div>
</body></html>