C:\axis>java org.apache.axis.wsdl.WSDL2Java http://www.xignite.com/xNews.asmx?WSDL
C:\axis>javac com\xignite\*.java
C:\axis>
You can then create your source file.
C:\axis>wsdl2java.bat -ap -uri http://www.xignite.com/xNews.asmx?WSDL
C:\axis>javac com\xignite\*.java
C:\axis>
You can then create your source file. // By default, all of the classes auto-generated by the Axis2
// "WSDL2Java" tool are placed into the package "com.xignite.www.services"
// for our Xignite WSDL, so we need an import.
import com.xignite.www.services.XigniteNewsXigniteNewsSoapStub;
import com.xignite.www.services.XigniteNewsXigniteNewsSoapStub.*;
public class XigniteNewsDemo {
public static void main(String[] args) throws Exception {
// Instantiate the XigniteNews proxy
// proxy object using the Helper class.
// This class was autogenerated by the WSDL2Java tool
try {
XigniteNewsXigniteNewsSoapStub stub = new XigniteNewsXigniteNewsSoapStub();
// Instantiate the return class from the operation
// This class was autogenerated by the WSDL2Java tool
GetStockHeadlines getStockHeadlinesArguments = new GetStockHeadlines();
getStockHeadlinesArguments.setSymbols("MSFT,ORCL");
getStockHeadlinesArguments.setHeadlineCount(5);
GetStockHeadlinesResponse response = stub.GetStockHeadlines(getStockHeadlinesArguments, null);
StockNews[] objStockNews = response.getGetStockHeadlinesResult().getStockNews();
// objStockNews is pointing to the result of the operation
if (objStockNews[0].getOutcome() == OutcomeTypes.RegistrationError)
{
// code to handle registration errors
System.out.println(OutcomeTypes.RegistrationError.toString() + ": " + objStockNews[0].getMessage());
}
else if (objStockNews[0].getOutcome() == OutcomeTypes.RequestError)
{
// code to handle request errors
System.out.println(OutcomeTypes.RequestError.toString() + ": " + objStockNews[0].getMessage());
}
else if (objStockNews[0].getOutcome() == OutcomeTypes.SystemError)
{
// code to handle system errors
System.out.println(OutcomeTypes.SystemError.toString() + ": " + objStockNews[0].getMessage());
}
else // Success
{
for(int i = 0; i < objStockNews.length; i++)
{
System.out.println(objStockNews[i].getHeadline());
}
}
}
catch (Exception ex) {
// add exception handling code here
}
}
}
NuSoap is one of the three major SOAP implementations for PHP: PEAR::SOAP, NuSOAP, and PHP-SOAP.
If you use PHP, we recommend you use NuSoap to access our web services. NuSoap uses our web services for demonstration in their own documentation and it works well.
This section assumes that you have PHP installed on your machine and that you are fairly familiar with it. We have tested this implementation for PHP 4.2.1 on Windows 2000. It should also work with more recent versions on more recent platforms. Note that PHP 5.0 supports SOAP natively (without extension), please follow their documentation for upgrade or code changes required.
To install NuSoap, download the latest package from this location. You can unzip the package in your PHP application directory. The package includes libraries (/lib) and samples (/samples). The sample code below is based on the wsdlclient1.php sample.
If you use one of the older version or PHP (i.e. 4.2.1) , you will need to comment out one line in the /lib/nusoap.php file. That section is not supported in earlier version. The line to comment out is line 1877 as shown below. 1876 // set response timeout
1877 //socket_set_timeout( $this->fp, $response_timeout); You can then create your source file. <?php
// need to use the NuSoap extension
require_once('../lib/nusoap.php');
// if you access the internet through a proxy server
$proxyhost = isset($_POST['proxyhost']) ? $_POST['proxyhost'] : '';
$proxyport = isset($_POST['proxyport']) ? $_POST['proxyport'] : '';
$proxyusername = isset($_POST['proxyusername']) ? $_POST['proxyusername'] : '';
$proxypassword = isset($_POST['proxypassword']) ? $_POST['proxypassword'] : '';
// define the SOAP client using the url for the service
$client = new soapclient('http://www.xignite.com/xNews.asmx?WSDL',
true, $proxyhost, $proxyport, $proxyusername, $proxypassword);
// assess the results
$err = $client->getError();
if ($err) {
echo '<h2>Constructor error</h2><pre>' . $err . '</pre>';
}
// create an array of parameters
$param = array(
'Symbols' => "MSFT,ORCL",
'HeadlineCount' => "5");
// call the service, passing the parameters and the name of the operation
$result = $client->call('GetStockHeadlines', array('parameters' => $param), '', '', false, true);
// assess the results
if ($client->fault) {
echo '<h2>Fault</h2><pre>';
print_r($result);
echo '</pre>';
} else {
$err = $client->getError();
if ($err) {
echo '<h2>Error</h2><pre>' . $err . '</pre>';
} else {
// display the results
echo '<h2>Result</h2><pre>';
// this function exposes the complete structure of the return class
print_r($result);
echo '</pre>';
}
}
// print the SOAP request
echo '<h2>Request</h2><pre>' . htmlspecialchars($client->request, ENT_QUOTES) . '</pre>';
// print the SOAP response
echo '<h2>Response</h2><pre>' . htmlspecialchars($client->response, ENT_QUOTES) . '</pre>';
// print the PHP debugging trace
echo '<h2>Debug</h2><pre>' . htmlspecialchars($client->debug_str, ENT_QUOTES) . '</pre>';
?>
PHP-SOAP is one of the three major SOAP implementations for PHP: PEAR::SOAP, NuSOAP, and PHP-SOAP.
This section assumes that you have PHP5.0 installed on your machine and that you are fairly familiar with it.
Note that PHP 5.0 supports SOAP, please follow their documentation for code changes required.
Here is a sample source for this operation.
<?php
// define the SOAP client using the url for the service
$client = new soapclient('http://www.xignite.com/xNews.asmx?WSDL', array('trace' => 1));
// create an array of parameters
$param = array(
'Symbols' => "MSFT,ORCL",
'HeadlineCount' => "5");
// call the service, passing the parameters and the name of the operation
$result = $client->GetStockHeadlines($param);
// assess the results
if (is_soap_fault($result)) {
echo '<h2>Fault</h2><pre>';
print_r($result);
echo '</pre>';
} else {
echo '<h2>Result</h2><pre>';
print_r($result);
echo '</pre>';
}
// print the SOAP request
echo '<h2>Request</h2><pre>' . htmlspecialchars($client->__getLastRequest(), ENT_QUOTES) . '</pre>';
// print the SOAP request Headers
echo '<h2>Request Headers</h2><pre>' . htmlspecialchars($client->__getLastRequestHeaders(), ENT_QUOTES) . '</pre>';
// print the SOAP response
echo '<h2>Response</h2><pre>' . htmlspecialchars($client->__getLastResponse(), ENT_QUOTES) . '</pre>';
?>
This section assumes that you have SOAP::Lite for Perl installed on your machine and that you are fairly familiar with it. But just in case your are not:You can then use a text editor to create the source code below. You can execute it by running:
C:\perl\perl demo.pl
Note that there are some unique steps to follow to use SOAP::Lite with .Net web Services. For detailed info, check this article on MSDN.
Here is a sample source for this operation.
# the maptype instruction is critical for compatibility
use SOAP::Lite maptype => {};
# this is our namespace
my $namespace = 'http://www.xignite.com/services/';
# declare the service using the namespace, the SOAP action and the uri
my $service = SOAP::Lite
-> uri($namespace)
-> on_action( sub { join '/', 'http://www.xignite.com/services', $_[1] } )
-> proxy('http://www.xignite.com/xNews.asmx');
# .Net requires the method, header, and attributes to be fully qualified
my $method = SOAP::Data->name('GetStockHeadlines')
->attr({xmlns => $namespace});
# this section is required for authentication
# you can skip it if you use IP-based authentication
my $header = SOAP::Header->name(Header => {
Username => '<your username here>'})->uri($namespace)->prefix('');
# same here, you can omit $header if you use IP-based authentication
my @params = ( $header,
SOAP::Data->name(Symbols => 'MSFT,ORCL')->uri($namespace),
SOAP::Data->name(HeadlineCount => '5')->uri($namespace));
# you can now call the service
my $result = $service->call($method => @params);
if ($result->fault)
{
print $result->faultstring;
}
else
{
# here we parse the output using the main return class
# and one of its attributes
# check here for the output structure
# since the output is an array, we must loop through the returned instances
foreach my $instance ($result->valueof('//StockNews'))
{
print $instance->{'Headline'}, "\n";
}
}
' create an instance of the web service
Dim objNewsService As New RemoteNews.XigniteNews()
' create a SOAP header to use for authentication
' the next 3 code lines are not needed if you use IP-based authentication
Dim objHeader As New RemoteNews.Header()
' assign your username to the header and assign the header to the service proxy
objHeader.Username="me@myfirm.com"
objNews.HeaderValue = objHeader
' you can then call the operation
' exceptions could occur on this call if the network was down for instance
' we recommend you catch those exceptions and retry the call a few times
Dim objStockNews() As RemoteNews.StockNews _
= objNewsService.GetStockHeadlines("MSFT,ORCL", 5)
IF objStockNews(0).Outcome = News.OutcomeTypes.Success
' add processing for displaying the results, e.g.
' since the return class contains an array
' we just display its count
' each instance and its values can be easily accessed
Console.WriteLine(objStockNews.GetUpperBound(0).ToString)
Else ' display the error to facilitate diagnostics, e.g.
Console.WriteLine(objStockNews(0).Message)
End If
' this DOM object will contain the result of the call
Dim objResult As IXMLDOMSelection
' create an instance of the soap toolkit
Dim objService As New MSSOAPLib30.SoapClient30
' if your network uses a proxy server, add this line
objService.ConnectorProperty("ProxyServer") = "ip of your proxy server"
' SOAP headers are not supported in the toolkit, so we will fake it with this handler
Dim objHeader As ClientHeaderHandler
Set objHeader = New ClientHeaderHandler
' set the username and passwords to your values
objHeader.Username = "myusername"
objHeader.Password = "mypassword"
Set objService.HeaderHandler = objHeader
' point the the toolkit to the WSDL
objService.mssoapinit "http://www.xignite.com/xNews.asmx?WSDL"
' load the result into the DOM object
Set objResult = objService.GetStockHeadlines("MSFT,ORCL",
"5")
' you can access the properties this way:
' where objResult(5).nodeName is the name of the 5th field of the instance returned
' and objResult(5).Text is the value
MsgBox objResult(5).nodeName & " = " & objResult(5).Text
' you must also add this class to your code.
' it will create the SOAP header to pass with your request
Class Module "ClientHeaderHandler"
Option Explicit
Implements IHeaderHandler
Private m_uid As String
Private m_pwd As String
Private m_tracer As String
Property Let Username(ByVal value As String)
m_uid = value
End Property
Property Let Password(ByVal value As String)
m_pwd = value
End Property
Property Let Tracer(ByVal value As String)
m_tracer = value
End Property
Private Function iHeaderHandler_ReadHeader( _
ByVal par_reader As MSSOAPLib30.ISoapReader, _
ByVal par_HeaderNode As MSXML2.IXMLDOMNode, _
ByVal par_object As Object) As Boolean
iHeaderHandler_ReadHeader = False
End Function
Private Function iHeaderhandler_willWriteHeaders() As Boolean
iHeaderhandler_willWriteHeaders = True
End Function
Private Sub iHeaderHandler_WriteHeaders( _
ByVal par_serializer As MSSOAPLib30.ISoapSerializer, _
ByVal par_object As Object)
Dim XigniteHeaderString As String
XigniteHeaderString = "<Header xmlns="http://www.xignite.com/services/"> " & _
"<Username>" & m_uid & "</Username>" & _
"<Password>" & m_pwd & "</Password>" & _
"<Tracer>" & m_tracer & "</Tracer>" & _
"</Header>"
par_serializer.WriteXml XigniteHeaderString
End Sub
When working with XSL, you only need to worry about properly dealing with namespaces.
The general principle in working with XSL is to apply the stylesheet (the XSL document) to the output of the web service (XML document). The code required to accomplish this varies based on your envirobment. For instance, using VB.Net it would be:Dim objSOAPClient
Dim objTemplate As New System.Xml.Xsl.XslTransform()
objTemplate.Load(<url_of_XSL_template>)
objTemplate.Transform(<url_of_input_document>,<url_of_output_document>)
In the code above, you want to replace the <url_of_input_document> with the following URL.
http://www.xignite.com/xNews.asmx/GetStockHeadlines?Symbols=MSFT,ORCL&HeadlineCount=5
And this is how you could write the XSL stylesheet. Note that all node names are prefixed.
<?xml version="1.0"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:xi="http://www.xignite.com/services/"
version="1.0" exclude-result-prefixes="xi">
<table>
<xsl:for-each select="xi:StockNews>
<tr>
<td>
<xsl:value-of select="xi:Headline/>
</td>
</tr>
</xsl:for-each>
</table>
</xsl:stylesheet>
Copyright © 2009 Xignite, Inc. All Rights Reserved.
Hostname: BATS151
|