documentation/101_gettingstarted.html - www.eclipse.org/xtend - Git at Google

 <!DOCTYPE html>
 <html>

   <head>
 	<meta charset="UTF-8">
 	<title>Xtend - Hello World</title>
 	<meta name="viewport" content="width=device-width, initial-scale=1.0">
 	<meta name="description"
 		content="Xtend is a statically typed programming language sitting on top of Java.">
 	<meta name="author" content="Sven Efftinge">
 	<meta name="author" content="Miro Spoenemann">
 	<!--  styles -->
 	<!-- Le HTML5 shim, for IE6-8 support of HTML5 elements -->
 	<!--[if lt IE 9]>
 	  <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
 	<![endif]-->

 	<!-- Le fav and touch icons -->

 	<link rel="shortcut icon" href="/xtend/images/favicon.png">

 	<link href="/xtend/css/bootstrap.css" rel="stylesheet" type='text/css'>
 	<link href="/xtend/css/bootstrap-responsive.css" rel="stylesheet" type='text/css'>
 	<link href="/xtend/css/shield-responsive.css" rel="stylesheet" type='text/css'>
 	<link href='/xtend/css/fonts.css' rel='stylesheet' type='text/css'>
 	<link href="/xtend/css/prettyPhoto.css" rel="stylesheet" media="screen" type='text/css'>
 	<link href="/xtend/css/prettify.css" type="text/css" rel="stylesheet"/>
 	<link href="/xtend/css/style.css" rel="stylesheet" type='text/css'>

 	<!--[if lt IE 9]>
 	<link href="css/iebugs.css" rel="stylesheet" type='text/css'>
 	<![endif]-->

 	<!-- BEGIN Cookie Consent
 	<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/cookieconsent2/3.0.3/cookieconsent.min.css" />
 	<script src="//cdnjs.cloudflare.com/ajax/libs/cookieconsent2/3.0.3/cookieconsent.min.js"></script>
 	<script>
 	window.addEventListener("load", function(){
 	window.cookieconsent.initialise({
 		"palette": {
 		"popup": {
 		  "background": "#000"
 		},
 		"button": {
 		  "background": "#f1d600"
 		}
 		},
 		"theme": "edgeless",
 		"type": "opt-in",
 		onInitialise: function (status) {
 		  var type = this.options.type;
 		  var didConsent = this.hasConsented();
 		  if (type == 'opt-in' && didConsent) {
 		    // TODO: enable cookies
 		  }
 		  if (type == 'opt-out' && !didConsent) {
 		    // TODO: disable cookies
 		  }
 		},
 		onStatusChange: function(status, chosenBefore) {
 		  var type = this.options.type;
 		  var didConsent = this.hasConsented();
 		  if (type == 'opt-in' && didConsent) {
 		    // TODO: enable cookies
 		  }
 		  if (type == 'opt-out' && !didConsent) {
 		    // TODO: disable cookies
 		  }
 		},
 		onRevokeChoice: function() {
 		  var type = this.options.type;
 		  if (type == 'opt-in') {
 		    // TODO: disable cookies
 		  }
 		  if (type == 'opt-out') {
 		    // TODO: enable cookies
 		  }
 		},
 		"content": {
 		"href": "http://www.eclipse.org/legal/privacy.php"
 		}
 	})});
 	</script>
 	END Cookie Consent -->
 </head>


   <body>

     <!-- Navbar -->
   <div class="navbar navbar-fixed-top"
     style="border-bottom: 1px solid #000;">
     <div class="navbar-inner">
       <div class="container">
         <a class="btn btn-navbar" data-toggle="collapse"
           data-target=".nav-collapse"> <span class="icon-bar"></span> <span
           class="icon-bar"></span> <span class="icon-bar"></span>
         </a> <a class="brand" href="/xtend/index.html"></a>
         <div class="nav-collapse collapse" style="height: 0px;">
           <ul class="nav">
             <li ><a href="/xtend/download.html">Download</a></li>
             <li ><a href="/xtend/documentation/index.html">Documentation</a></li>
             <li ><a href="/xtend/community.html">Community</a></li>
             <li ><a href="http://xtext.org">Xtext</a></li>
             <li ><a href="http://www.eclipse.org">Eclipse.org</a></li>
           </ul>
               <!--div class="btn-group pull-right">
                 <div class="g-plusone" data-href="http://www.xtend-lang.org"></div>
               </div-->
         </div>
         <!--/.nav-collapse -->
       </div>
     </div>
   </div>
   <!-- Navbar End -->


     <div class="page-content">
   <script>
     function startSearch(event) {
         if (event.keyCode == 13) {
             var q = 'site:eclipse.org/xtend/documentation+' + event.target.value;
             window.open('https://www.google.com/search?q=' + q, "_self");
         }
     }
   </script>
   <div class="wrapper">
     <div id="page">
       <div class="inner">
         <div id="maincontainer" class="container">
           <span class="edit-on-github pull-right">
             <a href="https://github.com/eclipse/xtext/edit/website-published/xtend-website/documentation/101_gettingstarted.md">Edit on Github</a>
           </span>
           <div class="span3" style="margin-left: 0px;">
             <div class="search-bar">
               <img src="/xtend/images/search-gray.png"/>
               <input type="search" id="google-search" onkeyup="startSearch(event);"/>
             </div>
             <ul id="nav-outline">
 	<li>&nbsp;</li>
 	<li style="color : #333;">Getting Started</li>
 	<li><a href="101_gettingstarted.html">Hello World</a></li>
 	<li><a href="102_moviesexample.html">The Movies Example</a></li>
 	<li>&nbsp;</li>
 	<li style="color : #333;">Reference Documentation</li>
 	<li><a href="201_types.html">Java Interoperability</a></li>
 	<li><a href="202_xtend_classes_members.html">Classes and Members</a></li>
 	<li><a href="203_xtend_expressions.html">Expressions</a></li>
 	<li><a href="204_activeannotations.html">Active Annotations</a></li>
 </ul>
           </div>
           <div class="span9 doc-contents">
             <h1 id="getting-started">Hello World</h1>

 <p>The first thing you want to see in any language is a <em>Hello World</em> example. In Xtend, that reads as</p>

 <pre><code class="language-xtend">class HelloWorld {
   def static void main(String[] args) {
     println("Hello World")
   }
 }
 </code></pre>

 <p>You see that Xtend looks quite similar to Java. At a first glance the main difference seems to be the <code>def</code> keyword to declare a method. Also like in Java it is mandatory to define a class and a main method as the entry point for an application. Admittedly <em>Hello World</em> programs are not a particular strength of Xtend. The real expressiveness is unleashed when you do real things as you will learn in a second.</p>

 <p>An Xtend class resides in a plain Eclipse Java project. As soon as the SDK is installed, Eclipse will automatically translate all the classes to Java source code. By default you will find it in a source folder <em>xtend-gen</em>. The hello world example is translated to the following Java code:</p>

 <pre><code class="language-java">// Generated Java Source Code
 import org.eclipse.xtext.xbase.lib.InputOutput;

 public class HelloWorld {
   public static void main(final String[] args) {
     InputOutput.&lt;String&gt;println("Hello World");
   }
 }
 </code></pre>

 <p>The only surprising fact in the generated Java code may be the referenced library class <a href="https://github.com/eclipse/xtext-lib/blob/master/org.eclipse.xtext.xbase.lib/src/org/eclipse/xtext/xbase/lib/InputOutput.java">InputOutput</a>. It is part of the runtime library and a nice utility that is quite handy when used in expressions.</p>

 <p>You can put an Xtend class into a source folder of any Java project within Eclipse or any Maven project. If the project is not yet configured properly, Eclipse will complain about the missing library. The xtend.lib has to be on the class path. The IDE will provide a quick fix to add it.</p>

 <p>The next thing you might want to do is materializing one of the example projects into your workspace. Right click anywhere in the <em>Navigator</em> view in Eclipse and select <em>New → Example…</em>.</p>

 <p>In the upcoming dialog you will find two examples for Xtend:</p>

 <ul>
   <li>
     <p><em>Xtend Introductory Examples</em> contains a couple of example code snippets illustrating certain aspects and strengths of Xtend. For instance it shows how to build an API which allows to write code like this:</p>

     <pre><code class="language-xtend">assertEquals(42.km/h, (40_000.m + 2.km) / 60.min)
 </code></pre>

     <p>The <em>Movies</em> example explained in detail <a href="102_moviesexample.html">in the next section</a> is also included there.</p>
   </li>
   <li>
     <p><em>Xtend Solutions For Euler</em> contains solutions to some of the problems you will find at <a href="http://projecteuler.net/">Project Euler</a>. These examples are leveraging the whole expressive power of Xtend. For instance <a href="http://projecteuler.net/problem=1">Euler Problem 1</a> can be solved with this expression :</p>

     <pre><code class="language-xtend">(1..999).filter[ i | i % 3 == 0 || i % 5 == 0 ].reduce[ i1, i2 | i1 + i2 ]
 </code></pre>
   </li>
 </ul>

 <hr />

 <p><strong><a href="102_moviesexample.html">Next Chapter: The Movies Example</a></strong></p>

           </div>
         </div>
       </div>
     </div>
   </div>
 </div>

     <footer class="site-footer">
   <div id="extra">
     <div class="container inner-footer">
       <div class="row">
         <div class="span6">
           <h3 class="footer-links-header">Quick Links</h3>
           <ul class="footer-links clearfix">
             <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
             <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
             <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
             <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
           </ul>
           <ul class="footer-links clearfix">
             <li><a href="http://www.eclipse.org">Eclipse Home</a></li>
             <li><a href="http://marketplace.eclipse.org/">Market Place</a></li>
             <li><a href="http://live.eclipse.org/">Eclipse Live</a></li>
             <li><a href="http://www.planeteclipse.org/">Eclipse Planet</a></li>
           </ul>
         </div>
         <div class="span6">
             <!-- Social Media Links -->
             <h3 class="footer-links-header"">Social Media</h3>
             <ul class="footer-links clearfix">
               <li>
                 <a href="https://twitter.com/xtendlang"><img src="/xtend/images/Twitter-bird-darkgray.png" class="img-responsive" style="margin-right: 5px;height: 1em;" alt="Twitter icon">@xtendlang on Twitter</a>
               </li>
             </ul>
           </div>

       </div>
     </div>
   </div>
   <a href="#" class="scrollup fadeOutRight animated" style="display: none;">ScrollUp</a>
   <a href="http://dryicons.com/">Icons by http://dryicons.com</a>
   <!-- Le javascript
       ================================================== -->
   <!-- Placed at the end of the document so the pages load faster -->
   <script src="/xtend/js/jquery-1.7.1.min.js" type="text/javascript"></script>
   <script src="/xtend/js/bootstrap.min.js" type="text/javascript"></script>

   <!-- include pretty-print files -->
   <script src="/xtend/js/prettify.js" type="text/javascript" ></script>
   <script src="/xtend/js/lang-xtend.js" type="text/javascript"></script>

   <!-- Include the plug-in -->
   <script src="/xtend/js/jquery.prettyPhoto.js" type="text/javascript"></script>
   <script src="/xtend/js/jquery.easing.1.3.js" type="text/javascript"></script>
   <script src="/xtend/js/custom.js" type="text/javascript"></script>
   <!--script src="https://apis.google.com/js/platform.js" async defer></script-->
   <!--script type="text/javascript">
     var _gaq = _gaq || [];
       _gaq.push([ '_setAccount', 'UA-2429174-4' ]);
     _gaq.push([ '_trackPageview' ]);
     (function() {
       var ga = document.createElement('script');
       ga.type = 'text/javascript';
       ga.async = true;
       ga.src = ('https:' == document.location.protocol ? 'https://ssl'
           : 'http://www')
           + '.google-analytics.com/ga.js';
       var s = document.getElementsByTagName('script')[0];
       s.parentNode.insertBefore(ga, s);
     })();
   </script-->
 </footer>

   </body>

 </html>
	<!DOCTYPE html>
	<html>

	<head>
	<meta charset="UTF-8">
	<title>Xtend - Hello World</title>
	<meta name="viewport" content="width=device-width, initial-scale=1.0">
	<meta name="description"
	content="Xtend is a statically typed programming language sitting on top of Java.">
	<meta name="author" content="Sven Efftinge">
	<meta name="author" content="Miro Spoenemann">
	<!-- styles -->
	<!-- Le HTML5 shim, for IE6-8 support of HTML5 elements -->
	<!--[if lt IE 9]>
	<script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
	<![endif]-->

	<!-- Le fav and touch icons -->

	<link rel="shortcut icon" href="/xtend/images/favicon.png">

	<link href="/xtend/css/bootstrap.css" rel="stylesheet" type='text/css'>
	<link href="/xtend/css/bootstrap-responsive.css" rel="stylesheet" type='text/css'>
	<link href="/xtend/css/shield-responsive.css" rel="stylesheet" type='text/css'>
	<link href='/xtend/css/fonts.css' rel='stylesheet' type='text/css'>
	<link href="/xtend/css/prettyPhoto.css" rel="stylesheet" media="screen" type='text/css'>
	<link href="/xtend/css/prettify.css" type="text/css" rel="stylesheet"/>
	<link href="/xtend/css/style.css" rel="stylesheet" type='text/css'>

	<!--[if lt IE 9]>
	<link href="css/iebugs.css" rel="stylesheet" type='text/css'>
	<![endif]-->

	<!-- BEGIN Cookie Consent
	<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/cookieconsent2/3.0.3/cookieconsent.min.css" />
	<script src="//cdnjs.cloudflare.com/ajax/libs/cookieconsent2/3.0.3/cookieconsent.min.js"></script>
	<script>
	window.addEventListener("load", function(){
	window.cookieconsent.initialise({
	"palette": {
	"popup": {
	"background": "#000"
	},
	"button": {
	"background": "#f1d600"
	}
	},
	"theme": "edgeless",
	"type": "opt-in",
	onInitialise: function (status) {
	var type = this.options.type;
	var didConsent = this.hasConsented();
	if (type == 'opt-in' && didConsent) {
	// TODO: enable cookies
	}
	if (type == 'opt-out' && !didConsent) {
	// TODO: disable cookies
	}
	},
	onStatusChange: function(status, chosenBefore) {
	var type = this.options.type;
	var didConsent = this.hasConsented();
	if (type == 'opt-in' && didConsent) {
	// TODO: enable cookies
	}
	if (type == 'opt-out' && !didConsent) {
	// TODO: disable cookies
	}
	},
	onRevokeChoice: function() {
	var type = this.options.type;
	if (type == 'opt-in') {
	// TODO: disable cookies
	}
	if (type == 'opt-out') {
	// TODO: enable cookies
	}
	},
	"content": {
	"href": "http://www.eclipse.org/legal/privacy.php"
	}
	})});
	</script>
	END Cookie Consent -->
	</head>


	<body>

	<!-- Navbar -->
	<div class="navbar navbar-fixed-top"
	style="border-bottom: 1px solid #000;">
	<div class="navbar-inner">
	<div class="container">
	<a class="btn btn-navbar" data-toggle="collapse"
	data-target=".nav-collapse"> <span class="icon-bar"></span> <span
	class="icon-bar"></span> <span class="icon-bar"></span>
	</a> <a class="brand" href="/xtend/index.html"></a>
	<div class="nav-collapse collapse" style="height: 0px;">
	<ul class="nav">
	<li ><a href="/xtend/download.html">Download</a></li>
	<li ><a href="/xtend/documentation/index.html">Documentation</a></li>
	<li ><a href="/xtend/community.html">Community</a></li>
	<li ><a href="http://xtext.org">Xtext</a></li>
	<li ><a href="http://www.eclipse.org">Eclipse.org</a></li>
	</ul>
	<!--div class="btn-group pull-right">
	<div class="g-plusone" data-href="http://www.xtend-lang.org"></div>
	</div-->
	</div>
	<!--/.nav-collapse -->
	</div>
	</div>
	</div>
	<!-- Navbar End -->


	<div class="page-content">
	<script>
	function startSearch(event) {
	if (event.keyCode == 13) {
	var q = 'site:eclipse.org/xtend/documentation+' + event.target.value;
	window.open('https://www.google.com/search?q=' + q, "_self");
	}
	}
	</script>
	<div class="wrapper">
	<div id="page">
	<div class="inner">
	<div id="maincontainer" class="container">
	<span class="edit-on-github pull-right">
	<a href="https://github.com/eclipse/xtext/edit/website-published/xtend-website/documentation/101_gettingstarted.md">Edit on Github</a>
	</span>
	<div class="span3" style="margin-left: 0px;">
	<div class="search-bar">
	<img src="/xtend/images/search-gray.png"/>
	<input type="search" id="google-search" onkeyup="startSearch(event);"/>
	</div>
	<ul id="nav-outline">
	<li> </li>
	<li style="color : #333;">Getting Started</li>
	<li><a href="101_gettingstarted.html">Hello World</a></li>
	<li><a href="102_moviesexample.html">The Movies Example</a></li>
	<li> </li>
	<li style="color : #333;">Reference Documentation</li>
	<li><a href="201_types.html">Java Interoperability</a></li>
	<li><a href="202_xtend_classes_members.html">Classes and Members</a></li>
	<li><a href="203_xtend_expressions.html">Expressions</a></li>
	<li><a href="204_activeannotations.html">Active Annotations</a></li>
	</ul>
	</div>
	<div class="span9 doc-contents">
	<h1 id="getting-started">Hello World</h1>

	<p>The first thing you want to see in any language is a <em>Hello World</em> example. In Xtend, that reads as</p>

	<pre><code class="language-xtend">class HelloWorld {
	def static void main(String[] args) {
	println("Hello World")
	}
	}
	</code></pre>

	<p>You see that Xtend looks quite similar to Java. At a first glance the main difference seems to be the <code>def</code> keyword to declare a method. Also like in Java it is mandatory to define a class and a main method as the entry point for an application. Admittedly <em>Hello World</em> programs are not a particular strength of Xtend. The real expressiveness is unleashed when you do real things as you will learn in a second.</p>

	<p>An Xtend class resides in a plain Eclipse Java project. As soon as the SDK is installed, Eclipse will automatically translate all the classes to Java source code. By default you will find it in a source folder <em>xtend-gen</em>. The hello world example is translated to the following Java code:</p>

	<pre><code class="language-java">// Generated Java Source Code
	import org.eclipse.xtext.xbase.lib.InputOutput;

	public class HelloWorld {
	public static void main(final String[] args) {
	InputOutput.<String>println("Hello World");
	}
	}
	</code></pre>

	<p>The only surprising fact in the generated Java code may be the referenced library class <a href="https://github.com/eclipse/xtext-lib/blob/master/org.eclipse.xtext.xbase.lib/src/org/eclipse/xtext/xbase/lib/InputOutput.java">InputOutput</a>. It is part of the runtime library and a nice utility that is quite handy when used in expressions.</p>

	<p>You can put an Xtend class into a source folder of any Java project within Eclipse or any Maven project. If the project is not yet configured properly, Eclipse will complain about the missing library. The xtend.lib has to be on the class path. The IDE will provide a quick fix to add it.</p>

	<p>The next thing you might want to do is materializing one of the example projects into your workspace. Right click anywhere in the <em>Navigator</em> view in Eclipse and select <em>New → Example…</em>.</p>

	<p>In the upcoming dialog you will find two examples for Xtend:</p>

	<ul>
	<li>
	<p><em>Xtend Introductory Examples</em> contains a couple of example code snippets illustrating certain aspects and strengths of Xtend. For instance it shows how to build an API which allows to write code like this:</p>

	<pre><code class="language-xtend">assertEquals(42.km/h, (40_000.m + 2.km) / 60.min)
	</code></pre>

	<p>The <em>Movies</em> example explained in detail <a href="102_moviesexample.html">in the next section</a> is also included there.</p>
	</li>
	<li>
	<p><em>Xtend Solutions For Euler</em> contains solutions to some of the problems you will find at <a href="http://projecteuler.net/">Project Euler</a>. These examples are leveraging the whole expressive power of Xtend. For instance <a href="http://projecteuler.net/problem=1">Euler Problem 1</a> can be solved with this expression :</p>

	<pre><code class="language-xtend">(1..999).filter[ i \| i % 3 == 0 \|\| i % 5 == 0 ].reduce[ i1, i2 \| i1 + i2 ]
	</code></pre>
	</li>
	</ul>

	<hr />

	<p><strong><a href="102_moviesexample.html">Next Chapter: The Movies Example</a></strong></p>

	</div>
	</div>
	</div>
	</div>
	</div>
	</div>

	<footer class="site-footer">
	<div id="extra">
	<div class="container inner-footer">
	<div class="row">
	<div class="span6">
	<h3 class="footer-links-header">Quick Links</h3>
	<ul class="footer-links clearfix">
	<li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
	<li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
	<li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
	<li><a href="http://www.eclipse.org/legal/">Legal</a></li>
	</ul>
	<ul class="footer-links clearfix">
	<li><a href="http://www.eclipse.org">Eclipse Home</a></li>
	<li><a href="http://marketplace.eclipse.org/">Market Place</a></li>
	<li><a href="http://live.eclipse.org/">Eclipse Live</a></li>
	<li><a href="http://www.planeteclipse.org/">Eclipse Planet</a></li>
	</ul>
	</div>
	<div class="span6">
	<!-- Social Media Links -->
	<h3 class="footer-links-header"">Social Media</h3>
	<ul class="footer-links clearfix">
	<li>
	<a href="https://twitter.com/xtendlang"><img src="/xtend/images/Twitter-bird-darkgray.png" class="img-responsive" style="margin-right: 5px;height: 1em;" alt="Twitter icon">@xtendlang on Twitter</a>
	</li>
	</ul>
	</div>

	</div>
	</div>
	</div>
	<a href="#" class="scrollup fadeOutRight animated" style="display: none;">ScrollUp</a>
	<a href="http://dryicons.com/">Icons by http://dryicons.com</a>
	<!-- Le javascript
	================================================== -->
	<!-- Placed at the end of the document so the pages load faster -->
	<script src="/xtend/js/jquery-1.7.1.min.js" type="text/javascript"></script>
	<script src="/xtend/js/bootstrap.min.js" type="text/javascript"></script>

	<!-- include pretty-print files -->
	<script src="/xtend/js/prettify.js" type="text/javascript" ></script>
	<script src="/xtend/js/lang-xtend.js" type="text/javascript"></script>

	<!-- Include the plug-in -->
	<script src="/xtend/js/jquery.prettyPhoto.js" type="text/javascript"></script>
	<script src="/xtend/js/jquery.easing.1.3.js" type="text/javascript"></script>
	<script src="/xtend/js/custom.js" type="text/javascript"></script>
	<!--script src="https://apis.google.com/js/platform.js" async defer></script-->
	<!--script type="text/javascript">
	var _gaq = _gaq \|\| [];
	_gaq.push([ '_setAccount', 'UA-2429174-4' ]);
	_gaq.push([ '_trackPageview' ]);
	(function() {
	var ga = document.createElement('script');
	ga.type = 'text/javascript';
	ga.async = true;
	ga.src = ('https:' == document.location.protocol ? 'https://ssl'
	: 'http://www')
	+ '.google-analytics.com/ga.js';
	var s = document.getElementsByTagName('script')[0];
	s.parentNode.insertBefore(ga, s);
	})();
	</script-->
	</footer>

	</body>

	</html>