2009-05-30T15:05:53Z
1985
GettingStartedGuide
19
3555
== How to write your first app in Java using ZCL?==
* Download JDK 5 or 6 from [http://java.sun.com java]
* Download the [http://kenai.com/projects/zcl/downloads/download/zcl4j.zip zcl4j.zip] library and unzip into your home directory
**Structure of zclfx.zip (See [http://kenai.com/projects/zcl/pages/Dependencies Dependencies] page for information on the contents of all jars)
+zcl4j / license.txt
/ readme.txt
/ javadoc
/ lib / zcl4j.jar (Contains zcl4j classes and all the dependent such as JSON.org.jar, zclcore.jar)
zcl4j_min.jar (Contains only zcl4j classes)
zclcore.jar (core classes such as OAuth signature generation, http client,...)
JSON.org.jar (used to convert result into JSON object if necessary)
* Using your favorite editor create a java file GoogleTraslator.java with the following:
/*
* Access Google translator service in Zembly.net using ZCL
*
*/
import com.zembly.gateway.client.Zembly;
public class GoogleTranslator {
public static void main(String[] args) {
try {
String result = Zembly.getInstance().callService("google.language.translate", new String[][]{{"langpair", "en|it"}, {"q", "Hello World="}, {"format", null}});
System.out.println("result: " + result);
} catch (Exception ex) {
...
}
}
}
* Compile GoogleTranslator.java
javac -classpath <path of zcl4j>/lib/zcl4j.jar GoogleTranslator.java
* Run GoogleTranslator
java -classpath <path of zcl4j>/lib/zcl4j.jar GoogleTranslator
* Read the wiki on [http://wiki.zembly.com/wiki/How_to_Call_Data_Service_from_Outside_zembly calling data services in zembly]
for getting code snippets for other data services in Zembly.
* Read [http://kenai.com/projects/zcl/pages/ProgrammingGuideJava ZCL for Java programming guide for Java] for types, exception handling,...
* See [http://kenai.com/svn/zcl~svn/trunk/www/docs/apidocs/zcl4j/0_5/index.html javadocs]
== How to write your first app in JavaFx using ZCL?==
* Download JDK 6 from [http://java.sun.com java]
* Download JavaFx 1.2 from [http://javafx.com/ JavaFx SDK1.2]
* Download the [http://kenai.com/projects/zcl/downloads/download/zclfx.zip zclfx.zip] library and unzip into your home directory
**Structure of zclfx.zip (See [http://kenai.com/projects/zcl/pages/Dependencies Dependencies] page for information on the contents of all jars)
+zclfx / license.txt
/ readme.txt
/ lib / zclfx.jar (Contains zclfx classes and all the dependent such as JSON.org.jar, zclcore.jar)
zclfx.html (JavaFx artifacts)
zclfx.jnlp (JavaFx artifacts)
zclfx_browser.jnlp (JavaFx artifacts)
...
* Sign-up for zembly wag key/secret pair @ http://zembly.com (select 'Your Keys' tab and click 'Regenerate key' button next to 'Zembly Web API Gateway'), and use this key/secret pair inside zcl.properties
in default package. The key/secret properties are as show below
# Use following parameters to access data services using your key chain in Zembly.com
consumerKey=
consumerSecret=
* Using your favourite editor create a java file GoogleTraslator.fx with the following
import com.zembly.gateway.client.fx.Zembly;
import com.zembly.gateway.client.fx.Parameter;
try {
//ZemblyAsync class uses javafx.async api's to do asynchronous communication with zembly.net.
var request = ZemblyAsync {
serviceName: "web.google.language.translate",
parameters: [
Parameter{name: "langpair", value: "en|it"},
Parameter{name: "q", value: "Hello!"}
],
onInput : function(input: java.io.InputStream) {//parse input using PullParser
input.close();
}
}
request.start();
} catch (e:Exception) {
println("WARNING: {e}");
}
* Compile GoogleTranslator.fx
javafxc -classpath <path of zcl4j>/lib/zclfx.jar GoogleTranslator.fx zcl.properties
* Run GoogleTranslator
javafx -classpath <path of zcl4j>/lib/zcl4j.jar;. GoogleTranslator
* Read the wiki on [http://wiki.zembly.com/wiki/How_to_Call_Data_Service_from_Outside_zembly calling data services in zembly]
for getting code snippets for other data services in Zembly.
* Read [http://kenai.com/projects/zcl/pages/ProgrammingGuideJavaFx ZCL for Java programming guide for JavaFx] for types, exception handling,...
== How to write your first app in PHP using ZCL?==
* Download one of the LAMP stack such as XAMPP from [http://xxxx]
* Download the [http://kenai.com/projects/zcl/downloads/download/zclphp.zip zclphp.zip] library and unzip into your home directory
**Structure of zclphp.zip
zclphp / license.txt
/ readme.txt
/ zclphp / (Contains all the zclphp source files)
/ samples
* Add the location of your zclphp library to your php.ini file. (You may need to restart your Apache server for this to take effect.)
* Using your favorite editor such as NetBeans to create a PHP project and in the index.php file, add the following:
<?php
require_once('zclphp/zembly.php');
$config = new Configuration();
// Get your zembly keys from http://zembly.com (select 'Your Keys' tab and click 'Regenerate key' button next to 'Zembly Web API Gateway')
//$config->setConsumerKey('your_key');
//$config->setConsumerSecret('your_secret');
try {
echo Zembly::getInstance($config)->callService('web.google.language.translate',
array('langpair' => 'en|it', 'q' => 'Hello World!'));
} catch (Exception $ex) {
echo $ex->getMessage();
}
?>
* Running Your PHP Application
If you are using NetBeans, simply right click on the project and select Run.
* Read the wiki on [http://wiki.zembly.com/wiki/How_to_Call_Data_Service_from_Outside_zembly calling data services in zembly]
for getting code snippets for other data services in Zembly.
== How to use Netbeans 6.7 to access Zembly data services==
A NetBeans plugin is available from the NetBeans 6.7 IDE Development Update Center (search for Zembly within the Update Center). It uses the latest version of the ZCL client libraries.
The link to the NetBeans 6.7 IDE Development Update Center is:
http://deadlock.netbeans.org/hudson/job/nbms-and-javadoc/lastStableBuild/artifact/nbbuild/nbms/updates.xml.gz
====Steps====
Perform the following steps to access Zembly data services in the NetBeans 6.7 IDE:
# Install NB 6.7 from http://download.netbeans.org/netbeans/6.7/rc/
# Open NB 6.7, go to Tools->Plugins->Settings.
# Click "Add", then enter name and URL (see above url).
# Click on the "Available Plugins" tab, search for Zembly.
# Install the plugins and restart the IDE.
#.Create a new Java project.
# Go to Services tab, right click on "Zembly Web API Gateway", do "Add Search", enter "google.language" and hit "OK"
# Expand "google.language" and drag-and-drop "google.language.translate" into file Main.java.
# Run the new Java Application.
[[image: wag.png]]
<h2><a name='How_to_write_your_first_app_in_Java_using_ZCL?'></a> How to write your first app in Java using ZCL?</h2>
<ul><li> Download JDK 5 or 6 from <a class='external' href="http://java.sun.com">java</a></li><li> Download the <a class='external' href="http://kenai.com/projects/zcl/downloads/download/zcl4j.zip">zcl4j.zip</a> library and unzip into your home directory
<ul><li>Structure of zclfx.zip (See <a class='external' href="http://kenai.com/projects/zcl/pages/Dependencies">Dependencies</a> page for information on the contents of all jars)
</li></ul></li></ul><pre> +zcl4j / license.txt
/ readme.txt
/ javadoc
/ lib / zcl4j.jar (Contains zcl4j classes and all the dependent such as JSON.org.jar, zclcore.jar)
zcl4j_min.jar (Contains only zcl4j classes)
zclcore.jar (core classes such as OAuth signature generation, http client,...)
JSON.org.jar (used to convert result into JSON object if necessary)
</pre><ul><li> Using your favorite editor create a java file GoogleTraslator.java with the following:
</li></ul><pre> /*
* Access Google translator service in Zembly.net using ZCL
*
*/
import com.zembly.gateway.client.Zembly;
public class GoogleTranslator {
public static void main(String[] args) {
try {
String result = Zembly.getInstance().callService("google.language.translate", new String[][]);
System.out.println("result: " + result);
} catch (Exception ex) {
...
}
}
}
</pre><ul><li> Compile GoogleTranslator.java
</li></ul><p>
javac -classpath <path of zcl4j>/lib/zcl4j.jar GoogleTranslator.java
</p><ul><li> Run GoogleTranslator
</li></ul><p>
java -classpath <path of zcl4j>/lib/zcl4j.jar GoogleTranslator
</p><ul><li> Read the wiki on <a class='external' href="http://wiki.zembly.com/wiki/How_to_Call_Data_Service_from_Outside_zembly">calling data services in zembly</a></li></ul><p>for getting code snippets for other data services in Zembly.
</p><ul><li> Read <a class='external' href="http://kenai.com/projects/zcl/pages/ProgrammingGuideJava">ZCL for Java programming guide for Java</a> for types, exception handling,...
</li><li> See <a class='external' href="http://kenai.com/svn/zcl~svn/trunk/www/docs/apidocs/zcl4j/0_5/index.html">javadocs</a></li></ul><h2><a name='How_to_write_your_first_app_in_JavaFx_using_ZCL?'></a> How to write your first app in JavaFx using ZCL?</h2>
<ul><li> Download JDK 6 from <a class='external' href="http://java.sun.com">java</a></li><li> Download JavaFx 1.2 from <a class='external' href="http://javafx.com/">JavaFx SDK1.2</a></li><li> Download the <a class='external' href="http://kenai.com/projects/zcl/downloads/download/zclfx.zip">zclfx.zip</a> library and unzip into your home directory
<ul><li>Structure of zclfx.zip (See <a class='external' href="http://kenai.com/projects/zcl/pages/Dependencies">Dependencies</a> page for information on the contents of all jars)
</li></ul></li></ul><pre> +zclfx / license.txt
/ readme.txt
/ lib / zclfx.jar (Contains zclfx classes and all the dependent such as JSON.org.jar, zclcore.jar)
zclfx.html (JavaFx artifacts)
zclfx.jnlp (JavaFx artifacts)
zclfx_browser.jnlp (JavaFx artifacts)
</pre><p>...
</p><ul><li> Sign-up for zembly wag key/secret pair @ <a class='external' href="http://zembly.com">http://zembly.com</a> (select 'Your Keys' tab and click 'Regenerate key' button next to 'Zembly Web API Gateway'), and use this key/secret pair inside zcl.properties
</li></ul><p>in default package. The key/secret properties are as show below
</p><pre> # Use following parameters to access data services using your key chain in Zembly.com
consumerKey=
consumerSecret=
</pre><ul><li> Using your favourite editor create a java file GoogleTraslator.fx with the following
</li></ul><p><br />
</p><p>import com.zembly.gateway.client.fx.Zembly;
import com.zembly.gateway.client.fx.Parameter;
</p><pre>
try {
//ZemblyAsync class uses javafx.async api's to do asynchronous communication with zembly.net.
var request = ZemblyAsync {
serviceName: "web.google.language.translate",
parameters: [
Parameter{name: "langpair", value: "en|it"},
Parameter{name: "q", value: "Hello!"}
],
onInput : function(input: java.io.InputStream) {//parse input using PullParser
input.close();
}
}
request.start();
} catch (e:Exception) {
println("WARNING: {e}");
}
</pre><ul><li> Compile GoogleTranslator.fx
</li></ul><p>
javafxc -classpath <path of zcl4j>/lib/zclfx.jar GoogleTranslator.fx zcl.properties
</p><ul><li> Run GoogleTranslator
</li></ul><p>
javafx -classpath <path of zcl4j>/lib/zcl4j.jar;. GoogleTranslator
</p><ul><li> Read the wiki on <a class='external' href="http://wiki.zembly.com/wiki/How_to_Call_Data_Service_from_Outside_zembly">calling data services in zembly</a></li></ul><p>for getting code snippets for other data services in Zembly.
</p><ul><li> Read <a class='external' href="http://kenai.com/projects/zcl/pages/ProgrammingGuideJavaFx">ZCL for Java programming guide for JavaFx</a> for types, exception handling,...
</li></ul><h2><a name='How_to_write_your_first_app_in_PHP_using_ZCL?'></a> How to write your first app in PHP using ZCL?</h2>
<ul><li> Download one of the LAMP stack such as XAMPP from <a class='external' href="http://xxxx">http://xxxx</a></li><li> Download the <a class='external' href="http://kenai.com/projects/zcl/downloads/download/zclphp.zip">zclphp.zip</a> library and unzip into your home directory
<ul><li>Structure of zclphp.zip
</li></ul></li></ul><pre> zclphp / license.txt
/ readme.txt
/ zclphp / (Contains all the zclphp source files)
/ samples
</pre><ul><li> Add the location of your zclphp library to your php.ini file. (You may need to restart your Apache server for this to take effect.)
</li><li> Using your favorite editor such as NetBeans to create a PHP project and in the index.php file, add the following:
</li></ul><pre> <?php
require_once('zclphp/zembly.php');
$config = new Configuration();
// Get your zembly keys from <a class='external' href="http://zembly.com">http://zembly.com</a> (select 'Your Keys' tab and click 'Regenerate key' button next to 'Zembly Web API Gateway')
//$config->setConsumerKey('your_key');
//$config->setConsumerSecret('your_secret');
try {
echo Zembly::getInstance($config)->callService('web.google.language.translate',
array('langpair' => 'en|it', 'q' => 'Hello World!'));
} catch (Exception $ex) {
echo $ex->getMessage();
}
?>
</pre><ul><li> Running Your PHP Application
</li></ul><p>If you are using NetBeans, simply right click on the project and select Run.
</p><ul><li> Read the wiki on <a class='external' href="http://wiki.zembly.com/wiki/How_to_Call_Data_Service_from_Outside_zembly">calling data services in zembly</a></li></ul><p>for getting code snippets for other data services in Zembly.
</p><h2><a name='How_to_use_Netbeans_6.7_to_access_Zembly_data_services'></a> How to use Netbeans 6.7 to access Zembly data services</h2>
<p>
A NetBeans plugin is available from the NetBeans 6.7 IDE Development Update Center (search for Zembly within the Update Center). It uses the latest version of the ZCL client libraries.
</p><p>The link to the NetBeans 6.7 IDE Development Update Center is:
</p><p><a class='external' href="http://deadlock.netbeans.org/hudson/job/nbms-and-javadoc/lastStableBuild/artifact/nbbuild/nbms/updates.xml.gz">http://deadlock.netbeans.org/hudson/job/nbms-and-javadoc/lastStableBuild/artifact/nbbuild/nbms/updates.xml.gz</a>
</p><h4><a name='Steps'></a>Steps</h4>
<p>Perform the following steps to access Zembly data services in the NetBeans 6.7 IDE:
</p><ol><li> Install NB 6.7 from <a class='external' href="http://download.netbeans.org/netbeans/6.7/rc/">http://download.netbeans.org/netbeans/6.7/rc/</a></li><li> Open NB 6.7, go to Tools->Plugins->Settings.
</li><li> Click "Add", then enter name and URL (see above url).
</li><li> Click on the "Available Plugins" tab, search for Zembly.
</li><li> Install the plugins and restart the IDE.
</li><li>.Create a new Java project.
</li><li> Go to Services tab, right click on "Zembly Web API Gateway", do "Add Search", enter "google.language" and hit "OK"
</li><li> Expand "google.language" and drag-and-drop "google.language.translate" into file Main.java.
</li><li> Run the new Java Application.
</li></ol><p><?link_for_image wag.png?></p>
2009-08-04T17:20:13Z
7146